指南

公开记录项

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

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

文件状态

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

如何使用本页

使用本指南将代理利用策略与 UAI 证据、AI 内存、项目移交、一致性和支持声明边界分开。

对于代理:将相关指南应用于用户的目标站点或存储库。除非用户明确要求该输出,否则请勿复制此 UAIX 页面、创建有关指南的页面或将此页面视为运行时权限。

证据路径

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

代理利用策略

让线束执行,同时 UAI 保留证据

使用本指南将线束工程、编排、工具、运行时内存、批准、跟踪、评估和优化保留在线束中,同时 UAI-1、AI 内存、项目切换、验证器证据和发布数据包保留可移植记录。

运行时

线束运行工作

规划、工具调用、重试、中断、批准、运行时内存和实时跟踪属于代理控制层。

证据

UAI 携带持久记录

审查的意图、任务状态、结果摘要、页面摘要、评估摘要、采用指标、验证器证据、一致性数据包和移交更新是应该传输的部分。

边界

桥梁想法首先需要证明

跟踪导出器、MCP/A2A 证据映射、修订 lint、参考适配器、SDK 和 CLI 保持计划,直到出现公共测试样例和发布证据。

证据路径

标准定位决定哪一层拥有该作品。UAI-1当前公共交换契约。项目交接运行后持久的项目内存。AI 记忆数据包向导规划支持的内存启动包。一致性包收集可重复使用的释放证据。路线图检查网桥、适配器、SDK、CLI 和一致性边界。
图层规则线束与 UAI 拆分
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.

在查看可能将 UAI 转变为运行时或将运行时跟踪转变为公共事实的副本时,请使用此行。

代理线束运行工作。 UAI 记录便携式证据。当团队决定如何利用工程、编排、工具、内存、可观察性、策略、评估和人工监督来适应 UAI-1、AI 内存和项目移交时,请使用本指南。

什么是代理安全带

代理工具是围绕模型和代理的软件层,可将意图转化为受控工作。它可以路由任务、调用工具、读取数据、协调代理、执行策略、收集批准、保留运行时内存、观察痕迹并决定何时应该有人介入。

  • 执行:模型、工具、工作流程、重试、中断和任务状态。
  • 连接性:API、MCP 样式工具/资源会话、本地适配器和数据访问策略。
  • 协调:运行时切换、A2A 风格的代理委派、任务板和批准检查点。
  • 记忆:短暂的运行时状态、持久的 AI 内存、项目切换文件和冷酷的 wiki 档案。
  • 证据:跟踪、决策、验证器结果、发布数据包、移交摘要和经过编辑的公共记录。

线束工程运营模式

线束工程是围绕运行时的实际操作循环:准备有界的规格包,在线束中运行工作,审查工件,然后仅写回接受的内存和证据。

线束工程工作 UAIX 切换或证据输出
准备 组装当前的项目交接文件、AI 内存、约束、页面摘要、验收标准和测试计划。 一个紧凑的启动数据包,命名源权限、支持边界、目标路由和目标检查。
跑步 让运行时选择工具、调用 MCP 资源、协调代理、收集批准、跟踪痕迹并运行评估。 没有自动公开声明。除非应用程序已使用经过验证的 UAI 记录,否则 UAIX 不会出现在实时控制路径中。
审核 将已接受的工件与原始痕迹、隐藏提示、私人日志、失败的尝试和推测性优化分开。 审查摘要、修订、验证器输出、测试或评估结果以及明确的非声明边界。
回信 仅宣传未来人类或代理应该加载的事实。 项目交接更新、AI 内存更改、发行说明、路线图状态、采用指标、页面摘要和下一步行动。

页面摘要、入职检查点、评估摘要、采用指标和工作流程决策在审核工件时可以改进 UAIX.org。原始跟踪、隐藏提示、私有日志、推测性优化和后台清理计划应保留在工具、问题跟踪器或冷内存中,直到升级。

UAI 适合的位置

UAI 不应与安全带竞争。 UAI-1 是公共交换和证据合同,保留代理运行的一部分,另一个团队、供应商、发布、审核员、客户或未来代理必须能够检查和推进。

利用战略领域 线束通常拥有 UAI 应保留
规划和编排 任务分解、模型选择、工具排序、重试和中断行为。 审查的意图、任务状态、结果和面向发布的移交摘要。
工具和数据访问 MCP 会话、API 客户端、凭据、本地适配器和数据访问强制。 已编辑的请求/结果证据、来源参考、出处和可供验证的有效负载记录。
代理间协调 A2A 风格的发现、委派、功能路由和运行时切换行为。 能力声明、任务状态快照、责任转移摘要和持久交换数据包。
记忆和背景 运行时内存、对话状态、向量存储和工具本地缓存策略。 AI内存数据包、项目交接文件、主动约束、决策、所有者、检查和升级规则。
可观察性和评估 跟踪、跨度、指标、评估运行、批准事件和行为仪表板。 仅审查、编辑复制、引用或审计公共记录所需的标识符和摘要。
政策和治理 护栏、人工审批门、数据控制和部署策略。 支持声明边界、验证器证据、一致性包材料和注明日期的发布轨迹链接。

特工技能和 UAI-1 证据

当可重用过程包是主要主题时,请使用专用的UAIX / UAI-1 特工技能包指导。该线束指南将层分割保持在视图中:代理技能处理可重用的程序加载; UAI-1 处理便携式公共证据。

参考架构循环

将 UAI 视为运行周围的记录层,而不是运行循环本身。一个好的代理架构可以在工作开始之前、工作运行期间以及工作被接受之后使用 UAI 。

片刻 运行时或线束作业 UAIX 作业
跑步前 加载任务指令、选择模型、公开工具、设置批准并准备运行时内存。 加载项目交接、当前约束、来源权限、证据规则以及 UAI-1 配置文件,如果运行成功,该配置文件将收到公共证明。
跑步过程中 执行步骤、调用工具、协调代理、收集跟踪、请求人工批准并处理中断。 将 UAI 保留在实时控制路径之外,除非经过验证的交换记录已经是应用程序设计的一部分。
审查门 将接受的输出与原始痕迹、私人数据、被拒绝的尝试和不受支持的声明分开。 编辑、总结、选择来源参考、附上出处,并决定哪些事实可以安全推广。
验收后 在所属系统中保留实施更改、部署说明、评估结果或面向客户的结果。 编写持久的 UAI-1 记录、验证器证据、一致性或采用数据包、AI 内存更新以及未来代理和审核者可以加载的项目移交摘要。

安全带应该留下什么

并非每个跟踪行、提示、工具结果或批准事件都应成为 UAI 证据。仅提升另一方在运行时会话之外需要的最小已审核记录。

问题 如果是 如果没有
另一个团队、供应商、发布、审核员、客户或未来的代理是否需要验证这一事实? 考虑 UAI-1 记录、验证器结果或项目切换更新。 将其保留在运行时日志、问题历史记录或私人操作记录中。
事实是否支持公开实施或支持主张? 在发布之前附加架构、注册表、示例、验证器、一致性、路线图和变更日志证据。 将其保留为内部背景或计划的工作。
它是否包括秘密、凭证、客户数据、原始批准、隐藏提示或私人痕迹? 不要发布它。首先进行编辑,然后在需要时仅保留已审查的证据指针。 在升级之前,它可能仍然需要源代码审查和支持边界检查。
这是下一个代理必须加载的当前项目真相吗? 审核后将其提升到AI 记忆、项目交接或键入的.uai记录中。 将其归档为源历史记录或冷内存,而不是启动上下文。

常见集成模式

大多数团队不需要从构建新的运行时集成开始。从创建有用证据的风险最低的模式开始,然后仅在公共测试样例和发布证据存在后才转向适配器。

图案 UAI 如何参与 边界
证据边车 该装置已经可以工作,但结果需要便携式记录。 在运行时工件旁边使用 UAI-1 示例、验证器输出、源参考和简短审查的结果包。 UAI 审核后观察并记录;它不驱动运行循环。
释放门记录 功能、实现或公开声明在发布之前需要证据。 将 UAI-1 有效负载、验证器证据、一致性或采用材料、路线图状态和变更日志链接附加到发布决策。 通过的数据包是该数据包和命名范围的证据,而不是认证或认可。
存储库移交 未来的人类或特工需要在没有私人聊天记录的情况下继续工作。 更新 AI 内存、项目交接、AGENTS.mdreadme.human 和键入的 .uai 记录,其中包含已接受的事实、检查、阻止程序和下一步操作。 移交文件是项目内存,而不是 UAI-1 本身的一致性证据。
桥梁夹具实验室 团队需要未来的 MCP、A2A、跟踪或运行时适配器支持。 在命名支持之前,创建经过编辑的小型装置、预期映射、验证器期望、支持边界和维护所有者。 在 UAIX 发布测试样例、测试和发布轨迹之前,桥梁工作仍处于计划或研究轨道。

第一次校样运行

有用的第一次证明运行故意很小:一个运行时结果、一个 UAI-1 配置文件、一个编辑后的有效负载、一个验证器结果、一个所有者、一个发布或移交目的地以及一个显式非声明边界。

  1. 选择记录:命名需要在运行中生存的请求、响应、任务状态、功能声明或错误记录。
  2. 选择公开资料:将记录连接到当前适用的 UAI-1 架构、注册表项、示例或一致性测试样例。
  3. 验证前编辑:在有效负载离开线束之前删除机密、客户数据、原始批准、隐藏提示和私人痕迹。
  4. 验证并引用:将验证器输出、夹具有效负载、实施范围以及注明日期的发布或移交注释放在一起。
  5. 写回接受的内存:仅使用未来代理应加载的事实更新项目切换,并将原始跟踪详细信息保留在所属运行时或存档中。
  6. 命名边界:说明证据未声明的内容,尤其是认证、认可、官方适配器支持、SDK、CLI、自动同步或广泛一致性。

策略选择

  1. 保持 UAI 非运行时:让线束执行工作,同时 UAI 记录持久交换、证据和移交材料。
  2. 从一次验证运行开始:在讨论广泛的平台支持之前,选择一个 UAI-1 配置文件、一个候选负载、一个验证器结果和一个记录所有者。
  3. 仅在审查后将痕迹映射为证据:痕迹是有用的原材料,但公共记录应包含经过编辑、精选、可复制的事实。
  4. 使用 AI 记忆 获取当前项目真相:项目切换和类型化 .uai 文件应包含接受的约束、决策、进度和检查,而不是整个运行时跟踪。
  5. 保持桥梁语言计划直到被证明:参考适配器、跟踪导出器、本地验证、编辑 lint、SDK、CLI 和一致性措辞在成为支持声明之前需要固定并发布证据。

接下来要证明的桥型材

未来有用的工作不是通用线束的替代品。它是一小组证据桥梁,证明已完成的运行如何成为可移植的 UAI 记录,而不会泄露秘密、过度支持或依赖于一个运行时。

桥梁理念 首先需要证据 公开状态
跟踪至 UAI 导出 示例跟踪、编辑规则、夹具有效负载和验证器期望。 计划的证据工作。
MCP 工具调用证据包 工具请求/结果映射、功能参考、来源和安全过滤。 计划的证据工作。
A2A 任务状态切换数据包 能力声明、任务所有者、任务状态、授权边界和结果摘要测试样例。 计划的证据工作。
项目移交回写 已接受的决策、更改的文件、检查运行、阻止程序以及写入当前移交文件的下一步操作。 当前模式;自动化仍在计划中。
本地验证和编辑 lint 秘密、私人数据、无支持的主张和公共安全证据输出的规则。 计划的证据工作。

当前支持边界

  • 当前 UAIX 支持是已发布的公共记录:UAI-1, 验证器, 一致性包, 人工智能记忆, 项目交接, API参考,以及已发布的实施轨道。
  • 本指南是战略和采用指南。它不会创建运行时工具、托管导入程序、调度程序、SDK、CLI、官方适配器、认证、认可、合规性计划、自动存储库编写器、自动 LLM Wiki 同步或存储库本地移交文件的 UAI-1 一致性声明。
  • 当代理利用工作成为公开证据时,请在重复声明之前附加验证器输出、夹具有效负载、实施范围、发行说明和路线图状态。

请勿索赔

  • 请勿声称 UAIX 运行代理、替换代理运行时或拥有实时工具调用控制流。
  • 在存在公共测试样例、工具和发布证据之前,请勿声明官方 MCP、A2A、OpenAI、供应商、SDK、CLI 或线束适配器支持。
  • 在经过审查和推广之前,请勿将运行时跟踪、私有仪表板、原始删除文件、旧报告或 AIWikis 冷内存视为活跃的公共支持证据。
  • 请勿将机密、凭据、私人客户数据、特权操作、原始批准或未经编辑的跟踪放入便携式 UAI、AI 内存或项目移交记录中。

实用的阅读路径

  1. 标准适合决定 UAI-1、MCP、A2A、可观察性或线束是否拥有直接作业。
  2. 使用UAI-1, 这验证器, 和一致性包当跑步需要公开交换证据时。
  3. 使用人工智能记忆, 这AI内存封装向导, 和项目交接当持久输出是未来人类和代理应该加载的项目上下文时。
  4. 使用OpenAI/法典, 编码剂, 和背景预算当问题是代理运行时拾取、多工具切换或热/冷内存维护时提供指导。
  5. 使用路线图在将桥配置文件、跟踪导出器、修订 lint、参考适配器、SDK、CLI 或一致性语言描述为当前支持之前。

相关 UAIX 记录