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 ("browser-use-llm","gemini-flash-latest","gpt-4.1","o3","claude-sonnet-4-20250514","claude-sonnet-4-5-20250929", etc.)sessionId: Session where task runs (optional - auto-created if not provided)status:started,paused,finished, orstoppedoutput: 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