Harness 学习笔记分享（Part 1） | 粥里有勺糖

Function Calling流程

• 通过schema声明工具能力，模型输出tool_calls结构，包含调用工具名、参数及唯一ID。
• tool_calls需与tool_call_id对应，Harness解析执行后以tool消息回写结果。
• 示例中get_weather工具参数为{"city":"上海"}，模型响应包含tool_calls字段触发执行。

Tools声明与实现

• 工具由schema（声明）和handler（实现）组成，schema用于模型调用决策，handler处理实际操作。
• 工具执行结果需包含content字段，若含terminate: true则终止循环无需再次调用模型。

Harness处理逻辑

• 核心步骤：校验参数→执行工具→按ID回写结果→再次请求模型。
• 示例代码中executeTool函数接收调用ID和参数，校验失败则推送错误消息。

Agent Loop循环机制

• 自动循环流程：组装上下文→请求模型→若有tool_calls则执行工具并更新上下文→重复循环直至无调用或满足终止条件。
• 循环条件包括工具结果是否需回传、shouldStopAfterTurn标志及用户消息注入时机（steering在工具执行后、follow-up在模型准备结束时）。

终止条件

• 工具结果若含terminate: true或最终答案已结构化输出，则无需继续模型调用。
• 示例中结构化工具执行后直接返回结果，省略后续模型推理步骤。