> ## Documentation Index
> Fetch the complete documentation index at: https://docs.celeria.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tasks

> Set up autonomous agentic workflows

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