---
title: "问答 Agent 对话（流式）"
method: POST
path: "/zrag/agent/chat"
tags: ["Agent API"]
---

# 问答 Agent 对话（流式）

`POST /zrag/agent/chat`

基于 ReAct（Reasoning + Acting）推理引擎的流式对话接口。LLM 会根据用户问题自主决定是否调用工具（知识检索、查询重写等），并通过 SSE 实时推送思考过程、工具调用和最终回答。点击 **Try it** 按钮可快速试用。

## Headers

- `X-Session-Id` string

## Request body

- AgentChatRequest
  - `messages` AgentMessage[], required — 当前消息列表，支持多模态内容
    - `role` 'user', required — 角色：user
    - `content` union, required — 消息内容。纯文本用 String，多模态用 ContentPart 数组
      - string
      - AgentContentPart[]
        - `type` 'text' | 'image_url' — 内容类型
        - `text` string — 文本内容（type=text 时）
        - `image_url` object — 图片 URL（type=image_url 时）
          - `url` string — 图片链接地址
  - `model` string — LLM 模型名称，默认为 glm-5v-turbo
  - `temperature` number — 采样温度，默认为 0.7
  - `max_steps` integer — 最大推理步数，默认为 10
  - `retrieval` AgentRetrieval, required — 检索预设参数。预设后 LLM 仅决定是否调用检索，无需自行填写参数
    - `know_ids` string[], required — 知识库 ID 列表
    - `top_k` integer — 检索数量
    - `top_n` integer — 召回数量
    - `enable_rerank` boolean — 是否启用重排序
    - `similarity_threshold` number — 相似度阈值
  - `enable_thinking` boolean — 是否启用思考模式。启用后模型输出推理过程，通过 reasoning 事件流式返回

## Response `200`

SSE 流式响应，返回 AgentStreamEvent 事件流

## Other responses

- `default` — 请求失败

---

[API](https://skmtc.net/bigmodel/apis/zhipu-ai-api.md) · [All operations](https://skmtc.net/bigmodel/apis/zhipu-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigmodel/zhipu-ai-api/versions/37de2d7b73de/schema)