智能体或工作流应用可发布为模块化的组件，供其他智能体或工作流应用接入使用，实现功能复用，加速复杂 AI 应用开发。
快速开始
以创建天气查询组件为例，您将学会组件的开发和使用方法。该组件可接入“旅途规划”、“农业管理”、“户外运动”等多种 AI 应用，提供便捷的天气查询服务。
步骤一：创建应用
您可以创建智能体或工作流应用，以实现一个天气分析模块。
- 智能体应用
- 工作流应用
步骤二：发布应用为组件
您可以在发布应用的同时发布组件。此外，对于已经发布的应用，您也可以在组件管理面板将其发布为组件。
- 发布应用为组件
- 在管理面板发布组件
- 发布应用：前往智能体或工作流应用的编辑界面，点击发布应用。
- 发布组件：在发布应用时选择发布应用组件。 在弹出的发布成功对话框中，单击发布应用组件右侧的立即发布链接。 也可以随时在发布渠道里创建组件。 在组件区域，单击+ 创建。
步骤三：配置组件名称和参数
在发布时，您需要为组件设置合适的名称、描述和参数设置，以便接入智能体或工作流应用。
为了标准化接入方式，组件预设了以下系统参数：
- query：用于传递用户输入的文本。例如：“请你帮我查询杭州今天的天气预报”。
- imageList：用于传递用户输入的图像公网地址列表。仅在组件使用图像与视频理解模型时有效。
预设的系统参数无法删除。如果您不需要某个预设参数，请在配置参数时隐藏该参数（将是否可见设置为否）。
填写组件名称和描述
- 组件名称： 描述组件功能的名称。（填写示例：天气分析智能体）
-
组件描述： 组件的功能简介。（填写示例：用于分析城市的天气信息）
- 接入智能体时，大模型会根据组件描述和上下文，自动判断是否调用该组件。
- 接入工作流时，该描述仅用于说明组件功能，不影响工作流的运行。
设置入参
配置项 | 用途 | 填写示例 | ||
|---|---|---|---|---|
输入信息 | 参数名称 | 参数的原始名称，不能修改。 | query | imageList |
别名 | 为避免参数名称相同，您需要给参数起别名。调用组件时，调用者只能看到参数的别名。 | userQuery | imageList | |
参数描述 | 参数的内容描述。
| 用自然语言表述的查询指令 | 用户上传的图片链接 | |
是否可见 | 组件是否对外透出此参数，用于隐藏不需要的参数。例如，组件使用了文本模型，就需要隐藏图像输入参数。 | 是 | 否 | |
传参方式 | 业务透传：
模型识别：
| 模型识别 | 模型识别 | |
步骤四：接入组件到智能体/工作流应用
- 智能体应用
- 工作流应用
组件可以作为工具接入智能体。在此场景下，智能体将根据用户问题自动使用组件。
如果接入的组件包含需要业务透传的参数，您可以在测试时手动填入入参变量配置，或者在 API 调用时通过 biz_param参数传入。
-
接入组件：前往应用管理，创建一个新的智能体应用。智能体的配置如下：
配置项
配置内容
模型
千问-Max-Latest
提示词
你是一个智能体。请持续进行处理，直到用户的疑问完全解决后，再结束你的回合并将控制权交还给用户。只有当你确信问题已得到解决时，才可终止你的回合。
如果你对用户请求所涉及的文件内容或代码库结构不确定，请使用你的工具来读取文件并收集相关信息：切勿猜测或编造答案。
在每次调用函数之前，你必须进行详尽的规划，并对先前函数调用的结果进行深入的反思。切勿仅通过调用函数来完成整个过程，因为这可能会削弱你解决问题和进行有洞察力思考的能力。
智能体
天气分析智能体
- 测试效果：在对话框中输入“请你查询杭州天气预报”，智能体将调用组件输出一份天气预报，表明组件已成功接入智能体。
注意事项
- 组件自动更新：应用发布为组件后，如果应用重新发布，那么该组件也会自动更新。
- 避免嵌套调用：对于 A 调用 B，B 调用 A 的情况，应用会进入重复调用状态，导致功能不可用。
- 避免多级调用：对于 A 调用 B，B 调用 C 的情况，应用有最长运行时间限制，多级调用容易产生超时错误。