本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。
这里的 Agent 指新的 Agent 应用类型（
agent 模式）；旧版 Agent 应用（agent-chat）参见 Chatbot 和旧版 Agent。agent 模式下：发送消息、流式接收生成中的回复，并通过会话保留多轮上下文。
模型会自主推理并调用工具，这些过程也会出现在事件流中：回复文本以 agent_message 事件增量流式返回，每个推理步骤和工具调用则以 agent_thought 事件同步返回。
每轮回复结束时，会先收到一个携带完整回答的 message 事件，然后是 message_end。实时渲染按 agent_message 增量拼接即可；收尾的 message 就是最终回答，不要再追加拼接。
每个 agent_thought 事件都包含该步骤的 thought、所调用的 tool 及其 tool_input，以及工具返回的 observation。完整的流式事件结构，详见 发送对话消息。
发送消息并接收流式回复
-
发送对话消息：向 Agent 应用发送用户提问。仅支持流式返回，使用阻塞式返回会收到 400
bad_request错误。 回复文本以agent_message增量事件流式返回，约每 0.5 秒合并发送一批，而非逐 token 推送。 收尾的message_end事件会报告 token 用量，但不会包含知识检索引用（retriever_resources）。 单次运行有两类上限，触及任一上限时，流式响应都会以agent_run_limit_exceeded错误码结束：- 时长：单次运行默认在 1 小时后被终止。自部署环境要运行更长时间，可将
APP_MAX_EXECUTION_TIME、WORKFLOW_MAX_EXECUTION_TIME和DIFY_AGENT_RUN_TIMEOUT_SECONDS都调高到目标时长以上。这些变量的说明详见 环境变量。 - 模型请求次数：最多 500 次。
- 时长：单次运行默认在 1 小时后被终止。自部署环境要运行更长时间，可将
- 停止响应：在回复完成前中断流式输出。
- 获取下一轮建议问题列表：回复完成后，基于当前对话内容推荐后续问题。
管理会话
- 获取会话列表：按最近活跃时间排序，返回当前用户的会话。
- 获取会话历史消息：返回某个会话的历史消息，适合滚动加载的聊天界面。每条消息的
agent_thoughts数组会包含该轮的推理步骤。 - 重命名会话：为会话设置名称，或根据会话内容自动生成名称。
- 删除会话：删除会话及其消息。
上传文件
- 上传文件：上传图片、文档、音频或视频文件，仅限上传的终端用户使用。 传给 发送对话消息 的文件，会作为可下载的引用提供给 Agent，Agent 可在其沙箱中获取并查看。
-
获取终端用户信息：根据终端用户 ID（例如上传文件响应中的
created_by）查询该用户的详细信息。
语音转写与合成
获取应用信息与配置
- 获取应用基本信息：返回应用的名称、描述、标签和模式。
- 获取应用参数：返回调用需在
inputs中传入的字段（名称、类型、默认值），以及应用的功能开关，可据此构建请求或客户端界面。 - 获取应用元数据：返回应用的配置元数据；对 Agent 应用，
tool_icons为空。 - 获取应用 Web 应用设置：返回 Web 应用的站点配置、主题和自定义选项。