Overview

Jobs (also called workflows or sigma-jobs) are multi-step automated tasks that Sigma Domain can execute on your behalf. They allow you to chain together multiple actions, import APIs, process data, and build complex automations.

What is a Job?

A job is a sequence of planned steps that the AI creates and executes:

1. The AI analyzes your request
2. It creates a step-by-step plan
3. Each step is executed in order
4. Results from earlier steps feed into later steps
5. You get a final result when all steps complete

Creating a Job

Method 1: Natural Language Request

Type a request that implies multiple steps:

• "Import the Stripe API and list my recent payments"
• "Crawl this website and extract all the product names"
• "Set up email notifications for new Trello cards"

The AI will detect that your request needs a job and offer to create one.

Method 2: Explicit Job Creation

Say explicitly:

• "Create a job to [description]"
• "Start a workflow for [task]"

Method 3: Auto-Detection

When you ask something that requires:

• API imports
• Multiple tool executions in sequence
• Data processing across services
• Long-running operations

The system may automatically suggest creating a job.

Job Lifecycle

1. Planning Phase

• The AI creates a list of steps
• Each step has a description and expected outcome
• You can review the plan before execution starts

2. Execution Phase

• Steps execute one at a time (or in parallel when safe)
• Progress updates appear in the chat
• Each step shows its status: pending, running, completed, or failed

3. Completion

• A summary of all results is presented
• Any created artifacts (files, data) are accessible
• The job is marked as completed

Viewing Job Progress

In the Chat

• Progress updates stream into the conversation
• Each step shows a status indicator
• Error messages appear inline if a step fails

Job Artifact

• Active jobs appear as an interactive artifact in the chat
• The artifact shows:
  • Current step and progress
  • Completed steps with results
  • Any errors or warnings
  • Support Q&A section for asking questions about the job

Managing Jobs

Pause or Cancel

• To cancel a running job: "Cancel the current job"
• Jobs may also time out if they run too long

Retry Failed Steps

• If a step fails, the system may retry automatically (up to 3 attempts)
• You can also ask: "Retry the failed step"

View Past Jobs

• Ask: "Show my recent jobs"
• Job history is stored and can be reviewed

Job Support Drawer

Active jobs have a built-in support section:

1. Scroll to the job artifact in the chat
2. Look for the support/help section at the bottom
3. Ask questions about the job or its tools
4. Answers appear in the support drawer (not as chat messages)

This is useful for asking "What does this tool do?" or "How do I configure authentication?" while a job is running.

Common Job Types

API Import Jobs

• Import and configure a new API integration
• Crawl API documentation, create functions, set up auth

Data Processing Jobs

• Extract data from one service, transform it, load into another
• Process CSV/JSON files
• Aggregate data from multiple sources

Monitoring Jobs

• Set up recurring checks (stock prices, website status)
• Send notifications when conditions are met

Content Jobs

• Generate reports from multiple data sources
• Create documents combining data from various tools

Troubleshooting

Job Stuck or Not Progressing

• Check if a step is waiting for your input
• The AI may need additional parameters or authentication
• Try asking "What's the status of my job?"

Step Fails Repeatedly

• Check the error message for the specific issue
• Common causes: missing auth, incorrect parameters, API rate limits
• The system retries up to 3 times with a 60-second cooldown

Job Creates Wrong Plan

• Cancel the job and rephrase your request with more detail
• Be specific about which services and actions you want
• Mention any constraints or preferences upfront