Tasks

​

What Are Tasks?

Tasks automate agent work. They combine an agent, an action, and triggers to run workflows on a schedule, in response to events, or on demand. Each task execution creates a session so you can observe what happened.

​

Creating a Task

Create tasks through conversation with your default agent, or directly in the UI from the Tasks page.

​

Configuration

Name (required) - Identifier for your task Agent (required) - Which agent performs the work Action (required) - Instructions the agent receives (uses existing action or creates new one) Triggers (optional) - When the task runs (cron schedule, webhooks, or manual only) Variables (optional) - Default values for any variables in the action Enabled (optional) - Whether the task responds to triggers

​

Triggers

​

Cron

Run on a schedule using cron expressions and timezone. Examples:

• 0 9 * * * - Daily at 9 AM
• 0 9 * * MON - Every Monday at 9 AM
• 30 14 * * 1-5 - Weekdays at 2:30 PM

​

Webhooks

Execute when external events occur from Slack, GitHub, or Linear. Slack:

• app_mention - Bot mentioned
• message - Message posted

GitHub:

• pull_request - PR events
• issue_comment - Comments
• issues - Issue events
• push - Code pushed

Linear:

• Issue - Issue events
• Comment - Comments added

Event data is automatically injected into the action’s first message.

​

Manual

Tasks with no triggers run only when you click “Run Now” or when another agent calls execute_task.

​

Variables

Set default values in the task. Override them at runtime for manual executions. Variables use {{variableName}} syntax in action messages. When a task runs, defaults merge with trigger context (webhook data, timestamp, etc).

​

Managing Tasks

Run Now - Execute immediately with optional variable overrides Edit - Modify name, agent, action, triggers, or variables Duplicate - Copy the task (created disabled) View History - See all executions with status, duration, and errors Enable/Disable - Control whether triggers fire Delete - Remove permanently

​

Task Access

All organization members can view and run tasks. Only admins can create, edit, or delete them.

​

Example

Daily weather report posted to Slack: Agent: Weather Reporter with Slack and fetch integrations Action: Fetch weather for {{location}} and post to {{channel}} Trigger: Cron 0 9 * * * at America/New_York Variables: location: "South Bend, IN", channel: "#general" Every morning at 9 AM, the task creates a session where the agent fetches weather and posts to Slack.