AIDAWORK / ARCHITECTURE

Prompt 组装与模型路由

独立图页 ↗
机制说明(SoT)图是辅读 · 结论以说明与证据为准

assembleSystemPrompt 按固定顺序拼接命名段;空段同时从文本与段落清单丢弃。当前代码顺序为:agent-instructions → tool-behavior-guide → write-tool-catalog → skill-context → extra-system-message → runtime-info(user-skill-context 段已随 User Skill delegated-run 在钉点 Agent e2adc9a3c325 删除)。

本页可直接往下读完整机制说明,不需要「演示 / 播放故事」。术语不熟先看 术语表。

先读机制说明,结论以说明与证据为准 · 基于固定代码版本核验 · 部署状态另行确认

机制说明(全文)

Prompt 组装与模型路由

固定顺序的 system prompt

assembleSystemPrompt 按固定顺序拼接命名段;空段同时从文本与段落清单丢弃。当前代码顺序为:agent-instructions → tool-behavior-guide → write-tool-catalog → skill-context → extra-system-message → runtime-info(user-skill-context 段已随 User Skill delegated-run 在钉点 Agent e2adc9a3c325 删除)。

Exclusive Live 下的 ModelRouter

ADR-0059 之后,平台只有一条 Platform Live Model(Admin「唯一生效」)。DbModelRouter 仍可在同 protocol 的其他 active sibling Providers 上组 fallback 链;但对 primary 同一 Provider,历史 supported_models[1…] 不是运行时重试目标(Exclusive live:只跳过同 id,不把兄弟 modelId 当 fallback)。StaticModelRouter / env-default 路径链长为 1、无 fallback。跨 Provider fallback 在 exclusive 生效后通常为空(只剩一个 active Provider),不把它当成第二套 live model。

Agent 行上的 provider_id / model_id 只是投影;问答权威经 resolveLiveLlmRoute 读 Providers catalog。详见主题 agent-config-pipeline。

证据与范围

  • aida-agent · packages/agent/src/prompt/assembler.ts L41–65 · assembleSystemPrompt · e2adc9a3c325
  • aida-agent · packages/agent/src/llm/model-router.ts L11–32 · exclusive live 合同注释 · e2adc9a3c325
  • aida-agent · packages/agent/src/llm/model-router.ts L100–130 · DbModelRouter · e2adc9a3c325
  • aida-agent · docs/adr/0059-platform-live-model.md L8–27 · Platform Live Model · e2adc9a3c325

结论来自固定版本的静态源码与合同阅读;实现存在、默认开关和生产启用分别判断。本站代码证据面板列出声明状态与具体限制。

机制说明

Prompt 组装与模型路由

固定顺序的 system prompt

assembleSystemPrompt 按固定顺序拼接命名段;空段同时从文本与段落清单丢弃。当前代码顺序为:agent-instructions → tool-behavior-guide → write-tool-catalog → skill-context → extra-system-message → runtime-info(user-skill-context 段已随 User Skill delegated-run 在钉点 Agent e2adc9a3c325 删除)。

Exclusive Live 下的 ModelRouter

ADR-0059 之后,平台只有一条 Platform Live Model(Admin「唯一生效」)。DbModelRouter 仍可在同 protocol 的其他 active sibling Providers 上组 fallback 链;但对 primary 同一 Provider,历史 supported_models[1…] 不是运行时重试目标(Exclusive live:只跳过同 id,不把兄弟 modelId 当 fallback)。StaticModelRouter / env-default 路径链长为 1、无 fallback。跨 Provider fallback 在 exclusive 生效后通常为空(只剩一个 active Provider),不把它当成第二套 live model。

Agent 行上的 provider_id / model_id 只是投影;问答权威经 resolveLiveLlmRoute 读 Providers catalog。详见主题 agent-config-pipeline。

证据与范围

  • aida-agent · packages/agent/src/prompt/assembler.ts L41–65 · assembleSystemPrompt · e2adc9a3c325
  • aida-agent · packages/agent/src/llm/model-router.ts L11–32 · exclusive live 合同注释 · e2adc9a3c325
  • aida-agent · packages/agent/src/llm/model-router.ts L100–130 · DbModelRouter · e2adc9a3c325
  • aida-agent · docs/adr/0059-platform-live-model.md L8–27 · Platform Live Model · e2adc9a3c325

结论来自固定版本的静态源码与合同阅读;实现存在、默认开关和生产启用分别判断。本站代码证据面板列出声明状态与具体限制。

代码证据

引用核验检查固定 commit 的文件与范围;实现结论来自代码阅读。自动检查不证明生产环境已启用。

已核验实现

assembleSystemPrompt 按固定顺序拼接 agent-instructions、tool-behavior-guide、write-tool-catalog、skill-context、extra-system-message、runtime-info;空段丢弃(user-skill-context 段已删除)。

aida-agentpackages/agent/src/prompt/assembler.ts:27–507f2e519936b57902d4907ed8026fe1ecdd146e82符号:skill-context
aida-agentpackages/agent/src/prompt/assembler.ts:41–657f2e519936b57902d4907ed8026fe1ecdd146e82符号:assembleSystemPrompt
已核验实现

Exclusive live(ADR-0059):DbModelRouter 对 primary 同一 Provider 跳过历史 supported_models,不把同 provider 其他 modelId 当 fallback;仅其他同 protocol active sibling Providers 可入 fallbacks;env-default/StaticModelRouter 无 fallback。

aida-agentpackages/agent/src/llm/model-router.ts:20–507f2e519936b57902d4907ed8026fe1ecdd146e82符号:exclusive live
aida-agentpackages/agent/src/llm/model-router.ts:100–1307f2e519936b57902d4907ed8026fe1ecdd146e82符号:DbModelRouter
aida-agentdocs/adr/0059-platform-live-model.md:8–277f2e519936b57902d4907ed8026fe1ecdd146e82符号:Platform Live Model
aida-agentpackages/agent/src/llm/model-router.ts:128–1587f2e519936b57902d4907ed8026fe1ecdd146e82符号:Exclusive live
已核验实现

resolveLiveLlmRoute 以 Providers catalog 的 active.supported_models[0] 为 Platform Live Model SoT,不继承 agents.model_id;agents.provider_id/model_id 仅为投影。

aida-agentpackages/agent/src/config/services/default-llm-service.ts:120–1507f2e519936b57902d4907ed8026fe1ecdd146e82符号:resolveLiveLlmRoute
aida-agentdocs/adr/0059-platform-live-model.md:12–277f2e519936b57902d4907ed8026fe1ecdd146e82符号:投影