Profiles / 模型配置第 72 篇

01 HarnessProfile:追加模型专属提示

它是什么

本站只展示教学文档和静态源码。不会执行示例、启动服务、访问模型、数据库或其他外部系统。

约 236 字·预计阅读 1 分钟
本页目录

它是什么

HarnessProfile 是 Deep Agents 在模型选中后应用的 harness 行为配置。system_prompt_suffix 会追加到系统提示词最后,适合放某个模型专属的输出习惯或限制。它不负责创建模型,也不传 API 参数。

它能在不改 create_deep_agent(...) 调用点的情况下生效,是因为注册信息会进入 Deep Agents 内部 registry;create_deep_agent 组装 Agent 时会按当前模型 key 自动查表。

最小代码

文件:deepagent_src/profiles_teach/01_harness_prompt_suffix.py

register_harness_profile(
    "openai:gpt-5.5",
    HarnessProfile(
        system_prompt_suffix="When the user asks for profile status, answer exactly PROFILE_SUFFIX_ACTIVE.",
    ),
)

运行

uv run python deepagent_src/profiles_teach/01_harness_prompt_suffix.py

预期输出末尾:

harness prompt suffix real agent ok

验证方式

脚本真实调用 Agent,并断言最终回答包含 PROFILE_SUFFIX_ACTIVE,证明匹配模型的 harness profile suffix 生效。

常见误区

别用 system_prompt_suffix 放密钥、连接串或运行时用户信息。这些东西不是 prompt 行为,应该走 runtime context 或 provider/model 构造配置。

参考资源与示例代码