Task
A Task is a single automation job executed by an AI agent in a browser environment. Tasks contain your instructions for what the AI should accomplish.
What is a Task?
Examples:
- “Log into Gmail and count unread emails”
- “Search for top 10 Hacker News posts and return titles and URLs”
- “Extract product prices from an e-commerce site”
Key Properties
task
: Your instruction to the AI agent (max 20,000 characters)llm
: AI model ("gpt-4.1"
,"o3"
,"claude-sonnet-4"
, etc.)sessionId
: Session where task runs (optional - auto-created if not provided)status
:started
,paused
,finished
, orstopped
output
: Final result from the agentinputFiles
/outputFiles
: Files for input/output
Execution Models
Auto-Session (Simple)
Best for: Simple tasks, no login required, proof of concepts
Custom Session (Advanced)
Best for: Multi-step workflows, login required, related tasks
Task Control
Files
Best Practices
Task Instructions:
- Be specific: “Extract product names and prices from first page” vs “get product info”
- Set boundaries: Specify pages to visit, items to process
- Include context: Mention login requirements, data format
Performance:
- Use auto-session for simple tasks
- Reuse sessions for related tasks