指南

代理利用策略和 UAI

将代理线束执行策略与 UAI 证据、AI 内存、项目移交、一致性和支持声明边界分开的实用指南。

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

文档状态

公共标准页面 作为当前公共标准记录的一部分发布在 UAIX 上
代码
UAIX-DOC-0038
页面类型
指南
访问
公开且可链接

如何使用此页面

将此页面用作 代理利用策略和 UAI 及其标准内容的规范公共参考。

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

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

什么是代理安全带

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

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

线束工程运营模式

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

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

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

UAI 适合的位置

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

UAI 适合的位置
利用战略领域线束通常拥有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 Memory、Project Handoff或键入的.uai记录中。将其归档为源历史记录或冷内存,而不是启动上下文。

常见集成模式

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

常见集成模式
图案当UAI 如何参与边界
证据边车该装置已经可以工作,但结果需要便携式记录。在运行时工件旁边使用 UAI-1 示例、验证器输出、源参考和简短审查的结果包。UAI 审核后观察并记录;它不驱动运行循环。
释放门记录功能、实现或公开声明在发布之前需要证据。将 UAI-1 有效负载、验证者证据、一致性或采用材料、路线图状态和变更日志链接附加到发布决策。通过的数据包是该数据包和命名范围的证据,而不是认证或认可。
存储库移交未来的人类或特工需要在没有私人聊天记录的情况下继续工作。更新 AI 内存、项目交接、AGENTS.md、readme.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 Memory 获取当前项目真相:项目切换和类型化 .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 记录