集成阿里云百炼应用_多端低代码开发平台魔笔(Mobi)-阿里云帮助中心

魔笔平台提供了强大的阿里云百炼应用集成功能，允许用户通过简单的配置，实现对阿里云百炼应用的无缝连接和数据交互。本文档将指导您如何创建和使用阿里云百炼应用集成。

功能介绍

魔笔平台的阿里云百炼应用集成功能支持以下特点：

流式传输支持：在配置面板中开启「SSE」后即可支持流式数据传输。
自定义触发方式：集成操作可以设置为手动触发或自动运行，满足不同的业务场景需求。
回调和数据转换：支持在查询成功或失败时执行特定的集成操作事件，以及对返回的数据进行自定义处理。
高级设置：提供防抖和禁止执行条件的高级配置，以优化集成操作的执行。

事件相关内容可参考：集成操作事件

使用阿里云百炼应用集成

步骤 1：创建阿里云百炼应用集成

登录魔笔平台，进入管控台。
导航至“资源”->“集成”，点击“创建集成”。
选择“阿里云百炼智能体应用”，并填写集成名称及描述。
配置不同环境的阿里云百炼应用连接信息，包括API-KEY、工作空间等。
点击“确定”以创建阿里云百炼应用集成。

说明

关于如何创建阿里云百炼智能体应用，可以参考 0代码构建问答应用

步骤 2：在应用内部创建集成操作

打开“代码”面板，点击对应作用域的“+”后选中“集成操作”。
选择之前创建的阿里云百炼智能体应用集成作为资源，输入阿里云百炼应用 ID 和输入提示词后，根据需求，选择集成操作的触发方式和更加细节的配置内容。

点击“运行”预览查询效果。

配置面板详解

通用配置

参数：定义查询所需的参数，包括类型、默认值和描述。在查询语句中，可通过{{ varName }}的方式引用参数。
启用 SSE 响应：定义了每轮对话是否使用流式数据传输。
应用 ID：定义了预期调用的阿里云百炼智能体应用 ID。
提示词：定义了每轮对话中的输入提示词内容。
会话 ID：定义了对话历史会话唯一标识，传入会话 ID 后，将在云端进行对话历史记录，调用大模型将自动携带存储的对话历史。
检索召回过程显示：定义了是否输出检索召回处理过程信息。开启后，将返回文档检索召回和模型推理的过程信息。
知识库检索范围：
- 知识库检索范围：定义了在使用 RAG 应用时指定检索的知识库 ID 列表，在使用该参数前，请确保您的应用为 RAG 应用且在阿里云百炼平台没有配置知识库。关于如何获取知识库 ID，可以参考知识库。
- 临时文件 ID 列表：用于在智能体应用的当前请求中上传临时文件 ID。关于上传临时文件，可以参考应用调用。
图片链接列表：定义了传入百炼智能体应用的图片 URL 数组，使用此参数前，请确保您的阿里云百炼智能体应用使用的模型支持图像输入（如通义千问 VL 模型）。
自定义参数：定义了传入阿里云百炼工作流应用和智能体编排应用的自定义参数。如果使用智能体应用传递用户自定义参数，需要使用user_prompt_params标识自定义提示词变量参数。
工作流模式：对于工作流的百炼应用，使用该参数控制工作流应用的不同输出模式，详情可以参考应用调用流式输出中的工作流应用输出模式：
- full_thought：所有节点的流式结果将在thoughts字段中输出。必须要设置has_thoughts为True。
- agent_format：使用与智能体应用相同的输出模式。在控制台应用中，可选择打开指定节点的结果返回开关，则该节点的流式结果将在output的text字段中输出。
可选参数：定义了额外的可选参数。
- 模型名称：替换原有的智能体中的模型。仅智能体应用支持此参数，可填写的模型名称参见支持的模型。
- 是否启用互联网搜索：启用互联网搜索，模型会将搜索结果作为生成回复过程中的参考信息，但模型会基于其内部逻辑判断是否使用互联网搜索结果。启用互联网搜索功能可能会增加 Token 的消耗。仅智能体应用支持此参数。
- 是否自动获取当前时间：启用当前时间，模型可直接响应实时时间请求（如“今天日期”）。仅智能体应用支持此参数。默认为启用。
- 是否启用思考模式：此参数用于在Qwen3模型中切换思考模式和非思考模式，仅对Qwen3模型有效，对 QwQ、DeepSeek-R1模型无效。仅智能体应用支持此参数。默认不启用。
- 上下文轮数：设置输入模型的最大历史对话轮数，轮数越多，对话相关性越强。仅智能体应用支持此参数。
触发方式：选择手动触发或自动运行。手动触发仅在触发集成操作事件或通过 API 调用action.trigger方法时执行。自动运行则在初次加载和依赖项变更时自动执行，例如当集成配置中引用了页面输入框组件 input1 的数据时，当{{input1.value}}改变时，集成将自动触发执行并更新数据。
超时时间：配置操作的最大执行时间。
描述：为集成操作提供详细描述。