导出与版本化
在工程实践中,我们通常会把“代码里的 Prompt 表达”转为配置进行持久化,或交给非开发角色维护。导出能力让这件事可落地:把代码表达转换为 YAML/JSON,便于构建配置化服务端与前端管理界面,实现 Prompt 的持续演进而不影响业务逻辑。
导出完整 Prompt
python
prompt_yaml = agent.prompt.to_yaml_prompt(inherit=True)
prompt_json = agent.prompt.to_json_prompt(inherit=True)inherit=True 会把 Agent Prompt 与 Request Prompt 合并输出。
导出分层 Prompt(推荐)
python
yaml_snapshot = agent.get_yaml_prompt()
json_snapshot = agent.get_json_prompt()分层导出便于定位问题来源:是 Agent 层规则影响了结果,还是 Request 层输入变化导致。
落盘保存
python
with open("prompt.snapshot.yaml", "w", encoding="utf-8") as f:
f.write(prompt_yaml)典型使用方式
- 代码表达 → YAML 配置持久化
- 配置化服务端 + 配置化前端构建 Prompt 管理系统
- 交给非开发角色维护与迭代