O que é a API de Habilidades do WordPress?

A API de Habilidades do WordPress é uma maneira padrão para plugins informarem às ferramentas de IA o que eles podem fazer. Ela foi incluída no WordPress 6.9. Eu a conectei ao WP Mail SMTP e pedi a uma IA para ler meus logs de e-mail. Ela respondeu em segundos.

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

Neste guia, você aprenderá o que são habilidades e como elas se aplicam a ferramentas de IA. Você também verá exatamente o que o WP Mail SMTP e o WPForms permitem que a IA leia.

A maior parte disso não requer código. Há uma seção para desenvolvedores perto do final também.

O que é a API de Habilidades do WordPress?

A API de Habilidades do WordPress é um registro central onde plugins, temas e o core do WordPress declaram o que podem fazer. Cada capacidade declarada é chamada de "habilidade".

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

• Entrada: os dados que ela precisa para executar
• Saída: os dados que ela retorna
• Executar: a ação que ela realiza
• Permissão: a verificação de quem tem permissão para executá-la

O registro é legível por máquina e por humanos. Assim, um agente de IA, outro plugin ou um desenvolvedor pode consultá-lo e entendê-lo. O WordPress armazena cada habilidade em um único local, chamado WP_Abilities_Registry.

Como funciona a API de Habilidades?

A API de Habilidades funciona mantendo cada habilidade em um único registro que qualquer ferramenta pode consultar. Um plugin registra suas habilidades quando o WordPress é iniciado. Cada um carrega suas próprias regras.

Essas regras realizam três tarefas:

• JSON Schema verifica os tipos de entrada e saída antes que qualquer coisa seja executada.
• Um callback de permissão confirma se o usuário ou a ferramenta tem permissão para executar a habilidade.
• Flags de metadados marcam uma habilidade como somente leitura, destrutiva ou idempotente, para que as ferramentas saibam as consequências.

Há também uma flag show_in_rest. Ela permite que uma habilidade apareça na API REST do WordPress quando um desenvolvedor opta por isso. Isso mantém a exposição deliberada, não automática.

Como as habilidades se conectam a agentes de IA (o adaptador MCP)?

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

O adaptador MCP permite que ferramentas de IA acessem essas habilidades. Ele lê suas habilidades registradas e as converte em partes do MCP:

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

Funciona via HTTP para sites ativos ou STDIO para desenvolvimento local. O login usa senhas de aplicativo do WordPress. Uma vez ativo, ferramentas MCP como Claude, ChatGPT, Cursor e VS Code podem descobrir e usar suas habilidades.

Por que a API de Habilidades é importante?

A API de Habilidades é importante porque fornece à IA uma maneira confiável de acessar seu site. Antes, não havia um padrão. As ferramentas precisavam escanear rotas REST ou ler o código do plugin para adivinhar o que era possível.

Agora, a recompensa é simples:

• Um registro para descobrir: ferramentas encontram todas as capacidades em um único lugar.
• Somente leitura por padrão: a maioria das habilidades apenas lê dados, portanto, é seguro expô-las.
• Sem código personalizado: você pula a integração específica que cada plugin precisava antes.
• Segurança consistente: cada habilidade é executada dentro do mesmo modelo de permissão.

Para proprietários de sites, isso significa que você pode fazer perguntas reais sobre seu site a uma IA. Para desenvolvedores, significa que seu plugin terá suporte de IA sem um SDK separado.

Corrija seus e-mails do WordPress agora

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

O WP Mail SMTP usa a API de Habilidades para permitir que ferramentas de IA leiam seus dados de e-mail, somente leitura. Um assistente conectado revisa sua atividade de e-mail e responde a perguntas. Ele nunca envia e-mails, exclui dados ou altera suas configurações.

Veja o que ele expõe:

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

Essas habilidades leem do Registro de E-mails e Relatórios, que fazem parte do WP Mail SMTP Pro. Seu site precisa do WordPress 6.9 ou posterior e do WP Mail SMTP 4.9 ou posterior.

Uma vez conectado, você pode perguntar coisas como "Meus e-mails de redefinição de senha foram enviados hoje?" Para ver em ação, leia nosso guia sobre como monitorar seu e-mail do WordPress com IA.

Quais habilidades o WPForms expõe?

O WPForms expõe habilidades de leitura e escrita para as entradas do seu formulário. Um assistente de IA pode criar formulários, ler envios, resumi-los e responder a perguntas sobre eles.

Isso abre perguntas rápidas e úteis:

• “Quantas entradas chegaram esta semana?”
• “Resuma o feedback da minha pesquisa.”
• “Qual formulário recebe mais envios?”

As regras são bem diferentes para o WPForms. Você pode opcionalmente habilitar o acesso de escrita para permitir que o assistente crie e gerencie formulários em seu site. Você simplesmente fornecerá um prompt para o tipo de formulário que deseja criar, e ele o criará automaticamente para você.

Como usar a API de Habilidades com o WP Mail SMTP

Para usar o WP Mail SMTP com assistentes de IA, você precisará primeiro atualizar o plugin para a versão 4.9 ou posterior. Em seguida, conecte uma ferramenta de IA. Aqui estão as etapas 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á para WP Mail SMTP » Ferramentas e abra a guia AI MCP.
4. Instale e ative o WPVibe, em seguida, conecte seu assistente de IA.

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

Como os desenvolvedores registram uma habilidade?

Desenvolvedores registram uma habilidade com a função wp_register_ability(). Você a chama dentro de uma função conectada à ação wp_abilities_api_init. Aqui está 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 é a função wp_register_ability()?

A função recebe duas coisas: um nome exclusivo e uma matriz de configurações. O nome usa o formato vendor/ability, como myplugin/get-recent-orders. A matriz de configurações define o restante:

• label e description: nomes legíveis por humanos para a habilidade
• category: um grupo ao qual a habilidade 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 os callbacks de permissão mantêm as habilidades seguras?

Os callbacks de permissão decidem quem pode executar uma habilidade. O seu deve retornar uma verificação current_user_can(), para que apenas os usuários corretos passem. O exemplo acima limita a habilidade aos administradores.

Três camadas adicionais a reforçam. O Esquema JSON rejeita entradas do tipo incorreto. Metadados de sinalização alertam as ferramentas quando uma habilidade altera dados. E show_in_rest mantém a exposição REST opt-in em vez de automática.

Em seguida, Conecte seu Site ao ChatGPT

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

O próximo passo é usar uma. Meu guia sobre como conectar seu site WordPress ao ChatGPT detalha o processo, sem necessidade de código. Depois de atualizar para a versão mais recente do WP Mail SMTP e conectar seu site usando um conector como o WPVibe, você pode perguntar a um assistente sobre seus logs de e-mail em linguagem simples.

Corrija seus e-mails do WordPress agora

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

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