集成与连接器
智能体连接器
在你自己的机器上运行 Buda 智能体——用一条命令把一台主机注册到空间，并从仪表盘查看它的状态。
有时候，工作必须在你自己的机器上完成。 本地文件、只有你的笔记本才能访问的某个工具、需要你本地环境才能跑的构建——连接器会把你自己的一台机器注册到某个空间，让 Buda 智能体可以在那里运行任务，同时你仍能从云端仪表盘查看状态和心跳。
连接器是什么
连接器是一个小型守护进程（daemon），运行在你掌控的机器上。注册之后，它会以固定的心跳向 Buda Cloud 回报，并出现在当前空间的 设置 → 连接器 中。每个连接器都是空间级的——它绑定到你安装它时所在的空间，而非某个单独用户，因此该空间中的任何人都能看到它。
安装连接器
打开你想让机器加入的空间的 设置 → 连接器，点击 生成脚本。
复制命令。 它看起来像下面这样，其中已填入你的空间 ID：
npx -y @buda-ai/connector@latest daemon --space-id <your-space-id>在你想让 Buda 智能体使用的机器上，在终端中运行它。 守护进程会把这台主机注册到空间，并开始发送心跳。
确认它已出现。 该连接器会出现在列表中，显示其设备名称、平台，以及一个 在线 标记。
这种简易模式标识的是空间，而非某个单独用户。Buda Desktop 则改用 OAuth 令牌模式来注册连接器。
在线、滞后、离线
每张连接器卡片都会根据其最近一次心跳显示实时状态：
- 在线 —— 最近约 30 秒内有过心跳。机器已就绪，可以接受任务。
- 滞后 —— 约 30 秒到 2 分钟内没有心跳。很可能是短暂的网络抖动或进程被暂停。
- 离线 —— 超过 2 分钟没有心跳，或守护进程已被停止。
另有一个独立的 Relay 标记，用于显示该连接器当前是否持有一条回到 Buda Cloud 的实时链路。页面顶部的汇总卡片会统计整个空间的总数。
排查问题
- 始终不出现 —— 检查终端是否有报错，并确认机器能向
https://buda.im发起出站访问。 - 卡在「滞后」 —— 进程在运行，但心跳被延迟了；检查网络，然后点击 刷新。
- 显示「离线」 —— 守护进程已停止。重新运行安装命令即可让它恢复。
- 空间不对 —— 从正确的空间生成脚本；命令中的
--space-id决定了主机注册到哪里。