配置
三种配置归属
| 宿主 | 配置来源 |
|---|---|
| 嵌入式 SAgents v2 | SageManifest：YAML 字符串、校验后的 Python 字典或 sage.yaml。 |
| Desktop v2 | 应用持久化设置和 catalog，在界面配置模型与 Agent。 |
| Server v2 | SAGE_SERVER_* 环境变量，加上各用户的模型、Agent、Skill 与 MCP catalog。 |
加载 manifest
from sagents.v2.package.manifest import SageManifest, SageManifestLoader
manifest = SageManifestLoader().loads(yaml_text)
# 也可以：manifest = SageManifest.model_validate(config_dict)
# 然后：application = await builder.build(manifest)
loads() 校验 YAML 并拒绝重复键。load("path/to/sage.yaml") 还会解析包目录内的指令文件。直接给 build() 传普通字符串会走文件加载。内存配置使用内联指令。
credentials 声明密钥解析来源；models 引用凭据，不携带密钥明文。agents 选择指令和模型路由，entrypoint 指定入口 Agent。
选择运行组件
通过 runtime.capabilities 绑定实现。例如，为延迟加载 Skill 的组件设置 token 预算：
runtime:
capabilities:
skill.loading:
plugin: sage.skill.loading.lazy
config:
max_active_tokens: 6000
以上片段需加入完整 manifest。插件配置经过 schema 校验；能力取决于实际注册的实现，只有元数据声明不代表组件可运行。