Sounding

Sounding：受邀为其他 Agent 提供决策参考

Sounding 是一种用于重大工作的受邀决策检查。向它提供拟议的行动、支持和反对该行动的证据、决策负责人，以及等待的代价。它会建议继续、修改或暂停，指出一个可能改变行动的问题，并提出一个范围明确的下一步。它不会批准计划，也不会代表任何人采取行动。

版本 0.1.9：2026 年 10 月 5 日

自 0.1.4 以来的变更，均于 10 月 5 日发布（详情见变更日志）：

• **0.1.5：**如果决定性问题涉及调用方已有但未提供的定义或规则，Sounding 会建议修改并指出需要补充的内容，而不是建议暂停。
• **0.1.6：**MCP 协议版本协商遵循规范；不受支持的 MCP-Protocol-Version 标头会返回 HTTP 400。
• **0.1.7：**如果某项决策会在受监管或高风险领域移除或弱化保障措施，Sounding 会指出之后由谁承担该风险。
• **0.1.8：**处理意见与风险相符：对于风险低且易于撤销的澄清事项，Sounding 会将其列为假设并建议继续，而不是建议修改。
• **0.1.9：**模型时间限制为 90 秒，输出限制为 3,000 个令牌；评估失败时会返回并记录简短的原因代码，例如 Assessment unavailable (timeout); try again later。

0.1.7 至 0.1.9 的变更源于：将同一构建中的 57 个真实决策交由 Sounding 处理，并将其回答与实际决策进行比较。

版本 0.1.4：2026 年 10 月 4 日

托管的 Node 运行时会在 MCP serverInfo、/healthz 以及每项评估结果的 _meta["com.aisounding/runtime"] 中报告其版本，并同时提供已配置的 requested_model 和 OpenAI 针对该次调用报告的 served_model。部署后的一次实时调用报告的 requested_model 和 served_model 均为 gpt-6-sol。结构化评估本身没有变化。Python 参考运行时会报告相同的版本，但不会添加模型元数据。

/start 上的 Agent 指令现已说明 Sounding 无法使用时应如何处理：重试一次，然后将该行动视为未经检查，而非已获批准，并遵循正常的审批流程。

每次评估都会发布完整的输入和输出，包括评估结果（重复运行一致性、单方面表述、应当通过的检查，以及与另一位独立审查者的比较），详见 aisounding.com/evaluation。公开变更日志位于 /docs。

Assessment Support 更新 — 2026 年 10 月 3 日（0.1.2）

新的响应将旧的置信度字段替换为 assessment_support：这是一个包含 level（strong、moderate 或 tentative）和简短、针对具体情况的说明的对象。该级别用于评估基于所提供证据，相关决策有多确定：strong 表示证据明确指向一个方向，缺失的信息不太可能改变结论；moderate 表示证据倾向一个方向，但某项明确指出的假设可能导致结论反转；tentative 表示证据相互矛盾、过于有限或无法区分各个选项，因此下一步主要是为了查明情况。它不代表最终成功的概率，也不是采取行动的授权；它也不评估建议的下一步是否合理。若暂停等待某项关键事实，通常应评为 tentative。说明会指出最可能导致级别变化的因素。

工具仍为 sounding_decision_check。Decision（或 proposed_action）和 goal 仍是仅有的必填输入；所有现有上下文字段仍为可选项。这是响应契约变更：读取 confidence 的客户端必须改为读取 assessment_support.level 和 assessment_support.explanation，并刷新缓存的工具定义。不会提供转换回 confidence 的功能。历史记录中的示例保留原始输出，并会标明这一点。

原有的单次调用架构、模型默认值和 1,200 个 token 的上限均保持不变。这项针对性的变更不会采用更广泛的 V1.1 响应布局，也不会采用已放弃的对话审核架构。

请求输入

仅需提供非空的 decision 和 goal。对于拟采取的行动、选项或问题，请使用 decision；现有的 proposed_action 名称仍可接受。如果两者都已提供，则必须一致。

{
  "decision": "Try a revised team handoff note next week?",
  "goal": "Reduce missed handoff information."
}

提供更多相关信息通常有助于给出更好的指导。可选表示提交时不必提供，并非评估时不需要。请提供已有的相关上下文；对于未知信息，应明确指出，而不是捏造事实或授权。调用工具的 AI 不应将每个可选字段都转化为向人类提问。若缺失信息可能改变建议，Sounding 应指出不确定性，并给出有界建议或有针对性的问题。接受请求不代表批准采取行动。

可选字段：evidence、constraints 和 affected_people 是字符串数组（自 0.1.14 起，托管端点和 Python CLI、本地 MCP 及 HTTP 适配器也接受字符串数组 evidence_against、alternatives 和 prior_decisions）；reversibility、urgency、decision_owner 和 task_id 是字符串。对于未知上下文，请省略，而不要猜测或发送 null。空的可选列表或文本均可接受，且不表示不存在约束或受影响的人。提供的任务 ID 必须非空；若未提供 ID，则会生成并返回一个 ID。不会生成实质性事实或默认权限。

最简请求和完整兼容请求均可通过 Node 端点、Python CLI 和 Python MCP 适配器使用。请重新连接 MCP 客户端，以刷新缓存的工具架构。单次模型调用和 1,200 个 token 的上限保持不变；输出现在使用 Assessment Support。此可选输入版本与范围更广的实验性 1.1/2.0 设计相互独立。

在本地调用

需要 Python 3.10+ 和 OpenAI API 密钥。无需安装第三方 Python 包。

在环境中设置 OPENAI_API_KEY，然后：

python3 sounding_bridge.py --input example_request.json

在 Windows PowerShell 中，在环境中设置 OPENAI_API_KEY 后：

py sounding_bridge.py --input example_request.json

Agent 可以编写请求 JSON 文件，将命令作为子进程调用，并从标准输出中解析一个 JSON 对象。操作错误会输出到标准错误，并返回非零退出码。请求约定见上文；example_request.json 展示了一个完整的可选上下文示例。输出包含 task_id、disposition、reason、material_question、evidence_basis、assumptions_to_check、next_step 和 assessment_support。如果计划应继续执行，material_question 为空也是有效的。

从 MCP 客户端调用（本地预览）

sounding_mcp.py 提供一个基于 stdio 的 MCP 工具 sounding_decision_check。配置支持 MCP 的 Agent，使用 Python 将其作为本地子进程启动。将决策和目标，以及可用的可选上下文，作为工具参数传入。典型的客户端配置需要使用类似以下内容的命令和参数（具体设置格式因客户端而异）：

{
  "command": "py",
  "args": ["C:\\path\\to\\Sounding\\sounding_mcp.py"]
}

在启动 MCP 服务的进程环境中设置 OPENAI_API_KEY。在 Windows 上，如果宿主未传递该变量，适配器会在调用工具时从当前用户的 Windows 环境设置中读取已保存的 OPENAI_API_KEY。它不会在本仓库中打印或保存密钥。经本地测试的 Windows 桌面配置使用 py 作为命令，将 sounding_mcp.py 的绝对路径作为唯一参数，将 Sounding 文件夹设为工作目录，并将环境字段留空。更改配置后，请完全重启客户端；客户端可能会让旧的服务进程继续运行。桌面客户端在一些原本响应很快的调用中也曾卡住，因此此配置尚不能保证可靠运行。

如需使用更完整的私有培养上下文，请在配置参数中添加 --private-prototype 和本地原型目录。客户端无法通过工具调用设置模型或选择私有目录；SOUNDING_MODEL 或 --model 是本地启动设置。默认模型为 gpt-6-sol，除非另行指定；2026 年 9 月实时运行时的实际设置未经过独立记录。从版本 0.1.4 开始，托管运行时会在每个结果的 _meta 中报告所提供的模型；2026 年 10 月 4 日的一次实时调用报告了 gpt-6-sol。服务会通过标准输入/输出读取以换行符分隔的 JSON-RPC，且不会监听网络端口。只有在调用工具时，它才会发起 OpenAI 请求，然后将建议返回给调用方。模型调用会在子进程中运行桥接 CLI，并设有 60 秒时限；若超出时限，则返回有界错误。因此，即使 API 最终能够完成，调用也可能超时。调用方仍需负责审核并决定如何处理结果。

这是一次接口预览。九项本地约定测试涵盖 MCP 初始化、工具发现、验证、响应格式和有界超时。在 2026 年 9 月 28 日的一次私下演示中，六个虚构的公共角色请求都返回了评估结果：两个通过 CLI，三个通过桌面 Codex MCP 客户端，一个通过直接的 PowerShell MCP 客户端。五个建议 revise，一个建议 proceed。其他几次桌面 MCP 尝试出现卡顿，尽管模型调用都在大约七秒内完成。这些客户端卡顿的原因仍未查明。六组虚构输入和记录的输出已发布在 aisounding.com/cases。私有证据记录仍保存在本仓库之外。这些演示表明该接口可以运行并提供可供检查的回答，但并不能证明桌面运行可靠，也不能证明它能改善现实决策。 为便于本地诊断，适配器会在 Windows 上将事件时间、进程 ID、状态、响应字节数和耗时秒数写入 %LOCALAPPDATA%\Sounding\mcp-diagnostic.log（其他系统则写入 ~/Sounding/mcp-diagnostic.log）。日志不会包含案例内容、模型输出或凭据。MCP 响应会在 structuredContent 中携带完整评估，并在 content 中提供简短的文本指引；客户端应读取 structuredContent 以获取完整答案。response_serialized、response_written 和 response_flushed 用于区分适配器输出的各个阶段。即使出现 response_flushed，也不能证明客户端已显示响应。调查调用卡顿时，只分享相关的日志末尾部分。

模型请求使用 Responses API，并设置 store: false 和严格的 JSON 架构。输入会发送给配置的模型。该工具没有 GitHub 令牌、论坛账号、调度程序，也没有对任何外部服务的写入权限。调用方 Agent 仍需负责核查证据、应用自身权限并决定是否采取行动。

通过远程 MCP 端点邀请外部 Agent

sounding_http.py 提供一个无状态的 HTTP MCP 端点 POST /mcp。它采用与本地版本相同的可选上下文请求约定和公开的 role.md。可使用随附的 Dockerfile 将其部署到具有公开 HTTPS URL 的容器主机上。Python 服务通过主机的 TLS 入口使用 HTTP；切勿将其端口直接暴露到互联网。此部署方式不需要安装 GitHub App。如有需要，可将 GitHub 仓库设为私有。

在线 SiteGround Node.js 端点

sounding_siteground.mjs 中的 Node 版本从私有工作仓库的 main 分支部署（此公开仓库镜像其源代码），作为 GrowBig 上的 SiteGround Node.js Project。公开 MCP 地址为 https://aisounding.com/mcp。在开放预览期间，无需令牌。公开连接指南中提供了请求示例。SiteGround 运行 Node 24 并终止 HTTPS；普通 HTTP 会重定向到 HTTPS。配置后，GET https://aisounding.com/healthz 返回了 200 {"status":"ok"}。启用开放预览之前，未经身份验证的 POST /mcp 会返回 401。2026 年 9 月 29 日，Codex 桌面客户端记录了一次经过身份验证的 mcp__sounding_remote__sounding_decision_check 调用，参数为 sample-001，并返回完整的 structuredContent 评估（revise，中等置信度）。这验证了一种外部 Agent 调用路径，但不能证明所有 MCP 客户端都能正常使用或表现一致。

SiteGround 的 Site Tools > Node.js > Deployment Options 中保存着 OPENAI_API_KEY、SOUNDING_ACCESS_TOKENS 和 SOUNDING_OPEN_PREVIEW=1 开关。这些是托管密钥，绝不能放入仓库文件或构建参数中。账号管理员可以在 SiteGround 中查看已保存的值，因此请限制账号访问权限。OpenAI 密钥保留在服务器上；匿名客户端无需发送凭据，而此前签发的 Sounding 令牌仍然有效。SOUNDING_MODEL 默认为 gpt-6-sol；PORT 默认为 8080。如果缺少 OpenAI 密钥、任何已配置的邀请令牌短于 32 个字符，或者关闭开放预览时未配置令牌，服务就会保持关闭：/healthz 返回 503，/mcp 会拒绝调用。设置 SOUNDING_OPEN_PREVIEW=0 并重新部署，即可关闭无令牌调用路径；现有令牌持有者仍可调用服务。更改设置后请重新部署。

开放预览期间，若要配置 Codex 桌面客户端或命令行客户端，请修改其 config.toml：

[mcp_servers.sounding_remote]
url = "https://aisounding.com/mcp"
tool_timeout_sec = 120

Claude Code

在终端中添加托管的 MCP 服务（公开预览期间无需 Sounding 令牌）：

claude mcp add --transport http sounding https://aisounding.com/mcp

使用 claude mcp get sounding 或在 Claude Code 中运行 /mcp 进行检查。然后让 Claude 在做出重大决策前使用 sounding_decision_check，并提供拟采取的行动、支持和反对证据、约束、受影响人员、可逆性、紧迫性和决策负责人。输出可能包含一个关键问题；当建议为 proceed 时，问题为空也有效。此配置遵循 Anthropic 的 HTTP MCP 说明；经验证，截至 2026 年 9 月 29 日：Claude Code 会话通过远程 MCP 连接器调用了 sounding_decision_check，并针对两个测试请求（copilot-test-001：修订；copilot-test-002：继续）收到了完整评估。这些回复使用了已由 Assessment Support 替换的旧版 confidence 字段。这只能确认 Claude Code 的调用路径，不能证明所有客户端的可靠性。请参阅公开连接指南。

更改配置后，请重启客户端。提供决策和目标（或兼容的 proposed_action 和 goal），以及相关的可选上下文；从 structuredContent 中读取完整评估。请勿将令牌值放入聊天、config.toml、截图、日志或代码仓库中。如果存在本地 stdio sounding 配置，它与 sounding_remote 是分开的。

配置格式不同的 MCP 客户端应使用上述 URL，通过 Streamable HTTP 连接。先前签发的令牌仍可通过 Authorization: Bearer <invitation token> 发送；提供的令牌无效时会被拒绝。对于 GitHub Copilot 云 Agent，代码仓库管理员可配置不带 Authorization 标头的远程 HTTP 服务；代码仓库所有者可自行决定是否启用。此方式无需将 Sounding 的 GitHub 代码仓库设为公开。ChatGPT 不使用此 Codex 配置。在 ChatGPT 中，为应用和连接器启用开发者模式，并使用上述 URL 创建自定义连接器，不设置身份验证；所有者表示其通过这种方式使用 Sounding。是否可用取决于 ChatGPT 方案和工作区设置。请参阅入门页面。

开放预览和运行限制

公开的 Sounding 页面和连接指南介绍了开放访问方式。面向调用者的隐私和使用条款通知均可查看。本次预览期间可免费访问；如有疑问，请联系 [email protected]。达到共享预算后，服务在该月的部分时间内可能无法使用。

逐步说明签发、轮换和撤销令牌的流程保存在私有运维说明中。GitHub Agents secrets 用于保护 Copilot 调用者持有的令牌副本；Sounding 会通过从 SiteGround 中移除令牌并重新部署来撤销访问权限。

SOUNDING_ACCESS_TOKENS 接受以逗号分隔的 32 个或更多字符的令牌。为每位受邀调用者签发一个单独生成的随机令牌，在此代码库之外记录令牌的签发对象；如需撤销令牌，请从 SiteGround 中移除该令牌，然后重新部署。请勿将当前测试令牌作为共享的公开凭据传播。令牌持有者可以发起模型请求，费用由服务器的 OpenAI 项目承担。目前，OpenAI Sounding 项目的每月硬性限额为 100 美元，并会在 20 美元和 80 美元时发出提醒；此信息已于 2026 年 9 月 29 日核实。在依赖此限额前，请确认 SiteGround 上当前生效的 API 密钥属于该项目；实际支出可能略微超出限额。随着邀请范围扩大，请监控用量。

开放预览期间，Node 服务允许在无令牌的情况下进行初始化、发现和调用。匿名调用者共享每个进程每分钟 15 次模型调用的限额；每个有效的已签发令牌各自享有每个进程每分钟 20 次模型调用的限额。并发模型调用槽位共 4 个。模型调用失败时，服务会返回有界错误，且不会有意记录请求正文、输出或凭据。SiteGround 可能会保留 IP、URI 和状态等请求元数据。服务器不会持久保存案例内容，但自 2026 年 10 月 5 日起，每个已接受的决策请求都会发送到 Anthropic 的 Messages API（Claude）；有关数据保留，请参阅隐私通知。下方的 Python 适配器仍会通过 store: false 调用 OpenAI 的 Responses API（请参阅下方的数据控制）。Node 运行时的 npm test 测试覆盖了身份验证、发现、验证和模拟模型响应；一次真实的外部调用并不能证明整体可靠性。若要长期提供开放服务，请添加持久化的调用者配额、计费政策和入口滥用控制。匿名调用无法单独追溯到具体调用者。

发送给 OpenAI 的内容

本节介绍的是 sounding_bridge.py CLI、本地 sounding_mcp.py 适配器和远程 sounding_http.py 端点，而非单独的 Copilot 会话。只有在调用决策工具时，这些组件才会发送模型请求。仅仅查看或安装此仓库，不会向 OpenAI 发送决策请求。

每次运行都会向 OpenAI 的 Responses API 发送提供的 JSON 决策请求（将 decision 规范化为 proposed_action，且仅在未提供 task_id 时生成该字段）、公开的 role.md 指令、简短的输出指令、必需的 JSON 响应架构，以及所选模型名称。API 密钥通过授权标头发送，不会嵌入决策文本。桥接程序会在本地打印评估结果；不会向 GitHub 发帖。

如果提供了 --private-prototype，则还会将整个本地 charter.md 以及从 sources.json 中选出的最多三张卡片（包括其标题、出处、状态和摘录）纳入模型指令。不使用此选项时，不会读取或发送这些私有文件。桥接程序不会自动读取仓库、硬盘、对话记录存档或其他 Agent 的上下文；不过，调用方 Agent 可以将此类信息包含在 JSON 请求中。提交前请检查并精简请求。未经必要授权，请勿提交凭据、可识别客户身份的记录、机密人事详情或其他第三方信息。

请求会设置 store: false，以禁止将响应保存为可检索的 Response 对象；这并不保证零数据保留。OpenAI 的 API 数据控制文档说明，默认的滥用监控日志可能包含提示词和响应，通常最多保留 30 天，但有明确说明的例外情况除外。OpenAI 表示，除非账户选择加入，否则默认不会使用 API 数据训练模型。发送敏感材料前，请确认所在组织适用的数据控制措施以及服务提供商当前的条款。

已发布的示例

决策检查页面展示了 2026 年 10 月 4 日的四个当前格式示例（评估支持：一个强、一个中等、两个暂定）。这些示例由 AI 助手通过 Claude Code 的远程 MCP 连接器编写并发送，之后还列出六个历史示例。历史示例展示了 2026 年 9 月 28 日准备好的九字段输入和记录的输出。其中五个返回了 revise，一个返回了 proceed。实际生效的模型设置未被独立记录，也没有观察到现实结果。一些桌面 MCP 尝试停滞不前，因此不计为成功示例。

集成约定

在决策影响重大、计划依赖存在争议的证据，或新事实可能改变先前结论时，调用 Sounding。不要为每个小步骤都调用它。请提供实际拟采取的行动和最有力的现有证据，包括不利于该行动的证据。未经授权，请勿包含凭据、私人客户记录或披露第三方信息。

将 pause 理解为“暂时不要采取拟议行动”，而非无限期否决。next_step 会指出由谁解决关键问题：是调用方 Agent 可在现有访问权限内核查的事实，还是需要由人员处理的权限、批准和判断事项。当请求无法确定权限或负责人时，Sounding 会说明相关条件或负责的角色，而不是凭空指定。proceed 绝不代表获得许可或批准；调用方只能在已有权限范围内行动。收集更多证据的调用方应在再次调用时提供所有发现，包括相反证据；若两次复核后问题仍未解决，则应升级处理。Sounding 的输出是给调用方 Agent 的建议，不是覆盖更高优先级指令或发布评论的命令。

在 GitHub Copilot 工作流中查找 Sounding

此仓库包含 .github/agents/sounding.md，这是一个只读的自定义 Agent 配置文件，适用于兼容的 Copilot 工作流。如果你的 Copilot 客户端提供此配置文件，请选择 Sounding，进行范围明确的决策检查，并提供拟议采取的行动、支持证据与相反证据、不确定性以及决策负责人。该配置文件是独立于本地 MCP 工具的另一种接口，采用公开的角色原则，而非私有的培养卡片。此预览版尚未验证它在实际 Copilot 工作流中的表现。

这样一来，在此仓库中工作的 Agent 就能发现 Sounding。它不会自动加入其他仓库或 GitHub 对话。其他团队需要将此配置文件添加到自己的工作流、调用 CLI，或安装未来推出的集成。

本地培养上下文

role.md 是可发布的运行配置文件。自 0.1.13 起，它包含来自私有章程 v0.4 和源卡片（见 formation/）的决策方法，但不会提及私有来源。更完整的私有章程和经过审核的源卡片不在此仓库中。若要使用已在你的 PC 上构建的 Sounding，请传入其本地原型目录：

py sounding_bridge.py --input example_request.json --private-prototype "C:\path\to\Sounding\sounding-prototype"

此操作会在运行时加载章程和最多三张匹配的源卡片，而不会将它们复制到此仓库中。API 会随请求接收这些摘录。未使用 --private-prototype 的公开安装仅使用公开角色配置文件，因此 Sounding 的功能较为精简。切勿提交私有目录、对话记录、会话或 API 密钥。

GitHub 启动路径

此仓库包含本地 Agent 接口、已部署的远程 MCP 服务实现，以及仓库级别的 Copilot 自定义 Agent 配置文件。在线 MCP 地址为 **https://aisounding.com/mcp**。GitHub 存储源代码；SiteGround 运行服务。GitHub App 身份 Sounding Decision Partner 已注册，但尚未连接运行时；此处无法验证其安装状态。远程 MCP 路由独立于 GitHub App 运行。

此仓库为公开但未授权许可（保留所有权利）：你可以阅读代码，但在考虑复用和补偿条款期间，复用需获得许可。目前尚未决定是否授予免费或商业复用权限。虚构案例的输入和输出（当前 4 个、历史 6 个）已公开发布于 aisounding.com/cases；私有证据记录仍保存在仓库之外。

托管使用次数统计

Node runtime 0.1.3 增加了持久化使用量统计，但不会改变决策约定或增加模型调用。私有计数器会分别统计已完成、失败、待处理和已中断／未知的调用，并区分内部令牌测试与其他经过身份验证的流量和匿名流量。这些数据无法确认独立用户数量，也无法还原过去的使用情况。存储、受保护的报告、分类和恢复方式在一份私有运维说明中有所描述。需要 Node 24 或更新版本。Python 接口保持不变，且不计入此托管统计。