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 por meio do 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 prompt. 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 administrar um agente personalizado usando o Chat:
Peça ao Chat que administre 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 passa como a solicitação 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á esperar que a invocação atual seja concluída, atinja o tempo limite ou seja cancelada antes de iniciar outra.
Configurar gatilhos do
Os gatilhos executam um agente personalizado automaticamente com base nas condições definidas. AWS DevOps O agente oferece suporte a dois tipos de gatilhos:
Agendar gatilhos — Execute o agente em intervalos recorrentes usando expressões EventBridge-compatible cron ou rate.
Acionadores de eventos — Execute o agente quando um evento de webhook chegar de uma integração conectada, passando a carga útil do evento como contexto.
Os dois tipos de gatilho são criados na guia Acionadores do agente personalizado. Para abri-lo, navegue até a página Agentes no seu aplicativo web DevOps Agent, escolha o agente personalizado e, em seguida, escolha a guia Acionadores.
Criando um gatilho de agendamento
As expressões de agendamento usam a sintaxe EventBridge-compatible cron ou rate. 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
Para expressões cron, exatamente um dia do mês ou do 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.
Para criar um gatilho de agendamento:
Escolha o botão + (criar).
Em Tipo de acionador, escolha Programar.
Insira uma expressão de agendamento. Uma mensagem de confirmação verde aparece quando a expressão é válida.
(Opcional) Para fornecer contexto adicional para cada execução agendada, insira uma solicitação no campo Solicitação do usuário (opcional). O prompt é passado para o agente junto com o prompt do sistema.
Escolha Criar.
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.
Criação de um gatilho de evento
Um acionador de evento executa o agente personalizado quando um evento de webhook chega de uma integração conectada. A carga útil do evento é passada para o agente como contexto para essa execução.
Pré-requisitos:
Antes de criar um acionador de evento, você deve ter uma integração conectada com um webhook ativo no espaço do seu agente. Qualquer integração com um webhook ativo pode servir como fonte de eventos. Para obter mais informações sobre a configuração de integrações, consulte Invocando o DevOps agente por meio do Webhook.
Para criar um acionador de evento:
Escolha o botão + (criar).
Em Tipo de acionador, escolha Evento.
Em Origem do evento, escolha a integração cujos eventos de webhook devem executar o agente. Somente integrações com um webhook ativo são listadas.
(Opcional) Em Expressão de filtro, insira uma expressão JMESPath para filtrar e, opcionalmente, transformar a carga útil do evento.
Escolha Criar.
Se nenhuma fonte de eventos estiver listada, não existe integração habilitada para webhook no espaço do agente ou sua função está sem as permissões e. ListAssociations ListWebhooks
Expressões de filtro:
Opcionalmente, você pode especificar uma expressão de filtro JMESpath para controlar quais eventos iniciam o agente e qual contexto o agente recebe. As expressões de filtro são avaliadas em relação à raiz da carga útil do evento bruto.
Sintaxe — especificação JMESpath
Tamanho máximo — 4.096 caracteres
Validação — Expressões inválidas são rejeitadas quando você cria o gatilho
A expressão do filtro atua como uma condição e, opcionalmente, como uma projeção:
Quando o resultado não
nullé uma string vazia, uma matriz vazia ou um objeto vazio, o gatilho é executado.falseQuando o resultado é o booleano
true(por exemplo, um predicado comoseverity == 'critical'), o agente recebe a carga útil bruta do evento como contexto.Quando o resultado é qualquer outro valor verdadeiro (por exemplo, uma projeção semelhante
{sev: severity}), o agente recebe o resultado projetado como contexto.
AWS DevOps O agente trunca esse contexto em 10.000 caracteres.
Se você deixar a expressão do filtro vazia, o agente será executado em todos os eventos dessa fonte e receberá a carga útil bruta do evento como contexto.
nota
Uma projeção avaliada como um objeto vazio ou uma matriz vazia conta como incompatível e o agente não é executado. Para passar um valor possivelmente vazio, envolva-o em um objeto literal. Por exemplo, .{payload: details}
Exemplos de expressões de filtro:
severity == 'critical'— Predicado: executa o agente somente quando a gravidade é igual à crítica, passando a carga útil bruta do evento como contexto.{sev: severity}— Projeção: executa o agente em cada evento, passando um objeto contendo somente o campo de severidade como contexto. Como um hash de seleção múltipla sempre inclui suas chaves, o resultado nunca fica vazio e não é filtrado.
Como o formato da carga é diferente para cada fonte, os campos disponíveis dependem da integração. Quando um evento chega, mas um gatilho não é executado, o AWS DevOps Agente emite um aviso descrevendo o motivo. Por exemplo, o aviso pode indicar que a expressão do filtro não correspondeu a nada. O aviso também lista os campos de nível superior presentes nessa carga. Para obter mais informações, consulte Registros e métricas vendidas.
Criação de gatilhos programaticamente
Você também pode criar gatilhos programaticamente usando os SDKs. AWS Ligue para a CreateTrigger operação do devops-agent cliente, que requer a aidevops:CreateTrigger permissão. Defina o tipo de gatilho como TIME_BASED e forneça uma condição de agendamento contendo a expressão de agendamento e a solicitação opcional do usuário.
Como alternativa, você pode modelar gatilhos baseados em agendamento como recursos em. AWS::DevOpsAgent::Trigger AWS CloudFormation Um gatilho faz referência ao agente personalizado que ele executa, então crie o agente primeiro. Para obter mais informações sobre o tipo de AWS::DevOpsAgent::Trigger recurso, consulteGerenciar ativos.
Gerenciando gatilhos
A guia Acionadores exibe todos os gatilhos configurados para o agente personalizado. Um acionador de agendamento mostra sua expressão de agendamento. Um acionador de evento mostra sua fonte de evento e, se definido, sua expressão de filtro. Ambos os tipos mostram a data de criação.
Se a integração de origem ou seu webhook for removido, um acionador de evento permanecerá listado, mas mostrará que a fonte não está mais disponível e não está sendo executada.
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 executado até ser reativado. Ligue o botão novamente para continuar.
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 a partir da 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 de 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 da 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.Falha nas chamadas de ferramentas — 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 problemas com resultados inesperados. Para obter mais informações sobre a visualização de trajetórias, consulte Visualizando uma trajetória de invocação.
