10分钟在钉钉上增加一个AI机器人

在阿里云上,您只需 10 分钟,无需任何编码,即可为您的组织在钉钉平台上创建一个有大模型能力加成的 AI 机器人。这个机器人可以全天候(7x24)响应用户咨询,还能解答私域问题,成为您业务的专属机器人,提升用户体验,增强业务竞争力。

方案概览

在钉钉中添加一个 AI 机器人,只需几步:

  1. 创建大模型问答应用:通过百炼创建一个大模型应用,并获取调用大模型应用 API 的相关凭证。

  2. 创建钉钉应用:创建一个钉钉应用,在您的钉钉组织中提供机器人问答服务。

  3. 创建钉钉连接流:基于阿里云的 AppFlow 服务,在无需编写代码的情况下,完成钉钉机器人和百炼 RAG 应用的关联,最终实现用户在钉钉聊天中和 RAG 应用对话。

  4. 配置钉钉机器人:为钉钉应用配置机器人,添加到群聊中可以回答用户问题。

  5. 为大模型问答应用增加私有知识:开启知识检索增强(RAG),为大模型问答应用增加知识库,让 AI 机器人能回答私有领域的问题,帮助您更好地应对用户咨询。

image

d022fe9c-c5d5-4c0b-a7fb-85b277b3eb91

1. 创建大模型问答应用

首先我们可以通过创建一个百炼应用,来获取大模型的推理 API 服务,用于实现 AI 助手。

百炼提供的新用户免费额度可以完全覆盖本教程所需资源消耗。额度消耗完后按 token 计费,相比自行部署大模型可以显著降低初期投入成本。

1.1 创建应用

  1. 进入百炼控制台的我的应用在页面右侧点击新增应用。在对话框,选择智能体应用并创建。2024-09-22_11-25-00

  2. 应用设置页面,模型选择通义千问-Plus,其他参数保持默认。

    您也可以选择输入一些 Prompt,比如设置一些人设以引导大模型更好的应对客户咨询。
    你叫小助,可以帮助用户解答产品选购、使用等方面的问题。

    image

  3. 在页面右侧可以提问验证模型效果。不过您会发现,目前它还无法准确回答你们公司的商品信息。点击右上角的发布,我们将在后面的步骤中去解决这一问题。

    image

1.2 获取调用 API 所需的凭证

为了在后续通过 API 调用大模型应用的能力,我们需要获取一个百炼应用的 API-KEY 和应用 ID:

  1. 在应用列表中可以查看所有百炼应用 ID。保存应用 ID 到本地用于后续配置。2024-09-18_17-38-41

  2. 在顶部导航栏右侧,点击人型图标,点击API-KEY进入我的API-KEY页面。在页面右侧,点击创建我的API-KEY,在弹出窗口中创建一个新 API-KEY。保存 API-KEY 到本地用于后续配置。2024-09-18_17-23-56

2. 创建钉钉应用

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

重要

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

2.1 创建应用

  1. 访问钉钉开放平台,点击创建。如果创建过应用未展示应用开发指引,点击立即开始进入钉钉应用页面。image

  2. 在应用开发的左侧导航栏中,点击钉钉应用,在钉钉应用页面右上角点击创建应用11

  3. 创建应用面板,填写应用名称应用描述,上传应用图标,完成后点击保存12

2.2 查看应用 Client ID 和 Client Secret

在左侧菜单选择凭证与基础信息,复制 Client ID 和 Client Secret,用于下一步创建连接流。

21

2.3 创建消息卡片

钉钉机器人通过卡片消息支持流式返回结果,您需要创建卡片模板供消息发送使用。

  1. 访问卡片平台,点击新建模板29

  2. 在创建模板输入框,填入模板信息。image

  3. 在模拟编辑页面,保存发布模板。然后点击返回模板列表页面。image

  4. 复制模板ID,用于创建钉钉连接流使用。image

2.4 授予应用发送卡片消息权限

创建卡片后,您需要给应用授予发送卡片消息的权限。

  1. 访问钉钉应用列表。找到刚刚创建的应用,点击应用名称进入详情页面。

  2. 在左侧菜单选择开发配置 > 权限管理,在左侧搜索框分别输入Card.Streaming.WriteCard.Instance.Write,并在操作列点击申请权限image

3. 创建钉钉连接流

AppFlow 可以让您在不写代码的情况下,通过界面配置就可以将大模型应用和钉钉连接起来。您可以通过预置的 AppFlow 模板创建一个钉钉机器人连接流。

  1. 使用AppFlow模板创建连接流,点击立即使用进入创建流程。18

  2. 在连接流的账户授权配置向导页,点击前往授权。在创建凭证对话框中,填入之前获取的钉钉应用的 Client ID 和 Client Secret,并设置一个自定义凭证名称。22

  3. 在连接流的账户授权配置向导页,点击前往授权。在创建凭证对话框中,填入之前获取的 API-KEY,并设置一个自定义凭证名称。23

  4. 执行动作配置向导页,填写应用Id模版ID,完成后点击下一步26

  5. 基本信息配置向导页,填写连接流名称连接流描述(建议保持默认),完成后点击下一步

  6. 界面提示流程配置成功,复制 WebhookUrl,点击发布27

4. 配置钉钉机器人

有了webhook地址后,接下来您可以在钉钉应用中配置机器人来回答用户问题了。

4.1 配置钉钉机器人

  1. 访问钉钉应用列表。找到刚刚创建的应用,点击应用名称进入详情页面。

  2. 添加应用能力页面,找到机器人卡片,点击添加13

  3. 在机器人配置页面,打开机器人配置开关,您可以参考下图完成配置。消息接收模式请选择HTTP模式消息接收地址为刚刚的 WebhookUrl。然后点击发布

    重要

    消息接收模式请选择HTTP模式,目前AppFlow仅支持HTTP模式,选择Stream模式会导致无法返回消息。

    30

4.2 发布应用版本

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

  1. 点击应用开发,在钉钉应用页面,点击目标应用(百炼手机答疑)。8

  2. 在目标应用开发导航栏,点击版本管理与发布,在版本管理与发布页面,点击创建新版本。进入版本详情页面,输入应用版本号版本描述信息,选择合适的应用可见范围,完成后点击保存。并在弹窗中点击直接发布10

4.3 测试机器人

你可以创建群聊或在已有群聊中添加机器人,并与机器人对话,查看效果。

  1. 在钉钉群管理中添加机器人​。进入钉钉群群设置页面,点击机器人卡片区域,在机器人管理页面,点击添加机器人。在添加机器人搜索文本框中输入目标机器人名称,并选中要添加的机器人。点击添加,完成后再点击完成添加14

  2. 在钉钉群中@机器人,进行交流互动。image

5. 为大模型问答应用增加私有知识

5.1 配置知识库

接下来,我们可以尝试让大模型在面对客户问题时参考这份文档,以产出一个更准确的回答和建议。

假设您在一家售卖智能手机的公司工作。您的钉钉用户群上会有很多涉及智能手机相关的问题,如支持双卡双待、屏幕、电池容量、内存等信息。不同机型的详细配置清单参考:百炼系列手机产品介绍.docx

  1. 上传文件:在百炼控制台的数据管理中的非结构化数据页签中点击导入数据,根据引导上传我们虚构的百炼系列手机产品介绍:

    根据您上传的文档大小,百炼需要一定时间解析,通常占用1~6分钟,请您耐心等待。

    image

  2. 建立索引:进入知识索引,根据引导创建一个新的知识库,并选择刚才上传的文件,其他参数保持默认即可。知识库将为上一步骤中准备的文档建立索引,以便后续大模型回答时检索参考。

    image

    选择向量存储类型时,如果您希望集中存储、灵活管理多个应用的向量数据,可选择ADB-PG

    image

    image

  3. 引用知识:完成知识库的创建后,可以返回我的应用进入到刚才创建的应用设置界面,打开知识检索增强开关、选择知识库,测试验证符合预期后点击发布。Prompt 中会被自动添加一段信息,以便大模型在后续回答时参考检索出来的信息。

    image

5.2 检验效果

有了参考知识,AI 机器人就能准确回答您关于百炼手机的问题了。66-1

总结

通过前面的学习,您已经能搭建一个大模型 RAG 应用,并且将其以 AI 机器人的形式添加到钉钉群中来应对客户咨询,过程仅需 0 元(免费试用额度内)10分钟。

应用评测

建议您在正式上线 AI 机器人前,组织业务人员一起参与应用评测,确保大模型应用的回答效果符合预期。如果不符合预期,可以通过优化提示词、完善补充私有知识、调整文档切分策略等方法来改进回答效果。

持续改进

大模型课程

系统体验的改进优化永远没有终点,您可以考虑学习并通过阿里云大模型ACA认证,该认证配套的免费课程能帮助您进一步了解大模型的能力和应用场景,以及如何优化通过大模型的应用效果。

常见问题

记录 AI 助理对话日志

如果您想要记录 AI 助理对话日志并进行分析,您可以参考如下内容在 Appflow 中添加日志节点,将对话内容记录在阿里云日志服务中。

  1. 访问AppFlow控制台,在表格操作列点击详情,在详情页面右上角点击创建新版本2024-10-08_17-48-33

  2. 在编辑页面阿里云百炼步骤之后,点击+添加新的步骤。行业类型选择阿里云公共连接器选择SLS日志云服务2024-10-08_17-51-322024-10-08_17-52-43

  3. 选择执行动作写入日志,点击保存,进入下一步2024-10-09_10-22-08

  4. 点击添加新凭证。在创建凭证对话框,根据表单填入信息,完成角色创建和授权。创建完成后,选择凭证,并点击保存,进入下一步2024-10-09_10-25-292024-10-09_10-27-29

  5. 选择地域、Project 和 Logstore。填入所需的日志信息,左侧输入框是日志Key,直接输入,右侧是日志Value,通过插入变量获取上下文中信息。

    1. 如果您已经创建过用于存储 AI 助手日志的阿里云日志服务的ProjectLogstore,则可以直接使用,如果没有创建过,可以参考创建ProjectLogstore创建。创建完成后无需接入日志,进入Logstore详情页面,在页面右上角点击开启索引,使用默认的全文索引即可。开启索引后才可以在日志服务进行在线日志查询和分析。2024-10-09_10-36-532024-10-09_10-38-45

    2. 选择地域、Project 和 Logstore。填入所需的日志信息,左侧输入框是日志Key,直接输入,右侧是日志Value,通过插入变量获取上下文中信息。image

  6. 保存并发布连接流版本。2024-10-09_11-02-12

  7. 进行对话测试,并查看日志。2024-10-09_11-35-40