传输方式 | https |
---|---|
请求地址 | https://open.bigmodel.cn/api/v1/agents |
调用方式 | 同步调用,等待模型完成执行并返回最终结果或使用SSE调用 |
字符编码 | UTF-8 |
接口请求格式 | JSON |
响应格式 | JSON 或标准 Stream Event |
接口请求类型 | POST |
开发语言支持 | 任意可发起 http 请求的开发语言 |
字段名称 | 字段类型 | 是否必填 | 备注 |
---|---|---|---|
agent_id | String | 是 | 智能体 ID,ID值:slides_glm_agent |
messages | List<Object> | 是 | 会话消息体 |
conversation_id | String | 否 | 会话id |
role | String | 是 | 用户的输入 role = user |
content | List<Object> | 是 | 会话内容 |
type | String | 是 | 目前支持内容类型,目前仅支持 text |
text | String | 是 | 具体内容,例如:“帮我生成一个关于人工智能技术发展的市场调研” |
字段名称 | 字段类型 | 备注 |
---|---|---|
id | String | 请求唯一ID |
agent_id | String | 当前 agent id |
conversation_id | String | 当前对话的唯一ID |
choices | List<Object> | 智能体响应选项 |
index | Number | 事件编号,单调递增 |
messages | List<Object> | 智能体响应消息体 |
role | String | 智能体的角色 role = assistant |
phase | String | 当前角色的状态:思考-thinking 、使用工具-tool 、回答-answer |
content | List<Object> | 智能体响应内容 |
type | String | 响应内容类型:文本-text 、对象-object |
tag_cn | String | 标签(中文),例如:Insert Page |
tag_en | String | 标签(英文),例如:插入幻灯片 |
text | String | 如果 type = text ,则这个字段以字符串格式给出具体内容 |
object | Object | 如果 type = object ,则这个字段以对象格式给出具体内容 |
tool_name | String | 工具唯一标识,例如:“search”、“insert_page” |
input | String | 调用工具的输入。例如,搜索时,此字段给出了具体的搜索词。 |
output | String | 工具执行后的输出。例如,生成幻灯片时,HTML 内容通过此字段输出。 |
position | List<Number> | 如果工具涉及到 PPT 的操作,position 字段指明具体操作哪几页 slides; 例如:当用户输入「在第二页之后插入一张幻灯片」,则 position = [3], output 是第三页幻灯片的 HTML 内容;当用户输入「请删除第四、五、 六页幻灯片」,则 position = [4, 5, 6]; |
传输方式 | https |
---|---|
请求地址 | https://open.bigmodel.cn/api/v1/agents/conversation/ |
调用方式 | 同步调用,等待模型完成执行并返回最终结果或使用SSE调用 |
字符编码 | UTF-8 |
接口请求格式 | JSON |
响应格式 | JSON |
接口请求类型 | POST |
开发语言支持 | 任意可发起 http 请求的开发语言 |
字段名称 | 字段类型 | 是否必填 | 备注 |
---|---|---|---|
agent_id | String | 是 | 智能体 ID,ID值:slides_glm_agent |
conversation_id | String | 是 | 当前对话的唯一ID |
custom_variables | Object | 否 | 自定义参数 |
pages | List<Object> | 是 | 涉及的 slides |
position | Number | 是 | Slide 页码 |
width | Number | 是 | 宽,单位 px |
height | Number | 是 | 高,单位 px |
include_pdf | Boolean | 是 | 是否导出 PDF 文件 |
字段名称 | 字段类型 | 备注 |
---|---|---|
agent_id | String | 固定值:slides_glm_agent |
conversation_id | String | 当前对话的唯一ID |
choices | List<Object> | 智能体响应选项 |
messages | List<Object> | 智能体响应消息体 |
role | String | 智能体的角色 role = assistant |
content | List<Object> | 智能体响应内容 |
type | String | 响应内容类型:文件下载链接-file_url 、图片下载链接-image_url |
tag_cn | String | 标签(中文),例如:市场调研.pdf |
tag_en | String | 标签(英文),例如:market research.pdf |
file_url | String | 如果 type = file_url ,则这个字段给出文件的具体下载链接 |
image_url | String | 如果 type = image_url ,则这个字段给出图片的具体下载链接 |