分享智能体应用

​

前提条件

已有构建好且已发布的智能体应用。具体操作请参考创建智能体应用。

​

Agent 版本说明

分享渠道（魔笔分享渠道、钉钉、微信、组件、音视频实时互动）均为 Agent 1.0 智能体应用的功能。Agent 2.0 智能体应用仅支持通过 API 调用，不支持上述分享渠道。

​

分享或发布百炼应用

1. 访问百炼控制台的应用管理页面，单击目标智能体应用卡片区域的发布。

智能体应用（Agent 1.0）支持以下四种分享或发布方式。

• 方式一：通过魔笔分享渠道分享
• 方式二：通过钉钉发布百炼应用
• 方式三：通过微信发布百炼应用
• 方式四：发布应用为组件

​

通过UI 应用分享应用

​

魔笔分享渠道

1. 单击UI 应用右侧的立即查看跳转到UI设计器界面。
2. 参考UI设计，进行相关应用界面的编辑与发布。
3. 访问百炼控制台的UI设计器页面，鼠标悬停于已发布的UI上，单击环境部署。
4. 可以将应用地址分享给其他用户，持有该链接的阿里云用户均可访问此应用。单击下线可以停止该应用服务。 在应用环境信息弹窗中，开发环境显示已发布状态及可用的应用地址，生产环境显示未发布状态，应用地址显示为无。

​

通过钉钉发布应用

1. 单击智能体应用的发布平台页签，单击钉钉机器人卡片右侧的请先授权。

   如果已经授权，请直接跳转至步骤3操作。

2. 在授权对话框中，选中勾选同意上述条款后，单击确认授权。
   如您是首次在百炼平台上创建微信或钉钉渠道的应用，您需要授权阿里云计算有限公司提供的计算巢AppFlow为您提供自动化应用集成服务，包括如下两项授权：

   • 授权SLR（服务关联角色，Service Linked Role）关联计算巢AppFlow。
   • 授权API-KEY加密传输给计算巢AppFlow用以调用百炼平台的应用。
3. 单击钉钉机器人卡片右侧的创建，在配置钉钉面板的选择API KEY配置向导页，选中目标API KEY，单击下一步。在 选择API KEY 步骤中，从列表中选中已有的API KEY，然后单击 下一步。如需新建或管理密钥，可单击右上方的 管理API-KEY 或 创建API-KEY 按钮。

如果没有可选API KEY，请单击创建API Key，完成创建后再选择。也可以单击管理API Key，跳转至我的API-KEY页面，对API-KEY进行管理。

1. 在配置钉钉面板的配置信息向导页，完成钉钉模版ID、钉钉Client ID和钉钉Client Secret配置后，单击确认。
   关于钉钉模板 ID、钉钉 Client ID 和钉钉 Client Secret 的获取，请参见以下步骤：

   接下来您需要在您的组织中创建一个简单的钉钉应用，作为 AI 助手回答用户问题。

   创建钉钉应用需要您的钉钉账号有开发者权限。您可以联系您的组织管理员获取钉钉开放平台的开发权限，具体操作请参见获取开发者权限。

   步骤一：创建应用

   1. 访问钉钉开放平台。
      • 如果是第一次创建钉钉应用，请点击应用开发指引创建。
      • 如果已经创建过应用，请点击快速构建 AI 应用立即开始。
   2. 在左侧导航栏中，点击钉钉应用，在页面右上角点击创建应用。
   3. 填写应用名称和应用描述，可以选择上传应用图标，点击保存。

   步骤二：获取应用 Client ID 和 Client Secret在左侧菜单选择凭证与基础信息，复制 Client ID 和 Client Secret，用于下一步创建连接流。步骤三：创建消息卡片，获取卡片模板 ID钉钉机器人通过卡片消息支持流式返回结果，您需要创建卡片模板供消息发送使用。

   1. 访问卡片平台，点击新建模板。
   2. 在创建模板输入框，填入模板信息，点击创建。
      • 卡片类型：选择消息卡片
      • 卡片模板场景：选择AI卡片。
      • 关联应用：需关联步骤一：创建应用中创建的应用。
      • 从模板创建：无需选择预设模板。
   3. 在模拟编辑页面，无需修改任何配置，保存并发布模板，点击返回。创建成功后，进入AI卡片模板编辑器界面。
   4. 在左侧菜单中，点击模板列表，复制模板 ID。返回模板列表后，在已创建的模板卡片底部找到 模板 ID 行，单击右侧复制图标复制该 ID，后续步骤中将使用此模板 ID。

   步骤四：授予应用发送卡片消息权限创建卡片后，需授予应用发送卡片消息的权限。

   1. 访问钉钉应用列表。点击刚才创建的应用名称，以进入详情页面。
   2. 在左侧菜单选择权限管理。在左侧搜索框分别输入Card.Streaming.Write和Card.Instance.Write，并在操作列点击申请权限。
   3. 获取权限后，请将模板 ID、Client ID、Client Secret 填回百炼应用的发布配置窗口，即可发布百炼应用到钉钉应用。
2. 钉钉应用创建完成后，在百炼应用发布渠道页签，复制回调地址。您可以按需将回调地址分享给目标用户。 获取到回调地址的用户，可以为钉钉应用配置机器人，添加到群聊中以回答用户问题。
   配置钉钉机器人

   步骤一：配置钉钉机器人

   1. 访问钉钉应用列表。找到刚才创建的应用，点击应用名称进入详情页面。
   2. 在添加应用能力页面，找到机器人卡片，点击添加。
   3. 打开机器人配置开关。
      • 机器人名称、机器人图标、机器人简介、机器人描述、机器人消息预览图：请根据页面描述自行填写。
      • 消息接收模式：请选择HTTP模式。目前AppFlow仅支持HTTP模式，选择Stream模式会导致无法返回消息。
      • 消息接收地址：粘贴从百炼发布渠道获取的回调地址。
      • 点击发布。

   步骤二：发布应用版本应用创建完成后，如果需要将应用供企业内其他用户使用，需发布一个版本。

   1. 点击应用开发，在钉钉应用页面，点击刚才创建的应用。
   2. 在左侧菜单栏，点击版本管理与发布。在右上角点击创建新版本。在版本详情页，输入应用版本号和版本描述信息，选择合适的应用可见范围，完成后点击保存。并在弹窗中点击直接发布。

   步骤三：测试机器人你可以创建群聊或在已有群聊中添加机器人，并与机器人对话，查看效果。

   1. 在钉钉群管理中添加机器人​。 进入钉钉群群设置页面，点击机器人卡片区域，在机器人管理页面，点击添加机器人。在添加机器人的搜索文本框中输入目标机器人名称，并选中要添加的机器人。点击添加，完成后再点击完成添加。
   2. 在钉钉群中@机器人，进行交流互动。添加完成后，群成员在聊天中通过 @机器人名称（如 @百炼手机答疑）向机器人提问，机器人将自动回复相关答案。

​

通过微信发布应用

如果您已在创建钉钉机器人的步骤授权过，则无需再次授权。具体授权流程，请参见通过钉钉发布应用的相应步骤。

1. 在智能体应用的发布平台页签，单击微信公众号卡片右侧的创建。
2. 在配置微信面板的选择API KEY配置向导页，选中目标API KEY，单击下一步。

   如果没有可选API KEY，您也可以单击创建API Key，完成创建后再选择。您也可以单击管理API Key，跳转至我的API-KEY页面，对API-KEY进行管理。

3. 在配置微信面板的配置信息向导页，选择目标微信凭据，完成后单击确认。
   如果没有微信凭证可选项，您可以单击 前往新建 。具体操作，请参见以下步骤。

   在对话框中，输入开发者ID（AppID），完成后单击授权。开发者ID（AppID）的获取方法：访问微信公众号后台，在左侧菜单选择设置与开发>开发接口管理。选择基本配置页签，获取 AppID。
4. 微信公众号AI机器人创建完成后，在发布渠道页签，将鼠标悬浮至微信公众号右侧的图标，您可以按需将二维码分享给目标用户。配置完成后，微信公众号卡片显示 已创建 状态，提示已生成微信客服二维码。单击 扫码使用 按钮，通过微信扫码体验AI机器人客服功能。

​

发布应用为组件

1. 单击智能体应用的发布渠道页签，鼠标悬停于组件上，单击右侧的创建。
2. 配置组件信息，单击确定发布。

   参数名称		参数说明
   组件名称		自定义填写，建议使用具有实际意义的名称。例如，天气分析智能体。
   组件描述		对组件的功能和使用场景的简要说明。请使用自然语言进行描述。例如，用于分析城市的天气信息。 组件发布后，在智能体应用中引用该组件时，大模型会根据组件描述和上下文，自动判断是否调用。在工作流应用中引用该组件时，组件描述仅用于说明组件功能，不影响工作流的运行。
   输入信息	别名	为避免参数名称相同，您需要给参数起别名。调用组件时，调用者只能看到参数的别名。
   	参数描述	参数的内容描述。 在智能体中引用该组件时，且传参方式为模型识别时，大模型会根据参数描述，自动填入参数内容。 其他情况下，该描述仅起到说明作用。
   	是否必填	按实际业务填写。
   	是否可见	组件是否对外透出此参数，用于隐藏不需要的参数。例如，组件使用了文本模型，就需要隐藏图像输入参数。
   	传参方式	业务透传： 在智能体中引用该组件时，由组件的使用者提供。 在工作流中引用该组件时，由上游节点提供。 模型识别： 在智能体中引用该组件时，由大模型根据参数描述，从上下文中自动推断并填充。 在工作流中引用该组件时，即使参数的传参方式设置为模型识别，应用也不会自动推断参数值。您必须像业务透传一样，从上游节点明确地为该参数提供输入值。
   	默认值	按实际业务填写。

3. 组件发布后，可在智能体应用或工作流应用中引用组件。
   • 避免嵌套调用：对于 A 调用 B，B 调用 A 的情况，应用会进入重复调用状态，导致功能不可用。
   • 避免多级调用：对于 A 调用 B，B 调用 C 的情况，应用有最长运行时间限制，多级调用容易产生超时错误。

   在智能体应用中引用组件	在阿里云百炼的应用管理页面，创建智能体应用（Agent 1.0）时，在技能中选择组件。 仅支持选择已发布的智能体组件。 单击智能体对应的+按钮，在弹出的选择智能体面板中完成选择。 配置完成后，输入组件功能相关的问题测试效果。 如果引用的组件包含需要业务透传的参数，您可以在测试时手动填入入参变量配置，或者在 API 调用时通过 biz_param参数传入。
   在工作流应用中引用组件	在阿里云百炼的应用管理页面，创建工作流应用时，将组件节点拖入画布，再选择组件。 支持选择已发布的智能体组件或工作流组件。 配置完成后，输入组件功能相关的问题测试效果。

​

通过音视频实时互动发布应用

1. 在智能体应用的AI实时互动页签，单击语音互动/视频互动，单击页面右侧的去配置。
2. 在查看API-KEY配置向导页，选中目标API KEY，单击确定。
3. 点击右上角，生成临时体验二维码，通过手机微信/钉钉/浏览器扫码体验交互效果。 二维码有效期为24小时，也可点击复制链接直接分享体验链接。
4. 测试完毕后，点击发布>确认发布。发布后，进入发布渠道，完成智能媒体服务开通和 SLR 授权后，创建互动智能体。 音视频实时互动应用支持两种发布渠道：
   1. H5/APP 扫码：点击生成分享链接，设置Token有效时间，点击确认。 在弹出的 分享与体验 弹窗中，H5体验 支持使用微信或钉钉扫码，也可复制链接后在手机浏览器中打开；APP体验 需通过 AI智能体 > 自定义智能体 > 授权Token 中扫码体验。iOS端安装时需在 设置 > 通用 > VPN与设备管理 中找到Taobao对应的信任描述并选择信任。
   2. SDK 集成：点击SDK集成，可以选择快速集成快速部署和运行音视频互动服务，也可以根据业务需求选择开发集成进一步扩展更多高级功能。 快速集成支持WEB、IOS、安卓三个平台，页面提供分享ID（可单击重新生成更新），将安装代码添加到网页<body>区域并填入分享ID即可免AppServer调试运行（仅限测试）。开发集成基于AICallKit SDK，提供含UI方案和不含UI方案两种集成选项。