变量映射与模板化

当数据来自数据库、API、表单或日志时，我们通常希望用同一套模板在不同场景复用，而不是把变量硬编码进 Prompt。变量映射正是为此服务：让模板与数据解耦，做到可复用、可替换、可追踪。

在模板里使用占位符

.request:
  input: 请为 ${product_name} 写一句定位。
  instruct: 语气风格：${tone}

加载时传入 mappings

from agently import Agently

agent = Agently.create_agent()
agent.load_yaml_prompt(
  "prompts/positioning.yaml",
  mappings={
    "product_name": "Agently",
    "tone": "专业、克制",
  },
)

在代码里直接替换

agent.set_request_prompt(
  "input",
  "请为 ${product_name} 写一句定位。",
  mappings={"product_name": "Agently"},
)

占位符会在加载与设置时自动替换，适合环境差异与多版本文案。常见场景包括多数据源合并、跨产品模板复用，以及 Prompt 与业务配置解耦。