Workers

Workers are AI agents that run automated tasks in your workspace. Unlike Chat assistants which operate in a request-response mode, Workers run continuously or on triggers, maintaining their own context and executing pre-defined instructions.

What are Workers?

Think of Workers as AI agents you can assign specific jobs to. Each Worker:

  • Has a clear set of instructions (system prompt).
  • Can access workspace resources (files, compute, notes).
  • Runs on triggers, schedules, or manual execution.
  • Maintains its own isolated context.
  • Can be used as reusable templates for common tasks.

Getting Started

To create your first Worker:

  1. Click "+ New Worker" in the Workers tab.
  2. Define its purpose with a system prompt.
  3. Choose how to run your worker:
    • Run manually whenever needed.
    • Enable email/webhook endpoints for external integration.
    • Configure schedule to run automatically at a given schedule.
  4. Let it run automatically or execute on-demand.

See the Email Workers Tutorial or Scheduling Workers Tutorial for step-by-step examples.

Workers vs Chat Assistants

While both Workers and Chat assistants can access workspace resources, they serve different purposes:

Workers Chat Assistants
Run automatically or on-demand Respond to user requests
Execute specific tasks Handle varied inquiries
Trigger-based or manual activation User-initiated interaction
Maintain task-specific context Keep conversation history
Can be saved as reusable templates Interactive dialogue

Key Capabilities

Workers can:

  • Process incoming data.
  • Monitor external sources.
  • Run computations.
  • Update documentation.
  • Generate reports.
  • Send notifications.
  • Maintain databases.
  • Serve as templates for repeated tasks.

Triggers

Workers can be activated by:

  • Schedules (every hour, daily, etc.).
  • Manual execution (run anytime with saved prompt).
  • External sources:
    • Email: Each worker has a dedicated email address that can be enabled.
    • Webhooks: Custom HTTPS endpoint for receiving data.
  • Other Workers (sequencing coming soon).

External Integration

Workers can receive data from:

  • Email: Enable a dedicated email address for your worker.
  • Webhooks: Enable an HTTPS endpoint compatible with:
    • Enterprise tools (Jira, Confluence, Slack, MS Teams).
    • E-commerce platforms (Shopify, WooCommerce).
    • Form builders (Typeform, Google Forms).
    • Custom internal systems.
    • Any system that can make HTTPS requests.

Context Management

Each Worker maintains its own context:

  • System prompt defines its role.
  • Access to workspace resources.
  • History of its own actions.
  • State between runs (via notes/databases).

Integration with Workspace Features

Workers seamlessly connect with other Workspace components:

Files

  • Read incoming data.
  • Process documents.
  • Store results.
  • Monitor for changes.

Compute

  • Run calculations.
  • Process data.
  • Generate visualizations.
  • Update analysis.

Notes

  • Create and update documentation.
  • Maintain living documents.
  • Track progress.
  • Store findings.

Other Workers

  • Share data through databases.
  • Access shared workspace resources.
  • Coming Soon: Sequentially execute Workers and deterministic Compute.

Common Use Cases

Data Processing

  • Monitor data sources.
  • Clean and validate data.
  • Run analysis pipelines.
  • Generate reports.

Documentation

  • Keep docs in sync with code.
  • Generate technical specifications.
  • Maintain changelogs.
  • Update status reports.

Research

  • Monitor publications.
  • Summarize findings.
  • Track experiments.
  • Update literature reviews.

Project Management

  • Track progress.
  • Update timelines.
  • Generate status reports.
  • Monitor metrics.

Related Links