Task Management

The .do platform provides comprehensive task management capabilities for AI agents, enabling seamless creation, assignment, monitoring, and completion of work across individual agents and teams.

Overview

Tasks represent units of work that agents execute to deliver business value. The task management system handles:

Task Creation - Define work with clear descriptions, context, and deliverables
Smart Assignment - Auto-assign to best-fit agents or specify manually
Lifecycle Tracking - Monitor progress from creation to completion
Deliverable Management - Retrieve completed work and artifacts
Quality Assurance - Feedback loops and performance metrics

Complete Task Catalog

For a comprehensive catalog of all available task types, categories, and templates, visit:

tasks.org.ai - Complete task ontology with 19,265 standardized tasks from O*NET

The tasks.org.ai catalog includes:

Detailed task descriptions and requirements
Skill and knowledge prerequisites
Typical contexts and industries
Related tasks and workflows
Performance metrics and quality standards

Quick Start

Create a Task

import { $ } from 'sdk.do'

const task = await $.Task.create({
  task: 'Analyze Q4 revenue trends and create executive report',
  agentId: 'amy',
  priority: 'high',
  deadline: '2024-10-30T17:00:00Z',
  deliverables: ['pdf-report', 'presentation'],
})

Monitor Progress

const status = await $.Task.get(task.taskId)
console.log(`Progress: ${status.progress}%, Status: ${status.status}`)

Retrieve Deliverables

const deliverables = await $.Task.deliverables(task.taskId)
deliverables.forEach((d) => {
  console.log(`${d.name}: ${d.downloadUrl}`)
})

Task Examples

Data Analysis Task

const analysisTask = await $.Task.create({
  task: 'Analyze customer churn patterns and identify retention opportunities',
  agentId: 'amy',
  context: {
    dataSource: 'customers_2024.csv',
    timeRange: 'Q1-Q4 2024',
    metrics: ['churn_rate', 'lifetime_value', 'engagement_score'],
  },
  deliverables: ['analysis-report', 'recommendations', 'dashboard'],
})

Content Creation Task

const contentTask = await $.Task.create({
  task: 'Write technical blog post about new API features',
  agentId: 'cody',
  context: {
    topic: 'GraphQL API enhancements',
    targetAudience: 'developers',
    length: '1500-2000 words',
    includeCodeExamples: true,
  },
  deliverables: ['blog-post', 'code-samples', 'social-media-snippets'],
})

Research Task

const researchTask = await $.Task.create({
  task: 'Research competitive landscape for SaaS project management tools',
  agentId: 'quinn',
  context: {
    competitors: ['Asana', 'Monday.com', 'ClickUp', 'Linear'],
    focusAreas: ['pricing', 'features', 'integrations', 'user-experience'],
    depth: 'comprehensive',
  },
  deliverables: ['competitive-analysis', 'feature-comparison', 'recommendations'],
})

Key Features

Automatic Task Assignment

When no agent is specified, the system automatically assigns tasks based on:

Agent capabilities and expertise
Current workload and availability
Task priority and urgency
Historical performance on similar tasks

// Auto-assign to best-fit agent
const task = await $.Task.create({
  task: 'Design new landing page for product launch',
  priority: 'urgent',
  // agentId not specified - system will auto-assign
})

Progress Monitoring

Track task progress in real-time:

const status = await $.Task.get(taskId)

console.log({
  status: status.status, // pending, in_progress, completed, etc.
  progress: status.progress, // 0-100%
  currentPhase: status.currentPhase,
  estimatedCompletion: status.estimatedCompletion,
})

Quality Metrics

Every completed task includes quality scores:

const completed = await $.Task.get(taskId)

console.log({
  qualityScore: completed.quality.score, // Overall: 0-1
  accuracy: completed.quality.accuracy, // 0-1
  completeness: completed.quality.completeness, // 0-1
  clarity: completed.quality.clarity, // 0-1
})