Cos'è l'API delle Abilità di WordPress?

La WordPress Abilities API è un modo standard per i plugin di comunicare agli strumenti di intelligenza artificiale ciò che possono fare. È stata introdotta in WordPress 6.9. L'ho collegata a WP Mail SMTP e ho chiesto a un'IA di leggere i miei log di posta elettronica. Ha risposto in pochi secondi.

Fino ad ora, non esisteva un modo condiviso per gli strumenti esterni di vedere cosa poteva fare il tuo sito. Ogni plugin parlava la propria lingua. Un agente IA doveva indovinare, oppure dovevi scrivere codice personalizzato.

In questa guida, imparerai cosa sono le abilità e come si applicano agli strumenti di intelligenza artificiale. Vedrai anche esattamente cosa WP Mail SMTP e WPForms consentono all'IA di leggere.

La maggior parte di questo non richiede codice. C'è anche una sezione per sviluppatori verso la fine.

Cos'è la WordPress Abilities API?

La WordPress Abilities API è un registro centrale in cui i plugin, i temi e il core di WordPress dichiarano ciò che possono fare. Ogni funzionalità dichiarata è chiamata "abilità".

Un'abilità è un'unità di funzionalità chiara. Pensa a "leggi le ultime 10 email" o "ottieni le statistiche di invio del mese". Ogni abilità ha quattro parti:

• Input: i dati necessari per l'esecuzione
• Output: i dati restituiti
• Esegui: l'azione che esegue
• Permesso: il controllo su chi è autorizzato ad eseguirla

Il registro è leggibile sia dalle macchine che dagli esseri umani. Quindi un agente IA, un altro plugin o uno sviluppatore possono consultarlo e comprenderlo. WordPress memorizza ogni abilità in un unico posto, chiamato WP_Abilities_Registry.

Come funziona la Abilities API?

La Abilities API funziona mantenendo ogni abilità in un unico registro che qualsiasi strumento può interrogare. Un plugin registra le sue abilità all'avvio di WordPress. Ognuna porta le proprie regole.

Quelle regole svolgono tre compiti:

• JSON Schema controlla i tipi di input e output prima che qualcosa venga eseguito.
• Una callback di permesso conferma che l'utente o lo strumento è autorizzato a eseguire l'abilità.
• Flag di metadati contrassegnano un'abilità come di sola lettura, distruttiva o idempotente, in modo che gli strumenti ne conoscano le conseguenze.

C'è anche un flag show_in_rest. Permette a un'abilità di apparire nell'API REST di WordPress quando uno sviluppatore sceglie di attivarla. Ciò mantiene l'esposizione deliberata, non automatica.

Come si collegano le abilità agli agenti IA (l'adattatore MCP)?

Le abilità sono disponibili per gli agenti IA tramite l'Adattatore MCP di WordPress. MCP sta per Model Context Protocol. È il linguaggio condiviso che gli strumenti IA usano per parlare con sistemi esterni.

L'adattatore MCP consente agli strumenti IA di accedere a queste abilità. Legge le tue abilità registrate e le converte in parti MCP:

• Strumenti: abilità che eseguono un'azione
• Risorse: abilità che restituiscono dati da leggere
• Prompt: modelli pronti per attività comuni

Funziona tramite HTTP per siti live o STDIO per lo sviluppo locale. L'accesso utilizza le password per applicazioni di WordPress. Una volta attivo, gli strumenti MCP come Claude, ChatGPT, Cursor e VS Code possono scoprire e utilizzare le tue capacità.

Perché la Abilities API è importante?

L'API delle capacità è importante perché fornisce all'IA un modo affidabile per accedere al tuo sito. In precedenza, non esisteva uno standard. Gli strumenti dovevano analizzare i percorsi REST o leggere il codice dei plugin per indovinare cosa fosse possibile.

Ora il risultato è semplice:

• Un registro da scoprire: gli strumenti trovano ogni capacità in un unico posto.
• Sola lettura per impostazione predefinita: la maggior parte delle capacità legge solo i dati, quindi è sicuro esporle.
• Nessuna integrazione personalizzata: salti l'integrazione su misura di cui ogni plugin aveva bisogno in precedenza.
• Sicurezza coerente: ogni capacità viene eseguita all'interno dello stesso modello di autorizzazione.

Per i proprietari di siti, ciò significa che puoi porre domande reali sul tuo sito a un'IA. Per gli sviluppatori, significa che il tuo plugin ottiene il supporto dell'IA senza un SDK separato.

Correggi subito le tue email WordPress

Cosa può fare WP Mail SMTP con la Abilities API?

WP Mail SMTP utilizza l'API delle capacità per consentire agli strumenti di IA di leggere i tuoi dati di posta elettronica, in sola lettura. Un assistente connesso esamina la tua attività di posta elettronica e risponde alle domande. Non invia mai e-mail, non elimina dati e non modifica le tue impostazioni.

Ecco cosa espone:

• Sfoglia e filtra le e-mail registrate per stato, mittente, data e destinatario
• Estrai i dettagli completi di una singola e-mail e il contenuto quando hai bisogno di un'analisi più approfondita
• Leggi le statistiche di invio dai tuoi Report
• Controlla gli eventi di debug per aiutare a rintracciare un problema di consegna

Queste capacità leggono dal registro e-mail e dai report, che fanno parte di WP Mail SMTP Pro. Il tuo sito richiede WordPress 6.9 o versioni successive e WP Mail SMTP 4.9 o versioni successive.

Una volta connesso, puoi chiedere cose come "Le mie e-mail di reimpostazione password sono state inviate oggi?" Per vederlo in azione, leggi la nostra guida al monitoraggio delle e-mail di WordPress con l'IA.

Quali abilità espone WPForms?

WPForms espone capacità di lettura e scrittura per le voci dei tuoi moduli. Un assistente IA può creare moduli, leggere le sottomissioni, riassumerle e rispondere a domande su di esse.

Ciò apre domande rapide e utili:

• "Quante voci sono arrivate questa settimana?"
• "Riassumi il feedback dal mio modulo di sondaggio."
• "Quale modulo riceve più sottomissioni?"

Le regole sono piuttosto diverse per WPForms. Puoi facoltativamente abilitare l'accesso in scrittura per consentire all'assistente di creare e gestire moduli sul tuo sito. Fornirai semplicemente un prompt per il tipo di modulo che desideri creare e questo lo creerà automaticamente per te.

Come usare la Abilities API con WP Mail SMTP

Per utilizzare WP Mail SMTP con assistenti IA, dovrai prima aggiornare il plugin alla versione 4.9 o successiva. Quindi, connetti uno strumento IA. Ecco i passaggi per WP Mail SMTP:

1. Aggiorna a WordPress 6.9 o versioni successive.
2. Aggiorna a WP Mail SMTP 4.9 o versioni successive.
3. Vai su WP Mail SMTP » Strumenti, quindi apri la scheda AI MCP.
4. Installa e attiva WPVibe, quindi connetti il tuo assistente IA.

Questa è la versione breve. Per la guida completa con screenshot, segui la nostra guida su come collegare WP Mail SMTP agli assistenti AI.

Come registrano uno sviluppatore un'abilità?

Gli sviluppatori registrano un'abilità con la funzione wp_register_ability(). La chiami all'interno di una funzione agganciata all'azione wp_abilities_api_init. Ecco un semplice esempio:

add_action( 'wp_abilities_api_init', 'myplugin_register_abilities' );

function myplugin_register_abilities() {
    wp_register_ability(
        'myplugin/get-recent-orders',
        array(
            'label'               => __( 'Get recent orders', 'myplugin' ),
            'description'         => __( 'Returns the 10 most recent orders.', 'myplugin' ),
            'category'            => 'myplugin',
            'input_schema'        => array(
                'type'       => 'object',
                'properties' => array(
                    'limit' => array( 'type' => 'integer' ),
                ),
            ),
            'output_schema'       => array( 'type' => 'array' ),
            'execute_callback'    => 'myplugin_get_recent_orders',
            'permission_callback' => function () {
                return current_user_can( 'manage_options' );
            },
        )
    );
}

Come si presenta wp_register_ability()?

La funzione accetta due elementi: un nome univoco e un array di impostazioni. Il nome utilizza il formato vendor/ability, come myplugin/get-recent-orders. L'array delle impostazioni definisce il resto:

• label e description: nomi leggibili dall'uomo per l'abilità
• category: un gruppo a cui appartiene l'abilità
• input_schema e output_schema: JSON Schema per i dati in entrata e in uscita
• execute_callback: la funzione che esegue il lavoro
• permission_callback: la funzione che concede o nega l'accesso

Come fanno le callback di autorizzazione a mantenere sicure le abilità?

Le callback di autorizzazione decidono chi può eseguire un'abilità. La tua dovrebbe restituire un controllo current_user_can(), in modo che solo gli utenti giusti possano passare. L'esempio sopra limita l'abilità agli amministratori.

Tre livelli in più la supportano. JSON Schema rifiuta input del tipo sbagliato. I flag dei metadati avvisano gli strumenti quando un'abilità modifica i dati. E show_in_rest mantiene l'esposizione REST opt-in anziché automatica.

Successivamente, collega il tuo sito a ChatGPT

Ora sai cos'è l'API delle abilità di WordPress, come raggiunge gli strumenti AI e cosa espongono i tuoi plugin attraverso di essa.

Il passo successivo è utilizzarne uno. La mia guida su come collegare il tuo sito WordPress a ChatGPT lo illustra, senza bisogno di codice. Una volta aggiornato all'ultima versione di WP Mail SMTP e collegato il tuo sito utilizzando un connettore come WPVibe, puoi chiedere a un assistente dei tuoi log di posta elettronica in linguaggio naturale.

Correggi subito le tue email WordPress

Pronto a creare il tuo modulo? Inizia oggi stesso con il plugin per la creazione di moduli WordPress più semplice. WPForms Pro include molti modelli gratuiti e offre una garanzia di rimborso di 14 giorni.

Se questo articolo ti è stato utile, seguici su Facebook e Twitter per altri tutorial e guide gratuite su WordPress.