Handling message blocks

🤖 使用工具（Tool Use）的关键概念

• 工具定义 (Tool Definition):
• 在向模型（如 Claude）发送请求时，必须包含一个工具模式（Tool Schema）。
• 该 Schema 告知模型有哪些可用的工具，通常通过 tools 关键字参数传入一个包含所有工具 JSON 规范的列表。

• 多块消息结构 (Multi-Block Message Structure):
• 当模型决定使用工具时，返回的助手消息（Assistant Message）结构发生变化。
• 消息内容（Content List）不再仅包含一个文本块（Text Block）。
• 它可能包含两种或两种以上的块：
• 文本块 (Text Block): 用于向用户展示的解释性文本（例如：“我将为您查找当前时间”）。
• 工具使用块 (Tool Use Block): 告知开发者模型想要调用的函数名称及其所需的输入参数（Arguments）。

• 对话历史管理 (Conversation History Management):
• 模型本身不会存储对话历史。开发者必须手动维护整个对话历史。
• 在执行工具函数后，必须将函数执行的结果作为新的消息，连同完整的对话历史一起返回给模型，以维持对话的连续性。

• 实现要点 (Implementation Focus):
• 在处理工具调用时，必须确保对话历史管理逻辑能够正确处理包含多块（Multiple Blocks）的消息对象（无论是用户消息还是助手消息）。
• 开发者需要更新消息添加的辅助函数，使其能够支持和解析这种多块消息结构。

Takeaways

• 工具使用必须通过 tools 关键字参数传入工具模式（Tool Schema）定义。
• 模型决定使用工具时，助手消息结构会变为多块（Multi-Block），包含文本块和工具使用块。
• 开发者必须手动维护整个对话历史，模型本身不会存储对话记录。
• 函数执行完毕后，必须将结果作为新的消息反馈给模型，以确保对话的连续性。