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

# Executando agentes personalizados
<a name="custom-agents-executing-custom-agents"></a>

Você pode executar um agente personalizado sob demanda ou configurar gatilhos para executá-lo automaticamente.

## Executando um agente personalizado sob demanda
<a name="running-a-custom-agent-on-demand"></a>

Você pode executar um agente personalizado imediatamente na página de detalhes do agente ou pelo Chat.

**Para executar um agente personalizado na página de detalhes:**

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

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

1. Escolha **Executar agora** para executar o agente com suas instruções configuradas.

**Para fornecer contexto adicional para uma execução específica, escolha a seta suspensa ao lado de **Executar agora**, insira um prompt descrevendo em que o agente deve se concentrar nessa invocação e escolha Executar com aviso.** O prompt é passado para o agente como contexto adicional junto com o prompt do sistema.

Após o início da execução, a nova invocação aparece na guia **Histórico** com o status “Início pendente”. Escolha a invocação para ver sua trajetória em tempo real.

**Para executar um agente personalizado usando o Chat:**

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

```
Run my weekly-investigation-report agent.
```

```
Run certificate-checker and focus on certificates expiring in the next 7 days.
```

Quando você fornece contexto adicional na mensagem de bate-papo, o Chat a transmite como o prompt para essa execução. Se você não fornecer contexto adicional, o agente será executado somente com o prompt do sistema configurado.

Um agente personalizado só pode executar uma invocação por vez. Se o agente já estiver em execução, você deverá aguardar a conclusão da invocação atual, expirar ou ser cancelada antes de iniciar outra.

## Agendamento de agentes personalizados
<a name="scheduling-custom-agents"></a>

Os gatilhos permitem que você execute um agente personalizado automaticamente com base em condições definidas. AWS DevOps Atualmente, o agente oferece suporte a acionadores baseados em agendamento, que executam o agente em intervalos recorrentes usando expressões cron ou rate. EventBridge-compatible 

**Para criar um gatilho de agendamento:**

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

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

1. Selecione a guia **Triggers**.

1. Escolha o botão **\+** (criar).

1. Na caixa de diálogo, insira uma expressão de agendamento no campo de entrada. A expressão deve ter um dos seguintes formatos:
   + **Expressão de taxa** — é executada em um intervalo fixo. Formato: `rate(value unit)`. Exemplos:
     + `rate(1 hour)`— A cada hora
     + `rate(30 minutes)`— A cada 30 minutos
     + `rate(7 days)`— A cada 7 dias
   + **Expressão Cron** — É executada em uma programação específica. Formato: `cron(minutes hours day-of-month month day-of-week year)`. Exemplos:
     + `cron(0 9 ? * MON-FRI *)`— Todos os dias da semana às 9:00 UTC
     + `cron(0 0 1 * ? *)`— Primeiro dia de cada mês à meia-noite UTC
     + `cron(0 */6 ? * * *)`— A cada 6 horas

Uma mensagem de confirmação verde aparece quando a expressão é válida.

1. Escolha **Criar**.

Para expressões cron, exatamente um dia do mês ou dia da semana deve ser (ponto de interrogação). `?` Para obter mais informações sobre a sintaxe da expressão de agendamento, consulte [Tipos de EventBridge ](https://docs.aws.amazon.com/scheduler/latest/UserGuide/schedule-types.html) *agendamento no Guia do usuário do Amazon Scheduler*.

Após a criação, o gatilho aparece na lista mostrando sua expressão, data de criação e próximo horário de execução programado.

## Gerenciando gatilhos
<a name="managing-triggers"></a>

A guia **Acionadores** exibe todos os acionadores configurados para o agente personalizado. Para cada acionador, você pode ver a expressão do cronograma, quando ela foi criada e quando será executada da próxima vez.

**Pausando um gatilho:**

Para impedir temporariamente que um gatilho invoque o agente sem excluí-lo, desative a chave seletora ao lado do gatilho. O status do gatilho muda para “Pausado” e não é mais acionado até ser reativado. Ative o botão novamente para retomar a programação.

**Excluindo um gatilho:**

Para remover permanentemente um gatilho, escolha o ícone de exclusão (lixeira) ao lado do gatilho que você deseja remover. Confirme a exclusão na caixa de diálogo exibida. Os gatilhos excluídos não podem ser recuperados.

## Cancelando uma invocação
<a name="canceling-an-invocation"></a>

Você pode cancelar uma invocação em execução na visualização da trajetória de invocação ou por meio do Chat.

**Para cancelar uma invocação em execução na visualização da trajetória:**

1. Na guia **Histórico**, escolha a invocação em execução.

1. Escolha **Cancelar** na parte superior da visualização da trajetória.

**Para cancelar uma invocação em execução usando o Chat:**

```
Cancel the running invocation of weekly-health-report.
```

O status da invocação muda para “Cancelado”. Qualquer trabalho concluído antes do cancelamento é preservado na trajetória. As chamadas de ferramentas que estavam em andamento quando o cancelamento ocorreu ainda podem ser concluídas.

## Resultados da chamada da ferramenta
<a name="tool-call-results"></a>

Durante a invocação, o agente personalizado invoca as ferramentas MCP para coletar dados, realizar ações e produzir resultados. Cada chamada de ferramenta e seu resultado são registrados na trajetória de invocação.

Os resultados da chamada de ferramenta fornecem transparência sobre o que o agente fez durante a invocação:
+ **Chamadas de ferramentas bem-sucedidas** — A ferramenta retornou dados que o agente usa para continuar seu trabalho. Por exemplo, `query_cloudwatch_logs` retorna entradas de registro ou `use_aws` retorna respostas da API.
+ **Chamadas de ferramentas com falha** — A ferramenta retornou um erro. O agente pode tentar novamente, tentar uma abordagem alternativa ou relatar a falha em sua saída.

Você pode inspecionar chamadas de ferramentas individuais e seus resultados na trajetória de invocação para entender o comportamento do agente, verificar se ele acessou os recursos corretos e solucionar resultados inesperados. Para obter mais informações sobre a visualização de trajetórias, consulte [Visualização de uma trajetória de invocação](custom-agents-managing-custom-agents.md).