Agentic 运行外壳负责运行工作;UAI 记录可携带证据。 当团队需要把编排、工具、记忆、可观测性、策略和人工审批放到 UAI-1、AI 记忆 与项目交接周围时,请从这页开始。
什么是 agentic 运行外壳
运行外壳是模型和代理周围的软件层。它可以分配任务、调用工具、读取数据、协调代理、执行策略、收集审批、保存运行时记忆、观察追踪,并决定什么时候需要人工介入。
- 执行:模型、工具、工作流、重试、中断和任务状态。
- 连接:API、MCP 式工具/资源会话、本地适配器和数据访问策略。
- 协调:运行时交接、A2A 式代理委派、任务板和审批检查点。
- 记忆:短期运行状态、AI 记忆、项目交接 文件和冷 Wiki 档案。
- 证据:追踪、决策、验证器结果、发布包、交接摘要和已删减的公开记录。
UAI 放在哪里
UAI 不应该和运行外壳竞争。UAI-1 是公开交换和证据契约,用来保存另一个团队、供应商、发布版本、审计者、客户或未来代理需要检查并带走的那部分运行结果。
| 外壳策略区域 | 外壳通常负责 | UAI 应保存 |
|---|---|---|
| 规划和编排 | 任务拆分、模型选择、工具顺序、重试和中断行为。 | 经过审查的意图、任务状态、结果和面向发布的交接摘要。 |
| 工具和数据访问 | MCP 会话、API 客户端、凭据、本地适配器和访问控制。 | 已删减的请求/结果证据、来源引用、出处和可验证载荷记录。 |
| 代理协作 | A2A 式发现、委派、能力路由和运行时交接。 | 能力声明、任务状态快照、责任转移摘要和持久交换包。 |
| 记忆和上下文 | 运行时记忆、对话状态、向量存储和工具本地缓存策略。 | AI 记忆 包、项目交接 文件、当前约束、决策、所有者、检查和提升规则。 |
| 可观测性和评估 | 追踪、指标、评估运行、审批事件和行为面板。 | 只保存复现、引用或审计公开记录所需的已审查、已删减标识和摘要。 |
| 策略和治理 | 护栏、人工审批门、数据控制和部署策略。 | 支持声明边界、验证器证据、一致性包材料和有日期的发布轨迹。 |
策略选择
- 保持 UAI 非运行时:让外壳执行工作,让 UAI 记录持久交换、证据和交接材料。
- 从一次证明运行开始:选择一个 UAI-1 profile、一个候选载荷、一个验证器结果和一个记录所有者。
- 追踪经过审查后才成为证据:追踪是有用原料,但公开记录只应包含已删减、被选择、可复现的事实。
- 用 AI 记忆 保存当前项目事实:项目交接 和类型化
.uai文件保存已接受的约束、决策、进度和检查,而不是整段运行追踪。 - 桥接语言先保持计划状态:参考适配器、追踪导出、本地验证、删减校验、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 记忆 或 项目交接 记录。
实用阅读路径
- 阅读 标准定位,判断 UAI-1、MCP、A2A、可观测性或运行外壳哪一层负责当前工作。
- 当一次运行需要公开交换证据时,使用 UAI-1、验证器 和 一致性包。
- 当持久输出是未来人类和代理需要加载的项目上下文时,使用 AI 记忆、AI 记忆数据包向导 和 项目交接。
- 当问题是代理运行时接入、多工具交接或冷热记忆维护时,使用 OpenAI/Codex、Coding Agents 和 Context Budget 指南。
- 在把桥接 profile、追踪导出、删减校验、参考适配器、SDK、CLI 或一致性措辞描述为当前支持前,先查 路线图。