Implementing multiple turns

核心概念总结：对话流程与工具调用机制

🔄 对话循环 (run_conversation) 机制

• 目标：持续调用 Claude，直到其生成最终回复（即不再需要工具）。
• 流程：采用 while 循环管理对话状态。
• 调用 Claude 获取响应。
• 检查响应的 stop_reason。
• 如果 stop_reason 不等于 "tool_use"，则循环终止，返回最终答案。
• 如果等于 "tool_use"，则进入工具执行阶段。

🛠️ 工具调用与执行 (run_tools / run_tool)

• 工具检测：通过检查 Claude 响应中的 stop_reason 是否为 "tool_use" 来判断是否需要调用工具。
• 执行逻辑：
• run_tools 负责接收 Claude 的工具调用请求。
• 辅助函数 run_tool 负责根据工具名称和输入，执行对应的具体函数并返回结果。
• 反馈机制：工具执行结果必须被作为新的“用户消息”反馈给 Claude，以便其进行下一步推理。

💡 高级特性与鲁棒性

• 多工具调用：Claude 具备将复杂查询分解为多个独立工具调用的能力（即一个响应中可能包含多个工具使用请求）。
• 消息处理：系统必须能够正确处理包含多个块（multiple blocks）的消息，并在 run_tools 中识别并执行单个消息内所有工具使用块。
• 可扩展性：通过重构引入 run_tool，未来添加新工具时，只需在 run_tool 中增加新的 if 检查，无需修改核心循环逻辑。

Takeaways

• 对话流程采用 while 循环管理，持续调用 Claude 直到其 stop_reason 不等于 "tool_use"。
• 工具调用由检查 Claude 响应的 stop_reason 是否为 "tool_use" 来触发。
• 工具执行结果必须被作为新的“用户消息”反馈给 Claude，以驱动后续推理。
• 系统需具备处理单个消息内包含多个工具调用块的能力。
• 引入 run_tool 机制，实现了工具调用的可扩展性，新增工具无需修改核心循环逻辑。