SuperAPI AI 工具集

refine-agent-prompt

智能体与模型

查看项目

更新于 10-16 07:24

技能介绍

用途:渲染 nooa 智能体实际会发送给 LLM 的完整提示词(含真实状态、上下文块与参数),并据此诊断、调试和优化提示词。

主要能力:用 nooa.print_prompt 配合 FakeLLMClient 在不发起真实 LLM 调用的情况下打印提示词;用 nooa.build_prompt_data 以编程方式获取 system_prompt、task_prompt、inspect_prefill、strategy_name 等分段;支持渲染指定子方法(如 answer_question、implement_step)。

使用方式:定义继承 Agent 的类并传入 FakeLLMClient,然后 await nooa.print_prompt(agent.respond, "示例消息");从文件加载的智能体可用 importlib 加载模块后同样调用。诊断环节包括:检查 execution_context 是否暴露了框架内部符号(可用 with hidden 包裹导入隐藏)、是否存在重复内容、内部方法与入口点是否可见(用 @hidden 或 Annotated[T, hidden] 隐藏,nosnapshot 可排除快照字段)、任务提示词是否清晰无冗余、Skills 是否通过 doc() 良好呈现、返回类型是否用 Pydantic 模型强类型化、以及上下文块与内联 doc() 的取舍。

适用场景:检查、调试或改进智能体的提示词、上下文块与工具文档。

限制:每项诊断都有取舍,需与用户讨论后再修改;隐藏符号会使 LLM 无法在 REPL 中按名调用;上下文块每轮都有开销,内联仅在任务开始时支付一次;更短的提示词更省成本,但 LLM 可能忽略只在上下文块中出现的指令。具体安装命令与版本信息暂未提供。