Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

Shorter tools

Magnus Müller55d10605fd0c
diff --git a/browser_use/tools/service.py b/browser_use/tools/service.py
index 8e24773e9..3e7b526a6 100644
--- a/browser_use/tools/service.py
+++ b/browser_use/tools/service.py
@@ -131,10 +131,10 @@ class Tools(Generic[Context]):
'bing': f'https://www.bing.com/search?q={encoded_query}',
}
- if params.search_engine.lower() not in search_engines:
- return ActionResult(error=f'Unsupported search engine: {params.search_engine}. Options: duckduckgo, google, bing')
+ if params.engine.lower() not in search_engines:
+ return ActionResult(error=f'Unsupported search engine: {params.engine}. Options: duckduckgo, google, bing')
- search_url = search_engines[params.search_engine.lower()]
+ search_url = search_engines[params.engine.lower()]
# Simple tab logic: use current tab by default
use_new_tab = False
@@ -149,13 +149,13 @@ class Tools(Generic[Context]):
)
await event
await event.event_result(raise_if_any=True, raise_if_none=False)
- memory = f"Searched {params.search_engine.title()} for '{params.query}'"
+ memory = f"Searched {params.engine.title()} for '{params.query}'"
msg = f'🔍 {memory}'
logger.info(msg)
return ActionResult(extracted_content=memory, long_term_memory=memory)
except Exception as e:
- logger.error(f'Failed to search {params.search_engine}: {e}')
- return ActionResult(error=f'Failed to search {params.search_engine} for "{params.query}": {str(e)}')
+ logger.error(f'Failed to search {params.engine}: {e}')
+ return ActionResult(error=f'Failed to search {params.engine} for "{params.query}": {str(e)}')
@self.registry.action(
'Navigate to URL.',
@@ -313,7 +313,7 @@ class Tools(Generic[Context]):
TypeTextEvent(
node=node,
text=params.text,
- clear_existing=params.clear_existing,
+ clear_existing=params.clear,
is_sensitive=has_sensitive_data,
sensitive_key_name=sensitive_key_name,
)
@@ -683,18 +683,18 @@ You will be given a query and the markdown of a webpage that has been filtered t
# Look up the node from the selector map if index is provided
# Special case: index 0 means scroll the whole page (root/body element)
node = None
- if params.frame_element_index is not None and params.frame_element_index != 0:
- node = await browser_session.get_element_by_index(params.frame_element_index)
+ if params.frame_idx is not None and params.frame_idx != 0:
+ node = await browser_session.get_element_by_index(params.frame_idx)
if node is None:
# Element does not exist
- msg = f'Element index {params.frame_element_index} not found in browser state'
+ msg = f'Element index {params.frame_idx} not found in browser state'
return ActionResult(error=msg)
direction = 'down' if params.down else 'up'
target = (
'the page'
- if params.frame_element_index is None or params.frame_element_index == 0
- else f'element {params.frame_element_index}'
+ if params.frame_idx is None or params.frame_idx == 0
+ else f'element {params.frame_idx}'
)
# Get actual viewport height for more accurate scrolling
@@ -715,11 +715,11 @@ You will be given a query and the markdown of a webpage that has been filtered t
logger.debug(f'Failed to get viewport height, using fallback 1000px: {e}')
# For multiple pages (>=1.0), scroll one page at a time to ensure each scroll completes
- if params.num_pages >= 1.0:
+ if params.pages >= 1.0:
import asyncio
- num_full_pages = int(params.num_pages)
- remaining_fraction = params.num_pages - num_full_pages
+ num_full_pages = int(params.pages)
+ remaining_fraction = params.pages - num_full_pages
completed_scrolls = 0
@@ -761,19 +761,19 @@ You will be given a query and the markdown of a webpage that has been filtered t
except Exception as e:
logger.warning(f'Fractional scroll failed: {e}')
- if params.num_pages == 1.0:
+ if params.pages == 1.0:
long_term_memory = f'Scrolled {direction} {target} by one page ({viewport_height}px)'
else:
- long_term_memory = f'Scrolled {direction} {target} by {completed_scrolls:.1f} pages (requested: {params.num_pages}, {viewport_height}px per page)'
+ long_term_memory = f'Scrolled {direction} {target} by {completed_scrolls:.1f} pages (requested: {params.pages}, {viewport_height}px per page)'
else:
# For fractional pages <1.0, do single scroll
- pixels = int(params.num_pages * viewport_height)
+ pixels = int(params.pages * viewport_height)
event = browser_session.event_bus.dispatch(
ScrollEvent(direction='down' if params.down else 'up', amount=pixels, node=node)
)
await event
await event.event_result(raise_if_any=True, raise_if_none=False)
- long_term_memory = f'Scrolled {direction} {target} by {params.num_pages} pages ({viewport_height}px per page)'
+ long_term_memory = f'Scrolled {direction} {target} by {params.pages} pages ({viewport_height}px per page)'
msg = f'🔍 {long_term_memory}'
logger.info(msg)
@@ -1170,10 +1170,10 @@ WRONG: document.querySelector('#id').value""",
memory += f' - {len_text - len_max_memory} more characters'
attachments = []
- if params.files_to_display:
+ if params.files:
if self.display_files_in_done_text:
file_msg = ''
- for file_name in params.files_to_display:
+ for file_name in params.files:
if file_name == 'todo.md':
continue
file_content = file_system.display_file(file_name)
@@ -1186,7 +1186,7 @@ WRONG: document.querySelector('#id').value""",
else:
logger.warning('Agent wanted to display files but none were found')
else:
- for file_name in params.files_to_display:
+ for file_name in params.files:
if file_name == 'todo.md':
continue
file_content = file_system.display_file(file_name)
diff --git a/browser_use/tools/views.py b/browser_use/tools/views.py
index 44fab1347..692757c6f 100644
--- a/browser_use/tools/views.py
+++ b/browser_use/tools/views.py
@@ -31,14 +31,14 @@ class ClickElementAction(BaseModel):
class InputTextAction(BaseModel):
- index: int = Field(ge=1, description='from browser_state')
+ index: int = Field(ge=1, description='index')
text: str
- clear_existing: bool = Field(default=True, description='True to clear, False to append')
+ clear: bool = Field(default=True, description='1=clear, 0=append')
class DoneAction(BaseModel):
text: str = Field(description='summary for user')
- success: bool = Field(description='True if completed')
+ success: bool = Field(description='True if user_request completed successfully')
files_to_display: list[str] | None = Field(default=[], description='files to display')
@@ -46,22 +46,22 @@ T = TypeVar('T', bound=BaseModel)
class StructuredOutputAction(BaseModel, Generic[T]):
- success: bool = Field(default=True, description='True if finished, False if not')
+ success: bool = Field(default=True, description='1=done')
data: T
class SwitchTabAction(BaseModel):
- tab_id: str = Field(min_length=4, max_length=4, description="from browser_state ('Tab <tab_id>')")
+ tab_id: str = Field(min_length=4, max_length=4, description='4-char id')
class CloseTabAction(BaseModel):
- tab_id: str = Field(min_length=4, max_length=4, description="from browser_state ('Tab <tab_id>')")
+ tab_id: str = Field(min_length=4, max_length=4, description='4-char id')
class ScrollAction(BaseModel):
- down: bool = Field(description='True=down, False=up')
- num_pages: float = Field(default=1.0, description='pages to scroll (0.5=half, 1=page, 10=bottom)')
- frame_element_index: int | None = Field(default=None, description='index for specific container')
+ down: bool = Field(description='1=down, 0=up')
+ pages: float = Field(default=1.0, description='0.5=half, 1=pg, 10=bottom')
+ frame_index: int | None = Field(default=None, description='container index')
class SendKeysAction(BaseModel):
@@ -69,7 +69,7 @@ class SendKeysAction(BaseModel):
class UploadFileAction(BaseModel):
- index: int = Field(description='from browser_state')
+ index: int = Field(description='index')
path: str
@@ -78,15 +78,13 @@ class ExtractPageContentAction(BaseModel):
class NoParamsAction(BaseModel):
- """Accepts any input, discards it, returns empty model."""
-
model_config = ConfigDict(extra='ignore')
class GetDropdownOptionsAction(BaseModel):
- index: int = Field(ge=1, description='dropdown from browser_state')
+ index: int = Field(ge=1, description='index')
class SelectDropdownOptionAction(BaseModel):
- index: int = Field(ge=1, description='dropdown from browser_state')
- text: str = Field(description='exact text/value to select')
+ index: int = Field(ge=1, description='index')
+ text: str = Field(description='exact text/value')