Definindo um agente personalizado - Amazon Q Developer
Criando seu primeiro agente personalizadoComandos personalizados do agenteMigração de perfis legadosUsando o agente padrão versus agentes personalizados

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á.

Definindo um agente personalizado

Esta seção aborda como criar e usar agentes personalizados em seu fluxo de trabalho da Amazon Q Developer CLI.

Criando seu primeiro agente personalizado

Aqui está um step-by-step passo a passo para criar seu primeiro agente personalizado:

  1. Inicie uma sessão de bate-papo da Amazon Q Developer CLI:

    $ q chat

  2. Liste os agentes existentes para ver o que está disponível:

    /agent list

  3. Crie um novo agente (my-agentsubstitua pelo nome de sua preferência):

    /agent create --name my-agent

    Isso cria um novo arquivo de configuração do agente e o abre em seu editor padrão (definido por meio da variável de EDITOR ambiente).

  4. Personalize a configuração personalizada do agente conforme necessário. Para começar de forma simples, talvez você queira:

    • Adicione uma descrição explicando a finalidade do agente personalizado

    • Especifique quais ferramentas devem estar disponíveis

    • Pré-aprove ferramentas que você usa com frequência

  5. Salve o arquivo de configuração e saia do editor para retornar à sessão de bate-papo.

  6. Inicie uma nova sessão de bate-papo com seu agente personalizado:

    $ q chat --agent my-agent

    Observação: você não pode alternar agentes personalizados em uma sessão de bate-papo existente. As alterações personalizadas do agente exigem o início de uma nova sessão.

  7. Teste seu agente personalizado solicitando que ele execute tarefas usando as ferramentas que você configurou.

Para obter informações detalhadas sobre as opções personalizadas de configuração do agente, consulte Referência de configuração.

Comandos personalizados do agente

O Amazon Q Developer CLI fornece vários comandos para gerenciar agentes personalizados. Esses comandos estão disponíveis durante uma sessão de bate-papo e começam com/agent.

Comandos personalizados do agente
Command Descrição Disponibilidade
/agent list Mostra todos os agentes personalizados disponíveis em seu ambiente Sessão de bate-papo
/agent schema Exibe o esquema JSON para criar arquivos de configuração de agentes personalizados Sessão de bate-papo
/agent create --name [name] Cria um novo arquivo de configuração de agente personalizado e o abre em seu editor padrão Sessão de bate-papo

Observação: algumas operações personalizadas de gerenciamento de agentes exigem edição manual de arquivos em vez de comandos interativos. As alterações personalizadas do agente entram em vigor quando você inicia uma nova sessão de bate-papo.

Migração de perfis legados

Quando você atualiza para uma versão do Amazon Q Developer CLI que oferece suporte a agentes e faz login, você pode ser solicitado a migrar seus perfis antigos para agentes se:

  • Você tem configurações de perfil herdadas existentes

  • Você está executando no modo interativo (a migração é ignorada com) --no-interactive

  • Você ainda não concluiu o processo de migração

O processo de migração:

  • Converte as configurações de perfil existentes no novo formato de agente

  • Preserva suas permissões de ferramentas e configurações de contexto existentes

  • Cria arquivos de configuração do agente em seu diretório inicial

  • Mantém a compatibilidade com versões anteriores de seus fluxos de trabalho existentes

A migração é opcional e pode ser recusada. Se você optar por não migrar, poderá continuar usando o agente padrão ou criar novos agentes manualmente. Para controlar o comportamento da migração, use o --no-interactive sinalizador para ignorar totalmente as solicitações de migração.

Usando o agente padrão versus agentes personalizados

O Amazon Q Developer CLI inclui um agente padrão integrado que fornece acesso a todas as ferramentas com o mínimo de permissões pré-aprovadas. Esse agente padrão:

  • Inclui todas as ferramentas disponíveis (incorporadas e MCP)

  • Pré-aprova somente a fs_read ferramenta para segurança

  • Inclui automaticamente arquivos de projeto comuns, como README.md e AmazonQ.md

  • Usa a configuração MCP legada, se disponível

Agentes personalizados permitem que você:

  • Limite o acesso à ferramenta somente ao que você precisa

  • Pré-aprove ferramentas adicionais para reduzir interrupções

  • Inclua documentação específica do projeto e arquivos de contexto

  • Configure o comportamento da ferramenta para seu caso de uso específico