Automatizar ações com base nos resultados do agente proativo

Você pode usar o Eventarc para monitorar e responder automaticamente à atividade do modo proativo no Gemini Cloud Assist.

Quando um agente conclui uma tarefa em segundo plano, como uma investigação de causa raiz ou uma análise de anomalia de custo, ele publica um evento que pode ser encaminhado para um webhook, um script ou um fluxo de trabalho.

Antes de começar

Criar um gatilho de automação

O Gemini Cloud Assist gera um evento google.cloud.geminicloudassist.task.v1.completed sempre que uma tarefa de investigação ou otimização em segundo plano é concluída.

É possível rotear esses eventos para destinos compatíveis, como o Cloud Run, o Cloud Run functions ou o Workflows, para acionar notificações do Slack, incidentes do PagerDuty ou correções automatizadas.

Por exemplo, para se inscrever nesses eventos e encaminhá-los ao Cloud Run, use o seguinte comando:

gcloud eventarc triggers create TRIGGER_NAME \
    --location=global \
    --destination-run-service=DESTINATION_SERVICE \
    --event-filters="type=google.cloud.geminicloudassist.task.v1.completed" \
    --event-filters="proactive=true" \
    --service-account=SERVICE_ACCOUNT

Substitua:

  • <var>TRIGGER_NAME</var>: um nome exclusivo para o gatilho.
  • <var>DESTINATION_SERVICE</var>: o nome do seu serviço do Cloud Run que vai processar os eventos do agente proativo.
  • <var>SERVICE_ACCOUNT</var>: o endereço de e-mail da conta de serviço do IAM usada para invocar o destino.

Para mais informações sobre como usar esse comando, consulte Criar gatilhos com o Eventarc.

Payload de evento

O payload de um evento entregue está no formato Protobuf, encapsulado em CloudEvents ou JSON. Ele contém os seguintes campos principais:

  • title: um resumo da tarefa, como "Investigação de anomalia de custo" ou "Investigação de alta latência".
  • result_object_reference: um URI que aponta para o artefato criado.

Filtrar agentes específicos

Como o modo proativo usa o mesmo tipo de evento, não é possível isolar agentes específicos usando apenas atributos do Eventarc.

Para rotear eventos para canais específicos, o serviço de destino, como uma função do Cloud, precisa analisar o payload do evento e filtrar com base no campo title:

  • Para monitorar alertas de custo, filtre os títulos que contêm "Anomalia de custo" ou "Otimização de custos".
  • Para monitorar a solução de problemas, filtre os títulos que contêm "Investigation of".

A seguir