创建企业 Agentic API 智能体

英飞团队·2025/10/24 发布·2026/07/08 更新·1,824 字·浏览量 772

什么是 Agentic API 智能体

Agentic API 智能体是平台中专门用于 “对接第三方平台智能体/系统接口” 的智能体类型，通过标准化配置将外部智能体、API（如Dify的智能体等）封装为平台可直接使用的模块，无需手动编写接口调用代码，即可实现与外部系统的数据交互和功能联动。

适用场景

API 式调用场景：将外部 API 封装后，在平台内通过 “一键调用” 实现功能触发（如调用报表接口生成数据统计文件等）。

智能体开发管理平台创建智能体时，选择 Agentic API 类型智能体，即可进入 Agentic API 智能体的创建流程。

“创建智能体”配置页面中需填写以下信息：

智能体名称：智能体名称要尽量体现智能体的核心功能或使用场景（如：天气查询、发送短信等）；
智能体描述：简要说明智能体的核心能力与适用范围，该内容除了再智能体开发管理平台中显示外，也会在商店以及画布使用时向使用智能体的用户进行展示，帮助用户快速识别和了解智能体的用途与使用方式；
智能体分类：选择智能体所属的分类，用于后续智能体的分类展示、筛选与管理；
图标：为智能体设置图标，可手动上传本地图片文件，也可以由AI通过智能体名称与描述信息进行智能生成。

Agentic API 智能体的配置，需完成三方平台选型、API 访问地址设置、鉴权方式配置，以及输入输出参数等信息的配置，全部完成后，方可与外部系统的API进行对接和数据交互。

智能体平台选择：通过下拉框选择要对接的智能体平台。不同平台的 API 对接规则与参数要求存在差异，需根据实际对接需求准确选择。不同的平台/系统，需要配置的平台信息以及参数配置方式可能存在不同。

BaseUrl 填写：BaseUrl 是 Dify 平台 API 接口的根地址，后续具体接口路径将基于此进行拼接。需确保填写的 URL 准确无误，可参考对接平台的 API 文档获取
认证方式选择：Dify 平台当前仅支持 API-Key 的认证方式，需要填写平台上配置的 API-Key 信息。需确保填写的 API-Key 准确无误，可参考对接平台的 API 文档获取；
智能体类型选择：系统当前支持 Dify 平台的智能体类型有：聊天助手、文本生成应用、Chatflow、工作流，暂不支持 Agent 类型智能体。不同的智能体类型，其在进行 API 调用时，请求与响应的报文结构不同，需确保选择的智能体类型与 Dify 平台中对应智能体的类型相匹配。

注意：系统当前的 API 响应模式仅支持 Blocking 模式，由于 Dify 平台 Agent 类型智能体并不支持 Blocking 响应模式，所以系统暂不做支持。

请求地址填写：Coze 平台 API 访问的根地址，Coze 平台智能体的调用过程将基于此地址进行调用。需确保填写的 URL 准确无误，可参考对接平台的 API 文档获取
认证方式选择：Coze 平台当前仅支持「服务访问令牌」的认证方式，需要填写平台上配置的「服务访问令牌」信息。需确保填写的「服务访问令牌」准确无误，可参考 Coze 平台的 API 文档获取
智能体类型选择：系统当前仅支持 Coze 平台的「智能体」，暂不支持 Coze 平台的「应用」类型

当用户完成平台配置并点击 “下一步” 时，系统会依据所配置的平台信息，自动开展连通性检测，以此验证平台配置的准确性。若连通性检测通过，即可顺利进入参数配置环节；反之，系统会弹出报错提示，指引用户排查配置问题。

此环节用于设置画布智能体的输入、输出参数与三方平台智能体输入、输出参数的映射关系。界面左侧为画布智能体参数设置区，右侧为三方平台智能体参数设置区，通过对同一参数在两侧进行映射配置，可实现画布智能体与三方平台智能体之间的参数映射及联动。

三方平台智能体若想在画布中使用，需先转化为画布智能体 —— 通过画布智能体的标准化形式，将三方平台智能体的功能开放给用户操作。

如图所示，配置环节中设置的 “画布智能体输入 / 输出参数名称”，最终会直接作为画布智能体的输入 / 输出针脚在画布界面显示；用户可通过针脚直观识别该智能体的可用数据接口，快速明确如何连接上下游节点、传递数据，降低使用门槛。

参数名称：画布智能体针脚上要显示出来的名称

参数描述：对每个参数的详细描述内容

Dify 平台

Dify 智能体支持输入参数的自动获取功能，所以在 Dify API 输入参数配置时，可通过下拉列表进行 Dify 智能体输入参数的选择，而无需手动输入参数名和参数类型。

Dify 智能体的输出参数需要手动填写参数名与参数类型，需确保填写的参数名、参数类型与Dify 平台上的配置相匹配，否则后续智能体在画布使用时会出现错误。

Coze 平台

Coze 智能体采用了一问一答的方式进行调用，所以它的输入输出参数配置无需配置。仅针对画布智能体参数部分进行配置即可。

Agentic API 智能体配置完成后，需通过 “发布” 操作，将智能体发布到应用商店后，才可以对智能体进行后续的上架动作。

用户完成了 Agentic API 智能体的配置后，可点击页面右下角的“发布”按钮，即可对智能体进行版本发布。

注意：Agentic API 智能体一经发布，会直接更新商店中已经上架的智能体版本；画布中已经在使用的老版本 Agentic API 智能体将失效，并会提醒用户使用新版本智能体

Tips：智能体上架流程见智能体上架部分描述