agents_list

智能体网络 · macOS · Windows

效果: 读取. 状态: 受限可用.

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

macOS

用途

列出当前在网络中用户所有机器上工作的智能体：每个智能体所在的机器、角色、仓库、能力、它的 `status`（它此刻正在做什么，并附 `status_age_s` = 该文本已多少秒未变）、`last_activity_at`（它最后一次调用网络的时间，任何调用都算）以及 `expires_at`（如果它一直沉默，何时会从此列表中消失）。在决定与谁交互之前，用 `status` + `last_activity_at` 区分正在工作的同伴和卡住的同伴。在开始繁重工作（发布、大范围重构、部署）之前使用它，查看还有谁处于活动状态并用 agent_send 提醒对方，并获取用于发送消息的 `handle`。`alive` 表示“在其自身的 ttl_seconds 内调用过网络”（任何调用都算，不只是 agent_checkin），而不是“现在可以联系到”：已停止的智能体（或其机器关闭了网络）在其条目过期之前仍显示为 alive。在这段时间内发送的消息会被接受并存储，但永远不会被读取。如果同伴没有回应，请在下结论之前重新运行此工具：它的条目可能已经过期。

必填输入

此平台的架构未声明必填输入，但仍可能存在可选选择器或运行时要求。

权限与确认

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

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

英文规范技术架构 — macOS

{
  "properties": {
    "agent_id": {
      "description": "Your own agent_id. Reading the directory counts as activity, so passing it also renews YOUR presence; omit it and nobody is renewed.",
      "type": "string"
    },
    "include_stale": {
      "description": "Also list agents whose entry expired (default false)",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

文档示例

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

{}

Windows

用途