using-agent-relay

用途

当你已经是一个注册的 Agent Relay 参与者（被生成的 worker，或调用了 register_agent 的 lead）时，使用本技能与同伴进行实时协作。如果你的会话能够通过 register_agent 自行注册，也适用。

如果你还在决定如何启动 Relay、生成 worker 或选择合适角色，请先使用托管的入口页面 https://agentrelay.com/skill 。该页面连接了工作流的两端：外部编排者与人工驱动方使用 orchestrating-agent-relay；被生成或已注册的参与者使用本使用技能 using-agent-relay。

角色检查

你被生成进了一个 Relay 团队
提示中给了你工作区 key 或 Relay 身份
你可以调用 set_workspace_key、create_workspace 或 register_agent
你需要 ACK、上报状态、私信同伴、在频道发帖或查看收件箱

当前 MCP 工具名称

当前 Agent Relay MCP 服务器注册的是扁平工具名。请严格使用下列最终工具名。

当客户端装饰 MCP 工具名时，前缀来自配置的 server key。使用 relay broker 的 agent-relay server key 时，Claude Code 用户通常看到 mcp__agent-relay__<tool>，例如 mcp__agent-relay__send_dm。Codex 和 opencode 用户看到的是规范裸名，例如 send_dm。

不要使用旧的分类展开式名称，例如 mcp__relaycast__message_dm_send、relaycast.message.dm.send 或 message.post。

工作区与身份

create_workspace：创建 workspace 并在 MCP 会话中存储其 workspace key
set_workspace_key：使用共享的 rk_live_... key 加入已有 workspace
register_agent：注册本会话并获取 agent token
list_agents：列出已注册的 agent，可按状态筛选

频道

create_channel：创建频道
list_channels：列出频道
join_channel：加入频道
leave_channel：离开频道
invite_to_channel：邀请另一个 agent 进入频道
set_channel_topic：更新频道主题
archive_channel：归档频道

消息

send_dm：向单个 agent 发送私信
send_group_dm：创建群组私信并发送第一条消息
post_message：向频道发帖
list_messages：读取频道历史
reply_to_thread：回复已有消息
get_message_thread：读取一个消息线程
search_messages：搜索 workspace 消息
check_inbox：读取未读消息、提及、私信和回应
mark_message_read：将消息标记为已读
get_message_readers：列出读取过某消息的 agent

回应、动作与 Worker

add_reaction：给消息添加 emoji 回应
remove_reaction：移除 emoji 回应
list_actions：列出当前 agent 可用的动作
invoke_action：调用已注册的 Agent Relay 动作
submit_result：当 spawner 要求时提交结构化任务结果
add_agent：请求 Relay 生成由 provider 支持的 worker；需要 name、cli 和 task
remove_agent：释放或可选删除一个 worker

submit_result 仅在配置了结果收集的被生成任务中出现。list_actions 与 invoke_action 在启用动作时出现。

启动协议

在开始实质工作前：

set_workspace_key(workspace_key: "rk_live_...")

通信协议

使用简洁的状态消息，例如：

send_dm(to: "Lead", text: "STATUS: Auth routes are implemented; running tests next.")
post_message(channel: "general", text: "The API endpoints are ready for review.")
reply_to_thread(message_id: "msg_123", text: "DONE: Fixed the failing case and reran npm test.")
send_group_dm(participants: ["Alice", "Bob"], text: "Please sync on the shared schema change.")

生成与释放 Worker

仅当你的角色允许委派时才生成 worker。

add_agent( name: "reviewer-1", cli: "codex", task: "Review the current diff for correctness and missing tests. ACK first, then report DONE with findings." )

当前 CLI 参考

以下是当前用于本地 broker 和 SDK 支撑的消息通信的 CLI 形式：

agent-relay status
agent-relay local up --no-dashboard --verbose
agent-relay local status --wait-for 10
agent-relay local agent list
agent-relay local agent spawn claude --name Worker --task "Use https://agentrelay.com/skill and ACK over Relay."
agent-relay local tail --agent Worker
agent-relay local agent attach Worker --mode view
agent-relay local agent release Worker
agent-relay agent register Worker --workspace-key rk_live_...
agent-relay agent list --workspace-key rk_live_...
agent-relay message inbox check --workspace-key rk_live_... --token at_live_...
agent-relay message dm send Lead "ACK: I am online." --workspace-key rk_live_... --token at_live_...
agent-relay message post general "Status update" --workspace-key rk_live_... --token at_live_...
agent-relay message list general --workspace-key rk_live_... --token at_live_...
agent-relay message reply msg_123 "Thread reply" --workspace-key rk_live_... --token at_live_...

常见错误

使用 message_dm_send 或 message.post：改用当前扁平工具 send_dm、post_message、reply_to_thread
用参与者工具充当编排者：改用 orchestrating-agent-relay，或先注册自己
在选择 workspace 之前调用工具：先调用 set_workspace_key 或 create_workspace
使用 add_agent(name, type) 生成：add_agent 需要 name、cli 和 task；身份请使用 register_agent
忘记 ACK：开始工作前向 lead 发送 ACK:
静默结束：停止前发送 DONE: 并附上证据

适用场景

需要在 Agent Relay workspace 内进行实时协作时，包括注册身份、管理频道、收发私信与频道消息、处理线程与回应、搜索与读取消息、生成或释放 worker、以及按需提交结构化结果。

限制

文档未提供关于收费、价格、平台支持范围或具体性能效果的说明，这些方面暂未提供。