创建AI助手

更新时间:2025-04-02 02:33:14

本文为您介绍如何在AppFlow中创建AI助手,以及如何将其集成到Web页面或企业微信中,实现共享访问或仅限企业内部访问的功能。

为什么使用AppFlowAI助手?

  • 多功能集成: 提供了H5页面、悬浮框两种页面方式, 集成到企业微信、钉钉应用(待)、微信小程序(待)。

  • 交互渲染友好:能够解决企业微信、飞书等常见IM类原生对话 不支持流式,不支持图片渲染等各种复杂markdown的问题。

  • 灵活配置:无需代理开发,可灵活生成自定义页面。

使用效果

独立web页面

悬浮挂件

企业微信移动端

企业微信桌面端

image

image

0c3efab14f15459fee4268bbf2a2a0a5

image

计费说明

使用AppFlow本身是免费的,但在创建和使用AI助手过程中,可能会产生阿里云资源使用费以及调用模型产生的费用(根据使用的Token数量来计算的)。更多内容,请参见计算巢计费模型计费月之暗面计费

创建流程图

image

操作步骤

步骤一:新建AI助手

  1. 登录AppFlow控制台。

  2. 在左侧导航栏中选择模型服务 > AI助手

  3. AI助手页面,单击创建AI助手设置基本信息。

    参数

    示例

    说明

    参数

    示例

    说明

    AI助手图标

    --

    建议图片为192x192像素,支持jpg、png、svg格式

    AI助手名称

    AI name

    由中文、数字、英文及下划线组成,长度在 3~200 个字符之间,一个中文字等于 2 个字符

    AI助手描述

    AI demo

    名称长度在10~500个字符之间,一个中文字符等于2个字符。

  4. 配置完成单击提交,跳转至AI助手详情页面。

步骤二:导入模型并设置页面

配置页面和模型参数,包括导入模型、选择链接凭证,以及设置对话背景、欢迎语、预设问题等配置项。完成配置后,根据需要您可选择添加插件来增强功能。

说明

设置参数时右侧的预览页面会动态展示,让您能够及时查看配置效果,确保最终结果符合预期。

  1. 模型区块中,单击导入模型,根据业务需求选择对应的模型,并单击确认

    说明

    支持的模型列表在逐步扩展中。

    image

  2. 在弹框中选择连接凭证,单击下一步

    如您没有对应凭证,请在下拉框中单击添加新凭证,模型所需APIKey/Token获取途径如下所示。

    模型

    获取APIKey/Token路径

    模型

    获取APIKey/Token路径

    阿里云百炼

    获取百炼账户API Key,请参见开通并创建百炼大模型平台API-KEY

    DeepSeek(百炼)

    通义千问

    DeepSeek(PAI)

    在人工智能平台PAI获取您的DeepSeek调用Token,请参见获取Token

    PAI EAS RAG应用

    在人工智能平台PAI获取您的PAI EAS RAG调用Token,请参见大模型RAG对话系统

    月之暗面(kimi)

    获取月之暗面账户API Key,请参见月之暗面-使用指南

  3. 参数配置中,根据提示填写参数,单击保存

    说明

    不同模型的参数不同,请以控制台为准。

  4. 配置项设置中,配置对话背景,欢迎语,以及预设问题。

    参数

    说明

    示例

    参数

    说明

    示例

    对话背景

    在对话中预设背景、角色和语气等要素,助手将根据这些设定进行回答。

    说明
    • 会增加每次交流的Token使用量。

    • 仅对裸模型生效,对于百炼等智能体平台不生效,使用的是对应智能体平台的prompt,例如,通义千问,

    担任技术咨询专家的角色,拥有丰富的AI、大数据处理及IoT集成经验。

    欢迎语

    用户进入对话框后,用户提问前,AI助手主动向用户发送的第一条消息。

    欢迎使用AI助手

    预设问题

    用户提前预设好问题列表,在与AI助手对话时,直接点击预置问题,即可发送问题进行对话。

    什么是AppFlow?

  5. 通用设置区块中根据您的业务需求配置如下内容。

    模型

    说明

    模型

    说明

    支持使用上下文记录

    设置输入模型的最大历史对话轮数,轮数越多,对话相关性越强。

    说明

    仅对裸模型生效,对于百炼等智能体平台不生效,使用的是对应智能体平台的上下文能力

    增加展示文档来源开关

    开启之后,将在结果中以序号方式展示生成结果的来源文档,并且会消耗更多token。

    SLS日志记录

    通过将对话记录集中存储在 SLS 中,您可以轻松检索和分析历史对话,洞察用户行为和偏好,从而优化对话模型和策略。

步骤三:web页面集成

  1. 集成页签下,单击web页面集成

  2. web页面集成页面单击创建集成,在弹框中输入集成名称,并单击确定

    image

  3. 跳转至Web配置页面后,根据提示设置基础信息。

    说明

    设置参数时右侧的预览页面会动态展示,让您能够及时查看配置效果,确保最终结果符合预期。

  4. 配置部署信息。

    1. 根据您的业务类型,选择合适的部署方式,单击提交完成配置。

      • 独立页面部署:将网页单独部署,拥有独立URL,可单独访问和运行。

      • Iframe页面嵌入:使用Iframe在现有页面嵌入其他HTML文档,显示外部内容于特定区域。

      • 悬浮挂件部署:固定于网页边缘的小工具,如客服窗口、返回顶部按钮,随用户操作显示或隐藏。

        示例代码

         <script src=https://d********dn.com/appflow/chatbot/v1/AppflowChatSDK.js></script>
            <script>
                window.APPFLOW_CHAT_SDK.init({
                    integrateConfig: {
                        integrateId: 'cit-e754b4f******1ba4c',
                        domain: {
                            requestDomain: 'https://******flow.aliyun.com'
                        }
                    },
                });
                <!-目前仅支持设置userAvatar:用户头像(公网可以访问的图片)、userName:用户名称、userId:用户ID ->
                window.APPFLOW_CHAT_SDK.setUser({
                
                    userAvatar: 'https://appflow-chabot-cn-hangzhou.oss-cn-hangz*****5438522/cn-hangzhou/1737880126889/向日葵图片.png',
                    userName: 'demo',
                    userId: '117***',
                });
            </script>
    2. 以访问独立页面的部署地址为例,测试集成效果图。

      image

    3. 绑定自定义域名。

      重要

      按照互联网合规要求,阿里云访问地址是测试使用的,有效期为:自创建Web集成之日起30个自然日。 请您尽快绑定自定义域名。

      1. 部署信息中单击绑定自定义域名

      2. 首次勾选绑定时,会弹出AppFlow服务关联角色授权创建页面,请您确认并授权

        image

      3. AppFlow共提供以下两种方式为您配置域名或IP。

        使用可信主体域名
        使用计算巢Nginx代理

        适用于已经在阿里云备案域名的情况。如果您想创建域名,请参见域名注册快速入门

        1. 添加或选择您的企业主体域名。

          若您还没有在AppFlow中添加您的域名,单击添加域名并按照提示添加。

          image

        2. 单击保存,完成配置。

        适用于没有在阿里云备案域名的情况,通过计算巢服务可以自动创建并配置Nginx代理,您选择的计算巢实例将自动作为内网代理机器使用。

        1. 在下拉框中选择计算巢实例。

          如没有您可单击部署计算巢实例进行部署。

        2. 在弹出的页面中,请根据您的实际情况配置参数并单击下一步:确认订单

        3. 请您确认服务实例的各个参数以及收费项,单击立即创建

          说明

          部署过程通常耗时1-3分钟,请刷新列表并耐心等待。

        4. 复制IP白名单并单击保存

          重要

          请保存Ip白名单,后续会添加到企业微信应用的企业可信IP中。

      4. 绑定自定义域名后,效果对比图如下所示。

        测试地址

        自定义域名

        image

        image

后续操作

企业微信集成

当您为AI助手完成Web页面集成后,可将其嵌入企业微信的自建应用中。这种方式让员工可以直接在企业微信内访问AI助手,提供即时帮助,提升工作效率和体验。具体操作,请参见企业微信集成

管理模型

当创建完成AI助手后,您可以管理和调整已有模型,同时也支持导入新模型。具体操作,请参见管理模型

管理插件

为您的AI助手添加插件能大幅提升效率和专业性。AppFlow提供多种现成插件,并支持您开发自定义插件。具体操作,请参见管理插件

  • 本页导读 (1)
  • 为什么使用AppFlow的AI助手?
  • 使用效果
  • 计费说明
  • 创建流程图
  • 操作步骤
  • 步骤一:新建AI助手
  • 步骤二:导入模型并设置页面
  • 步骤三:web页面集成
  • 后续操作
  • 企业微信集成
  • 管理模型
  • 管理插件