公开记录项

公开记录项

此处说明当前公开记录、证据路径和支持边界。

  • 记录 UAIX-DOC-1018
  • 小路 /zh-cn/guides/agentic-harnesses-uai/
  • 使用 规范公共记录

文件状态

公共标准页面 作为当前公共标准记录的一部分在 UAIX 上发布
代码
UAIX-DOC-1018
表面
公开记录项
使用权
公开且可链接

如何使用本页

此处说明当前公开记录、证据路径和支持边界。

公开记录项

标准定位UAI-1项目交接AI 记忆数据包向导

公开记录项

此处说明当前公开记录、证据路径和支持边界。

此处说明当前公开记录、证据路径和支持边界。

公开记录项

公开记录项

此处说明当前公开记录、证据路径和支持边界。

公开记录项

公开记录项

此处说明当前公开记录、证据路径和支持边界。

边界

公开记录项

此处说明当前公开记录、证据路径和支持边界。

公开记录项

标准定位公开记录项UAI-1当前公共交换契约。项目交接公开记录项AI 记忆数据包向导公开记录项一致性包公开记录项路线图此处说明当前公开记录、证据路径和支持边界。
公开记录项公开记录项
Agentic harnesses run work. UAI records only the reviewed, redacted, validator-ready evidence, eval summary, adoption signal, and project-memory handoff that must survive the run.

此处说明当前公开记录、证据路径和支持边界。

Agentic 运行外壳负责运行工作;UAI 记录可携带证据。 当团队需要把编排、工具、记忆、可观测性、策略和人工审批放到 UAI-1、AI 记忆 与项目交接周围时,请从这页开始。

什么是 agentic 运行外壳

运行外壳是模型和代理周围的软件层。它可以分配任务、调用工具、读取数据、协调代理、执行策略、收集审批、保存运行时记忆、观察追踪,并决定什么时候需要人工介入。

  • 执行:模型、工具、工作流、重试、中断和任务状态。
  • 连接:API、MCP 式工具/资源会话、本地适配器和数据访问策略。
  • 协调:运行时交接、A2A 式代理委派、任务板和审批检查点。
  • 记忆:短期运行状态、AI 记忆、项目交接 文件和冷 Wiki 档案。
  • 证据:追踪、决策、验证器结果、发布包、交接摘要和已删减的公开记录。

UAI 放在哪里

UAI 不应该和运行外壳竞争。UAI-1 是公开交换和证据契约,用来保存另一个团队、供应商、发布版本、审计者、客户或未来代理需要检查并带走的那部分运行结果。

外壳策略区域 外壳通常负责 UAI 应保存
规划和编排 任务拆分、模型选择、工具顺序、重试和中断行为。 经过审查的意图、任务状态、结果和面向发布的交接摘要。
工具和数据访问 MCP 会话、API 客户端、凭据、本地适配器和访问控制。 已删减的请求/结果证据、来源引用、出处和可验证载荷记录。
代理协作 A2A 式发现、委派、能力路由和运行时交接。 能力声明、任务状态快照、责任转移摘要和持久交换包。
记忆和上下文 运行时记忆、对话状态、向量存储和工具本地缓存策略。 AI 记忆 包、项目交接 文件、当前约束、决策、所有者、检查和提升规则。
可观测性和评估 追踪、指标、评估运行、审批事件和行为面板。 只保存复现、引用或审计公开记录所需的已审查、已删减标识和摘要。
策略和治理 护栏、人工审批门、数据控制和部署策略。 支持声明边界、验证器证据、一致性包材料和有日期的发布轨迹。

策略选择

  1. 保持 UAI 非运行时:让外壳执行工作,让 UAI 记录持久交换、证据和交接材料。
  2. 从一次证明运行开始:选择一个 UAI-1 profile、一个候选载荷、一个验证器结果和一个记录所有者。
  3. 追踪经过审查后才成为证据:追踪是有用原料,但公开记录只应包含已删减、被选择、可复现的事实。
  4. 用 AI 记忆 保存当前项目事实:项目交接 和类型化 .uai 文件保存已接受的约束、决策、进度和检查,而不是整段运行追踪。
  5. 桥接语言先保持计划状态:参考适配器、追踪导出、本地验证、删减校验、SDK、CLI 和一致性措辞在有公开样例和发布证据前不能变成支持声明。

下一步需要证明的桥接 profile

有价值的未来工作不是替代通用运行外壳,而是证明完成后的运行如何安全转成可携带 UAI 记录。

  • 追踪转 UAI 导出需要样例追踪、删减规则、fixture 载荷和验证器期望。
  • MCP 工具调用证据包需要工具请求/结果映射、能力引用、出处和安全过滤。
  • A2A 任务状态交接包需要能力声明、任务所有者、任务状态、委派边界和结果摘要样例。
  • 项目交接 写回当前是模式;自动化仍是计划工作。
  • 本地验证和删减校验需要秘密、私有数据、不支持声明和公开安全输出规则。

当前支持边界

  • 当前 UAIX 支持是已经发布的公开记录:UAI-1验证器一致性包AI 记忆项目交接API 参考 和已发布的实现轨道。
  • 本页是策略和采用指导。它不会创建运行外壳、托管导入器、调度器、SDK、CLI、官方适配器、认证、背书、合规项目、自动仓库写入、自动 LLM Wiki 同步,或为仓库本地交接文件创建 UAI-1 一致性声明。
  • 当 agentic 外壳工作需要成为公开证据时,先附上验证器输出、fixture 载荷、实现范围、发布说明和路线图状态。

不要这样声明

  • 不要声明 UAIX 运行代理、替代代理运行时,或拥有实时工具调用控制流。
  • 不要在公开 fixture、工具和发布证据存在前声明官方 MCP、A2A、OpenAI、供应商、SDK、CLI 或外壳适配器支持。
  • 不要把运行时追踪、私有面板、原始投放文件、旧报告或 AIWikis 冷记忆当成当前公开支持证据,除非已经审查并提升。
  • 不要把秘密、凭据、私有客户数据、特权操作、原始审批或未删减追踪放进可携带 UAI、AI 记忆 或 项目交接 记录。

实用阅读路径

  1. 阅读 标准定位,判断 UAI-1、MCP、A2A、可观测性或运行外壳哪一层负责当前工作。
  2. 当一次运行需要公开交换证据时,使用 UAI-1验证器一致性包
  3. 当持久输出是未来人类和代理需要加载的项目上下文时,使用 AI 记忆AI 记忆数据包向导项目交接
  4. 当问题是代理运行时接入、多工具交接或冷热记忆维护时,使用 OpenAI/CodexCoding AgentsContext Budget 指南。
  5. 在把桥接 profile、追踪导出、删减校验、参考适配器、SDK、CLI 或一致性措辞描述为当前支持前,先查 路线图