For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal

Habilidades

Entenda como as habilidades adicionam fluxos de trabalho repetíveis ao uso de ferramentas MCP.

Habilidades são pastas com instruções e recursos que ensinam o ChatGPT e o Codex a executar fluxos de trabalho repetíveis. Em um plug-in baseado em MCP, as habilidades complementam o servidor ao ensinar o modelo a combinar suas ferramentas para atender a objetivos identificáveis dos usuários.

Cada habilidade tem um arquivo SKILL.md com:

  • Um nome.
  • Uma descrição que informa ao modelo quando considerar o uso da habilidade.
  • Instruções para executar o fluxo de trabalho.
  • Referências, scripts, modelos e outros recursos opcionais.

Como as habilidades complementam um servidor MCP

Um servidor MCP fornece informações em tempo real e ações controladas. Uma habilidade define o fluxo de trabalho para usar essas ferramentas: quando chamá-las, em que ordem, como lidar com resultados incompletos e o que o resultado final deve conter.

Por exemplo, uma habilidade pode definir como:

  • Consultar a atividade de uma conta e transformá-la em um resumo sobre o cliente.
  • Revisar dados do projeto, identificar riscos e redigir uma atualização de status.
  • Combinar ferramentas de busca e recuperação de conteúdo em um fluxo de pesquisa com fontes.
  • Aplicar os padrões de redação ou revisão de uma organização aos resultados do MCP.

Mantenha clara a divisão de responsabilidades: o servidor MCP fornece dados, autenticação, autorização e ações; a habilidade fornece instruções reutilizáveis, exemplos, modelos e outros recursos. Uma habilidade também pode funcionar sem um servidor MCP quando o fluxo de trabalho precisa apenas das instruções e dos recursos incluídos no pacote.

Como as habilidades são ativadas

O modelo vê primeiro os metadados da habilidade, incluindo o nome e a descrição. Ele carrega as instruções completas quando a solicitação do usuário corresponde à habilidade ou quando o usuário a invoca diretamente.

Escreva descrições com foco no objetivo do usuário e nas condições que devem acionar o fluxo de trabalho. Mantenha as etapas detalhadas e os requisitos de saída no corpo das instruções.

Habilidades em um plug-in

As habilidades são a camada de fluxo de trabalho de um plug-in. Elas podem:

  • Orientar o modelo no uso das ferramentas expostas pelo servidor MCP do plug-in.
  • Reunir procedimentos específicos da organização com modelos e referências reutilizáveis em um pacote.
  • Funcionar de forma independente quando não são necessários dados em tempo real nem ações controladas.

As habilidades e as ferramentas MCP devem ter papéis claros e complementares. Uma habilidade explica como executar o fluxo de trabalho; um servidor MCP fornece informações em tempo real e garante que as ações sejam executadas de forma controlada.

Continue em Criar habilidades para criar, testar e empacotar uma habilidade.