OpenAI: 运行助手 操作
- Updated: 2025/04/30
OpenAI: 运行助手 操作
OpenAI: 运行助手 操作 使用 OpenAI 的助手 API (v2) 在您自己的应用程序中构建 AI 助手。 助手拥有指令,并可以利用模型、工具和知识来回应用户的查询。 v2 助手 API 目前支持三种类型的工具: 代码解释器、文件搜索和函数调用。
先决条件
- 您必须拥有机器人创造程序角色才能在自动化中使用 OpenAI 运行助手 操作。
- 确保您拥有发送请求所需的凭据,并在调用任何 OpenAI 操作之前包含 OpenAI: 身份验证操作。
- 理解助手的局限性: 了解助手的能力和局限性有助于您设定现实的期望。
此示例展示了如何在 OpenAI 运行助手 操作 中加载一个现有的助手并获得适当的响应。 如果您有兴趣学习如何创建自己的助手,请参阅 OpenAI Create Assistant。
过程
代码解释器:
以下示例演示了如何在启用代码解释器的情况下使用助手生成斐波那契数列的前八项。

上述自动化的响应如下:
{ "metadata": {}, "data": [ { "role": "助手","content": [ { "type": "文本","text": { "value": "斐波那契数列的前 8 项是:\n\n\\[0, 1, 1, 2, 3, 5, 8, 13\\]", "annotations": [] } } ] }, { "role": "助手","content": [ { "type": "文本","text": { "value": "斐波那契数列是一个数字序列,其中每个数字是前两个数字之和,从 0 和 1 开始。 让我们生成斐波那契数列的前8项。", "annotations": [] } } ] } ], "status":"完成" }
文件搜索:
以下示例演示了如何在启用文件搜索的情况下使用助手。 在这种情况下,助手会读取附件文件以生成回复。

上述自动化的响应如下:
{ "metadata": {}, "data": [ { "role": "助手","content": [ { "type": "文本","text": { "value": "以下是附加文件中列出的假期:\n\n1. 元旦 \n 2。 马丁·路德·金 纪念日 \n 3。 总统日 \n 4。 阵亡将士纪念日 \n 5。 独立日 \n 6。 劳动节\n7。 哥伦布日 \n 8。 退伍军人节 \n 9。 感恩节 \n 10。 圣诞节 \n \n 这些假期在附加的文件中找到。", "annotations": [] } } ] } ], "status": "完成" }
注:
- 要上传多个文件,您可以添加文件 ID 列表。 这些文件 ID 是分配给使用 OpenAI 上传的文件的唯一标识符。 有关在助手中上传和检索文件的更多信息,请参阅 OpenAI Files Operations。
- 上传到 OpenAI 的 Control Room 文件或桌面文件可以在 OpenAI 存储中找到。
函数:
以下示例演示了如何使用带有函数的助手。 在这种情况下,假设您希望您的助手获取天气信息。 通过提供一个名为 get_weather
的新函数(以及描述和参数),您为助手配备了这一新技能。
{ "name": "获取天气","description": "确定我所在位置的天气","parameters": { "type": "对象","properties": { "location": { "type": "字符串","description": "城市和州,例如:旧金山,加利福尼亚" },"unit": { "type": "字符串","enum": [ "摄氏","华氏" ] } },"required": [ "位置" ] } }
以下图像后的 JSON 输出突出显示了助手的状态为 requires_action
。 这表明助手正在等待您的指示以继续进行。 您现在可以利用 OpenAI: 运行助手功能 操作 来指导助手如何使用新引入的 get_weather
函数,并根据检索到的数据制定适当的响应。

上述自动化的响应如下:
{ "data":{ "thread_id":"thread_Sizn8HNIKH5NzDYXQ61n05RC", "tool_calls":[ { "id":"call_wCWp3g9fdWLszmSvUMqglyW5", "type":"function", "function":{ "name":"get_weather", "arguments":"{\"location\":\"Chicago, IL\"}" } } ], "id":"run_MBq3pioUk9K0NaREPOIY4qFG" }, "status":"requires_action" }
您可以使用 JSON 中的线程 ID、调用 ID 和运行 ID 调用 OpenAI: 运行助手功能 操作。