QwenLM/Qwen项目中百炼文档Function Call示例问题分析

在QwenLM/Qwen项目的百炼文档中，关于Function Call的示例代码存在一个常见但容易被忽视的问题。这个问题会导致开发者在实际调用API时遇到参数错误，影响开发效率。

问题现象

当开发者按照文档示例代码执行Function Call时，系统会返回400错误，提示消息内容不合法。具体错误信息表明：当消息角色为"tool"时，必须是对前一条包含"tool_calls"消息的响应。这意味着示例代码中缺少了关键的一步操作。

技术分析

在OpenAI风格的API调用中，Function Call的正确流程应该包含以下几个步骤：

1. 首次调用时传入messages和tools参数
2. 获取包含tool_calls的响应
3. 将响应消息追加到对话历史中
4. 然后才能发送tool角色的消息

文档示例中缺少了第三步，即没有将首次调用的响应消息追加到对话历史中，导致后续调用时上下文不完整，API无法验证tool消息的合法性。

解决方案

正确的代码实现应该包含以下关键修改：

# 首次调用获取工具调用请求
first_response = client.chat.completions.create(
    model="qwen-plus",
    messages=messages,
    tools=tools
)

# 必须将响应消息添加到对话历史中
assistant_output = first_response.choices[0].message
messages.append(assistant_output)  # 这是文档中缺失的关键步骤

# 然后才能处理工具调用结果

最佳实践建议

1. 在使用Function Call时，务必保持对话上下文的完整性
2. 每次API调用后，都应该将响应消息添加到对话历史中
3. 对于工具调用的响应，需要确保其对应前一个工具调用请求
4. 在开发过程中，建议逐步打印和检查messages列表的内容，确保上下文结构正确

这个问题虽然看似简单，但对于刚接触Function Call功能的开发者来说可能会造成困扰。理解API调用的上下文管理机制，是正确使用这类功能的关键。