O WordPress 6.9, com lançamento previsto para 2 de dezembro de 2025, vem com uma nova API de habilidades que apresenta um novo sistema projetado para tornar possíveis funcionalidades avançadas orientadas por IA para temas e plug-ins. A nova API Abilities padronizará como plug-ins, temas e núcleo descrevem o que podem fazer em um formato que humanos e máquinas possam entender.

Isso posiciona os sites WordPress para serem compreendidos e usados ​​de forma mais confiável por agentes de IA e ferramentas de automação, uma vez que a API Abilities fornece as informações estruturadas que esses sistemas precisam para interagir com a funcionalidade do site de maneira previsível.

A API Abilities foi projetada para resolver um problema antigo no WordPress: a funcionalidade foi espalhada por funções personalizadas, manipuladores AJAX e implementações específicas de plug-ins. De acordo com o WordPress, o objetivo da API é fornecer uma maneira comum para o núcleo, plug-ins e temas do WordPress descreverem o que eles podem fazer de uma forma padronizada e legível por máquina.

Essa abordagem permite descoberta, validação clara e execução previsível onde quer que uma habilidade se origine. Ao centralizar a descrição e a exposição dos recursos, a API Abilities fornece uma maneira centralizada de descrever funcionalidades que, de outra forma, poderiam estar espalhadas por diferentes implementações.

O que é uma habilidade

O anúncio define uma “habilidade” como uma unidade independente de funcionalidade que inclui suas entradas, saídas, permissões e lógica de execução. Essa estrutura permite que as habilidades sejam gerenciadas como partes separadas de funcionalidade, em vez de fragmentos enterrados no tema ou no código do plugin. O WordPress explica que o registro de habilidades por meio da API permite que os desenvolvedores definam verificações de permissão, retornos de chamada de execução e requisitos de validação, garantindo um comportamento previsível onde quer que a habilidade seja usada. Ao substituir funções isoladas por unidades definidas, o WordPress cria um sistema mais claro e aberto para interagir com seus recursos.

O que os desenvolvedores ganham com a API Abilities

Os desenvolvedores ganham diversas vantagens ao registrar funcionalidades como habilidades. De acordo com o anúncio, as habilidades podem ser descobertas por meio de interfaces padronizadas, o que significa que podem ser consultadas, listadas e inspecionadas em diferentes contextos. Os desenvolvedores podem organizá-los em categorias, validar entradas e saídas e aplicar regras de permissão que definem quem ou o que pode executá-los. O anúncio observa que um benefício é a exposição automática por meio de endpoints da API REST no namespace wp-abilities/v1. Esta configuração muda o WordPress de ações com código personalizado para um sistema onde a funcionalidade é definida de forma consistente e acessível.

Melhores práticas de habilidades

Um dos pontos frustrantes para os usuários do WordPress é quando um plugin ou tema entra em conflito com outro. Isso acontece por vários motivos, mas no caso da API Abilities, o WordPress criou um conjunto de regras que deve ajudar a evitar conflitos e erros.

WordPress explica as práticas:

Os nomes das habilidades devem seguir estas práticas:

• Use nomes com namespace para evitar conflitos (por exemplo, my-plugin/my-ability)
• Use apenas caracteres alfanuméricos minúsculos, travessões e barras
• Use nomes descritivos e orientados para a ação (por exemplo, processar-pagamento, gerar-relatório)
• O formato deve ser namespace/nome da habilidade

API de habilidades

A API Abilities apresenta três componentes que funcionam juntos para fornecer um sistema completo de registro e interação com habilidades.

1. A primeira é uma API PHP para registrar, gerenciar e executar habilidades.

2. A segunda é a exposição automática da API REST, que garante que as habilidades possam ser acessadas por meio de endpoints sem esforço extra do desenvolvedor.

3. O terceiro é um conjunto de novos ganchos que ajudam os desenvolvedores a se integrarem ao sistema. Esses componentes, segundo o edital, trazem consistência à forma como as habilidades são descritas e executadas, formando uma base descrita no edital como forma consistente de registrar e executar habilidades.

A API Abilities é guiada por vários objetivos de design que a ajudam a funcionar como uma base de longo prazo.

Descoberta
A descoberta é um objetivo central, permitindo que todas as habilidades sejam listadas, consultadas e inspecionadas.

Interoperabilidade
A interoperabilidade também é enfatizada, pois o esquema uniforme permite que diferentes partes do WordPress criem fluxos de trabalho juntas.

Segurança
A segurança faz parte da nova API desde o projeto, com verificações de permissão que definem quem e o que pode invocar habilidades.

Parte da iniciativa AI Building Blocks

A API Abilities não é uma mudança isolada, mas parte da iniciativa AI Building Blocks destinada a preparar o WordPress para fluxos de trabalho orientados por IA. O anúncio explica que este sistema fornece a base para agentes de IA, ferramentas de automação e desenvolvedores interagirem com o WordPress de maneira previsível.
As habilidades são legíveis por máquina e expostas da mesma maneira em PHP, REST e interfaces planejadas, e o anúncio as descreve como utilizáveis ​​nesses contextos. A API Abilities fornece os metadados que os agentes de IA e as ferramentas de automação podem usar para compreender e trabalhar com a funcionalidade do WordPress.

A introdução da API Abilities no WordPress 6.9 marca potencialmente uma grande mudança na forma como a funcionalidade é organizada, descrita e acessada em toda a plataforma. Ao criar um sistema padronizado para definir habilidades e expô-las em diferentes contextos, o WordPress apresenta um sistema que posiciona o WordPress para estar na vanguarda das futuras inovações de IA nos próximos anos. Esta é uma grande e importante atualização do WordPress que estará aqui em poucas semanas.

Imagem em destaque por Shutterstock/AntonKhrupinArt