Prerequisites
- A programmable agent, either defined under
.dinoai/agents/<name>.ymlin your repository or built in the app from the Agents page (see Creating Agents in the App).
No API keys required. The command runs natively inside your workspace, so there are no credentials to set on the schedule. Existing schedules that still set
PARADIME_API_ENDPOINT, PARADIME_API_SECRET, or PARADIME_WORKSPACE_UID as environment variables keep working unchanged, and you can remove those variables.Usage
Add the Run DinoAI Background Agent command to your schedule, then:- Select the Agent name from the dropdown. The list includes agents from the YAML files in
.dinoai/agents/on the configured branch as well as agents built in the app. - Describe the Task you want the agent to complete (for example, “investigate why the run failed and propose a fix”). Be specific and reference concrete inputs like table names or time windows.
- Click Add command.
What happens on a run
- Bolt dispatches the agent run natively and waits for it: the command blocks until the agent reaches a terminal state, and the Bolt run inherits the agent’s success or failure.
- The agent’s messages stream into the command log, so you can follow progress live in the Bolt run logs.
- The session also appears in the DinoAI Agent sessions panel under the Bolt source, so scheduled runs are easy to tell apart from API or Slack sessions.
Each run starts a fresh agent session with the configured task as its first message. It does not resume previous sessions.
Learn more
- Programmable Agents overview
- Creating Agents in the App for building an agent without writing YAML
- Triggering from Bolt for the full lifecycle, including schedules-as-code
- YAML configuration for authoring an agent under
.dinoai/agents/ - Tools reference for the tools an agent can use