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ções 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 pelo Chat. O formulário permite que você atualize o nome, o prompt do sistema e as habilidades. Para modificar as ferramentas do agente, use o Chat.
Para editar um agente personalizado usando o formulário:
Navegue até a página Agentes em seu aplicativo web DevOps Agent.
Escolha o agente personalizado que você deseja editar.
Na página de detalhes do agente, escolha Editar.
Na caixa de diálogo, escolha Formulário.
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).
Aviso do sistema — revise as instruções do agente (mínimo 10 caracteres, máximo 50.000 caracteres).
Habilidades — Adicione ou remova habilidades usando o campo de pesquisa.
Escolha Salvar.
Os campos que você não modifica mantêm seus valores atuais. As ferramentas atribuídas ao agente são preservadas durante a edição por meio do formulário.
Para editar um agente personalizado usando o Chat:
Você pode atualizar qualquer campo, incluindo ferramentas, perguntando ao 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.
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 acionador e registros de data e hora.
Para ver o histórico de invocações:
Navegue até a página Agentes em seu aplicativo web DevOps Agent.
Escolha o agente personalizado que você deseja inspecionar.
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 programadas 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á na fila e aguardando para ser agendada. |
| Em execução | O agente está executando ativamente. |
| Bem-sucedido | A invocação foi concluída com sucesso. |
| 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:
Na guia Histórico, escolha a invocação que você deseja inspecionar.
Revise o cronograma da trajetória.
A linha do tempo 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 que o agente produziu durante a invocação.
Saídas geradas — quaisquer artefatos ou recomendações que o agente produziu, 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é serem concluídas, expirarem ou serem canceladas. No entanto, o agente não pode ser chamado 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.
