View a markdown version of this page

Gerenciar agentes personalizados - AWS DevOps Agente

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

Gerenciar agentes personalizados

Depois de criar um agente personalizado, você pode editar sua configuração, visualizar seu histórico de invocação e excluí-lo quando não for mais necessário.

Editando um agente personalizado

Você pode editar um agente personalizado usando o formulário ou por meio do Chat. O formulário permite que você atualize o nome, o prompt do sistema, as habilidades e os armazenamentos de memória anexados. Para modificar as ferramentas do agente, use o Chat.

Para editar um agente personalizado usando o formulário:

  1. Navegue até a página Agentes em seu aplicativo web DevOps Agent.

  2. Escolha o agente personalizado que você deseja editar.

  3. Na página de detalhes do agente, escolha Editar.

  4. Na caixa de diálogo, escolha Formulário.

  5. Modifique os campos que você deseja atualizar:

    • Nome — Atualize o identificador do agente (mesmas restrições da criação: minúsculas, hífens, máximo de 64 caracteres).

    • Prompt do sistema — Revise as instruções do agente (mínimo de 10 caracteres, máximo de 50.000 caracteres).

    • Habilidades — Adicione ou remova habilidades usando o campo de pesquisa.

    • Armazenamentos de memória — Adicione ou remova os armazenamentos de memória que o agente pode acessar usando o campo de pesquisa.

  6. Escolha Salvar.

Os campos que você não modifica mantêm seus valores atuais. As ferramentas atribuídas ao agente e os armazenamentos de memória anexados são preservados, a menos que você os altere.

Para editar um agente personalizado usando o Chat:

Você pode atualizar qualquer campo, incluindo ferramentas e armazenamentos de memória anexados, perguntando ao agente no chat. Por exemplo:

Update weekly-health-report to also check for Lambda function errors.
Add the use_kubectl tool to my cluster-audit-agent.
Change the system prompt of certificate-checker to also report certificates expiring within 30 days.
Attach the payments-runbook memory store to certificate-checker, and remove the directives store.

O Chat recupera a configuração atual do agente, aplica as alterações solicitadas e confirma antes de salvar. Os campos que você não menciona permanecem inalterados.

Visualizando o histórico de invocações

A página de detalhes do agente mostra um histórico completo de todas as invocações de um agente personalizado, incluindo status, origem do gatilho e carimbos de data e hora.

Para visualizar o histórico de invocações:

  1. Navegue até a página Agentes em seu aplicativo web DevOps Agent.

  2. Escolha o agente personalizado que você deseja inspecionar.

  3. Escolha a guia History (Histórico).

A tabela de invocações exibe as seguintes informações:

Coluna Description
Invocação O título ou a descrição da tarefa fornecidos quando o agente foi chamado.
Status Status atual da invocação (veja abaixo).
Acionado por Como a invocação foi iniciada — o nome do acionador para execuções agendadas ou “Manual” para invocações sob demanda.
Iniciou Data e hora em que a invocação começou.
Última atualização Data e hora da alteração de status mais recente.

Você pode filtrar as invocações por status ou pesquisar por título. A tabela é atualizada automaticamente a cada 10 segundos para mostrar os status atualizados das invocações em execução.

Status de invocação:

Status Description
Início pendente A invocação está em fila e aguardando para ser agendada.
Em execução O agente está executando ativamente.
Bem-sucedido A invocação foi concluída com êxito.
Failed A invocação encontrou um erro e foi interrompida.
Tempo expirado A invocação excedeu o limite de tempo limite de 1 hora.
Cancelado A invocação foi cancelada manualmente antes da conclusão.

Visualizando uma trajetória de invocação

A trajetória de invocação mostra o traço completo do trabalho de um agente — cada chamada de ferramenta, resultado e saída de texto que o agente produziu durante uma única invocação.

Para visualizar uma trajetória de invocação:

  1. Na guia Histórico, escolha a invocação que você deseja inspecionar.

  2. Revise o cronograma da trajetória.

O cronograma exibe os seguintes tipos de etapas:

  • Chamadas de ferramentas — Quais ferramentas o agente invocou e com quais parâmetros.

  • Resultados da ferramenta — As respostas retornadas por cada ferramenta.

  • Saídas de texto — Mensagens produzidas pelo agente durante a invocação.

  • Saídas geradas — quaisquer artefatos ou recomendações produzidas pelo agente, mostrados como links no final da linha do tempo.

Para executar invocações, a trajetória é atualizada em tempo real. Você pode cancelar uma invocação em execução escolhendo Cancelar na parte superior da visualização da trajetória.

Excluindo um agente personalizado

Importante

A exclusão de um agente personalizado não afeta as invocações que já estão em andamento. As invocações em execução continuam até que sejam concluídas, atinjam o tempo limite ou sejam canceladas. No entanto, o agente não pode ser invocado novamente após a exclusão.

Você pode excluir um agente personalizado usando o Chat. A exclusão é permanente e não pode ser desfeita.

Para excluir um agente personalizado:

Peça ao Chat que exclua o agente pelo nome. Por exemplo:

Delete the custom agent weekly-health-report.

O Chat confirma o nome e o tipo do agente antes de excluir. Se o agente tiver gatilhos ativos, eles serão removidos junto com o agente.