解析 Agent publication

修改“Agent 行为如何变成可执行数据”时阅读本页。配置解析止于不可变的 ExecutableAgentSnapshot；它不执行 inference，不选择 Worker，也不委托其他 Agent。

分开可编辑数据与可执行数据

flowchart LR
  A[AgentConfig] --> V[校验字段与 reference]
  V --> C[compile_published 或 compile_resolved]
  C --> S[ExecutableAgentSnapshot]
  S --> P[Publication store 与 executable catalog]
  P --> R[RunActivation 钉住精确 snapshot]
  R --> K[Runtime kernel]
  M[后续 AgentConfig revision] --> N[新 publication]
  N -. 不替换 .-> R

snapshot 保存一次 Run 可以使用的行为，包括指令、模型 candidate、Tool descriptor、Plugin、 context policy、限制与内容 identity。它只保存 reference 和已解析选择，不保存 plaintext secret 或 service 所有的可变记录。

解析序列

sequenceDiagram
  participant Authoring as 配置编写
  participant Compiler as Agent compiler
  participant Catalog as Publication catalog
  participant Host as Run host
  participant Runtime
  Authoring->>Compiler: AgentConfig 与可解析 reference
  Compiler->>Compiler: 校验并推导不可变字段
  alt 输入无效或有歧义
    Compiler-->>Authoring: typed compile error，不产生 publication
  else 输入有效
    Compiler->>Catalog: 保存 snapshot 与 publication identity
    Host->>Catalog: 读取本次 Run 的精确 publication
    Catalog-->>Host: 不可变 snapshot
    Host->>Runtime: 带钉住 snapshot 的 RunActivation
  end

awaken-config-resolver 是管理面的模型 offering 与 credential 读取、解析入口。它的 ResolvedInference 用于 preview 和 probe。生产 publication 产生不含 secret 的模型 candidate；Runtime 不会在 Run 中调用管理面 resolver。

失败与变更行为

• reference 缺失、有歧义或不兼容时，在 publication 之前失败。
• 找不到精确 snapshot 时，Run 在执行前被拒绝，不会自动改用最新 Agent 版本。
• 发布新版本只影响后续 Run。正在运行、等待或重试的 Run 保留原行为 identity。
• credential materialization 与 Worker placement 发生在 publication 之后，由执行边界负责。

这些是解析结果，不是故障排查流程。根据明确结果修正 authored reference，或恢复结果中 指明的精确 publication；自动重试不能换用另一份行为。

Delegation 属于独立执行路径。参阅从 Tool 调用 sub-Agent 和多 Agent 模式。