Skip to content

Create a Flow

Creating a new flow

  1. Go to Console → Flows
  2. Click New Flow
  3. Give the flow a name (e.g., “GitHub Issue Triage”)
  4. Select your Trigger — see Triggers & Events →
  5. Select the Agent to run when triggered
  6. Write the Agent Prompt — see below
  7. Click Save then Enable

Writing the agent prompt

The agent prompt is the message passed to the agent when the flow fires. Use template variables to inject data from the trigger event.

Example — GitHub webhook trigger:

A new GitHub issue has been created. Please triage it.
Issue title: {{event.title}}
Issue body: {{event.body}}
Issue URL: {{event.url}}
Author: {{event.author}}
Please:
1. Classify the issue type (bug / feature request / question / other)
2. Assess severity (P1 / P2 / P3)
3. Apply the appropriate labels on GitHub
4. Post a brief acknowledgment comment on the issue

Template variables

Event variables (all trigger types)

VariableDescription
{{event.title}}Title of the event
{{event.body}}Body/content of the event
{{event.url}}URL associated with the event
{{event.author}}Who triggered the event
{{event.timestamp}}When the event occurred (ISO 8601)
{{event.raw}}Full raw payload as JSON

Date variables (scheduled flows)

VariableDescription
{{date.today}}Today’s date (YYYY-MM-DD)
{{date.yesterday}}Yesterday’s date
{{date.week_start}}Monday of the current week

Testing a flow


Flow run history

Each triggered run appears in Flows → [flow name] → Run History:

  • Input event that triggered the run
  • Agent output
  • Tool calls made
  • Credits consumed
  • Success or error status