> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 新 Agent API

> 面向新 Agent 应用的 API，涵盖流式对话消息、会话管理、文件上传及应用配置

> 本文档由 AI 自动翻译。如有任何不准确之处，请参考 [英文原版](/en/api-reference/guides/agent)。

<Info>
  * 新 Agent 与 [Chatbot 和 Agent](/zh/api-reference/guides/chat) 中介绍的 Agent 应用（`agent-chat`）是两种不同的应用类型。
  * 新 Agent 目前处于 Beta 阶段，可在 Dify [1.16.0-rc1](https://github.com/langgenius/dify/releases) 中体验。
</Info>

[新 Agent 应用](/zh/self-host/use-dify/build/new-agent/overview) 运行在 `agent` 模式下：发送消息、流式接收生成中的回复，并通过会话保留多轮上下文。

模型会自主推理并调用工具，这些过程也会出现在事件流中：回复文本以 `agent_message` 事件增量流式返回，每个推理步骤和工具调用则以 `agent_thought` 事件同步返回。

每轮回复结束时，会先收到一个携带完整回答的 `message` 事件，然后是 `message_end`。实时渲染按 `agent_message` 增量拼接即可；收尾的 `message` 就是最终回答，不要再追加拼接。

每个 `agent_thought` 事件都包含该步骤的 `thought`、所调用的 `tool` 及其 `tool_input`，以及工具返回的 `observation`。完整的流式事件结构，详见 [发送对话消息](/zh/api-reference/chat-messages/send-chat-message)。

<Info>
  认证方式、基础 URL，以及按终端用户区分数据的 `user` 字段，详见 [快速开始](/zh/api-reference/guides/get-started) 和 [终端用户身份](/zh/api-reference/guides/end-user-identity)。
</Info>

## 发送消息并接收流式回复

* **[发送对话消息](/zh/api-reference/chat-messages/send-chat-message)**：向新 Agent 应用发送用户提问。仅支持流式返回，使用阻塞式返回会收到 400 `bad_request` 错误。

  收尾的 `message_end` 事件会报告 token 用量，但不会包含知识检索引用（`retriever_resources`）。

* **[停止响应](/zh/api-reference/chat-messages/stop-chat-message-generation)**：在回复完成前中断流式输出。

## 管理会话

* **[获取会话列表](/zh/api-reference/conversations/list-conversations)**：按最近活跃时间排序，返回当前用户的会话。
* **[获取会话历史消息](/zh/api-reference/conversations/list-conversation-messages)**：返回某个会话的历史消息，适合滚动加载的聊天界面。每条消息的 `agent_thoughts` 数组会包含该轮的推理步骤。

## 上传文件

* **[上传文件](/zh/api-reference/files/upload-file)**：上传图片、文档、音频或视频文件，仅限上传的终端用户使用。

  传给 [发送对话消息](/zh/api-reference/chat-messages/send-chat-message) 的文件，会作为可下载的引用提供给 Agent，Agent 可在其沙箱中获取并查看。

## 获取应用信息与配置

* **[获取应用基本信息](/zh/api-reference/applications/get-app-info)**：返回应用的名称、描述、标签和模式。
* **[获取应用参数](/zh/api-reference/applications/get-app-parameters)**：返回调用需在 `inputs` 中传入的字段（名称、类型、默认值），以及应用的功能开关，可据此构建请求或客户端界面。
* **[获取应用元数据](/zh/api-reference/applications/get-app-meta)**：返回应用的配置元数据；对新 Agent 应用，`tool_icons` 为空。