Agentes especializados

Um agente especializado atribui um papel a uma parte da tarefa, como revisar um diff ou investigar um caminho de chamadas. Sua descrição indica quando delegar; suas instruções explicam como trabalhar. Use um papel específico quando o mesmo tipo de investigação ou revisão se repetir.

​

Use um agente disponível

Abra Ajustes → Agentes para examinar definições predefinidas, pessoais, do projeto e de pacotes. Busque por nome ou descrição, filtre por todos ou ativados e confira o controle de ativação. Na sessão de Código, digite @ e selecione o agente nas sugestões. Delimite a tarefa e o resultado:

Revise a mudança de quantidades do checkout. Confira cálculo, testes e preservação da assinatura pública. Informe problemas concretos com referências a arquivos. Não altere arquivos.

Leia os resultados antes de pedir alterações. Encontrar um teste ausente não o escreve nem o executa. Mantenha revisão do diff e verificação no fluxo principal.

​

Crie um papel reutilizável

Escolha Novo agente em Ajustes → Agentes ou duplique uma definição existente. Separe a descrição de seleção das instruções de trabalho. Uma descrição útil é: “Revise mudanças de checkout para encontrar regressões de cálculo e testes ausentes.” As instruções podem ser:

Examine o cálculo alterado e seus testes. Confira quantidades de um e de várias unidades, além de mudanças involuntárias de interface. Para cada problema, informe arquivo, comportamento afetado e teste sugerido. Se faltar evidência, explique o que não pôde verificar. Não edite arquivos.

Use o acesso personalizado para selecionar somente as ferramentas necessárias. Para inspeção, omita edição e execução de comandos salvo quando exigidas. Instruções descrevem comportamento; ferramentas e permissões da sessão principal determinam ações disponíveis. Um conjunto personalizado não concede mais acesso que o agente principal. Salve, ative e teste a definição em uma mudança pequena conhecida. Ajuste a descrição se ela for selecionada para o trabalho errado, ou as instruções se o resultado não trouxer evidências suficientes.

​

Gerencie definições e escopo

A origem determina o que pode ser editado. Agentes pessoais podem ser editados, duplicados ou excluídos. Um predefinido alterado pode ser restaurado. Um agente de pacote pode direcionar você ao gerenciamento desse pacote. Excluir uma definição pessoal exige confirmação e preserva resultados anteriores. Desativar controla a disponibilidade sem apagar o trabalho passado da conversa. Papéis diferentes não criam cópias Git separadas. Se várias tarefas precisarem editar ao mesmo tempo, use worktrees separados. Para procedimentos reutilizáveis sem outro papel de agente, consulte skills e plugins.