Camel.toolkits.async browser toolkit
extract_function_name
Extract the pure function name from a string (without parameters or parentheses)
Parameters:
- s (str): Input string, e.g.,
1.
click_id(14)
,scroll_up()
,\'visit_page(url)\'
, etc.
Returns:
str: Pure function name (e.g., click_id
, scroll_up
, visit_page
)
AsyncBaseBrowser
init
Initialize the asynchronous browser core.
Parameters:
- headless (bool): Whether to run the browser in headless mode.
- cache_dir (Union[str, None]): The directory to store cache files.
- channel (
Literal["chrome", "msedge", "chromium"]
): The browser channel to use. Must be one of “chrome”, “msedge”, or “chromium”. - cookie_json_path (Optional[str]): Path to a JSON file containing authentication cookies and browser storage state. If provided and the file exists, the browser will load this state to maintain authenticated sessions without requiring manual login.
Returns:
None
init
Initialize the browser asynchronously.
clean_cache
Delete the cache directory and its contents.
wait_for_load
Wait for a certain amount of time for the page to load.
Parameters:
- timeout (int): Timeout in seconds.
click_blank_area
Click a blank area of the page to unfocus the current element.
visit_page
Visit a page with the given URL.
ask_question_about_video
Ask a question about the video on the current page, such as YouTube video.
Parameters:
- question (str): The question to ask.
Returns:
str: The answer to the question.
get_screenshot
Get a screenshot of the current page.
Parameters:
- save_image (bool): Whether to save the image to the cache directory.
Returns:
Tuple[Image.Image, str]: A tuple containing the screenshot
image and the path to the image file if saved, otherwise
:obj:None
.
capture_full_page_screenshots
Capture full page screenshots by scrolling the page with a buffer zone.
Parameters:
- scroll_ratio (float): The ratio of viewport height to scroll each step (default: 0.8).
Returns:
List[str]: A list of paths to the captured screenshots.
get_visual_viewport
Get the visual viewport of the current page.
get_interactive_elements
Returns:
Dict[str, InteractiveRegion]: A dictionary of interactive elements.
get_som_screenshot
Get a screenshot of the current viewport with interactive elements marked.
Parameters:
- save_image (bool): Whether to save the image to the cache directory.
Returns:
Tuple[Image.Image, str]: A tuple containing the screenshot image and the path to the image file.
scroll_up
Scroll up the page.
scroll_down
Scroll down the page.
get_url
Get the URL of the current page.
click_id
Click an element with the given identifier.
extract_url_content
Extract the content of the current page.
download_file_id
Download a file with the given identifier.
fill_input_id
Fill an input field with the given text, and then press Enter.
scroll_to_bottom
Scroll to the bottom of the page.
scroll_to_top
Scroll to the top of the page.
hover_id
Hover over an element with the given identifier.
find_text_on_page
Find the next given text on the page, and scroll the page to the targeted text. It is equivalent to pressing Ctrl + F and searching for the text.
Parameters:
- search_text (str): The text to search for.
Returns:
str: The result of the action.
back
Navigate back to the previous page.
close
Close the browser.
show_interactive_elements
Show simple interactive elements on the current page.
get_webpage_content
Extract the content of the current page.
_ensure_browser_installed
Ensure the browser is installed.
AsyncBrowserToolkit
An asynchronous class for browsing the web and interacting with web pages.
This class provides methods for browsing the web and interacting with web pages.
init
Initialize the BrowserToolkit instance.
Parameters:
- headless (bool): Whether to run the browser in headless mode.
- cache_dir (Union[str, None]): The directory to store cache files.
- channel (
Literal["chrome", "msedge", "chromium"]
): The browser channel to use. Must be one of “chrome”, “msedge”, or “chromium”. - history_window (int): The window size for storing the history of actions.
- web_agent_model (Optional[BaseModelBackend]): The model backend for the web agent.
- planning_agent_model (Optional[BaseModelBackend]): The model backend for the planning agent.
- output_language (str): The language to use for output. (default: :obj:
"en
”) - cookie_json_path (Optional[str]): Path to a JSON file containing authentication cookies and browser storage state. If provided and the file exists, the browser will load this state to maintain authenticated sessions without requiring manual login. (default: :obj:
None
)
_reset
_initialize_agent
Initialize the agent.
_get_final_answer
Get the final answer based on the task prompt and current browser state. It is used when the agent thinks that the task can be completed without any further action, and answer can be directly found in the current viewport.
_task_planning
Plan the task based on the given task prompt.
_task_replanning
Replan the task based on the given task prompt.
Parameters:
- task_prompt (str): The original task prompt.
- detailed_plan (str): The detailed plan to replan.
Returns:
Tuple[bool, str]: A tuple containing a boolean indicating whether the task needs to be replanned, and the replanned schema.