在智能体中集成浏览器

前提条件

• 已创建沙箱工具，具体请参见创建浏览器。
• 已安装Python，且版本不低于3.10。
• 已安装agentarts-sdk包。
• 配置访问端点：通过AGENTARTS_BROWSER_DATA_ENDPOINT设置环境变量 ，访问端点获取请参考终端节点，获取到终端节点后，在配置使用时，请配置为http://{域名}。

在智能体中集成浏览器

1. 登录AgentArts智能体平台。
2. 在左侧导航栏选择“托管与运行 > 浏览器”，进入浏览器界面。

3. 通过SDK调用浏览器工具。

   在工具列表单击操作列的“调用代码”，通过SDK调用工具实现浏览器自动化的能力。SDK提供browser_session函数，可快速启动浏览器的会话，并支持自动停止会话。

   "调用代码"仅为代码示例，请根据实际情况替换代码示例中的"type"、"action"。

   API_KEY认证代码示例如下，获取API_KEY请参考如何获取浏览器的API_KEY。

   from agentarts.sdk.tools import browser_session
   api_key = "your_actual_api_key"  # your api key
   with browser_session("cn-southwest-2", "your_browser_name", "your_session_name", api_key=api_key) as browser_client:
       response = browser_client.invoke(
           type="navigate",
           api_key=api_key,
           action={
               "url": "https://example.com"
           }
       )

   IAM认证代码示例如下，获取AK/SK请参考如何获取华为云AK/SK。

   from agentarts.sdk.tools import browser_session
   # Please configure the HUAWEICLOUD_SDK_AK/HUAWEICLOUD_SDK_SK in your environment variables in advance.
   with browser_session("cn-southwest-2", "your_browser_name", "your_session_name", auth_type="IAM") as browser_client:
       response = browser_client.invoke(
           type="navigate",
           action={
               "url": "https://example.com"
           }
       )

   了解沙箱工具支持的操作，请参考浏览器支持的快捷操作。

4. 将浏览器能力封装成工具。

   将浏览器自动化能力封装成工具，此处使用langgraph的tool装饰器作为演示。

   import json
   from agentarts.sdk.tools import browser_session
   from langchain_core.tools import tool
   @tool
   def navigate_tool(url: str) -> str | None:
       """Navigate to a URL in the browser"""
       api_key = "your_actual_api_key"  # your api key
       with browser_session("your_region", "your_browser_name", "your_session_name", api_key=api_key) as browser_client:
           response = browser_client.invoke(
               type="navigate",
               api_key=api_key,
               action={
                   "url": url
               }
           )
       return json.dumps(response)

5. 将工具集成到智能体中。

   将封装好的工具集成到智能体中，此处以langgraph框架开发智能体为例。

   from langchain_openai import ChatOpenAI
   import os
   llm = ChatOpenAI(
       model="deepseek-v4-flash",
       api_key=os.environ.get("MODEL_API_KEY", ""),
       base_url=os.environ.get("BASE_URL", ""),
       max_tokens=1000,
       temperature=0.7,
   )
   # 创建工具列表
   tools = [navigate_tool]
   # 工具绑定Agent
   llm = llm.bind_tools(tools)