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
<a name="custom-agents-managing-custom-agents"></a>

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
<a name="editing-a-custom-agent"></a>

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:**

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

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

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

1. Na caixa de diálogo, escolha **Formulário**.

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

1. 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 name="viewing-invocation-history"></a>

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:**

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

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

1. 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 name="viewing-an-invocation-trajectory"></a>

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.

1. 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
<a name="deleting-a-custom-agent"></a>

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