Documentação

Skills

Capacidades reutilizaveis que um agente pode adquirir. Como compor skills, como diferem de MCPs e onde elas vivem.

6 min de leitura

O que e uma skill

Uma skill e um pedaco de conhecimento ou comportamento que um agente pode invocar. Exemplo: "classificar uma fatura em categorias contabeis", "resumir um ticket do Zendesk em 3 bullets", "executar um fluxo de escalacao". Skills são reutilizaveis entre agentes do mesmo tenant.

Skill vs MCP

AspectoSkillMCP
FormaInstrução + prompt / toolProcesso externo via protocolo
Onde viveDentro do tenant (instruções, templates)Processo independente (npx, binario)
EscopoCompartamento/estratégia do agenteAcesso a sistemas externos
Exemplo"Resumir em 3 bullets""Conectar ao Postgres e rodar query"
Regra prática: se você precisa acessar um sistema externo, e MCP. Se você quer mudar como o agente pensa ou age num cenário, e skill.

Como criar uma skill

Pelo Configurador de Agentes na UI, pedindo ao assistente algo como "crie uma skill chamada triagem-urgência que classifique mensagens em 3 niveis de severidade". Você também pode editar diretamente na aba Skills do agente — a skill e apenas instruções em markdown + metadados.

# Skill: triagem-urgência

## Quando usar
Quando receber uma mensagem de suporte e precisar classificar urgência.

## Niveis
- critico: paciente com risco imediato, queda de receita em prod
- alto: impedimento de trabalho, falha parcial
- normal: dúvidas, melhorias, pedidos de contexto

## Saida esperada
Um JSON:
{ "nivel": "critico" | "alto" | "normal", "justificativa": "..." }

Compartilhamento

Skills são escopadas por tenant. Uma skill criada em um tenant não vaza para outro — mesmo se tiver o mesmo nome. Para promover uma skill entre empresas, copie o markdown manualmente ou contate nosso time para definir uma biblioteca compartilhada no seu plano.