必须手动配置HTTP Request节点实现,因Dify当前版本(≤v1.2.0)未内置OpenAI Assistants API供应商类型;需通过POST请求创建线程、触发Run并轮询状态,且知识库与工具须在OpenAI平台侧配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Dify中托管具备多步推理、工具调用和长期记忆能力的高级Agent,必须绕过Dify原生Agent工作流的限制,直接对接OpenAI Assistants API——它原生支持线程(Thread)、文件上传、代码解释器、函数调用及运行状态轮询等关键能力。
确认Dify是否支持Assistants API直连
进入Dify控制台 → 设置 → 模型供应商 → 查看是否有“OpenAI Assistants”或“Assistants API”类型选项。若未出现,说明当前版本(≤v1.2.0)尚未内置该供应商类型,【必须手动配置HTTP Request节点实现】。Dify官方文档明确标注:Assistants API不兼容传统/v1/chat/completions接口路径,混用将导致404或invalid_request_error。
检查插件市场是否上架“OpenAI Assistants Connector”插件。如有,安装后刷新页面;如无,跳至下一阶段。
配置Assistants API专用模型供应商(仅限v1.3.0+)
方法一:使用内置Assistants供应商(推荐)
① 在模型供应商列表中点击“+ 添加”,选择“OpenAI Assistants”类型;
② Base URL填写:https://api.openai.com/v1/assistants(注意结尾无斜杠,且不是/v1);
③ API Key填入OpenAI平台生成的Secret Key(【切勿复用个人ChatGPT账户Key】),确保该Key已开通Assistants权限(在OpenAI Settings → API keys → View permissions);
④ 模型名称字段填入你在OpenAI平台创建的Assistant ID(格式如 asst_abc123xyz),不是模型名(gpt-4-turbo);
⑤ 保存后,在应用编辑页的“大模型”下拉菜单中即可选择该供应商条目。
在工作流中调用Assistants API(全版本通用)
方法一:通过HTTP Request节点手动构造请求
拖入一个HTTP Request节点 → 方法选POST → URL填:https://api.openai.com/v1/threads;
在Headers中添加:Authorization: Bearer sk-xxx 和 Content-Type: application/json;
Body填JSON:
{"messages": [{"role": "user", "content": "{{input}}"}]};
这一步会创建新线程并发送首条消息,返回thread_id用于后续步骤。
方法二:复用已有线程ID(避免每次新建)
在工作流开头加一个“变量”节点,设置thread_id为全局变量(如从用户会话ID哈希生成);
HTTP Request节点URL改为:https://api.openai.com/v1/threads/{{thread_id}}/messages,Body同上;
注意:OpenAI对单个thread_id的message写入有速率限制(每秒1次),高频场景需加延迟节点或队列缓冲。
方法三:触发Run并轮询结果
在发送消息后,再接一个HTTP Request节点,URL为:https://api.openai.com/v1/threads/{{thread_id}}/runs,Body:{"assistant_id": "asst_abc123xyz"};
获取run_id后,用第三个HTTP Request节点轮询:https://api.openai.com/v1/threads/{{thread_id}}/runs/{{run_id}},直到status字段变为“completed”;
最后用JSON Path提取响应中的最新message内容作为输出。
挂载知识库与工具到OpenAI Assistant
这一步必须在OpenAI平台完成,Dify无法代理配置。
登录platform.openai.com → Assistants → 编辑目标Assistant → 在“Tools”区域勾选Code Interpreter、Retrieval或自定义Function;
在“Files”区域上传PDF/CSV等文件,系统自动索引为检索知识源;
关键点:Dify工作流中调用的Assistant ID,必须已在OpenAI平台完成上述配置并发布,否则即使调用成功,也会忽略工具和文件。
若需动态更新知识库,不能依赖Dify知识库模块——必须调用OpenAI Files API(POST /v1/files)单独上传,并在Assistant配置中重新关联file_id。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











