集成与连接器
使用 Agent 连接器
连接一台电脑，并在创建 Agent 时将它选为运行设备。
Agent 连接器可以把你的电脑接入 Buda。创建 Agent 时选择这台电脑，Agent 就可以使用它执行代码、终端、文件和 Git 操作；电脑上安装了 Chrome、Chromium 或 Microsoft Edge 时，也可以使用浏览器功能。
使用前准备
- 在要连接的电脑上安装 Node.js 24.18 或更高版本。
- 确保电脑可以访问
https://buda.im。 - 在 Agent 使用期间保持电脑和 Connector 进程运行。
添加 Connector
打开需要使用 Connector 的 Space，进入 设置 → Agent 连接器。
点击 添加连接器。如果页面提示尚未生成安装命令，先点击 生成 token。
点击 复制，复制页面显示的完整安装命令。
在要连接的电脑上打开终端，粘贴并运行这条命令。不要关闭正在运行 Connector 的终端进程。
回到 Buda 等待连接。页面会先显示 已发现设备，连接完成后显示 连接器已就绪。
点击 在此设备上新建智能体。也可以关闭弹窗后再新建 Agent，在 运行时 中选择 本机模式 / 远程主机，然后选择刚连接的设备。
创建完成后，像平常一样与 Agent 对话即可。只要 Connector 保持在线，该 Agent 就会使用所选电脑完成任务。
重新连接离线设备
- 进入 设置 → Agent 连接器。
- 在离线设备右侧点击 连接设备。
- 复制弹窗中的命令，并在原电脑的终端中运行。
- 等待页面显示 连接器已就绪，关联的 Agent 即可继续使用这台电脑。
常见问题
- 复制命令后一直等待：确认已经在目标电脑的终端中运行命令，而不只是完成复制。
- 已发现设备，但没有就绪：保持终端进程运行，并检查电脑的网络连接。
- 设备显示离线：电脑可能已休眠、网络已断开，或 Connector 进程已退出。恢复电脑后重新运行连接命令。
- Agent 无法使用浏览器：在目标电脑安装 Chrome、Chromium 或 Microsoft Edge，然后重新启动 Connector。