Disparadores

Los disparadores definen cómo los flujos de trabajo se inician en ADK Studio. Cada flujo de trabajo comienza con un nodo disparador que determina el punto de entrada — ya sea desde la entrada del usuario, un webhook HTTP, una programación cron, o un evento externo.

Tipos de Disparadores

---

Disparadores Manuales

El tipo de disparador predeterminado. Cuando un flujo de trabajo tiene un disparador manual, la entrada del chat se muestra con una etiqueta y un marcador de posición configurables.

Configuración:

La etiqueta de entrada aparece encima del campo de entrada del chat, y el mensaje predeterminado se utiliza como texto de marcador de posición.

---

Disparadores Webhook

Expone un punto de conexión HTTP que inicia el flujo de trabajo cuando se llama. Útil para integrarse con servicios externos, pipelines de CI/CD u otras aplicaciones.

Configuración:

Puntos de Conexión

Cada disparador webhook crea dos puntos de conexión:

Los webhooks GET también funcionan:

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

Autenticación

Token de portador:

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"}'

Clave de 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"}'

Notificaciones de eventos de Webhook

Suscríbase a eventos de ejecución de webhook en tiempo real a través de SSE:

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

Esta secuencia emite eventos a medida que los webhooks son recibidos y procesados.

---

Activadores de Programación

Ejecute flujos de trabajo en un horario recurrente usando expresiones cron.

Configuración:

Sintaxis Cron

Expresiones cron estándar de 5 campos:

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

Ejemplos:

El servicio de programación rastrea las marcas de tiempo last_executed para evitar ejecuciones duplicadas.

---

Activadores de Eventos

Iniciar flujos de trabajo en respuesta a eventos de sistemas externos. Los eventos se emparejan por source y eventType, con filtrado opcional de JSONPath en los datos del evento.

Configuración:

Envío de 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 de JSONPath

Filtre los eventos para que el flujo de trabajo solo se active cuando se cumplan condiciones específicas:

Los eventos que no coinciden con el filtro se ignoran silenciosamente.

---

Botón de Ejecución Consciente del Disparador

La interfaz de usuario de Studio se adapta según el tipo de disparador activo:

• Manual — Entrada de chat estándar con la etiqueta y el marcador de posición configurados
• Webhook — El botón de ejecución envía una carga útil de webhook simulada
• Programado — El botón de ejecución envía el mensaje predeterminado configurado
• Evento — El botón de ejecución envía una carga útil de evento simulada

Cuando un flujo de trabajo ha cambiado desde la última compilación, el botón de Enviar se transforma en un botón de Compilar para solicitar la recompilación.

---

Referencia de la API

---

Anterior: ← Nodos de Acción | Siguiente: Pautas de Desarrollo →