Responses API 工具调用上限：写作预算与停止规则

先确定预算边界

资料显示，Responses API 的 max_tool_calls 用于限制单个响应中可处理的内置工具调用总数，限制按所有内置工具合计计算，并非每一种工具各自计算；超过该数量后的工具调用尝试会被忽略。开始前先按写作任务列出必要工具，不把“可能有用”的工具一并开放。

预算值应来自团队的固定样本测试，而不是假设某个数字适用于所有主题。把任务标识、输入版本、可用工具、预算和人工复核人一并记录。

在请求中设置总次数限制

1. 将本次写作任务拆为资料定位、字段核对和正文整理三个阶段。
2. 仅在需要外部信息的阶段传入对应工具，并设置 max_tool_calls。
3. 在指令中要求代理每次调用后记录用途、依据和结果摘要；没有新增验证目标时转入正文整理。
4. 保存响应标识、预算值、实际调用数和每次结果，便于编辑复核。

response = client.responses.create(
    model="你的模型",
    input="根据已返回资料整理草稿；达到工具预算后停止查询，并列出待人工确认项。",
    tools=tools,
    max_tool_calls=预算值
)

max_tool_calls限制的是内置工具调用总量。若流程还包含应用自行执行的函数或其他外部逻辑，应在应用侧另行计数，不能只依赖这一项。

记录调用用途和停止条件

在任务记录中为每次调用保存序号、工具名称、查询目的、输入摘要、结果摘要、是否支持正文结论和后续动作。停止条件应同时覆盖预算和质量，避免只因还有额度就继续检索。

• 关键事实已获得可复核材料，停止新增检索。
• 同一问题连续获得重复或无关结果，停止并标记资料不足。
• 已达到预算，禁止继续扩展查询，转入汇总。
• 需要权限、敏感操作或无法判断的业务字段，转人工复核。

产品更新说明草稿

假设任务是根据内部资料和公开页面起草一篇产品更新说明。团队可先用一次调用定位公开资料，再用一次调用核对内部版本字段，剩余预算只用于修补明确缺口。到达上限后，代理输出三部分：可写入正文的已证实信息、未证实而不能写入的内容、需要编辑确认的问题。

正文中不要把工具返回的原始片段直接拼接成结论。每个关键说法应能对应一次记录中的结果摘要；没有证据的表述改为待确认项。需要了解工具结果如何回传和继续生成时，可参考工具调用接入写作流程。

常见故障与回退动作

• 故障：达到上限后正文仍缺少关键事实。原因：预算没有优先留给决定发布的字段。修正动作：停止生成可发布结论，输出缺口清单，由人工补充材料后新建任务。
• 故障：代理反复查询同一个问题。原因：没有把已得到的结果和停止条件写入任务状态。修正动作：按查询目标去重，命中重复结果后直接进入汇总。
• 故障：记录显示未超限，但外部操作仍过多。原因：应用侧函数调用未纳入统一计数。修正动作：为全部工具建立共享计数器和硬停止开关。
• 故障：达到预算后仍把猜测写进正文。原因：正文阶段没有区分证实信息与待确认信息。修正动作：将缺少依据的句子删除或标为人工待确认，不进入发布队列。

发布前复核清单

• 已核对任务实际调用数不超过设定预算。
• 每次调用都有用途、结果摘要和任务关联记录。
• 正文中的关键事实能回溯到可复核资料。
• 达到上限后的缺口已转为人工复核项，没有被写成确定结论。
• 任务状态明确标为可发布、待补料或待人工确认。
• 编辑已检查标题、正文、链接和版本是否对应同一任务。