Assistant API 功能概览_大模型服务平台百炼(Model Studio)-阿里云帮助中心

Assistant API 是文本生成API的一个演进，旨在简化智能体应用（Assistants）的创建过程，并为开发者提供丰富的工具支持（如函数调用和知识检索增强功能）。

什么是智能体应用

智能体应用是一类 AI 对话助手，具备以下功能特点：

支持多种基础模型：智能体应用可以配置多种基础模型，还可以添加系统提示词（Instructions）以调整模型的个性和能力。
支持多工具调用：智能体应用可以调用多个工具，可以是百炼官方工具（如代码解释器和夸克搜索），也可以是您自己构建的工具（通过函数调用的方式）。
支持对话管理：智能体应用使用线程对象来管理对话。线程对象存储了消息历史记录，并在整个对话超出模型的上下文长度时截断它。您只需创建一次线程对象，然后当用户回复消息时，简单地将消息附加到线程对象中。

体验智能体应用最简单的方式是在控制台上创建智能体应用，这种方式无需编程经验。您也可以按照Assistant API 快速入门指南创建智能体应用，逐步集成到您的业务代码中。

说明

目前，“通过控制台”和“通过 Assistant API”创建的智能体应用（以下简称“控制台版本”和“API版本”），在功能和管理上存在细微差异，具体以实际产品为准：

文本生成 API 的基本要素是消息（Messages），你可以使用模型（Models，如 Qwen-Plus、Qwen-Max 等）生成消息。在使用这种轻量级的 API 时，您需要手动管理对话状态、定义工具、检索知识库和执行代码，才能构建一个简单的智能体应用。

在文本生成 API 的基础上，Assistant API 的基本要素演进为：

接下来，您将进一步了解这些基本元素的交互方式，以构建一个智能体应用。

Assistant API 使用线程（Thread）机制来确保消息按顺序执行，从而维护对话的连贯性。具体流程如下：

以一个简单的绘画智能体应用为例：

用户输入：用户输入两条消息：
- 输入1：“你是一位画家”
- 输入2：“帮我画一只猫”
消息创建：每个用户输入的消息通过 Message.create() 方法创建并发送到线程。
线程处理：线程通过 Thread.create() 创建会话，接收消息，并传递给智能体对象。
消息传递给智能体：智能体对象收到上下文信息，分别处理每条消息：
- 消息1（“你是一位画家”）的角色是用户。
- 消息2（“帮我画一只猫”）的角色也是用户。
智能体的响应：智能体对象处理用户消息后生成相应的回复，输出消息3，角色为智能体，回复内容为“布偶猫[url]”。
运行和等待：运行通过 Run.create() 创建并开始执行，之后智能体在 Run.wait() 阶段等待任务完成。

如需调试大语言模型或快速掌握 Assistant API，以下文档将为您提供详细指导：

说明

模型的兼容性请以 Assistant API 的实际执行结果为准，更多详情可参考模型列表。

工具（tools）	Assistant API 标识符	用途
代码解释器插件	code_interpreter	帮助执行 Python 代码，适用于编程问题、数学计算、数据分析等场景
夸克搜索插件	quark_search	用于实时检索网络信息，增强知识获取能力。
图片生成插件	text_to_image	将文字描述转为图像，丰富回复形式。
自定义插件	${plugin_id}	连接自定义业务接口，扩展 AI 业务能力。
函数调用（Function calling）	function	在本地设备上执行特定功能，无需依赖外部网络服务。
知识检索增强（RAG）	rag	检索外部知识，增强大模型回答准确性。

说明

插件的兼容性请以 Assistant API 的实际执行结果为准，更多详情可参考插件列表。