Criar e configurar agentes
Crie um agente quando um tipo de trabalho recorrente precisar de instruções, modelo ou limites de permissão próprios.
Criar um agente
- Abra Settings → Agents (Configurações → Agentes) e permaneça na aba Agents (Agentes).
- Selecione a ação de criar.
- Informe um Name (Nome): letras minúsculas, números e hifens, por exemplo
reviewer. - Escreva uma Description (Descrição) curta que ajude as pessoas a escolher o agente.
- Escreva o System Prompt (Prompt do Sistema): o resultado esperado, as restrições importantes e como o trabalho deve ser verificado.
- Selecione Create (Criar).
Dê a cada agente uma única responsabilidade clara. A lista também mostra os agentes carregados da sua organização e das configurações global e do projeto. Use Import (Importar) para adicionar a definição de um agente a partir de um arquivo e Export agent definition (Exportar definição do agente) para compartilhar uma.
Ajustar um agente
Abra um agente para mudar a descrição e o prompt e para definir substituições só quando ele precisar de um comportamento diferente dos padrões da sessão:
| Configuração | Efeito |
|---|---|
| Model Override (Substituição de modelo) e Variant Override (Substituição de variante) | Usar um modelo e um esforço de raciocínio específicos neste agente. |
| Temperature (Temperatura) e Top P | Ajustar a amostragem do modelo, quando o modelo permitir. |
| Max Steps (Passos máximos) | Limitar quantos passos o agente pode dar em um turno. |
| Hidden (Oculto) | Manter o agente fora do seletor. |
| Disabled (Desativado) | Desligar o agente sem excluí-lo. |
Calculated Permissions (Permissões Calculadas) mostra as permissões que o agente acaba tendo depois de combinar as próprias regras com as suas configurações.
Agentes nativos não podem ser redefinidos, mas você pode configurar para eles as mesmas substituições e um prompt personalizado.
Agentes principais e subagentes
Um agente pode ser oferecido para seleção interativa (principal), apenas para trabalho delegado (subagente) ou para os dois. Defina isso com o campo mode (primary, subagent ou all) no arquivo de configuração do agente. Agentes só de subagente não aparecem no seletor de agentes do Chat.
Requisitos
Um agente pode declarar as skills, os servidores MCP ou as extensões do VS Code de que precisa. Antes de o agente rodar, o Reasoning verifica esses itens. Quando falta algo, ele lista os pré-requisitos e oferece Open Marketplace (Abrir Marketplace); instale ou conecte o que falta e tente de novo.
Salvar e verificar
Selecione Done (Concluído) para fechar o editor e salve pela barra de salvamento de Settings. Digite /reload no Chat se você editou arquivos fora de Settings. Depois, abra o seletor de agentes do Chat e confirme que o agente aparece com a descrição esperada.
Configurações antigas ainda podem usar o termo mode (modo). O termo atual é agente.