> ## Documentation Index
> Fetch the complete documentation index at: https://ikun.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Browserbase

**BrowserbaseTools** 允许 Agent 使用 Browserbase（一项无头浏览器服务）来自动化浏览器交互。

## 前提条件

下面的示例需要您在 [此处](https://www.browserbase.com/) 注册后获得的 Browserbase API 凭证，以及 Playwright 库。

```shell theme={null}
pip install browserbase playwright
export BROWSERBASE_API_KEY=xxx
export BROWSERBASE_PROJECT_ID=xxx
```

## 示例

下面的 Agent 将使用 Browserbase 访问 `https://quotes.toscrape.com` 并提取内容。然后导航到该网站的第二页并同样获取那里的名言。

```python cookbook/tools/browserbase_tools.py theme={null}
from agno.agent import Agent
from agno.tools.browserbase import BrowserbaseTools

agent = Agent(
    name="Web Automation Assistant",
    tools=[BrowserbaseTools()],
    instructions=[
        "You are a web automation assistant that can help with:",
        "1. Capturing screenshots of websites",
        "2. Extracting content from web pages",
        "3. Monitoring website changes",
        "4. Taking visual snapshots of responsive layouts",
        "5. Automated web testing and verification",
    ],
    markdown=True,
)

agent.print_response("""
    Visit https://quotes.toscrape.com and:
    1. Extract the first 5 quotes and their authors
    2. Navigate to page 2
    3. Extract the first 5 quotes from page 2
""")
```

<Tip>查看 [Startup Analyst MCP agent](/examples/concepts/tools/mcp/stagehand)</Tip>

## Toolkit 参数

| 参数           | 类型    | 默认值    | 描述                                                                                                          |
| ------------ | ----- | ------ | ----------------------------------------------------------------------------------------------------------- |
| `api_key`    | `str` | `None` | Browserbase API 密钥。如果未提供，则使用 BROWSERBASE\_API\_KEY 环境变量。                                                    |
| `project_id` | `str` | `None` | Browserbase 项目 ID。如果未提供，则使用 BROWSERBASE\_PROJECT\_ID 环境变量。                                                  |
| `base_url`   | `str` | `None` | 自定义 Browserbase API 端点 URL。仅当您使用自托管的 Browserbase 实例时使用此参数，或需要连接到其他区域。如果未提供，则使用 BROWSERBASE\_BASE\_URL 环境变量。 |

## Toolkit 函数

| 函数                 | 描述                                                            |
| ------------------ | ------------------------------------------------------------- |
| `navigate_to`      | 导航到指定的 URL。接受一个 URL 和一个可选的 connect\_url 参数。                   |
| `screenshot`       | 截取当前页面的屏幕截图。接受保存屏幕截图的路径、一个用于全页截图的布尔值，以及一个可选的 connect\_url 参数。 |
| `get_page_content` | 获取当前页面的 HTML 内容。接受一个可选的 connect\_url 参数。                      |
| `close_session`    | 关闭浏览器会话。                                                      |

## 开发者资源

* 查看 [Tools](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/browserbase.py)
* 查看 [Cookbook](https://github.com/agno-agi/agno/blob/main/cookbook/tools/browserbase_tools.py)