Skip to main content

Building Workflows

Workflows are created and edited in the Console's workflow builder. You can also write them as JSON and import them directly.

Creating a Workflow in the Console​

  1. Open the Console
  2. Click Workflows in the left nav
  3. Click New Workflow
  4. Give it a name and optional description
  5. Add steps using the step editor

Each step requires:

  • A step ID — unique within the workflow, used for output references
  • A tool — any node from the tool graph dropdown
  • Parameters — the tool's input fields

Step Editor​

The step editor shows:

  • Tool selector (searchable dropdown of all available tool graph nodes)
  • Parameter fields (rendered from the tool's input schema)
  • Output preview (shows what the step will produce, based on tool schema)
  • Dependency graph (visual indicator of what this step depends on)

Workflow JSON Structure​

You can also write workflows as JSON and paste them into the Console's JSON editor (click the </> button in the builder).

Full structure:​

{
  "id": "my_workflow",
  "name": "My Workflow",
  "description": "Optional description shown in the Console.",
  "steps": [
    {
      "id": "step1",
      "name": "Search the web",
      "tool": "web_search",
      "params": {
        "query": "AI safety",
        "limit": 5
      }
    },
    {
      "id": "step2",
      "name": "Summarize results",
      "tool": "agent_call",
      "params": {
        "agent_id": "aria",
        "prompt": "Summarize the search results"
      },
      "depends_on": ["step1"]
    },
    {
      "id": "step3",
      "name": "Send email",
      "tool": "email_send",
      "params": {
        "to": "you@example.com",
        "subject": "Summary",
        "body": "See attached summary"
      },
      "depends_on": ["step2"]
    }
  ]
}

Conditional Steps​

Use condition to skip a step based on a previous output:

{
  "id": "send_if_results",
  "tool": "email_send",
  "condition": "search.output.total > 0",
  "params": {
    "to": "you@example.com",
    "subject": "Results found",
    "body": "Results are available"
  }
}

Saving and Versioning​

Workflows are auto-saved in the Console. Each save creates a new version. You can view version history and revert from the workflow's History tab.

Go Deeper​

→ Running Workflows

Manual run, SSE streaming, run logs.

→ Scheduled Jobs

Schedule your workflow with a cron expression.

→ Built-in Tools

All available tool graph nodes.