Gatilhos

Gatilhos definem como os fluxos de trabalho começam no ADK Studio. Cada fluxo de trabalho começa com um nó Trigger que determina o ponto de entrada — seja a partir de entrada do usuário, um webhook HTTP, um agendamento cron, ou um evento externo.

Tipos de Gatilho

Gatilhos Manuais

O tipo de gatilho padrão. Quando um fluxo de trabalho tem um gatilho manual, a entrada do chat é exibida com um rótulo e um espaço reservado configuráveis.

Configuração:

O rótulo de entrada aparece acima do campo de entrada do chat, e o prompt padrão é usado como texto de espaço reservado.

---

Gatilhos de Webhook

Exponha um HTTP endpoint que inicia o fluxo de trabalho quando chamado. Útil para integrar com serviços externos, pipelines de CI/CD ou outras aplicações.

Configuração:

Pontos de Extremidade

Cada gatilho de webhook cria dois pontos de extremidade:

Webhooks GET também funcionam:

GET /api/projects/:id/webhook/my-path?message=Hello

Autenticação

Token Bearer:

curl -X POST "http://localhost:3000/api/projects/{id}/webhook/my-path" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "Process this"}'

Chave API:

curl -X POST "http://localhost:3000/api/projects/{id}/webhook/my-path" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Process this"}'

Notificações de Eventos de Webhook

Assine eventos de execução de webhook em tempo real via SSE:

GET /api/projects/:id/webhook-events

Este fluxo emite eventos à medida que os webhooks são recebidos e processados.

---

Gatilhos de Agendamento

Execute fluxos de trabalho em um agendamento recorrente usando expressões cron.

Configuração:

Sintaxe Cron

Expressões cron padrão de 5 campos:

┌───────────── minute (0-59)
│ ┌───────────── hour (0-23)
│ │ ┌───────────── day of month (1-31)
│ │ │ ┌───────────── month (1-12)
│ │ │ │ ┌───────────── day of week (0-6, Sun=0)
│ │ │ │ │
* * * * *

Exemplos:

O serviço de agendamento rastreia last_executed carimbos de data/hora para evitar execuções duplicadas.

---

Gatilhos de Eventos

Inicie fluxos de trabalho em resposta a eventos de sistemas externos. Os eventos são correspondidos por source e eventType, com filtragem JSONPath opcional nos dados do evento.

Configuração:

Enviando Eventos

curl -X POST "http://localhost:3000/api/projects/{id}/events" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "payment-service",
    "eventType": "payment.completed",
    "data": {
      "orderId": "12345",
      "amount": 99.00,
      "status": "active"
    }
  }'

Filtros JSONPath

Filtre eventos para que o fluxo de trabalho seja acionado apenas quando condições específicas forem atendidas:

Eventos que não correspondem ao filtro são silenciosamente ignorados.

---

Botão de Execução Sensível ao Gatilho

A interface do usuário do Studio se adapta com base no tipo de gatilho ativo:

• Manual — Entrada de chat padrão com o rótulo e o espaço reservado configurados
• Webhook — O botão de execução envia uma carga útil de webhook simulada
• Schedule — O botão de execução envia o prompt padrão configurado
• Event — O botão de execução envia uma carga útil de evento simulada

Quando um fluxo de trabalho foi alterado desde a última compilação, o botão Enviar se transforma em um botão de Compilação para solicitar a recompilação.

---

API Referência

Anterior: ← Nós de Ação | Próximo: Diretrizes de Desenvolvimento →