Camel.toolkits.async browser toolkit

​

extract_function_name

def extract_function_name(s: str):

• s (str): Input string, e.g., 1.click_id(14), scroll_up(), \'visit_page(url)\', etc.

​

AsyncBaseBrowser

class AsyncBaseBrowser:

​

init

def __init__(
    self,
    headless = True,
    cache_dir: Optional[str] = None,
    channel: Literal['chrome', 'msedge', 'chromium'] = 'chromium',
    cookie_json_path: Optional[str] = None,
    user_data_dir: Optional[str] = None
):

• 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. This is primarily used when user_data_dir is not set.
• user_data_dir (Optional[str]): The directory to store user data for persistent context. If None, a fresh browser instance is used without saving data. (default: :obj:None)

​

init

def init(self):

​

clean_cache

def clean_cache(self):

​

wait_for_load

def wait_for_load(self, timeout: int = 20):

• timeout (int): Timeout in seconds.

​

click_blank_area

def click_blank_area(self):

​

visit_page

def visit_page(self, url: str):

​

ask_question_about_video

def ask_question_about_video(self, question: str):

• question (str): The question to ask.

​

get_screenshot

def get_screenshot(self, save_image: bool = False):

• save_image (bool): Whether to save the image to the cache directory.

​

capture_full_page_screenshots

def capture_full_page_screenshots(self, scroll_ratio: float = 0.8):

• scroll_ratio (float): The ratio of viewport height to scroll each step (default: 0.8).

​

get_visual_viewport

def get_visual_viewport(self):

​

get_interactive_elements

def get_interactive_elements(self):

​

get_som_screenshot

def get_som_screenshot(self, save_image: bool = False):

• save_image (bool): Whether to save the image to the cache directory.

​

scroll_up

def scroll_up(self):

​

scroll_down

def scroll_down(self):

​

get_url

def get_url(self):

​

click_id

def click_id(self, identifier: Union[str, int]):

​

extract_url_content

def extract_url_content(self):

​

download_file_id

def download_file_id(self, identifier: Union[str, int]):

​

fill_input_id

def fill_input_id(self, identifier: Union[str, int], text: str):

​

scroll_to_bottom

def scroll_to_bottom(self):

​

scroll_to_top

def scroll_to_top(self):

​

hover_id

def hover_id(self, identifier: Union[str, int]):

​

find_text_on_page

def find_text_on_page(self, search_text: str):

• search_text (str): The text to search for.

​

back

def back(self):

​

close

def close(self):

​

show_interactive_elements

def show_interactive_elements(self):

​

get_webpage_content

def get_webpage_content(self):

​

_ensure_browser_installed

def _ensure_browser_installed(self):

​

AsyncBrowserToolkit

class AsyncBrowserToolkit(BaseToolkit):

​

init

def __init__(
    self,
    headless: bool = False,
    cache_dir: Optional[str] = None,
    channel: Literal['chrome', 'msedge', 'chromium'] = 'chromium',
    history_window: int = 5,
    web_agent_model: Optional[BaseModelBackend] = None,
    planning_agent_model: Optional[BaseModelBackend] = None,
    output_language: str = 'en',
    cookie_json_path: Optional[str] = None,
    user_data_dir: Optional[str] = None
):

• 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)
• user_data_dir (Optional[str]): The directory to store user data for persistent context. (default: :obj:"user_data_dir/")

​

_reset

def _reset(self):

​

_initialize_agent

def _initialize_agent(self):

​

get_tools

def get_tools(self):