SuperAPI AI 工具集

openai-assistants

智能体与模型

查看项目

更新于 10-15 22:39

技能介绍

用途:本技能讲解 OpenAI Assistants API v2 的用法,帮助维护已有状态化对话应用,并规划向 Responses API 迁移。新项目建议改用 Responses API。v1 已于 2024 年 12 月 18 日弃用,v2 计划于 2026 上半年停用。

主要能力:核心对象为 Assistants(指令、模型、工具、文件)、Threads(对话容器,持久保存消息)、Messages(文本与图片内容、附件)、Runs(异步执行,含排队、进行中、需操作、完成、失败、过期等状态,最长 10 分钟)。工具包括 Code Interpreter(沙箱运行 Python、生成图表与文件)、File Search(基于向量存储的语义检索,每助手最多 1 万个文件,向量存储 $0.10/GB/天,首 1GB 免费)、函数调用。

使用方式:安装 npm install openai@6.7.0,设置环境变量 OPENAI_API_KEY。使用 Node.js SDK 或 fetch 调用,需带 OpenAI-Beta: assistants=v2 请求头。典型流程:创建 assistant,创建 thread,添加 message,创建 run 并轮询至完成,最后列出消息;也可用 runs.stream 以 SSE 流式接收事件。

适用场景与限制:适合已有 Assistants API 代码的存量应用维护,以及迁移前的过渡期使用。不支持新项目。轮询需自行处理状态;删除线程会同时删除所有消息和运行,无法恢复;取消运行是异步的。向量存储需等待状态就绪后再使用。其他未在资料中说明的能力、价格与平台细节,暂未提供。