# 在 Agent 中使用 Beav

> 让 Codex Desktop 或 WorkBuddy 安装 Beav Creator 插件，并通过本机 MCP 访问 Beav 数据、使用工具或与 Beav Agent 协作。

- 原文: https://www.getbeav.com/docs/agent

Beav Creator Plugin 把 Codex Desktop 或 WorkBuddy 连接到同一台电脑上的 Beav。宿主 Agent 可以直接检索资料、读写内容并使用创作工具，也可以选择把工作交给 Beav 内部 Agent。直接数据和工具访问需要更新后的 Beav 宿主与 0.2.0 或更新版本的插件；以连接后实际发现的工具为准。

## 一句话安装

把下面的内容发送给 Codex Desktop：

```text
/goal Read https://www.getbeav.com/agent to install the Beav Creator plugin and set up a new task for me.
```

Codex 会读取官网机器指南，先检查本机是否安装 Beav，再定位桌面应用内置的 Codex CLI。若 Beav 未安装，它会提醒你先安装桌面版；准备命令受沙箱限制时，它会给出普通终端中的恢复命令。随后 Codex 安装并回读插件，创建新任务验证 MCP 连接。

或者把下面的内容发送给 WorkBuddy：

```text
Read https://www.getbeav.com/workbuddy to install the Beav Creator plugin and connect it to my local Beav workspace.
```

WorkBuddy 会定位自己内置的 CodeBuddy CLI，并给出 Beav 启动和准备命令；你在 WorkBuddy 外的普通终端依次运行，只将准备命令返回的插件市场路径交给它。桌面版 Beav 已内置这些命令，无需另装 CLI。随后 WorkBuddy 校验并安装插件、热加载，再用 `creator_status`、`creator_capabilities` 和 `workspace_list` 验证 MCP，存在当前空间时再执行一次只读数据访问。

## 两条通道

* Agent 控制通道：Codex 或 WorkBuddy 通过 Beav Creator MCP 直接操作数据和工具，或给 Beav Agent 发消息。
* 用户工作台通道：用户通过 localhost 浏览器 UI 登录、查看、审批和编辑。

宿主 Agent 不点击网页、不读取 DOM，也不根据截图判断任务完成。工具回执说明操作状态；需要保存内容时，读取实际资源引用核对结果，再根据用户要求判断是否完成。普通对话不要求生成文件。

完整步骤见[连接 Codex Desktop 与 WorkBuddy](https://www.getbeav.com/docs/agent/connect)。