# ========= Copyright 2025-2026 @ Eigent.ai All Rights Reserved. ========= # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # ========= Copyright 2025-2026 @ Eigent.ai All Rights Reserved. ========= import platform import uuid from camel.messages import BaseMessage from camel.toolkits import ToolkitMessageIntegration from app.agent.agent_model import agent_model from app.agent.listen_chat_agent import logger from app.agent.prompt import BROWSER_SYS_PROMPT from app.agent.utils import NOW_STR from app.component.environment import env from app.model.chat import Chat from app.service.task import Agents from app.utils.file_utils import get_working_directory from app.utils.toolkit.human_toolkit import HumanToolkit from app.utils.toolkit.hybrid_browser_toolkit import HybridBrowserToolkit # TODO: Remove NoteTakingToolkit and use TerminalToolkit instead from app.utils.toolkit.note_taking_toolkit import NoteTakingToolkit from app.utils.toolkit.search_toolkit import SearchToolkit from app.utils.toolkit.terminal_toolkit import TerminalToolkit def browser_agent(options: Chat): working_directory = get_working_directory(options) logger.info( f"Creating browser agent for project: {options.project_id} " f"in directory: {working_directory}" ) message_integration = ToolkitMessageIntegration( message_handler=HumanToolkit( options.project_id, Agents.browser_agent ).send_message_to_user ) web_toolkit_custom = HybridBrowserToolkit( options.project_id, headless=False, browser_log_to_file=True, stealth=True, session_id=str(uuid.uuid4())[:8], default_start_url="about:blank", cdp_url=f"http://localhost:{env('browser_port', '9222')}", enabled_tools=[ "browser_click", "browser_type", "browser_back", "browser_forward", "browser_select", "browser_console_exec", "browser_console_view", "browser_switch_tab", "browser_enter", "browser_visit_page", "browser_scroll", "browser_sheet_read", "browser_sheet_input", "browser_get_page_snapshot", ], ) # Save reference before registering for toolkits_to_register_agent web_toolkit_for_agent_registration = web_toolkit_custom web_toolkit_custom = message_integration.register_toolkits( web_toolkit_custom ) terminal_toolkit = TerminalToolkit( options.project_id, Agents.browser_agent, working_directory=working_directory, safe_mode=True, clone_current_env=True, ) terminal_toolkit = message_integration.register_functions( [terminal_toolkit.shell_exec] ) note_toolkit = NoteTakingToolkit( options.project_id, Agents.browser_agent, working_directory=working_directory, ) note_toolkit = message_integration.register_toolkits(note_toolkit) search_tools = SearchToolkit.get_can_use_tools(options.project_id) if search_tools: search_tools = message_integration.register_functions(search_tools) else: search_tools = [] tools = [ *HumanToolkit.get_can_use_tools( options.project_id, Agents.browser_agent ), *web_toolkit_custom.get_tools(), *terminal_toolkit, *note_toolkit.get_tools(), *search_tools, ] system_message = BROWSER_SYS_PROMPT.format( platform_system=platform.system(), platform_machine=platform.machine(), working_directory=working_directory, now_str=NOW_STR, ) return agent_model( Agents.browser_agent, BaseMessage.make_assistant_message( role_name="Browser Agent", content=system_message, ), options, tools, prune_tool_calls_from_memory=True, tool_names=[ SearchToolkit.toolkit_name(), HybridBrowserToolkit.toolkit_name(), HumanToolkit.toolkit_name(), NoteTakingToolkit.toolkit_name(), TerminalToolkit.toolkit_name(), ], toolkits_to_register_agent=[web_toolkit_for_agent_registration], enable_snapshot_clean=True, )