---
title: 在 Chrome 中使用 Beeuni
description: 让会话使用你已登录的浏览器，并自行决定访问范围。
---

Beeuni 可以通过扩展打开你的浏览器页面，操作已经登录的网站。这是实验功能，只有部署管理员配置了 Beeuni 自己的扩展后才会出现。目前尚未在 Chrome 应用商店公开上架，请向管理员获取认可的扩展包和安装说明。

## 连接浏览器

1. 在准备使用的浏览器个人资料中，安装管理员提供的扩展包。
2. 打开 Beeuni 的 **设置 → Chrome 中的 Beeuni**，点击 **连接**。扩展要求登录时，使用你自己的 Beeuni 账户。
3. 选择访问方式和标签页范围。会话使用浏览器期间，请保持浏览器打开。

连接属于登录扩展的本人，不会自动成为团队共享的连接器账户，其他成员的浏览器列表中也不会出现你的浏览器。你不需要向 Beeuni 粘贴网站密码或 Cookie。不过，智能体可以利用当前的网站登录状态，读取获准访问的页面并执行操作。请只开放完成任务所需的标签页。

## 选择访问范围

扩展中的选项目前显示为英文：

- **Ask first**：会话请求连接时，Chrome 会显示授权提示。你可以只允许本次会话、允许此项目中符合条件的会话，或拒绝。
- **Without asking**：符合条件的会话可以直接连接，不再逐次弹出提示。
- **Off**：拒绝新的连接请求。

默认的 **All tabs** 会让智能体看到各个浏览器窗口中的标签页。**Only tabs it opens** 则将访问范围限制在当前会话打开的标签页内。Chrome 内置页面、扩展页面和 Chrome 应用商店不在可访问范围内。

## 开始和停止

告诉智能体使用已连接的浏览器即可。在支持标签页分组的浏览器中，会话的页面会归入对应分组。点击 **Take over** 会暂停智能体输入；点击 **Stop** 会结束本次连接。如果你不准备重新授权，就不要让智能体在停止后自行重试。

也可以在会话终端中运行：

```sh
beeuni chrome use
beeuni chrome status
beeuni chrome release
```

`release` 只结束会话对浏览器的使用，不会退出网站登录。在扩展设置中点击 **Disconnect this browser**，会撤销这台浏览器与 Beeuni 的连接；之后需要重新连接才能使用。

## 部署配置

管理员需要使用 Beeuni 自己的扩展 ID：

- API：设置 `BEEUNI_CHROME_ENABLED=true` 和 `BEEUNI_CHROME_EXTENSION_ID`。
- Web：将 `NEXT_PUBLIC_BEEUNI_EXTENSION_ID` 设为相同的扩展 ID，然后重新构建。

应用 Chrome 相关数据库迁移，并部署包含 Chrome 桥接功能的新版 API、网页和会话运行环境。如果沙盒镜像中仍是旧版运行环境，也需要更新镜像；只添加环境变量不会为旧镜像补上桥接功能。项目本身还需要开启 Chrome 功能。未配置有效的扩展 ID 时，平台会保持关闭。