搜索文档

浏览 Awaken Agents 文档
Docs/Awaken Agentsv1.0.0-dev/内部机制/理解系统调优与运行
提示·你正在阅读发布前文档(v1.0.0-dev)。接口与行为在稳定发布前仍可能变化。

内部机制 · 理解系统

调优与运行

本页内容

先为嵌入式 Awaken Agents 执行内核选择下一项维护任务,再用已提交事实验证改动。

先确定要改变什么。本页只负责把任务送到正确位置;具体契约和操作由链接页面维护。

需要完成的事改动或检查对象前往
弄清一个 Run 为何结束已提交的 RunStateEndCause 与事实Run 生命周期
保住中断的模型流重试策略与可选的进行中 checkpoint恢复流式 LLM
限制或停止工作步数上限、推理失败上限、取消或结束 guard配置 Run 终止
查看延迟、失败和执行路径日志、trace、指标与 trace 传播启用可观测性
比较行为改动在最低有效边界执行确定性测试测试策略
改变 Tool 授权权限策略与持久化审批人在回路中
改变持久化或共享方式提交存储、读取模型与应用自有状态状态与存储

先认清改动边界

flowchart LR
    A[Agent snapshot] --> R[Runtime loop]
    P[权限策略] --> R
    S[存储与提交端口] --> R
    R --> F[已提交事实与状态]
    R --> L[实时事件]
    R --> O[日志、trace 与指标]
    F --> T[确定性测试]
    L --> T
    O --> T

Agent snapshot 负责 instructions、模型绑定、Tools、Plugins 与步数上限。host 负责 存储、取消、模型和 Tool executor,以及进程可观测性。恢复以已提交事实为准;实时 事件与 telemetry 用来解释过程,不能取代已提交事实。

每次只改变一个原因

  1. 为固定场景记录 Run id、snapshot fingerprint、模型绑定、Tool 清单和终态 RunState
  2. 写清希望改变的结果,以及必须保持不变的结果。
  3. 只在归属边界修改一个类型化输入。
  4. 用脚本化模型重放场景,对比已提交消息、状态命令、事实、用量和终止原因。
  5. 只有当结论跨越存储、协议、重启或进程边界时,才运行更广的 conformance 或 进程测试。
sequenceDiagram
    participant M as 维护者
    participant C as 类型化配置
    participant R as Runtime
    participant E as 已提交证据
    M->>E: 记录基线
    M->>C: 修改一个归属明确的输入
    C->>R: 运行固定场景
    R->>E: 提交消息、状态、事实与终止原因
    M->>E: 与预期结果对比
    alt 必须保持的性质仍成立
        M->>C: 保留改动
    else 行为发生回退
        M->>C: 撤销或缩小改动
    end

Runtime 会自行重试符合条件的模型故障、恢复受支持的部分流、拒绝过期提交,并让 终态保持吸收性。这些正常路径不需要另写处理流程。只有内置策略结束后仍持续出现 明确错误,而且链接页面给出了外部修正方法时,才需要处理。

何时使用 Awaken Agents 服务能力

当配置、凭据、持久化 dispatch 或运行 HTTP endpoint 需要跨进程共享时,使用 Awaken Agents。Runtime 仍是执行内核;Agents 服务层负责组合它,而不是建立第二个 执行权威。参见 Awaken Agents 配置任务