智能体对话

与智能体进行对话交互。支持同步和流式调用，提供智能体的专业能力。见 智能体文档

POST /v1/agents

Try it

智能体对话

cURL

curl --request POST \
  --url https://open.bigmodel.cn/api/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "general_translation",
  "messages": [
    {
      "role": "user",
      "content": "请帮我翻译这段文字：Hello World"
    }
  ],
  "stream": false,
  "custom_variables": {
    "source_lang": "en",
    "target_lang": "zh-CN",
    "strategy": "general",
    "strategy_config": {
      "general": {
        "suggestion": "专业技术文档翻译风格"
      }
    }
  }
}
'

200

{
  "id": "<string>",
  "agent_id": "<string>",
  "conversation_id": "<string>",
  "async_id": "<string>",
  "choices": [
    {
      "index": 123,
      "messages": [
        {
          "role": "assistant",
          "content": "<string>"
        }
      ],
      "finish_reason": "<string>"
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123
  }
}

Authorizations

Authorization · string · header · required

使用以下格式进行身份验证：Bearer

Body

application/json

agent_id · enum<string> · required

智能体 ID

Available options: general_translation, slides_glm_agent, cartoon_generator_agent, ai_drawing_agent, receipt_recognition_agent, clothes_recognition_agent, contract_parser_agent, service_check_agent, subtitle_translation_agent, intelligent_education_correction_agent, job_matching_agent, social_translation_agent, social_literature_translation_agent, intelligent_education_solve_agent, vidu_template_agent, bidwin_parser_agent

messages · object[] · required

会话消息体列表。

Minimum array length: 1

Hide child attributes

messages. role · enum<string> · required

消息作者的角色。用户输入时 role = user。

Available options: system, user, assistant

Example:

"user"

messages. content · required

用户输入的文本内容。

Example:

"请帮我翻译这段文字：Hello World"

stream · boolean · default: false

是否选择流式输出。当一个 agent 提供流式与非流式两种输出方式时，可根据需求选择一种。

custom_variables · 通用翻译智能体 · object

智能体扩展参数。根据不同智能体的需求提供相应的参数配置。

通用翻译智能体

Hide child attributes

custom_variables. source_lang · enum<string> · default: auto

待翻译文本的源语言代码，默认值为 auto

Available options: 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

custom_variables. target_lang · enum<string> · default: zh-CN

待翻译文本的目标语言代码，默认为 zh-CN

Available options: 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

custom_variables. glossary · string

术语表id

custom_variables. strategy · enum<string> · default: general

翻译策略

Available options: general, paraphrase, two_step, three_step, reflection, cot

custom_variables. strategy_config · object

翻译策略对应的参数

Hide child attributes

custom_variables.strategy_config. general · object

当翻译策略指定为general时生效

Hide child attributes

custom_variables.strategy_config.general. suggestion · string

翻译建议或风格要求，如术语对照、文体规范等

custom_variables.strategy_config. cot · object

当翻译策略指定为cot时生效

Hide child attributes

custom_variables.strategy_config.cot. reason_lang · enum<string> · default: to

翻译理由的语言，取值 ["from"｜"to"]，默认 "to"

Available options: from, to

Example:

{
  "source_lang": "en",
  "target_lang": "zh-CN",
  "strategy": "general",
  "strategy_config": { "general": { "suggestion": "专业技术文档翻译风格" } }
}

Response

200

application/json

业务处理成功

id · string

请求唯一标识

agent_id · string

智能体唯一标识

conversation_id · string

对话唯一标识

async_id · string

异步任务唯一标识（异步调用时出现）

choices · object[]

智能体响应列表。

Hide child attributes

choices. index · integer

结果索引。

choices. messages · object[]

智能体生成的响应消息列表。

Hide child attributes

choices.messages. role · string

响应角色，通常为 assistant。

Example:

"assistant"

choices.messages. content

智能体生成的响应内容（纯文本格式）。

choices. finish_reason · string

响应结束原因。可能的取值为 正常结束-stop、长度达到上限-length、内容敏感-sensitive 或 网络错误-network_error。

usage · object

调用结束时返回的 Token 使用统计。

Hide child attributes

usage. prompt_tokens · integer

用户输入的 Token 数量

usage. completion_tokens · integer

输出的 Token 数量

usage. total_tokens · integer

Token 总数