Skip to main content

​
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.