Agentic API 智能体的使用

Agentic API 智能体是一种专负责连接和调用外部服务的智能体类型。简单来说，它就像一个智能连接器，能够轻松地让外部应用、智能体、服务在画布中相互沟通、协同工作。

Agentic API 智能体的特点

服务协同工作：基于智能工作流，可将第三方服务编排至智能工作流中，使画布中的智能体以及各种第三方服务可以在画布中协同工作。比如，你可以构建一个工作流，先使用 Agentic API 智能体调用天气API获取未来三天的天气信息，然后让自定义智能体根据天气情况生成出行建议，最后通过 Agentic API 智能体将建议发送到企业微信或邮件中，实现多服务无缝协作完成复杂任务。

如何使用 Agentic API 智能体

1. 添加智能体至画布：打开画布左侧的「智能体中心」面板，在智能体列表中浏览或通过搜索找到想要使用的 Agentic API 智能体，点击并将其拖拽到画布上的合适位置；

2. 智能体针脚连接：

• 识别针脚：Agentic API 智能体上会显示多个“针脚”（即三方服务的输入/输出参数），通常有不同颜色或标识区分输入针脚（接收数据）和输出针脚（发送数据）。

• 针脚元素对应关系：不同的针脚类型，会有不同的元素类型要求，对应关系如下：

1. 字符串类型，可连接画布中文本类元素，如：文本元素、便签元素、图形元素、英飞文档等元素；

2. 数字类型，可连接画布中文本类元素，如：文本元素、便签元素、图形元素、英飞文档等元素。仅当元素内的内容为数字时，智能体方可正常运行；

3. 数组类型，可连接画布中的帧框。需要注意的是，帧框中的种类型元素可被处理，与针脚的详细定义有关，可通过针脚说明进行了解；

4. 图片文件类型，可连接画布中的图片元素（包含图片占位）；

5. Document 文件类型，可连接画布中的 Document 文件元素，如 PDF、PPT、Word 等文件元素；

6. 音频文件类型，可连接画布中的音频文件元素；

7. 视频文件类型，可连接画布中的视频文件元素。

• 连接输入数据：根据智能体的针脚要求，找到需要为其提供数据的元素，使用连接线元素与针脚连接即可。也可通过针脚点击的方式，唤起可选择的文件占位列表进行选择（输出数据连接同样支持此种方式）；
• 连接输出目标：将 Agentic API 智能体的输出针脚，通过连接线连接至想要“承载”其输出信息的元素。针脚类型与元素类型的对应关系，同输入针脚部分。

3. 测试与运行：

• 完成连接配置后，点击 Agentic API 智能体的运行按钮，或运行 Agentic API 智能体所在的工作流，即可进行智能体的测试；
• 观察数据是否按照预期在各元素间流转，检查目标输出元素是否正确显示了智能体的输出结果（如文本内容更新、第三方服务收到信息等）；
• 若运行异常，可检查针脚连接是否正确、智能开发管理平台的智能体配置是否正确，根据提示调整后再次测试，直至实现预期功能；

常见问题与解决方案

1. 问题：智能体运行失败

解决方案：检查智能开发管理平台中该智能体的配置是否正确，特别是 BaseURL、API 密钥等信息是否与三方平台中的配置匹配

2. 问题：智能体运行迟迟没有结果

解决方案：Agentic API 智能体的实际执行部分是在三方服务完成，若三方服务的处理过程、时间较长，则确实可能需要很长的时间才可以获取到智能体处理后的结果。目前平台中最多可支持5分钟的三方服务处理等待，超过此时间后，智能体运行会出现超时错误

3. 问题：输出结果不符合预期

解决方案：检查输入数据是否准确，尤其是多针脚的情况下，需要检查输入数据是否连接到了正确的针脚