代理线束运行工作。 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.md、readme.human 和键入的 .uai 记录,其中包含已接受的事实、检查、阻止程序和下一步操作。 |
移交文件是项目内存,而不是 UAI-1 本身的一致性证据。 |
| 桥梁夹具实验室 | 团队需要未来的 MCP、A2A、跟踪或运行时适配器支持。 | 在命名支持之前,创建经过编辑的小型装置、预期映射、验证器期望、支持边界和维护所有者。 | 在 UAIX 发布测试样例、测试和发布轨迹之前,桥梁工作仍处于计划或研究轨道。 |
第一次校样运行
有用的第一次证明运行故意很小:一个运行时结果、一个 UAI-1 配置文件、一个编辑后的有效负载、一个验证器结果、一个所有者、一个发布或移交目的地以及一个显式非声明边界。
- 选择记录:命名需要在运行中生存的请求、响应、任务状态、功能声明或错误记录。
- 选择公开资料:将记录连接到当前适用的 UAI-1 架构、注册表项、示例或一致性测试样例。
- 验证前编辑:在有效负载离开线束之前删除机密、客户数据、原始批准、隐藏提示和私人痕迹。
- 验证并引用:将验证器输出、夹具有效负载、实施范围以及注明日期的发布或移交注释放在一起。
- 写回接受的内存:仅使用未来代理应加载的事实更新项目切换,并将原始跟踪详细信息保留在所属运行时或存档中。
- 命名边界:说明证据未声明的内容,尤其是认证、认可、官方适配器支持、SDK、CLI、自动同步或广泛一致性。
策略选择
- 保持 UAI 非运行时:让线束执行工作,同时 UAI 记录持久交换、证据和移交材料。
- 从一次验证运行开始:在讨论广泛的平台支持之前,选择一个 UAI-1 配置文件、一个候选负载、一个验证器结果和一个记录所有者。
- 仅在审查后将痕迹映射为证据:痕迹是有用的原材料,但公共记录应包含经过编辑、精选、可复制的事实。
- 使用 AI 记忆 获取当前项目真相:项目切换和类型化
.uai文件应包含接受的约束、决策、进度和检查,而不是整个运行时跟踪。 - 保持桥梁语言计划直到被证明:参考适配器、跟踪导出器、本地验证、编辑 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 内存或项目移交记录中。
实用的阅读路径
- 读标准适合决定 UAI-1、MCP、A2A、可观察性或线束是否拥有直接作业。
- 使用UAI-1, 这验证器, 和一致性包当跑步需要公开交换证据时。
- 使用人工智能记忆, 这AI内存封装向导, 和项目交接当持久输出是未来人类和代理应该加载的项目上下文时。
- 使用OpenAI/法典, 编码剂, 和背景预算当问题是代理运行时拾取、多工具切换或热/冷内存维护时提供指导。
- 使用路线图在将桥配置文件、跟踪导出器、修订 lint、参考适配器、SDK、CLI 或一致性语言描述为当前支持之前。