Run an agent with Bolt

Bolt is the main way to run a DinoAI agent on a schedule. Add a Run Paradime DinoAI Agent command to a Bolt schedule and the agent runs on your cron, after another schedule completes, on a pull request merge, or as part of a Turbo CI run.

Prerequisites

An agent you can run, built in the Agent UI or defined as code under .dinoai/agents/<name>.yml.
A Bolt schedule you can edit.
API credentials with DinoAI Agent capabilities set as Bolt schedule environment variables: PARADIME_API_ENDPOINT, PARADIME_API_SECRET (an account API key, prdm_cmp_...), and PARADIME_WORKSPACE_UID.

Estimated time: 10 minutes.

Steps

Add the Run DinoAI Agent command

In the Bolt schedule editor, select Add command, then Run Paradime DinoAI Agent.

Agent name: pick the agent (the list comes from .dinoai/agents/*.yml on the schedule’s git branch).
Task: describe what you want the agent to do. This becomes the agent’s opening message.
Select Save command.

Set the trigger and deploy

Configure the trigger (cron, on merge, on run completion, or Turbo CI), then deploy the schedule.

The schedule runs and the agent’s messages stream into the Bolt command’s logs. The Bolt run inherits the agent’s outcome: it passes when the agent completes and fails when the agent fails. Each Bolt run starts a fresh agent session, so there’s no continuity between runs.

Define it as code

The UI writes a paradime dinoai command into the schedule. If you manage schedules as code, add it directly:

schedules:
  - name: nightly data quality
    slug: nightly-data-quality-f6g7h8
    owner_email: data-team@acme.io
    environment: production
    git_branch: main
    commands:
      - paradime dinoai --agent=data-quality-checker --message="Audit all staging models for missing tests and post a summary to #data-quality-alerts"
    schedule: "0 2 * * *"
    timezone: UTC

Trigger from the API (optional)

When you orchestrate the run yourself (Airflow, Lambda, a webhook), trigger the agent through the API with triggerDinoaiAgentRun instead. Use the API when you need multi-turn continuity, which a Bolt run does not provide.

API and SDK reference

Trigger, poll, and message agents programmatically.

Next steps

Triggering from Bolt reference

Every field of the Run DinoAI Agent command.

Browse templates

Start from a proven agent recipe.

Foundations

Automate with AI agents

Set up & configure

Orchestrate data pipelines

Migrate to Paradime

Develop in Paradime

Learn dbt™

Run an agent with Bolt

Steps

Define it as code

Trigger from the API (optional)

API and SDK reference

Next steps

Triggering from Bolt reference

Browse templates

​Steps

​Define it as code

​Trigger from the API (optional)

API and SDK reference

​Next steps

Triggering from Bolt reference

Browse templates

Steps

Define it as code

Trigger from the API (optional)

Next steps