Skip to main content

Writing effective tasks

Good task descriptions lead to better results. Follow these guidelines:

Be specific and clear

Include expected outcomes

Provide necessary context


Email format templates

Example:

Template 2: Manual checkpoints

Example:

Template 3: Baseline (no verification)

Example:

API format templates

Template 2: Manual checkpoints

Template 3: With webhook callback


Task categories and examples

Financial calculations

Research tasks

Communication tasks


Best practices

Do’s ✅

Be specific about numbers and amounts
Include verification criteria
Specify data sources when relevant
Break complex tasks into steps

Don’ts ❌

Don’t use vague language
Don’t forget to specify reviewer
Don’t mix manual checkpoints with auto-detect

Checkpoint placement guide

AI auto-detects checkpoints before:

External Communications

  • Sending emails
  • Posting to social media
  • Sending SMS/messages

Financial Actions

  • Making purchases
  • Transferring money
  • Processing payments

Irreversible Operations

  • Deleting data
  • Canceling subscriptions
  • Submitting forms

High-Value Decisions

  • Strategic recommendations
  • Large calculations
  • Important approvals

AI does NOT checkpoint for:

  • Web searches and research
  • Reading files or data
  • Analysis and calculations (unless result triggers action)
  • Information gathering
  • Report generation (unless sending/publishing)

Field reference

Required fields

Optional fields


Common mistakes

Wrong: Subject: Calculate Commission Right: Subject: Eval: Calculate Commission
Wrong: Do some calculations Right: Calculate 15% commission on a $50,000 sale
Wrong: No reviewer specified Right: Reviewer: manager@company.com
Wrong: 10 checkpoints for simple task Right: 2-4 checkpoints for most tasks, or use auto-detect

Next steps

See Examples

10+ ready-to-use example tasks

API Reference

Complete API documentation

Best Practices

Advanced tips and tricks

Get Started

Submit your first task