--- title: "创建 Channel" method: POST path: "/agent/forward/v0/channels" tags: ["Channel"] --- # 创建 Channel `POST /agent/forward/v0/channels` ## Request - Base URL: `https://agent-api.bigmodel.cn/api` - URL: `https://agent-api.bigmodel.cn/api/agent/forward/v0/channels` - Auth: HTTP bearer 创建 Channel，将固定版本的 Agent 绑定到飞书、企业微信、钉钉或个人微信；201 仅表示保存成功，连接异步建立，凭据永不回显。 ## Headers - `zai-version` '2026-05-26', required - `zai-beta` string, required ## Request body - union: 按 channel_type 选择配置。所有对象均为严格 Schema，未知、跨渠道字段或类型错误返回 400。 - ForwardFeishuChannelCreateRequest - `channel_type` 'feishu', required: 固定为 feishu。 - `name` string, required: 名称；trim 后 1–128 字符。 - `template` ForwardChannelTemplateInput, required: Channel 固定资源模板。调用 Create API 的身份必须具有目标 Agent 的 owner 权限；所有资源须属于同一账号。资源 ID 均在 trim 后为 1–128 字符。模型、工具、MCP 与 Skills 由固定 Agent 版本定义，不接受临时覆盖。 - `agent` union, required - string: Agent ID，trim 后 1–128 字符；Create 解析并固定当前版本。 - object - `type` 'agent', required - `id` string, required: 当前身份可访问的 Agent ID；trim 后 1–128 字符。 - `version` integer: 正整数，必须属于当前 Agent；省略时创建并固定当前版本。指定版本不存在返回 404；资源预检调用失败返回 500。 - `environment_id` string, required: 当前账号未归档的 Environment ID；trim 后 1–128 字符。 - `vault_ids` string[]: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `file_ids` string[]: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `memory_stores` ForwardChannelMemoryStore[]: 默认 []，最多 8 项；memory_store_id 不得重复。Store 须属于当前账号且未归档；与自动创建的私有 Memory Store 合计最多 8 个。已归档 Store 返回 409，资源预检调用失败返回 500。 - `memory_store_id` string, required: Memory Store ID；trim 后 1–128 字符，须属于当前账号且未归档。 - `access` 'read_only' | 'read_write' - `channel_config` ForwardFeishuChannelConfigInput, required: 飞书创建配置；未知字段、类型错误和跨渠道字段返回 400。序列化后的配置 JSON 不得超过 65,535 UTF-8 字节，超限返回 400。 - `response_options` ForwardChannelResponseOptionsInput - `include_tool_calls` boolean: 展示公开工具名称、状态和返回项数；不展示工具原始参数或结果。 - `include_process` boolean: 展示公开 Agent 过程正文，不展示隐藏推理。最终回复取本轮最后一条非空 agent.message。 - `card_output` boolean: 启用渠道卡片或流式展示；false 时仅发送最终文本。钉钉还需有效互动卡片模板；个人微信始终仅最终回复。 - `private_memory_store_enabled` boolean: 自动为会话范围创建并挂载私有 Memory Store；创建后不可修改。与 template.memory_stores 合计最多 8 个。 - `credentials` ForwardFeishuCredentials, required: 标识字段 trim 后 1–256 字符，Secret 1–4096 字符且不 trim。凭据对象另有加密存储的组合长度上限，组合过长返回 400；凭据永不回显。 - `app_id` string, required: 飞书机器人/应用标识；trim 后 1–256 字符。 - `app_secret` string, required: 飞书 Secret，1–4096 字符；不 trim，仅写入，永不回显。 - `group_prompt_template` string, nullable: 群聊提示模板；仅 Feishu / WeCom / DingTalk 可写入，WeChat 禁止。null 恢复默认。最多 4096 个 UTF-16 code units；{{context_note}} 与 {{messages}} 必须各出现一次，空串、缺失/重复/未知或残缺占位符返回 400。只做一次文本替换，不支持表达式。 - `group_reply_in_thread` boolean: 仅 Feishu。true 时普通群 @ 后在触发消息下创建话题回复；false 直接回复。已有话题沿用原话题，私聊不受影响；不扩大历史权限。 - ForwardWeComChannelCreateRequest - `channel_type` 'wecom', required: 固定为 wecom。 - `name` string, required: 名称；trim 后 1–128 字符。 - `template` ForwardChannelTemplateInput, required: Channel 固定资源模板。调用 Create API 的身份必须具有目标 Agent 的 owner 权限；所有资源须属于同一账号。资源 ID 均在 trim 后为 1–128 字符。模型、工具、MCP 与 Skills 由固定 Agent 版本定义，不接受临时覆盖。 - `agent` union, required - string: Agent ID，trim 后 1–128 字符；Create 解析并固定当前版本。 - object - `type` 'agent', required - `id` string, required: 当前身份可访问的 Agent ID；trim 后 1–128 字符。 - `version` integer: 正整数，必须属于当前 Agent；省略时创建并固定当前版本。指定版本不存在返回 404；资源预检调用失败返回 500。 - `environment_id` string, required: 当前账号未归档的 Environment ID；trim 后 1–128 字符。 - `vault_ids` string[]: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `file_ids` string[]: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `memory_stores` ForwardChannelMemoryStore[]: 默认 []，最多 8 项；memory_store_id 不得重复。Store 须属于当前账号且未归档；与自动创建的私有 Memory Store 合计最多 8 个。已归档 Store 返回 409，资源预检调用失败返回 500。 - `memory_store_id` string, required: Memory Store ID；trim 后 1–128 字符，须属于当前账号且未归档。 - `access` 'read_only' | 'read_write' - `channel_config` ForwardWeComChannelConfigInput, required: 企业微信创建配置；未知字段、类型错误和跨渠道字段返回 400。序列化后的配置 JSON 不得超过 65,535 UTF-8 字节，超限返回 400。 - `response_options` ForwardChannelResponseOptionsInput - `include_tool_calls` boolean: 展示公开工具名称、状态和返回项数；不展示工具原始参数或结果。 - `include_process` boolean: 展示公开 Agent 过程正文，不展示隐藏推理。最终回复取本轮最后一条非空 agent.message。 - `card_output` boolean: 启用渠道卡片或流式展示；false 时仅发送最终文本。钉钉还需有效互动卡片模板；个人微信始终仅最终回复。 - `private_memory_store_enabled` boolean: 自动为会话范围创建并挂载私有 Memory Store；创建后不可修改。与 template.memory_stores 合计最多 8 个。 - `credentials` ForwardWeComCredentials, required: 标识字段 trim 后 1–256 字符，Secret 1–4096 字符且不 trim。凭据对象另有加密存储的组合长度上限，组合过长返回 400；凭据永不回显。 - `bot_id` string, required: 企业微信智能机器人的 Bot ID，对应长连接 API 配置页的 Bot ID；trim 后 1–256 字符。不接受 CorpID、AgentId 或群机器人 Webhook URL。 - `secret` string, required: 同一企业微信智能机器人长连接 API 配置页的 Secret，不是普通自建应用 Secret；1–4096 字符，不 trim，仅写入，永不回显。 - `group_prompt_template` string, nullable: 群聊提示模板；仅 Feishu / WeCom / DingTalk 可写入，WeChat 禁止。null 恢复默认。最多 4096 个 UTF-16 code units；{{context_note}} 与 {{messages}} 必须各出现一次，空串、缺失/重复/未知或残缺占位符返回 400。只做一次文本替换，不支持表达式。 - ForwardDingTalkChannelCreateRequest - `channel_type` 'dingtalk', required: 固定为 dingtalk。 - `name` string, required: 名称；trim 后 1–128 字符。 - `template` ForwardChannelTemplateInput, required: Channel 固定资源模板。调用 Create API 的身份必须具有目标 Agent 的 owner 权限；所有资源须属于同一账号。资源 ID 均在 trim 后为 1–128 字符。模型、工具、MCP 与 Skills 由固定 Agent 版本定义，不接受临时覆盖。 - `agent` union, required - string: Agent ID，trim 后 1–128 字符；Create 解析并固定当前版本。 - object - `type` 'agent', required - `id` string, required: 当前身份可访问的 Agent ID；trim 后 1–128 字符。 - `version` integer: 正整数，必须属于当前 Agent；省略时创建并固定当前版本。指定版本不存在返回 404；资源预检调用失败返回 500。 - `environment_id` string, required: 当前账号未归档的 Environment ID；trim 后 1–128 字符。 - `vault_ids` string[]: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `file_ids` string[]: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `memory_stores` ForwardChannelMemoryStore[]: 默认 []，最多 8 项；memory_store_id 不得重复。Store 须属于当前账号且未归档；与自动创建的私有 Memory Store 合计最多 8 个。已归档 Store 返回 409，资源预检调用失败返回 500。 - `memory_store_id` string, required: Memory Store ID；trim 后 1–128 字符，须属于当前账号且未归档。 - `access` 'read_only' | 'read_write' - `channel_config` ForwardDingTalkChannelConfigInput, required: 钉钉创建配置；未知字段、类型错误和跨渠道字段返回 400。序列化后的配置 JSON 不得超过 65,535 UTF-8 字节，超限返回 400。 - `response_options` ForwardChannelResponseOptionsInput - `include_tool_calls` boolean: 展示公开工具名称、状态和返回项数；不展示工具原始参数或结果。 - `include_process` boolean: 展示公开 Agent 过程正文，不展示隐藏推理。最终回复取本轮最后一条非空 agent.message。 - `card_output` boolean: 启用渠道卡片或流式展示；false 时仅发送最终文本。钉钉还需有效互动卡片模板；个人微信始终仅最终回复。 - `private_memory_store_enabled` boolean: 自动为会话范围创建并挂载私有 Memory Store；创建后不可修改。与 template.memory_stores 合计最多 8 个。 - `credentials` ForwardDingTalkCredentials, required: 标识字段 trim 后 1–256 字符，Secret 1–4096 字符且不 trim。凭据对象另有加密存储的组合长度上限，组合过长返回 400；凭据永不回显。 - `client_id` string, required: 钉钉机器人/应用标识；trim 后 1–256 字符。 - `client_secret` string, required: 钉钉 Secret，1–4096 字符；不 trim，仅写入，永不回显。 - `group_prompt_template` string, nullable: 群聊提示模板；仅 Feishu / WeCom / DingTalk 可写入，WeChat 禁止。null 恢复默认。最多 4096 个 UTF-16 code units；{{context_note}} 与 {{messages}} 必须各出现一次，空串、缺失/重复/未知或残缺占位符返回 400。只做一次文本替换，不支持表达式。 - `card_template_id` string, nullable: 仅 DingTalk；已发布且该应用可访问的互动卡片模板 ID。trim 后 1–256 字符，只含字母、数字、下划线、点、冒号、连字符；null 关闭模板。 - `card_content_key` string: 仅 DingTalk；绑定 Markdown 正文的变量名，默认 content。trim 后 1–64 字符，字母开头，后续仅字母、数字或下划线。 - ForwardWeChatChannelCreateRequest - `channel_type` 'wechat', required: 固定为 wechat。 - `name` string, required: 名称；trim 后 1–128 字符。 - `template` ForwardChannelTemplateInput, required: Channel 固定资源模板。调用 Create API 的身份必须具有目标 Agent 的 owner 权限；所有资源须属于同一账号。资源 ID 均在 trim 后为 1–128 字符。模型、工具、MCP 与 Skills 由固定 Agent 版本定义，不接受临时覆盖。 - `agent` union, required - string: Agent ID，trim 后 1–128 字符；Create 解析并固定当前版本。 - object - `type` 'agent', required - `id` string, required: 当前身份可访问的 Agent ID；trim 后 1–128 字符。 - `version` integer: 正整数，必须属于当前 Agent；省略时创建并固定当前版本。指定版本不存在返回 404；资源预检调用失败返回 500。 - `environment_id` string, required: 当前账号未归档的 Environment ID；trim 后 1–128 字符。 - `vault_ids` string[]: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `file_ids` string[]: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `memory_stores` ForwardChannelMemoryStore[]: 默认 []，最多 8 项；memory_store_id 不得重复。Store 须属于当前账号且未归档；与自动创建的私有 Memory Store 合计最多 8 个。已归档 Store 返回 409，资源预检调用失败返回 500。 - `memory_store_id` string, required: Memory Store ID；trim 后 1–128 字符，须属于当前账号且未归档。 - `access` 'read_only' | 'read_write' - `channel_config` ForwardWeChatChannelConfigInput, required: 个人微信创建配置；未知字段、类型错误和跨渠道字段返回 400。创建时不传 credentials 或任何群聊、话题、卡片字段；后续扫码绑定。序列化后的配置 JSON 不得超过 65,535 UTF-8 字节，超限返回 400。 - `response_options` ForwardChannelResponseOptionsInput - `include_tool_calls` boolean: 展示公开工具名称、状态和返回项数；不展示工具原始参数或结果。 - `include_process` boolean: 展示公开 Agent 过程正文，不展示隐藏推理。最终回复取本轮最后一条非空 agent.message。 - `card_output` boolean: 启用渠道卡片或流式展示；false 时仅发送最终文本。钉钉还需有效互动卡片模板；个人微信始终仅最终回复。 - `private_memory_store_enabled` boolean: 自动为会话范围创建并挂载私有 Memory Store；创建后不可修改。与 template.memory_stores 合计最多 8 个。 ## Response `201` 预检与配置保存成功，初始连接状态 disconnected；不代表可收发消息。 - union: 固定 Agent 版本和渠道安全配置。不回显 credentials、扫码 token、平台消息 ID、内部 Session ID 或计费字段。 - ForwardFeishuChannel - `id` string, required - `type` 'channel', required - `channel_type` 'feishu', required: 渠道平台。 - `name` string, required - `template` ForwardChannelTemplate, required - `agent` ForwardChannelAgent, required - `type` 'agent', required - `id` string, required - `version` integer, required - `environment_id` string, required: 当前账号未归档的 Environment ID；trim 后 1–128 字符。 - `vault_ids` string[], required: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `file_ids` string[], required: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `memory_stores` ForwardChannelMemoryStore[], required: 共享 Memory Store；ID 不可重复，与自动创建的私有 Store 合计最多挂载 8 个。 - `memory_store_id` string, required: Memory Store ID；trim 后 1–128 字符，须属于当前账号且未归档。 - `access` 'read_only' | 'read_write' - `enabled` boolean, required: 新建 Channel 固定为 true。 - `binding_status` string, required: 绑定状态。WeChat 创建后为 unbound；创建扫码会话后可能为 pending，继续查询 QR 状态；手机确认后为 bound。其他渠道通常创建后为 bound。 - `connection_status` 'disconnected' | 'connecting' | 'connected' | 'error', required: 异步连接状态。disconnected 尚未建立；connecting 连接中；connected 已连接；error 查看 last_error。 - `channel_config` ForwardFeishuChannelConfig, required - `response_options` ForwardChannelResponseOptions, required - `include_tool_calls` boolean, required: 展示公开工具名称、状态和返回项数；不展示工具原始参数或结果。 - `include_process` boolean, required: 展示公开 Agent 过程正文，不展示隐藏推理。最终回复取本轮最后一条非空 agent.message。 - `card_output` boolean, required: 启用渠道卡片或流式展示；false 时仅发送最终文本。钉钉还需有效互动卡片模板；个人微信始终仅最终回复。 - `private_memory_store_enabled` boolean, required - `group_prompt_template` string, nullable, required: 群聊提示模板；所有渠道均返回。WeChat 固定为 null，不接受配置。 - `group_reply_in_thread` boolean, required: 仅 Feishu。true 时普通群 @ 后在触发消息下创建话题回复；false 直接回复。已有话题沿用原话题，私聊不受影响；不扩大历史权限。 - `last_error` object, nullable, required: 最近连接错误的安全提示，正常时为 null；不能仅凭该字段判断某轮 Agent 执行是否成功。 - `created_at` string, date-time, required: 创建时间。 - `updated_at` string, date-time, required: 更新时间。 - ForwardWeComChannel - `id` string, required - `type` 'channel', required - `channel_type` 'wecom', required: 渠道平台。 - `name` string, required - `template` ForwardChannelTemplate, required - `agent` ForwardChannelAgent, required - `type` 'agent', required - `id` string, required - `version` integer, required - `environment_id` string, required: 当前账号未归档的 Environment ID；trim 后 1–128 字符。 - `vault_ids` string[], required: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `file_ids` string[], required: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `memory_stores` ForwardChannelMemoryStore[], required: 共享 Memory Store；ID 不可重复，与自动创建的私有 Store 合计最多挂载 8 个。 - `memory_store_id` string, required: Memory Store ID；trim 后 1–128 字符，须属于当前账号且未归档。 - `access` 'read_only' | 'read_write' - `enabled` boolean, required: 新建 Channel 固定为 true。 - `binding_status` string, required: 绑定状态。WeChat 创建后为 unbound；创建扫码会话后可能为 pending，继续查询 QR 状态；手机确认后为 bound。其他渠道通常创建后为 bound。 - `connection_status` 'disconnected' | 'connecting' | 'connected' | 'error', required: 异步连接状态。disconnected 尚未建立；connecting 连接中；connected 已连接；error 查看 last_error。 - `channel_config` ForwardWeComChannelConfig, required - `response_options` ForwardChannelResponseOptions, required - `include_tool_calls` boolean, required: 展示公开工具名称、状态和返回项数；不展示工具原始参数或结果。 - `include_process` boolean, required: 展示公开 Agent 过程正文，不展示隐藏推理。最终回复取本轮最后一条非空 agent.message。 - `card_output` boolean, required: 启用渠道卡片或流式展示；false 时仅发送最终文本。钉钉还需有效互动卡片模板；个人微信始终仅最终回复。 - `private_memory_store_enabled` boolean, required - `group_prompt_template` string, nullable, required: 群聊提示模板；所有渠道均返回。WeChat 固定为 null，不接受配置。 - `last_error` object, nullable, required: 最近连接错误的安全提示，正常时为 null；不能仅凭该字段判断某轮 Agent 执行是否成功。 - `created_at` string, date-time, required: 创建时间。 - `updated_at` string, date-time, required: 更新时间。 - ForwardDingTalkChannel - `id` string, required - `type` 'channel', required - `channel_type` 'dingtalk', required: 渠道平台。 - `name` string, required - `template` ForwardChannelTemplate, required - `agent` ForwardChannelAgent, required - `type` 'agent', required - `id` string, required - `version` integer, required - `environment_id` string, required: 当前账号未归档的 Environment ID；trim 后 1–128 字符。 - `vault_ids` string[], required: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `file_ids` string[], required: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `memory_stores` ForwardChannelMemoryStore[], required: 共享 Memory Store；ID 不可重复，与自动创建的私有 Store 合计最多挂载 8 个。 - `memory_store_id` string, required: Memory Store ID；trim 后 1–128 字符，须属于当前账号且未归档。 - `access` 'read_only' | 'read_write' - `enabled` boolean, required: 新建 Channel 固定为 true。 - `binding_status` string, required: 绑定状态。WeChat 创建后为 unbound；创建扫码会话后可能为 pending，继续查询 QR 状态；手机确认后为 bound。其他渠道通常创建后为 bound。 - `connection_status` 'disconnected' | 'connecting' | 'connected' | 'error', required: 异步连接状态。disconnected 尚未建立；connecting 连接中；connected 已连接；error 查看 last_error。 - `channel_config` ForwardDingTalkChannelConfig, required - `response_options` ForwardChannelResponseOptions, required - `include_tool_calls` boolean, required: 展示公开工具名称、状态和返回项数；不展示工具原始参数或结果。 - `include_process` boolean, required: 展示公开 Agent 过程正文，不展示隐藏推理。最终回复取本轮最后一条非空 agent.message。 - `card_output` boolean, required: 启用渠道卡片或流式展示；false 时仅发送最终文本。钉钉还需有效互动卡片模板；个人微信始终仅最终回复。 - `private_memory_store_enabled` boolean, required - `group_prompt_template` string, nullable, required: 群聊提示模板；所有渠道均返回。WeChat 固定为 null，不接受配置。 - `card_template_id` string, nullable, required: 仅 DingTalk；已发布且该应用可访问的互动卡片模板 ID。trim 后 1–256 字符，只含字母、数字、下划线、点、冒号、连字符；null 关闭模板。 - `card_content_key` string, required: 仅 DingTalk；绑定 Markdown 正文的变量名，默认 content。trim 后 1–64 字符，字母开头，后续仅字母、数字或下划线。 - `last_error` object, nullable, required: 最近连接错误的安全提示，正常时为 null；不能仅凭该字段判断某轮 Agent 执行是否成功。 - `created_at` string, date-time, required: 创建时间。 - `updated_at` string, date-time, required: 更新时间。 - ForwardWeChatChannel - `id` string, required - `type` 'channel', required - `channel_type` 'wechat', required: 渠道平台。 - `name` string, required - `template` ForwardChannelTemplate, required - `agent` ForwardChannelAgent, required - `type` 'agent', required - `id` string, required - `version` integer, required - `environment_id` string, required: 当前账号未归档的 Environment ID；trim 后 1–128 字符。 - `vault_ids` string[], required: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `file_ids` string[], required: 默认 []，最多 20 项，服务端按 ID 去重；每个 ID trim 后为 1–128 字符，资源须属于当前账号。 - `memory_stores` ForwardChannelMemoryStore[], required: 共享 Memory Store；ID 不可重复，与自动创建的私有 Store 合计最多挂载 8 个。 - `memory_store_id` string, required: Memory Store ID；trim 后 1–128 字符，须属于当前账号且未归档。 - `access` 'read_only' | 'read_write' - `enabled` boolean, required: 新建 Channel 固定为 true。 - `binding_status` string, required: 绑定状态。WeChat 创建后为 unbound；创建扫码会话后可能为 pending，继续查询 QR 状态；手机确认后为 bound。其他渠道通常创建后为 bound。 - `connection_status` 'disconnected' | 'connecting' | 'connected' | 'error', required: 异步连接状态。disconnected 尚未建立；connecting 连接中；connected 已连接；error 查看 last_error。 - `channel_config` ForwardWeChatChannelConfig, required - `response_options` ForwardChannelResponseOptions, required - `include_tool_calls` boolean, required: 展示公开工具名称、状态和返回项数；不展示工具原始参数或结果。 - `include_process` boolean, required: 展示公开 Agent 过程正文，不展示隐藏推理。最终回复取本轮最后一条非空 agent.message。 - `card_output` boolean, required: 启用渠道卡片或流式展示；false 时仅发送最终文本。钉钉还需有效互动卡片模板；个人微信始终仅最终回复。 - `private_memory_store_enabled` boolean, required - `group_prompt_template` 'null', nullable, required: WeChat 固定为 null。 - `last_error` object, nullable, required: 最近连接错误的安全提示，正常时为 null；不能仅凭该字段判断某轮 Agent 执行是否成功。 - `created_at` string, date-time, required: 创建时间。 - `updated_at` string, date-time, required: 更新时间。 ## Other responses - `400`: Schema、凭据或渠道字段不合法。 - `404`: 指定 Agent version 不存在。 - `409`: 机器人已有绑定或 Memory Store 已归档。 - `429`: 账号或全局请求频率超限。 - `500`: owner 或资源预检失败，未创建 Channel。 - `502`: 渠道探测未返回有效机器人身份。 - `503`: 渠道暂时不可用、并发预检忙或依赖不可用。 ## Changes - **2026-11-05** `f2be7c0fcbb9`: 15 breaking, 6 warning, 8 info - the request's body type changed from `object` to no type - added `#/components/schemas/ForwardFeishuChannel, #/components/schemas/ForwardWeComChannel, #/components/schemas/ForwardDingTalkChannel, #/components/schemas/ForwardWeChatChannel` to the response body `oneOf` list for the response status `201` - the response's body type changed from `object` to no type for status `201` - removed the required property `binding_status` from the response with the `201` status - …25 more - **2026-11-03** `7fd61aa7f811`: 1 info - endpoint added [Operation history](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/changes/agent/forward/v0/channels/post.md) --- [API](https://skmtc.dev/bigmodel/apis/zhipu-ai-api.md) - [All operations](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/revisions/f2be7c0fcbb9?raw)