​
Available Parameters

​
Core Settings

  • tools: Registry of our tools the agent can call. Example for custom tools
  • browser: Browser object where you can specify the browser settings.
  • output_model_schema: Pydantic model class for structured output validation. Example

​
Vision & Processing

  • use_vision (default: True): Enable/disable vision capabilities for processing screenshots
  • vision_detail_level (default: 'auto'): Screenshot detail level - 'low', 'high', or 'auto'
  • page_extraction_llm: Separate LLM model for page content extraction. You can choose a small & fast model because it only needs to extract text from the page (default: same as llm)

​
Actions & Behavior

  • initial_actions: List of actions to run before the main task without LLM. Example
  • max_actions_per_step (default: 10): Maximum actions per step, e.g. for form filling the agent can output 10 fields at once. We execute the actions until the page changes.
  • max_failures (default: 3): Maximum retries for steps with errors
  • use_thinking (default: True): Controls whether the agent uses its internal “thinking” field for explicit reasoning steps.
  • flash_mode (default: False): Fast mode that skips evaluation, next goal and thinking and only uses memory. If flash_mode is enabled, it overrides use_thinking and disables the thinking process entirely. Example

​
System Messages

  • override_system_message: Completely replace the default system prompt.
  • extend_system_message: Add additional instructions to the default system prompt. Example

​
File & Data Management

  • save_conversation_path: Path to save complete conversation history
  • save_conversation_path_encoding (default: 'utf-8'): Encoding for saved conversations
  • available_file_paths: List of file paths the agent can access
  • sensitive_data: Dictionary of sensitive data to handle carefully. Example

​
Visual Output

  • generate_gif (default: False): Generate GIF of agent actions. Set to True or string path
  • include_attributes: List of HTML attributes to include in page analysis

​
Performance & Limits

  • max_history_items: Maximum number of last steps to keep in the LLM memory. If None, we keep all steps.
  • llm_timeout (default: 90): Timeout in seconds for LLM calls
  • step_timeout (default: 120): Timeout in seconds for each step
  • directly_open_url (default: True): If we detect a url in the task, we directly open it.

​
Advanced Options

  • calculate_cost (default: False): Calculate and track API costs
  • display_files_in_done_text (default: True): Show file information in completion messages

​
Backwards Compatibility

  • controller: Alias for tools for backwards compatibility.
  • browser_session: Alias for browser for backwards compatibility.