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
Você pode executar um agente personalizado sob demanda ou configurar gatilhos para executá-lo automaticamente.
Executando um agente personalizado sob demanda
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:
Navegue até a página Agentes em seu aplicativo web DevOps Agent.
Escolha o agente personalizado que você deseja executar.
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
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:
Navegue até a página Agentes em seu aplicativo web DevOps Agent.
Escolha o agente personalizado que você deseja agendar.
Selecione a guia Triggers.
Escolha o botão + (criar).
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 horarate(30 minutes)— A cada 30 minutosrate(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 UTCcron(0 0 1 * ? *)— Primeiro dia de cada mês à meia-noite UTCcron(0 */6 ? * * *)— A cada 6 horas
Uma mensagem de confirmação verde aparece quando a expressão é válida.
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 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 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
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:
Na guia Histórico, escolha a invocação em execução.
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
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_logsretorna entradas de registro ouuse_awsretorna 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.
