平台接入

功能概述

平台接入位于 能力扩展 → 平台接入，保存第三方服务的类型、地址和密钥；流程中的三方平台节点引用该资源，并补充业务输入和应用标识。当前支持 Coze、Dify、FastGPT、MaxKB。

前置条件

已在第三方平台创建应用，并取得服务地址、应用或服务凭证，以及节点所需的应用标识（如 Coze 的 botId、MaxKB 的应用 ID）。

1. 新建平台资源

进入 能力扩展 → 平台接入，点击 新增，填写名称、类型、接口地址和接口密钥。

平台管理与新增入口。

平台	地址填写方式	流程配置重点
Coze	服务根地址，如 https://api.coze.cn	对话或工作流模式，以及对应 botId、appId、workflowId
Dify	部署的服务根地址	对话或工作流模式、inputs 与用户标识
FastGPT	部署的服务根地址	问题与 chatId 等对话参数
MaxKB	对应应用的接口基址，如 /chat/api/<应用ID>	问题与会话标识

各平台的接口路径由适配器按协议补齐，地址只填写服务根地址，无需拼接版本路径；MaxKB 按应用接口地址填写。

2. 核对鉴权与地址

接口密钥使用第三方平台签发的应用或服务凭证。编辑时回显遮蔽值，保持原值即沿用已保存密钥；更换时填写新凭证并保存。

Coze 平台配置：填写名称、类型、接口地址与接口密钥。

MaxKB 的应用标识位于接口地址中，与其他平台只填写服务根地址的方式不同。

MaxKB 平台配置：接口地址包含应用 ID。

3. 配置流程节点

在流程画布添加 三方平台 节点，选择厂商与已登记平台。根据该厂商的字段填写问题、inputs、用户及会话标识；Coze 按模式补充机器人、应用或工作流编号。

将问题映射到开始节点输入，将返回的正文和会话字段映射到后续节点。具体可用字段以节点面板和所选平台类型为准。

4. 调试并发布

先运行节点或草稿流程，检查第三方返回结果；再发布流程，并以已发布版本验证，操作见 应用调试与版本发布。多轮对话时，将上一轮返回的会话标识传入下一次请求。

常见问题

现象	处理方法
连接失败	检查后端网络与接口基址
鉴权失败	检查凭证是否有效及其作用域
应用不存在	核对节点中的应用标识；应用标识填写第三方平台的应用编号，而非平台接入资源的编号

适配实现见 工具扩展与渠道集成。