Déclencheurs

Les déclencheurs définissent comment les workflows démarrent dans ADK Studio. Chaque workflow commence par un nœud de déclencheur qui détermine le point d'entrée — que ce soit à partir d'une entrée utilisateur, d'un webhook HTTP, d'une planification cron ou d'un événement externe.

Types de déclencheurs

---

Déclencheurs manuels

Le type de déclencheur par défaut. Lorsqu'un workflow a un déclencheur manuel, l'entrée du chat est affichée avec une étiquette et un espace réservé configurables.

Configuration :

L'étiquette d'entrée apparaît au-dessus du champ d'entrée du chat, et l'invite par défaut est utilisée comme texte de l'espace réservé.

---

Déclencheurs Webhook

Expose un point de terminaison HTTP qui démarre le workflow lorsqu'il est appelé. Utile pour l'intégration avec des services externes, des pipelines CI/CD ou d'autres applications.

Configuration :

Points de terminaison

Chaque déclencheur webhook crée deux points de terminaison :

Les webhooks GET fonctionnent également :

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

Authentification

Jeton d'authentification (Bearer token) :

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

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

Notifications d'événements de webhook

Abonnez-vous aux événements d'exécution de webhook en temps réel via SSE :

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

Ce flux émet des événements au fur et à mesure que les webhooks sont reçus et traités.

---

Déclencheurs de planification

Exécutez des flux de travail selon un calendrier récurrent à l'aide d'expressions cron.

Configuration :

Syntaxe Cron

Expressions cron standard à 5 champs :

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

Exemples :

Le service de planification suit les horodatages last_executed pour éviter les exécutions en double.

---

Déclencheurs d'événements

Démarrez des flux de travail en réponse à des événements de systèmes externes. Les événements sont mis en correspondance par source et eventType, avec un filtrage JSONPath facultatif sur les données d'événement.

Configuration :

Envoi d'événements

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

Filtres JSONPath

Filtrez les événements afin que le workflow ne se déclenche que lorsque des conditions spécifiques sont remplies :

Les événements qui ne correspondent pas au filtre sont ignorés silencieusement.

---

Bouton d'exécution sensible au déclencheur

L'interface utilisateur de Studio s'adapte en fonction du type de déclencheur actif :

• Manuel — Saisie de chat standard avec le libellé et l'espace réservé configurés
• Webhook — Le bouton d'exécution envoie une charge utile de webhook simulée
• Planification — Le bouton d'exécution envoie l'invite par défaut configurée
• Événement — Le bouton d'exécution envoie une charge utile d'événement simulée

Lorsqu'un workflow a été modifié depuis la dernière compilation, le bouton d'envoi se transforme en bouton de compilation pour déclencher la recompilation.

---

Référence API

---

Précédent: ← Nœuds d'action | Suivant: Lignes directrices de développement →