O que é a API de Habilidades do WordPress?

A API de Capacidades do WordPress é uma forma padrão para os plugins informarem às ferramentas de IA o que podem fazer. Foi incluída no WordPress 6.9. Eu liguei-a ao WP Mail SMTP e pedi a uma IA para ler os meus registos de e-mail. Ela respondeu em segundos.

Até agora, não havia uma forma partilhada para ferramentas externas verem o que o seu site podia fazer. Cada plugin falava a sua própria língua. Um agente de IA tinha de adivinhar, ou tinha de escrever código personalizado.

Neste guia, aprenderá o que são capacidades e como se aplicam a ferramentas de IA. Verá também exatamente o que o WP Mail SMTP e o WPForms permitem que a IA leia.

A maior parte disto não necessita de código. Há também uma secção para programadores perto do fim.

O que é a API de Capacidades do WordPress?

A API de Capacidades do WordPress é um registo central onde plugins, temas e o núcleo do WordPress declaram o que podem fazer. Cada capacidade declarada é chamada uma "capacidade".

Uma capacidade é uma unidade clara de funcionalidade. Pense em "ler os últimos 10 e-mails" ou "obter as estatísticas de envio deste mês". Cada capacidade tem quatro partes:

• Entrada: os dados de que necessita para executar
• Saída: os dados que retorna
• Executar: a ação que executa
• Permissão: a verificação de quem tem permissão para a executar

O registo é legível por máquina e por humanos. Assim, um agente de IA, outro plugin ou um programador pode consultá-lo e compreendê-lo. O WordPress armazena cada capacidade num só local, chamado WP_Abilities_Registry.

Como funciona a API de Capacidades?

A API de Capacidades funciona mantendo cada capacidade num único registo que qualquer ferramenta pode consultar. Um plugin regista as suas capacidades quando o WordPress arranca. Cada um carrega as suas próprias regras.

Essas regras cumprem três funções:

• JSON Schema verifica os tipos de entrada e saída antes de qualquer coisa ser executada.
• Uma função de retorno de permissão confirma se o utilizador ou ferramenta tem permissão para executar a capacidade.
• Indicadores de metadados marcam uma capacidade como somente leitura, destrutiva ou idempotente, para que as ferramentas conheçam as consequências.

Existe também um indicador show_in_rest. Permite que uma capacidade apareça na API REST do WordPress quando um programador opta por isso. Isso mantém a exposição deliberada, não automática.

Como é que as capacidades se conectam a agentes de IA (o adaptador MCP)?

As capacidades estão disponíveis para agentes de IA através do Adaptador MCP do WordPress. MCP significa Model Context Protocol. É a linguagem partilhada que as ferramentas de IA usam para falar com sistemas externos.

O adaptador MCP permite que as ferramentas de IA acedam a estas capacidades. Lê as suas capacidades registadas e converte-as em partes MCP:

• Ferramentas: capacidades que executam uma ação
• Recursos: capacidades que retornam dados para leitura
• Prompts: modelos prontos para tarefas comuns

Funciona via HTTP para sites ativos, ou STDIO para desenvolvimento local. O início de sessão utiliza senhas de aplicação do WordPress. Assim que estiver ativo, ferramentas MCP como Claude, ChatGPT, Cursor e VS Code podem descobrir e utilizar as suas capacidades.

Porque é que a API de Capacidades é importante?

A API de Capacidades é importante porque fornece à IA uma forma fiável de aceder ao seu site. Anteriormente, não existia um padrão. As ferramentas tinham de analisar rotas REST ou ler código de plugins para adivinhar o que era possível.

Agora, o resultado é simples:

• Um registo para descobrir: as ferramentas encontram todas as capacidades num único local.
• Apenas leitura por defeito: a maioria das capacidades apenas lê dados, pelo que são seguras para expor.
• Sem código personalizado: evita a integração específica que cada plugin necessitava anteriormente.
• Segurança consistente: cada capacidade é executada dentro do mesmo modelo de permissões.

Para os proprietários de sites, isto significa que pode fazer perguntas reais sobre o seu site a uma IA. Para os programadores, significa que o seu plugin obtém suporte de IA sem um SDK separado.

Corrija os Seus Emails do WordPress Agora

O que pode o WP Mail SMTP fazer com a API de Capacidades?

O WP Mail SMTP utiliza a API de Capacidades para permitir que ferramentas de IA leiam os seus dados de e-mail, apenas leitura. Um assistente conectado revê a sua atividade de e-mail e responde a perguntas. Nunca envia e-mails, elimina dados ou altera as suas definições.

Eis o que expõe:

• Navegar e filtrar e-mails registados por estado, remetente, data e destinatário
• Obter os detalhes completos de um único e-mail e conteúdo quando precisar de uma análise mais aprofundada
• Ler estatísticas de envio dos seus Relatórios
• Verificar eventos de depuração para ajudar a rastrear um problema de entrega

Estas capacidades leem do Registo de E-mails e Relatórios, que fazem parte do WP Mail SMTP Pro. O seu site necessita do WordPress 6.9 ou posterior e do WP Mail SMTP 4.9 ou posterior.

Assim que estiver conectado, pode perguntar coisas como “Os meus e-mails de redefinição de palavra-passe foram enviados hoje?” Para ver em ação, leia o nosso guia sobre monitorizar o seu e-mail WordPress com IA.

Que capacidades expõe o WPForms?

O WPForms expõe capacidades de leitura e escrita para as suas entradas de formulário. Um assistente de IA pode criar formulários, ler submissões, resumi-las e responder a perguntas sobre elas.

Isto abre perguntas rápidas e úteis:

• “Quantas entradas chegaram esta semana?”
• “Resumir o feedback do meu formulário de inquérito.”
• “Qual formulário recebe mais submissões?”

As regras são bastante diferentes para o WPForms. Pode ativar opcionalmente o acesso de escrita para permitir que o assistente crie e gerencie formulários no seu site. Basta fornecer um prompt para o tipo de formulário que deseja criar, e ele criá-lo-á automaticamente para si.

Como usar a API de Capacidades com o WP Mail SMTP

Para usar o WP Mail SMTP com assistentes de IA, primeiro precisará de atualizar o plugin para a versão 4.9 ou posterior. Em seguida, conecte uma ferramenta de IA. Aqui estão os passos para o WP Mail SMTP:

1. Atualize para o WordPress 6.9 ou posterior.
2. Atualize para o WP Mail SMTP 4.9 ou posterior.
3. Vá a WP Mail SMTP » Ferramentas, depois abra o separador AI MCP.
4. Instale e ative o WPVibe, depois conecte o seu assistente de IA.

Essa é a versão curta. Para o guia completo com capturas de ecrã, siga o nosso guia sobre como ligar o seu WP Mail SMTP a assistentes de IA.

Como é que os programadores registam uma capacidade?

Os programadores registam uma capacidade com a função wp_register_ability(). Você chama-a dentro de uma função ligada à ação wp_abilities_api_init. Eis um exemplo simples:

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' );
            },
        )
    );
}

Como é que a wp_register_ability() se parece?

A função recebe duas coisas: um nome único e um array de configurações. O nome usa o formato vendor/ability, como myplugin/get-recent-orders. O array de configurações define o resto:

• label e description: nomes legíveis por humanos para a capacidade
• category: um grupo a que a capacidade pertence
• input_schema e output_schema: Esquema JSON para os dados de entrada e saída
• execute_callback: a função que executa o trabalho
• permission_callback: a função que concede ou nega acesso

Como é que as callbacks de permissão mantêm as capacidades seguras?

As callbacks de permissão decidem quem pode executar uma capacidade. A sua deve retornar uma verificação current_user_can(), para que apenas os utilizadores corretos passem. O exemplo acima limita a capacidade aos administradores.

Mais três camadas reforçam-na. O Esquema JSON rejeita entradas do tipo errado. As flags de metadados alertam as ferramentas quando uma capacidade altera dados. E show_in_rest mantém a exposição REST opt-in em vez de automática.

Em seguida, Ligue o Seu Site ao ChatGPT

Agora sabe o que é a API de Capacidades do WordPress, como ela alcança as ferramentas de IA e o que os seus plugins expõem através dela.

O próximo passo é usar uma. O meu guia sobre como ligar o seu site WordPress ao ChatGPT explica o processo, sem necessidade de código. Assim que atualizar para a versão mais recente do WP Mail SMTP e ligar o seu site usando um conector como o WPVibe, pode perguntar a um assistente sobre os seus registos de e-mail em linguagem natural.

Corrija os Seus Emails do WordPress Agora

Pronto para criar o seu formulário? Comece hoje com o plugin construtor de formulários WordPress mais fácil. WPForms Pro inclui muitos modelos gratuitos e oferece uma garantia de devolução do dinheiro em 14 dias.

Se este artigo o ajudou, siga-nos no Facebook e no Twitter para mais tutoriais e guias gratuitos do WordPress.