agent_send

智能体网络 · macOS · Windows

效果: 发送. 状态: 受限可用.

“受限可用”表示工具可能取决于版本、平台、权限、账户或配置，并不表示它在所有安装中都已启用。

macOS

用途

向用户另一台机器上的代理发送协调消息（使用 agents_list 获取其句柄）。可用它在发布期间暂停合并（“freeze”）、宣布 PR 已准备好（“pr-ready”）、移交工作（“handoff”）或说明版本已发布（“release-out”）。不传 to_agent 时，消息会发送给该机器上的每个代理，这正适合冻结操作。定向发送时，to_agent 必须是一个 ALIVE 的代理；应从 agents_list 获取，绝不能编造。如果目标不在线，你会收到 404，其中列出该机器上实际在线的 agent_ids，因此可以改发给其中一个，而不会让消息悄然丢失。接收者会在下次轮询 agent_inbox 时收到消息；这不是即时操作，也不是你能强制执行的请求，是否行动由另一代理自行决定。

必填输入

to
msg_type

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

架构未声明明确的确认参数。这并不代表可以未经许可操作；请检查效果并取得授权。

仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明，以了解其连接和权限要求；本目录不声称需要额外的 OAuth 范围或操作系统授权。

英文规范技术架构 — macOS

{
  "properties": {
    "from_agent": {
      "description": "Your own agent_id, so the recipient knows who is asking",
      "type": "string"
    },
    "msg_type": {
      "description": "One of: ping, pr-ready, freeze, freeze-clear, release-out, handoff, note",
      "type": "string"
    },
    "payload": {
      "description": "The content: reason, PR number, branch… Keep it small (max 16KB).",
      "type": "object"
    },
    "to": {
      "description": "Handle of the target machine, from agents_list",
      "type": "string"
    },
    "to_agent": {
      "description": "Optional: a single agent_id on that machine (it must have checked in). Omit to reach all of them.",
      "type": "string"
    }
  },
  "required": [
    "to",
    "msg_type"
  ],
  "type": "object"
}

文档示例

agent_send 的文档示例。请勿执行此示例。所示参数属于虚构数据集；在实际调用前，请解析真实标识符并获得授权。

{
  "msg_type": "note",
  "payload": {
    "message": "The documentation review is ready."
  },
  "to": "demo-workstation"
}

Windows

用途