Visão geral
Agentes personalizados oferecem uma forma de personalizar o comportamento da CLI do Amazon Q Developer definindo configurações específicas para diferentes casos de uso. Cada agente personalizado é definido por um arquivo de configuração JSON que especifica quais ferramentas o agente pode acessar, quais permissões ele tem e qual contexto ele deve incluir.
Importante: o gerenciamento de agentes personalizados envolve principalmente a criação e edição de arquivos de configuração. Embora alguns comandos estejam disponíveis durante as sessões de chat (como /agent list e /agent create), é preciso iniciar uma nova sessão de chat com q chat --agent [name] para alternar entre agentes personalizados.
Como os agentes personalizados diferem da experiência padrão
Por padrão, a CLI do Amazon Q Developer fornece acesso a todas as ferramentas disponíveis, mas exige a confirmação do usuário para a maioria das operações. Essa abordagem prioriza a segurança, mas pode interromper seu fluxo de trabalho com prompts de permissão frequentes.
Agentes personalizados resolvem isso, permitindo que você:
-
Pré-aprove ferramentas específicas: defina quais ferramentas podem ser executadas sem prompt
-
Limite o acesso à ferramenta: restrinja quais ferramentas estão disponíveis para reduzir a complexidade
-
Inclua contexto relevante: carregue automaticamente arquivos de projeto, documentação ou informações do sistema
-
Configure o comportamento da ferramenta: defina parâmetros específicos de como as ferramentas devem operar
Benefícios de usar agentes personalizados
- Otimização do fluxo de trabalho
-
Crie agentes personalizados para tarefas específicas, como gerenciamento de infraestrutura da AWS, revisões de código ou sessões de depuração.
- Interrupções reduzidas
-
Pré-aprove ferramentas confiáveis para eliminar prompts de permissão durante sessões de trabalho específicas.
- Contexto aprimorado
-
Inclua automaticamente documentação relevante do projeto, arquivos de configuração ou informações do sistema.
- Colaboração em equipe
-
Compartilhe configurações de agentes personalizados com os membros da equipe para garantir ambientes de desenvolvimento consistentes.
- Controle de segurança
-
Limite o acesso às ferramentas somente ao que é necessário para fluxos de trabalho específicos, reduzindo possíveis riscos de segurança.
Relacionamento com o MCP e ferramentas integradas
Os agentes personalizados trabalham com ferramentas integradas da CLI do Amazon Q Developer e ferramentas externas fornecidas por meio do protocolo de contexto para modelos (MCP). Isso fornece flexibilidade para:
-
Usar ferramentas integradas: operações de arquivos, execução de comandos, integração com a CLI da AWS e outras funcionalidades essenciais
-
Integrar servidores MCP: adicione ferramentas e serviços personalizados por meio das configurações do servidor MCP
-
Controlar o acesso à ferramenta: especifique exatamente quais ferramentas de cada fonte estão disponíveis
-
Gerenciar conflitos de ferramentas: use aliases para lidar com conflitos de nomenclatura entre diferentes fontes de ferramentas
Para obter mais informações sobre a integração de MCP, consulte Using MCP with Amazon Q Developer.
