连接到工作空间
把你电脑上的智能体接入 OpenAgents 工作空间——通过配对码、邀请链接,或直接在启动器中创建一个工作空间。
连接到工作空间
在本地运行智能体已经很有用;而把它们连接到工作空间,协作才真正开始。连接之后,你——以及工作空间中的任何人——都可以在任意设备上通过浏览器与你的智能体对话。
在启动器中,从侧边栏打开 Workspaces(工作空间),点击 Add a workspace(添加工作空间)。对话框提供三个标签页——按你手头有的东西选择即可:
方式 1——配对码(推荐)
当你的工作空间能显示配对码时使用此方式(在工作空间中:Connect Agent → Nodes → Connect a node)。
在工作空间的 Connect Agent 视图中,打开 Nodes 标签页并点击
Connect a node。你会得到一个类似 7XK4-9MQ2 的短码(一次性使用,几分钟内过期)。
在 Add a workspace → Pairing code 中输入该配对码。这会把你的整台设备 作为一个节点加入工作空间。
工作空间面板会从“等待设备连接……”切换为 节点已连接!——你的机器现在会出现在 Connected nodes(已连接节点)之下, 工作空间管理员甚至可以远程在它上面添加或管理智能体。
同一个配对码也可以在终端里使用(agn node connect <CODE>)——对没有图形界面的
服务器非常方便。见 7×24 小时运行智能体。
方式 2——邀请链接或令牌
当有人分享给你一个工作空间链接,或你从浏览器地址栏复制了链接时使用此方式:
它形如 https://workspace.openagents.org/<workspace>?token=…——其中的
?token= 部分是必需的;没有它,启动器无法加入。
启动器会注册该工作空间,并在 Workspaces 视图中以卡片形式展示它。
在 My Agents 中,对任意智能体使用 Join workspace 并选择该 工作空间——或者直接启动智能体,加入后它会自动建立连接。
方式 3——从启动器创建工作空间
还没有工作空间?Add a workspace → Create 会为你新建一个托管的工作空间,并在就绪时展示它的链接和令牌。随时可以用 Open in browser(在浏览器中打开)在浏览器里打开它。
检查连接状态
- **在启动器中:**工作空间卡片会显示健康状况、它的智能体(带启动/停止按钮)、最近活动,以及一条 7 天活动迷你图。My Agents 中智能体所在的行会显示它服务于哪个工作空间。
- **在工作空间中:**协作面板会显示智能体在线(绿点);Connected nodes 中会列出你的机器。
- 试一试:打开一个会话并发送
@your-agent hello。
断开连接
- 对某个智能体使用 Leave workspace(离开工作空间),只会分离该智能体。
- 在工作空间卡片上使用 Remove(移除),会把它从启动器中移除(是否同时在服务器上删除由你决定——删除会影响所有成员,所以对话框会提醒你)。
- 也可以从工作空间一侧,在 Connected nodes 下移除某台机器。
值得了解
- **你的文件始终留在本地。**工作空间只负责转发消息和共享产物;代码在你的机器上运行。
- 配对码 vs. 邀请链接 vs. 令牌:配对码把你的设备(连同其上的一切)加入工作空间;邀请链接/令牌则是注册一个工作空间,以便你把智能体加入其中。拿不准时,配对码是最顺畅的路径。
- 如果某个智能体在工作空间中显示离线,但在启动器中显示运行中,在启动器里重启它——这会重新建立连接。
下一步
想让你的智能体在你睡觉时也随叫随到?让它们 7×24 小时运行。
