用途：把 Agently 的提示词结构从业务代码中抽离，作为 YAML/JSON 数据资产进行版本化、跨服务与环境共享。
主要能力：load_yaml_prompt(...) 与 load_json_prompt(...) 从文件或字符串加载；get_yaml_prompt(...) 与 get_json_prompt(...) 导出当前提示词状态；.agent 映射持久化 agent 提示词状态，.request 映射单次请求提示词状态；顶层 $key 是写入 agent 状态的简写，顶层普通键是写入 request 状态的简写；.alias 在加载时执行 agent 方法；mappings 用于配置键与值的占位符替换；prompt_key_path 用于从较大文档中选取单个提示词配置；支持代码构建的提示词状态与导出配置文本之间的往返。
使用方式：按任务查阅对应参考文档——结构与路由见 references/structure-and-routing.md；文件与字符串加载、mappings、JSON5 行为、prompt_key_path 见 references/loading-mappings-and-key-paths.md；.alias、导出与往返见 references/alias-and-roundtrip.md；异常排查见 references/troubleshooting.md。
适用场景：提示词模板应存于 YAML/JSON 而非 Python；一个文件含多个可复用提示词包；加载时填充占位符；提示词状态需导出并在别处恢复；用配置驱动简单提示词构建方法。
限制：mappings 仅在键值写入提示词状态时应用；.alias 参数按原样执行，不享受加载时 ${...} 替换；导出序列化当前 .agent 与 .request 状态，不保留 .alias、注释、prompt_key_path 或原始未解析模板文本。不覆盖会话序列化、TriggerFlow 配置/导出、provider 设置与响应消费。前置条件：Agently >= 4.0.8.5。