# 连接器节点
工作流中的连接器节点允许用户通过选择已创建的连接器,实现数据的获取。并允许用户根据连接器中参数类型配置对应的请求参数、请求头、路径参数、请求体等,以满足不同的数据交互需求。可自定义请求体参数以满足请求体中数据交互。此外,连接器节点还提供了超时设置、重试机制,异常忽略,确保请求的可靠性和数据的正确处理。
连接器节点的作用:
- 数据获取:从外部服务获取数据,例如从 API 获取用户信息、天气数据等。
# 节点配置
在使用连接器节点实现数据获取功能时,需要先在连接器管理菜单中配置相关连接器基础信息及连接器认证信息,具体参考AI连接器。连接器管理菜单中目前内置了秘塔、博查、百度地图、高德地图连接器。连接器可支持扩展认证实现,具体实现方式可参考 AI连接器扩展 连接器节点选择连接器同时即可展示该连接器中对应请求参数、请求头、路径参数、请求体等参数。连接器节点简化了配置过程,提高开发效率。
| 配置项 | 说明 |
|---|---|
| 连接器选择 | 连接器下拉选择,数据来源于连接器管理菜单中连接器列表 |
| 认证选择 | 选择某个连接器后,联动出该连接器对应的认证列表,数据来源于连接器管理菜单中某个连接器的认证列表。 |
| 请求参数 | 请求参数是附加在 URL 后面的键值对,用于向服务器传递额外的信息。例如,在搜索请求中,可以通过请求参数传递搜索关键词。 |
| 请求头 | 请求头包含客户端的信息,如 User-Agent、Accept 等。通过配置请求头,可以指定客户端的类型、接受的数据格式等信息。 |
| 路径参数 | 连接器操作url中路径参数,像连接器外部服务传递必要参数。 |
| 请求体 | 请求体是 POST 请求中包含的数据,可以是表单数据、JSON 数据等。根据不同的请求类型和数据格式,可以选择相应的请求体格式,例如 form-data、x-www-form-urlencoded、raw text、JSON 等。 |
| 请求体参数 | 请求体参数可自定义参数变量。该参数用于请求体中变量替换 |
| 超时设置 | 超时时间指节点运行的最大耗时,如果超过此时长,则判断为节点运行超时。通过配置超时设置,可以避免长时间等待,提高工作流的响应速度。 默认情况下,连接器节点的超时时间默认为 30s;最长可设置为 180 秒。 |
| 重试次数 | 节点运行超时或异常时,默认重试 2 次。 |
| 输出 | 输出变量包括响应体、状态码和响应头。 |
| 异常忽略 | 支持异常忽略功能。开启此功能后,如果试运行工作流时此节点运行失败,工作流不会中断,而是继续运行后续下游节点。如果下游节点引用了此节点的输出内容,则使用此节点预先配置的默认输出内容。 |
# 使用示例
例如连接器节点选择已有连接器秘塔-搜索,进行搜索查询操作。

节点配置如下:
开始节点
工作流的起始节点,本示例需要配置输入参数question,用于指定需要搜索的问题。
![image-20260108151913432]()
连接器节点
选择已有连接器 秘塔-搜索,选择对应连接器认证,该连接器中需要的入参会在选择连接器后自动带出。示例中配置请求体参数q,变量值来源于开始节点的输入参数question,替换请求体中q属性值
![image-20260108151949961]()
结束节点
选择返回变量模式,定义 data参数,引用连接器节点的输出参数 body。
![image-20260108152021160]()
执行结果如下
![image-20260108152225545]()
# 常见问题
(此处保留,用于后续补充常见问题与解答)



