Agentes e skills

Agentes tornam um modo de trabalho reutilizável. Skills adicionam procedimentos focados ou orientação de domínio a esse modo. Mantenha o agente base pequeno e adicione skills apenas quando a tarefa exigir.

Configurar um agente

Crie ou edite um agente e defina:

nome e propósito claros;
o papel e as instruções duráveis que ele deve seguir;
um provedor e modelo padrão, quando fizer sentido;
as ferramentas que ele pode usar e as aprovações exigidas;
skills opcionais para trabalho especializado.

Escreva as instruções como regras de operação, não como uma tarefa pontual. Inclua como o agente deve inspecionar contexto, comunicar incerteza, respeitar escopo e verificar mudanças. Coloque a tarefa concreta no chat.

Adicionar uma skill

Uma boa skill tem um gatilho restrito e um procedimento repetível. Ela deve explicar:

quando a skill se aplica;
quais entradas ou acessos são necessários;
a sequência e as verificações a seguir;
o que um resultado concluído deve conter.

Evite duplicar a mesma regra no agente e em várias skills. Quando houver conflito de instruções, simplifique a configuração antes de executá-la sem supervisão.

Testar antes de reutilizar

Rode o agente em um chat pequeno e verifique se ele:

seleciona apenas as ferramentas necessárias para a tarefa;
pede confirmação antes de ações sensíveis ou irreversíveis;
permanece dentro do projeto e do escopo de arquivos solicitados;
produz as verificações e informações de entrega esperadas;
para de forma clara quando está bloqueado.

Teste uma skill nova ou alterada isoladamente antes de reutilizá-la em outros chats.

Usar em chats

Selecione um agente ao iniciar um chat para reutilizar sua configuração. Mantenha as instruções específicas da tarefa no chat. Revise modelo, skills, acesso a ferramentas e limites sempre que o fluxo mudar.

Segurança e portabilidade

Instruções de agentes e skills podem levar ferramentas a ler dados ou realizar ações. Trate configurações importadas como não confiáveis até revisá-las. Não coloque segredos nas instruções; use o mecanismo de credenciais do provedor, da ferramenta ou do servidor MCP.

A disponibilidade pode depender do modelo e das ferramentas conectadas. Se o agente mudar de comportamento após uma troca de provedor ou modelo, teste novamente suas skills e chamadas de ferramentas.

A seguir: Ferramentas e MCP.