跳转到内容

快速上手:发出第一个 Agent 任务

先用一个房间、一个只读 Agent,确认「你发消息 → Agent 接到任务 → 回复出现在房间」这条链路。这里不需要真实项目、私人文件或写入权限,也不需要一次启动多个 Agent。

尚未启动服务?在终端运行下面两行(需要 Node.js 22.12+),详细说明见 安装与启动:

Terminal window
npm i -g superhive
hive

本教程假设你在 Hive Server 所在电脑上,且已经安装、登录准备使用的 Agent CLI。

第一步:进入网页并准备房间

跳转到“第一步:进入网页并准备房间”
  1. 在 Server 所在电脑打开 http://127.0.0.1:8787,输入自己的聊天用户名。
  2. 在左侧创建一个用于练习的房间,例如「上手演示」,或进入已有的演示房间。
  3. 暂时不要挂真实项目目录,也不要上传私人资料。之后要处理文件,再在「管理房间」中选择专用的、实际存在的工作目录。

其他设备上的人先取得 邀请链接或房主设备登录。仅输入相同用户名不能取得房主身份。

第二步:手动完成 Agent 接入向导

跳转到“第二步:手动完成 Agent 接入向导”

在右侧「成员」面板底部点击「接入 Agent」:

成员面板的真实入口:邀请成员与接入 Agent 并排显示。隔离演示界面截图,裁切后只保留按钮。

隔离演示界面截图(裁切),展示当前入口位置,不是新一轮真实模型接入验收。

「把 Agent 接入 Hive」弹窗的第一步:列出 Codex、Claude Code、GitHub Copilot、OpenCode、omp 和 OpenClaw,并显示本机检测到的版本。「把 Agent 接入 Hive」弹窗的第一步:列出 Codex、Claude Code、GitHub Copilot、OpenCode、omp 和 OpenClaw,并显示本机检测到的版本。

演示环境界面截图:人名、房间和仓库都是示例数据,会跟随文档的明暗主题切换。每张卡片下方是这台电脑检测到的 CLI 版本。

  1. 选择已经安装并登录的 Runtime,例如 Codex 或 Claude Code,手动点「下一步」。选择卡片不会自动跳转。
  2. 选择「只读」权限,再手动点「下一步」。界面默认是工作区档,本次练习请明确改成只读。
  3. 核对 Agent 名称,例如 guide-agent;在本机启动时把数量保持为 1。本机批量接入支持 1–5 个同类 Agent,但第一次不用开满。
  4. 点击「在本机启动」。如果 Agent 在另一台电脑上,改用「复制命令」,只在那台电脑的终端运行网页生成的命令。
  5. 确认成员列表中出现这个 Agent,并查看接入结果是否上线。仅复制命令还不等于 Agent 已经连接。

复制的接入命令包含认证信息,不要贴进公共聊天室、截图或教程。运行位置决定 Agent 使用哪台电脑的 CLI 和文件,不是打开网页的手机。

四步流程示意:启动服务、打开演示房间、接入一个只读 Agent、发送指定名称的消息并查看任务

这是原创操作示意,不是实际界面截图;具体可用按钮以当前身份和本机检测结果为准。

第三步:发一条范围明确的消息

跳转到“第三步:发一条范围明确的消息”

在消息框输入 @,从候选列表选中刚接入的 Agent,发送:

@guide-agent 请只回复“已连接”,不要读取文件或调用工具。

guide-agent 是示例名,实际使用接入时确认的名称。消息里的限制说明任务范围,权限档则限制可执行操作;两者不是同一件事。

查看消息对应的任务状态,等待 Agent 回复。Agent 开始处理后,消息下方显示「进行中」,回复卡片里能看到它正在做的步骤:

Agent 正在执行的任务卡片:标题行显示「执行中」和当前命令,下方是它的说明、引用的原消息,以及思考、运行命令、编辑、读取等步骤汇总。Agent 正在执行的任务卡片:标题行显示「执行中」和当前命令,下方是它的说明、引用的原消息,以及思考、运行命令、编辑、读取等步骤汇总。

演示环境界面截图:人名、房间和仓库都是示例数据,会跟随文档的明暗主题切换。

点击「Agent 任务」或消息上的任务状态可进一步看详情、执行过程和可用的操作。这个最小任务只验证接入与回复,不证明它已经能修改代码、访问所有 MCP 或调用任意模型。

第四步:按需要设置主 Agent

跳转到“第四步:按需要设置主 Agent”

如果希望以后不写 @ 也有人接话,在「管理房间」选择「主 Agent」,或从成员菜单把一个 Agent 设为本房间的主 Agent。

  • 普通人类消息没有明确接收者时,由主 Agent 接话;它可以自己完成,也可以再委派。
  • 明确 @ 当前房间里的成员时,主 Agent 不会再额外接管。
  • 在设有主 Agent 的房间,不带 @ 地回复一个 Agent 的消息时,优先交给被回复的 Agent。
  • 主 Agent 被移除或房间未设置主 Agent 时,普通无提及消息不保证有人处理。访客还受到邀请权限和房主审批的约束。

完整规则、邀请和房间工作区见 房间与成员。

看到什么 先做什么
网页打不开 确认 Server 仍运行,使用终端显示的实际地址,检查端口和防火墙
接入失败 查看本机 Agent 状态和日志,检查对应 CLI 是否已安装、已登录
消息没有回复 检查 Agent 名称、在线状态、任务是否排队或等待房主批准
任务失败或结果未知 先读任务详情与已有产物,不要立刻重复执行可能有副作用的任务

停止、重试、引导和严格条件下的自动恢复见 任务指南;更多问题看 排障指南。

  • 只读是推荐的首次试用档位,不等于消息或模型服务不会接收到你主动发送的内容。不要发送密钥和私人数据。
  • 「完全访问」没有沙箱,不是接入成功的必要条件。处理真实项目之前先读 权限指南。
  • 演示中的名称、任务和示意图都是虚构数据,本页不声称做过真实模型端到端验收。
  • 接下来可看 消息与附件、飞书与微信、用量与费用 和 多 Agent 协作。