Gerenciamento de agentes personalizados - Amazon Q Developer
Localizações personalizadas dos arquivos do agentePráticas recomendadas para organizar agentes personalizadosCompartilhamento de agentes personalizados com equipes

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Gerenciamento de agentes personalizados

Esta seção aborda como organizar, gerenciar e trabalhar com agentes personalizados de forma eficaz em seu fluxo de trabalho de desenvolvimento.

Localizações personalizadas dos arquivos do agente

Os arquivos personalizados de configuração do agente são armazenados como arquivos JSON em diretórios específicos:

Agentes personalizados globais

~/.aws/amazonq/cli-agents/{agent-name}.json

Disponível em todos os projetos e diretórios do seu sistema.

Agentes personalizados em nível de projeto

.amazonq/cli-agents/{agent-name}.json

Disponível somente dentro do diretório específico do projeto e seus subdiretórios.

Importante: O {agent-name} nome do arquivo é apenas para sua referência. O nome real do agente é determinado pelo name campo no próprio arquivo de configuração JSON, o que é obrigatório.

Precedência personalizada do agente e resolução de conflitos

Quando o Amazon Q Developer CLI procura um agente personalizado, ele segue uma ordem de precedência específica:

  1. Agentes personalizados locais primeiro - Verifica a existência de agentes personalizados no diretório de trabalho atual

  2. Agentes personalizados globais em segundo lugar - Volta para agentes personalizados em seu diretório inicial

  3. Padrão incorporado - usa o agente padrão se nenhum agente personalizado for encontrado

Se os diretórios local e global contiverem agentes personalizados com o mesmo nome, o agente personalizado local terá precedência. O Amazon Q Developer CLI exibirá uma mensagem de aviso quando isso ocorrer:

WARNING: Agent conflict for my-agent. Using workspace version.

Esse sistema de precedência permite que você:

  • Substitua agentes personalizados globais por versões específicas do projeto

  • Teste as modificações personalizadas do agente localmente antes de torná-las globais

  • Mantenha diferentes configurações personalizadas de agentes para diferentes projetos

Práticas recomendadas para organizar agentes personalizados

Quando usar agentes personalizados globais

Use agentes personalizados globais para:

  • Fluxos de trabalho de uso geral - agentes personalizados usados em vários projetos

  • Produtividade pessoal - Agentes personalizados adaptados ao seu estilo de trabalho individual

  • Tarefas comuns de desenvolvimento - revisão de código, depuração, geração de documentação

  • Fluxos de trabalho específicos de ferramentas — gerenciamento da AWS, operações do Git, fluxos de trabalho do Docker

Quando usar agentes personalizados locais

Use agentes personalizados locais para:

  • Configurações específicas do projeto - agentes personalizados que precisam acessar arquivos específicos do projeto

  • Colaboração em equipe - agentes personalizados compartilhados por meio do controle de versão

  • Ambientes de desenvolvimento - Agentes personalizados com requisitos exclusivos para projetos específicos

  • Teste e experimentação - Modificações temporárias do agente personalizado sem afetar as configurações globais

Convenções personalizadas de nomenclatura de agentes

Considere estas convenções de nomenclatura para uma melhor organização personalizada dos agentes:

  • Nomes baseados em propósitos -aws-specialist.json,, code-reviewer.json documentation-writer.json

  • Nomes específicos de tecnologia -python-dev.json,, react-frontend.json terraform-ops.json

  • Nomes específicos do projeto -project-alpha.json,, mobile-app.json api-backend.json

  • Nomes específicos do ambiente -,, development.json staging.json production.json

Compartilhamento de agentes personalizados com equipes

Agentes personalizados locais podem ser compartilhados com os membros da equipe por meio de sistemas de controle de versão. Essa abordagem permite que as equipes:

  • Padronize os ambientes de desenvolvimento — garanta que todos os membros da equipe tenham acesso às mesmas ferramentas e configurações

  • Compartilhe o contexto específico do projeto - inclua documentação do projeto, padrões de codificação e scripts personalizados

  • Mantenha a consistência — use as mesmas permissões e configurações da ferramenta em toda a equipe

  • Colabore em melhorias - Use pull requests para revisar e melhorar as configurações personalizadas do agente

Práticas recomendadas de controle de versão

Ao compartilhar agentes personalizados por meio do controle de versão:

  • Inclua diretórios de agentes personalizados - Adicione .aws/amazonq/agents/ ao seu repositório

  • Documente as finalidades personalizadas do agente - Use descrições claras nos arquivos de configuração do agente personalizado

  • Revise as alterações personalizadas do agente - Trate as alterações personalizadas na configuração do agente como alterações no código

  • Teste as configurações personalizadas do agente - verifique se os agentes personalizados compartilhados funcionam corretamente para todos os membros da equipe

  • Evite informações confidenciais — não inclua chaves de API, senhas ou informações pessoais em agentes personalizados compartilhados