Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
New efficiency guidelines
Magnus Müllerd97462e49ab6
diff --git a/browser_use/agent/system_prompt.md b/browser_use/agent/system_prompt.mdindex a19305678..3320063db 100644--- a/browser_use/agent/system_prompt.md+++ b/browser_use/agent/system_prompt.md@@ -128,50 +128,19 @@ The `done` action is your opportunity to terminate and share your findings with- You are allowed to use a maximum of {max_actions} actions per step.If you are allowed multiple actions, you can specify multiple actions in the list to be executed sequentially (one after another).-- If the page changes after an action, the sequence is interrupted and you get the new state. You can see this in your agent history when this happens.+- If the page changes after an action, the sequence is interrupted and you get the new state.</action_rules><efficiency_guidelines>-**IMPORTANT: Be More Efficient with Multi-Action Outputs**+You can output multiple actions in one step. Try to be efficient where it makes sense. Do not predict actions which do not make sense for the current page.-Maximize efficiency by combining related actions in one step instead of doing them separately:--**Highly Recommended Action Combinations:**-- `click_element_by_index` + `extract_structured_data` → Click element and immediately extract information-- `go_to_url` + `extract_structured_data` → Navigate and extract data in one step+**Recommended Action Combinations:**- `input_text` + `click_element_by_index` → Fill form field and submit/search in one step-- `click_element_by_index` + `input_text` → Click input field and fill it immediately-- `click_element_by_index` + `click_element_by_index` → Navigate through multi-step flows (when safe)+- `input_text` + `input_text` → Fill form fields+- `click_element_by_index` + `click_element_by_index` → Navigate through multi-step flows- File operations + browser actions--**Examples of Efficient Combinations:**-```json-"action": [- {{"click_element_by_index": {{"index": 15}}}},- {{"extract_structured_data": {{"query": "Extract the first 3 headlines", "extract_links": false}}}}-]-```--```json-"action": [- {{"input_text": {{"index": 23, "text": "laptop"}}}},- {{"click_element_by_index": {{"index": 24}}}}-]-```--```json-"action": [- {{"go_to_url": {{"url": "https://example.com/search"}}}},- {{"extract_structured_data": {{"query": "product listings", "extract_links": false}}}}-]-```--**When to Use Single Actions:**-- When next action depends on previous action's specific result---**Efficiency Mindset:** Think "What's the logical sequence of actions I would do?" and group them together when safe.+Think "What's the logical sequence of actions I would do?" and group them together when safe.</efficiency_guidelines><reasoning_rules>diff --git a/browser_use/agent/system_prompt_flash.md b/browser_use/agent/system_prompt_flash.mdindex 40b4ee1bb..9180d9433 100644--- a/browser_use/agent/system_prompt_flash.md+++ b/browser_use/agent/system_prompt_flash.md@@ -131,46 +131,16 @@ If you are allowed multiple actions, you can specify multiple actions in the lis<efficiency_guidelines>-**IMPORTANT: Be More Efficient with Multi-Action Outputs**+You can output multiple actions in one step. Try to be efficient where it makes sense. Do not predict actions which do not make sense for the current page.-Maximize efficiency by combining related actions in one step instead of doing them separately:--**Highly Recommended Action Combinations:**-- `click_element_by_index` + `extract_structured_data` → Click element and immediately extract information-- `go_to_url` + `extract_structured_data` → Navigate and extract data in one step+**Recommended Action Combinations:**- `input_text` + `click_element_by_index` → Fill form field and submit/search in one step-- `click_element_by_index` + `input_text` → Click input field and fill it immediately-- `click_element_by_index` + `click_element_by_index` → Navigate through multi-step flows (when safe)+- `input_text` + `input_text` → Fill form fields+- `click_element_by_index` + `click_element_by_index` → Navigate through multi-step flows- File operations + browser actions--**Examples of Efficient Combinations:**-```json-"action": [- {{"click_element_by_index": {{"index": 15}}}},- {{"extract_structured_data": {{"query": "Extract the first 3 headlines", "extract_links": false}}}}-]-```--```json-"action": [- {{"input_text": {{"index": 23, "text": "laptop"}}}},- {{"click_element_by_index": {{"index": 24}}}}-]-```--```json-"action": [- {{"go_to_url": {{"url": "https://example.com/search"}}}},- {{"extract_structured_data": {{"query": "product listings", "extract_links": false}}}}-]-```--**When to Use Single Actions:**-- When next action depends on previous action's specific result---**Efficiency Mindset:** Think "What's the logical sequence of actions I would do?" and group them together when safe.+Think "What's the logical sequence of actions I would do?" and group them together when safe.</efficiency_guidelines>+<reasoning_rules>Be clear and concise in your decision-making. Exhibit the following reasoning patterns to successfully achieve the <user_request>:- Reason about <agent_history> to track progress and context toward <user_request>.diff --git a/browser_use/agent/system_prompt_no_thinking.md b/browser_use/agent/system_prompt_no_thinking.mdindex 9e6117d4a..a003ea731 100644--- a/browser_use/agent/system_prompt_no_thinking.md+++ b/browser_use/agent/system_prompt_no_thinking.md@@ -132,45 +132,14 @@ If you are allowed multiple actions, you can specify multiple actions in the lis</action_rules><efficiency_guidelines>-**IMPORTANT: Be More Efficient with Multi-Action Outputs**+You can output multiple actions in one step. Try to be efficient where it makes sense. Do not predict actions which do not make sense for the current page.-Maximize efficiency by combining related actions in one step instead of doing them separately:--**Highly Recommended Action Combinations:**-- `click_element_by_index` + `extract_structured_data` → Click element and immediately extract information-- `go_to_url` + `extract_structured_data` → Navigate and extract data in one step+**Recommended Action Combinations:**- `input_text` + `click_element_by_index` → Fill form field and submit/search in one step-- `click_element_by_index` + `input_text` → Click input field and fill it immediately-- `click_element_by_index` + `click_element_by_index` → Navigate through multi-step flows (when safe)+- `input_text` + `input_text` → Fill form fields+- `click_element_by_index` + `click_element_by_index` → Navigate through multi-step flows- File operations + browser actions--**Examples of Efficient Combinations:**-```json-"action": [- {{"click_element_by_index": {{"index": 15}}}},- {{"extract_structured_data": {{"query": "Extract the first 3 headlines", "extract_links": false}}}}-]-```--```json-"action": [- {{"input_text": {{"index": 23, "text": "laptop"}}}},- {{"click_element_by_index": {{"index": 24}}}}-]-```--```json-"action": [- {{"go_to_url": {{"url": "https://example.com/search"}}}},- {{"extract_structured_data": {{"query": "product listings", "extract_links": false}}}}-]-```--**When to Use Single Actions:**-- When next action depends on previous action's specific result---**Efficiency Mindset:** Think "What's the logical sequence of actions I would do?" and group them together when safe.+Think "What's the logical sequence of actions I would do?" and group them together when safe.</efficiency_guidelines><reasoning_rules>