Assistant API 旨在帮助开发者快速开发大模型应用(Assistant),例如个人助理、智能导购、会议助手等。相比文本生成 API,Assistant API 还内置了多轮对话和工具调用组件,从而降低了大模型应用的开发成本。
Assistant API下线中,建议迁移至Responses API:内置多种工具,并支持多轮上下文管理,可作为替代方案。
为什么选择 Assistant API
Assistant API 为您提供高效、灵活的大模型应用构建能力,具备以下核心优势:
内置官方工具:提供代码执行、文生图、在线搜索等实用工具。例如,Assistant 可以直接运行 Python 代码生成结果,调用搜索功能获取实时信息,或生成图片用于创意设计。 | |
内置对话管理:提供上下文管理工具,无需手动维护对话历史。 | |
快速搭建多智能体系统:提供 Assistant、上下文、消息封装、流程控制等简易模板,可以灵活、高效地实现多智能体系统。例如具备自动规划能力的 Multi Agent 系统。 | |
快速构建 Assistant
您可以与 Assistant 进行多轮对话,同时可以选择启用流式输出。通常情况下,您需要依次完成四个主要步骤:
创建 Assistant:Assistant 配置了大模型、指令和工具列表,用于执行特定任务。
创建 Thread:Thread 将记录用户和 Assistant 的所有消息,用于实现多轮对话。
创建 Message: Message 是承载用户和 Assistant 消息的容器。
创建 Run:Run 代表 Assistant 响应多轮对话的一系列过程,包括模型推理和工具调用。在这个步骤中,可同时选择启用流式输出,实现自然的交互效果。
在Assistant API 快速入门中,您可以快速上手 Assistant 的使用方法,包括模型推理、工具调用、多轮对话和流式输出。
兼容性
模型支持
Assistant API 支持千问的多款主流模型。您可以前往模型广场查看和体验这些模型。
千问-Turbo、千问-Plus、千问-Max 模型的快照版本(例如qwen-plus-1220)仅兼容“函数调用”及“知识检索增强”工具。模型的兼容性以实际运行结果为准。
模型系列 | 模型标识符 |
千问-Turbo | qwen-turbo |
千问-Plus | qwen-plus |
千问-Max | qwen-max |
工具支持
Assistant API 支持多款官方工具,以及自定义的函数调用或插件。
插件的兼容性请以实际执行结果为准,更多详情可参考插件列表。
工具(tools) | 唯一标识符 | 用途 |
代码解释器 | code_interpreter | 帮助执行 Python 代码,适用于编程问题、数学计算、数据分析等场景 |
夸克搜索 | quark_search | 用于实时检索网络信息,增强知识获取能力。 |
文生图 | text_to_image | 将文字描述转为图像,丰富回复形式。 |
计算器 | calculator | 拥有良好的计算能力,可用于执行精确运算任务。 |
生成二维码 | generate_qrcode | 可将文本转换为二维码。 |
GitHub搜索 | github_search | 可搜索GitHub项目的实时信息。 |
函数调用(Function calling) | function | 在本地设备上执行特定功能,无需依赖外部网络服务。 |
知识检索增强(RAG) | rag | 检索外部知识,增强大模型回答准确性。 |
自定义插件 | ${plugin_id} | 连接自定义业务接口,扩展 AI 业务能力。 |


