SuperAPI AI 工具集

openai-assistants

智能体与模型

查看项目

更新于 10-16 03:14

技能介绍

用途:该技能用于构建有状态聊天机器人,基于 OpenAI Assistants API v2,涵盖助手、线程、消息、运行等对象,以及代码解释器、文件检索与函数调用三类工具。官方已宣布 v2 将在 H1 2026 停止服务,新的 Responses API 现已可用,建议新项目改用 openai-responses。

主要能力:助手可配置指令(最长 256k 字符)、模型、最多 128 个工具、tool_resources、温度与响应格式等。线程保存消息历史并跨运行持久化,最多 10 万条消息。消息支持文本、图像与附件。运行支持 queued、in_progress、requires_action、completed、failed、expired 等状态,可轮询、取消与流式(SSE)输出。Code Interpreter 在沙箱中运行 Python、生成图表并处理文件;File Search 通过向量存储做语义与关键词检索,每个助手最多 1 万个文件,向量存储按 $0.10/GB/天计费、首 1GB 免费;Function Calling 在 requires_action 时需自行处理函数回传。

使用方式:安装 npm install openai@6.7.0,设置 export OPENAI_API_KEY="sk-..."。Node.js 下用 openai.beta.assistants.create、openai.beta.threads.create、openai.beta.threads.messages.create、openai.beta.threads.runs.create 等创建并轮询;也可直接用 fetch 调用 API,需带 OpenAI-Beta: assistants=v2 请求头。运行最长约 10 分钟,轮询间隔可设为 1 秒;删除线程会级联删除其消息与运行,不可恢复。

适用与限制:适合维护已有 Assistants 代码、旧应用或迁移到 Responses 的过渡期项目;新项目不建议采用。实际使用前请以官方公告为准,迁移路径见 references/migration-to-responses.md。