掌握OpenAI Assistant函数调用：正确提交工具输出的Python指南

本文详细阐述了在OpenAI Assistant API中处理函数调用并正确提交工具输出的方法。针对常见的`BadRequestError`问题，文章深入分析了错误原因，并提供了使用`client.beta.threads.runs.submit_tool_outputs`的正确解决方案。通过完整的Python代码示例和注意事项，旨在帮助开发者高效、准确地实现Assistant的函数调用功能，确保API交互的顺畅与可靠。

理解OpenAI Assistant的函数调用机制

OpenAI Assistant API提供了一个强大的功能，允许助手在对话过程中调用外部工具或函数来获取信息或执行操作。当助手需要调用某个函数时，它会将对话状态从“in_progress”转换为“requires_action”，并在run.required_action.submit_tool_outputs.tool_calls中提供需要调用的函数信息，包括函数名和参数。开发者的任务是执行这些函数，并将结果反馈给助手，以便其继续生成响应。

常见的错误与原因分析

许多开发者在首次尝试向Assistant提交函数执行结果时，可能会遇到类似于以下代码片段所示的错误：

# 错误的尝试
message = client.beta.threads.messages.create(
    thread_id=thread.id,
    role="tool", # 错误：此角色不适用于创建新消息来提交工具输出
    content=ret,
)

登录后复制

当尝试使用client.beta.threads.messages.create方法并指定role="tool"来提交函数执行结果时，API会返回openai.BadRequestError: Error code: 400 - {'error': {'message': "1 validation error for Request\nbody -> role\n value is not a valid enumeration member; permitted: 'user' (type=type_error.enum; enum_values=[])", ...}}。

立即学习“Python免费学习笔记（深入）”；

这个错误清晰地表明，client.beta.threads.messages.create方法中的role参数仅接受"user"（用户消息）或"assistant"（助手消息）。它并不是用来提交工具函数执行结果的接口。工具函数的结果需要通过专门的机制来通知Assistant，而不是作为普通对话消息的一部分。

标签： python js json app 工具 ai 环境变量 openai nas gpt gpt-4 区别 api调用