Skip to main content
Triggers and ingress start Agent Graph runs from outside the canvas. What you configure depends on graph type: Conversational graphs use channels and Chat API; Autonomous graphs use API webhooks, background tasks, and cron.

Trigger APIs

Autonomous — API, background task, and cron modes.

API usage examples

cURL, Python, JavaScript, and more.

Event triggers

Schedules and email-driven runs.

Mapping

Assign triggers to Agent Builds per environment.

​
Trigger types

​
Conversational ingress

Use when a user talks to the agent through a connected surface: These paths do not use Autonomous trigger execution modes (single endpoint / background task / cron).

​
Autonomous triggers

Use when an external system or schedule starts a graph without a user in chat:

​
How a run starts

​
Configure and deploy (Autonomous)

  1. Design an Autonomous Agent Graph in Graph Studio.
  2. Save and Build (Builds).
  3. Assign the build to DEV / UAT / PROD.
  4. Create the trigger under Integrations → Triggers (Configure integrations).
  5. Deploy in Graph Studio → Deploy as API or Cron job (Deploy a trigger).
  6. Test with API usage examples; monitor in Observability.
Workspace Integrations Triggers tab

Integrations — Triggers tab

Design Autonomous graphs to be idempotent — webhooks may retry. Map payload fields to variables for auditability in logs.