---
title: "智能体对话"
method: POST
path: "/v1/agents"
tags: ["Agent API"]
---

# 智能体对话

`POST /v1/agents`

与智能体进行对话交互。支持同步和流式调用，提供智能体的专业能力。见 [智能体文档](/cn/guide/agents/translation)。点击 **Try it** 按钮可快速试用。

## Request body

- AgentRequest
  - `agent_id` 'general_translation' | 'slides_glm_agent' | 'ai_drawing_agent' | 'receipt_recognition_agent' | 'clothes_recognition_agent' | 'intelligent_education_solve_agent' | 'vidu_template_agent', required — 此处提供 通用翻译智能体 `general_translation` 的拓展参数模板作为示例，其他内嵌智能体需要参考文档在下方手动设置拓展参数。
  - `stream` boolean — 是否选择流式输出。当一个 `agent` 提供流式与非流式两种输出方式时，可根据需求选择一种。
  - `messages` object[], required — 会话消息体列表。
    - `role` 'system' | 'user' | 'assistant', required — 消息作者的角色。用户输入时 `role = user`。
    - `content` union, required
      - string — 用户输入的文本内容。
      - object — 单个多模态内容，用于只有一个元素的情况
        - `type` 'text' | 'file_id' | 'file_url' | 'image_url', required — 内容类型，可以是文本、文件`ID`、文件链接或图片链接
        - `text` string — 当 `type` 为 `text` 时的文本内容
        - `file_id` string — 当 `type` 为 `file_id` 时的文件唯一标识
        - `file_url` string — 当 `type` 为 `file_url` 时的文件链接
        - `image_url` string — 当 `type` 为 `image_url` 时的图片链接
      - object[] — 多模态内容数组，支持文本、文件和图片
        - `type` 'text' | 'file_id' | 'file_url' | 'image_url', required — 内容类型，可以是文本、文件`ID`、文件链接或图片链接
        - `text` string — 当 `type` 为 `text` 时的文本内容
        - `file_id` string — 当 `type` 为 `file_id` 时的文件唯一标识
        - `file_url` string — 当 `type` 为 `file_url` 时的文件链接
        - `image_url` string — 当 `type` 为 `image_url` 时的图片链接
  - `custom_variables` union — 智能体扩展参数。根据不同智能体的需求提供相应的参数配置。
    - TranslationAgentCustomVariables — 当前为 [通用翻译智能体](/cn/guide/agents/translation) `general_translation` 扩展参数预设
      - `source_lang` 'auto' | 'zh-CN' | 'zh-TW' | 'wyw' | 'yue' | 'en' | 'ja' | 'ko' | 'fr' | 'de' | 'es' | 'ru' | 'pt' | 'it' | 'ar' | 'hi' | 'bg' | 'cs' | 'da' | 'el' | 'et' | 'fi' | 'hu' | 'id' | 'lt' | 'lv' | 'nl' | 'no' | 'pl' | 'ro' | 'sk' | 'sl' | 'sv' | 'th' | 'tr' | 'uk' | 'vi' | 'my' | 'ms' | 'Pinyin' | 'IPA' — 待翻译文本的源语言代码，默认值为 `auto`
      - `target_lang` 'zh-CN' | 'zh-TW' | 'wyw' | 'yue' | 'en' | 'en-GB' | 'en-US' | 'ja' | 'ko' | 'fr' | 'de' | 'es' | 'ru' | 'pt' | 'it' | 'ar' | 'hi' | 'bg' | 'cs' | 'da' | 'el' | 'et' | 'fi' | 'hu' | 'id' | 'lt' | 'lv' | 'nl' | 'no' | 'pl' | 'ro' | 'sk' | 'sl' | 'sv' | 'th' | 'tr' | 'uk' | 'vi' | 'my' | 'ms' | 'Pinyin' | 'IPA' — 待翻译文本的目标语言代码，默认为 `zh-CN`
      - `glossary` string — 术语表`id`
      - `strategy` 'general' | 'paraphrase' | 'two_step' | 'three_step' | 'reflection' | 'cot' — 翻译策略
      - `strategy_config` object — 翻译策略对应的参数
        - `general` object — 当翻译策略指定为`general`时生效
          - `suggestion` string — 翻译建议或风格要求，如术语对照、文体规范等
        - `cot` object — 当翻译策略指定为`cot`时生效
          - `reason_lang` 'from' | 'to' — 翻译理由的语言，取值 ["from"｜"to"]，默认 "to"
    - CustomAgentCustomVariables — 自定义其它智能体的扩展参数，具体参数字段可参考对应的[智能体文档](/cn/guide/agents/translation)

## Response `200`

业务处理成功

- AgentResponse
  - `id` string — 请求唯一标识
  - `agent_id` string — 智能体唯一标识
  - `conversation_id` string — 对话唯一标识
  - `async_id` string — 异步任务唯一标识（异步调用时出现）
  - `choices` object[] — 智能体响应列表。
    - `index` integer — 结果索引。
    - `messages` object[] — 智能体生成的响应消息列表。
      - `role` string — 响应角色，通常为 `assistant`。
      - `content` union
        - string — 智能体生成的响应内容（纯文本格式）。
        - object — 单个多模态响应内容，用于响应只有一个元素的情况
          - `type` 'text' | 'file_url' | 'image_url' | 'audio_url' | 'video_url', required — 内容类型，可以是文本、文件、图片、音频或视频
          - `text` string — 当 `type` 为 `text` 时的文本内容
          - `file_url` string — 当 `type` 为 `file_url` 时的文件链接
          - `image_url` string — 当 `type` 为 `image_url` 时的图片链接
          - `audio_url` string — 当 `type` 为 `audio_url` 时的音频链接
          - `video_url` string — 当 `type` 为 `video_url` 时的视频链接
        - object[] — 多模态响应内容数组，支持文本、文件、图片、音频和视频
          - `type` 'text' | 'file_url' | 'image_url' | 'audio_url' | 'video_url', required — 内容类型，可以是文本、文件、图片、音频或视频
          - `text` string — 当 `type` 为 `text` 时的文本内容
          - `file_url` string — 当 `type` 为 `file_url` 时的文件链接
          - `image_url` string — 当 `type` 为 `image_url` 时的图片链接
          - `audio_url` string — 当 `type` 为 `audio_url` 时的音频链接
          - `video_url` string — 当 `type` 为 `video_url` 时的视频链接
    - `finish_reason` string — 响应结束原因。可能的取值为 正常结束-`stop`、长度达到上限-`length`、内容敏感-`sensitive` 或 网络错误-`network_error`。
  - `usage` UsageStatistics — 调用结束时返回的 `Token` 使用统计。
    - `prompt_tokens` integer — 用户输入的 `Token` 数量
    - `completion_tokens` integer — 输出的 `Token` 数量
    - `total_tokens` integer — `Token` 总数

## 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)