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

一、引言

想象一下，你只需要花10分钟，不用写一行代码，就能在钉钉里给团队添一个24小时在线、能解答私域问题的AI助手。这个机器人随时待命，处理产品咨询、技术支持都不在话下——简直就是你业务的专属客服，还能大幅提升用户体验。

这次的活动，就是带大家亲手走一遍流程，

，顺便还有机会拿奖品。别担心步骤复杂，其实核心环节就那么几块，我们一步步来。

二、方案概览

要在钉钉里装上这个AI大脑，总共分五步：

1. 创建大模型应用：
   先在百炼上搭一个能理解问题、生成回答的应用，拿到调用它的钥匙（API凭证）。

2. 创建钉钉应用：
   在钉钉组织里新建一个应用，作为机器人的宿主。

3. 创建钉钉连接流：
   借助阿里云AppFlow，不用写代码，把钉钉机器人和百炼应用串起来。

4. 配置钉钉机器人：
   给钉钉应用装上机器人功能，扔到群里就能回答问题。

5. 注入私有知识：
   开启RAG（知识检索增强），把产品手册、内部文档喂给大模型，让它能回答只有你们公司才知道的事。

三、创建大模型问答应用

3.1 创建应用

先从最基础的大模型应用开始。进到百炼控制台的“我的应用”，点“创建应用”。在设置里，模型选“通义千问-Plus”，其他参数保持默认。你也可以在Prompt里写点人设，比如：

你叫小助，可以帮助用户解答产品选购、使用等方面的问题。

设好后，在右侧对话框试一下——你会发现它确实能回答通用问题，但对你们公司的具体商品还一问三不知。别急，先点“发布”，后面我们会补上知识库。

3.2 获取调用API所需的凭证

要让后续的钉钉机器人能调用这个AI能力，需要拿到两个东西：

• API-KEY：
  在“我的应用”页，点击“查看我的API-KEY”，新建一个。

• 应用ID：
  在应用列表里可以直接复制。

2. 创建钉钉应用

接下来，在钉钉组织里创建一个应用，做机器人的容器。注意：创建钉钉应用需要你的账号有开发者权限——如果还没有，找组织管理员开通一下（具体可参考“成为钉钉开发者[1]”）。

2.1 创建应用

1. 访问钉钉开放平台，点击“创建”。
2. 在左侧导航栏选“钉钉应用”，然后点右上角的“创建应用”。
3. 在弹出面板里填上应用名称、描述，上传图标，保存。

2.2 查看应用Client ID和Client Secret

在左侧菜单选“凭证与基础信息”，复制Client ID和Client Secret。这两个值是下一步连接流要用到的密钥。

2.3 创建消息卡片

钉钉机器人通过卡片消息支持流式返回结果，所以得先建一张卡片模板：

1. 访问卡片平台，点击“新建模板”。
2. 填入模板信息（名称、描述等）。
3. 在模拟编辑页面保存并发布模板。
4. 回到模板列表，复制模板ID，后面用得上。

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

创建完卡片，要给应用授权才能发消息：

1. 进入钉钉应用列表，找到刚创建的应用，点击进入详情。
2. 在左侧选“开发配置 > 权限管理”，在搜索框分别输入Card.Streaming.Write和Card.Instance.Write，点击“申请权限”。

3. 创建钉钉连接流

AppFlow是个好东西，它让你不用写代码，通过图形界面就把大模型和钉钉接起来。这里我们用预置模板搞定：

1. 使用AppFlow模板[2]创建连接流，点击“立即使用”。
2. 在“账户授权”配置页，点“前往授权”，填入钉钉应用的Client ID和Client Secret，自定义一个凭证名称。
3. 同样，再授权一次百炼，填入刚才拿到的API-KEY。
4. 在“执行动作”配置页，填写“应用Id”（百炼应用ID）和“模版ID”（刚才复制的卡片模板ID）。
5. 在“基本信息”页，连接流名称和描述保持默认就行。
6. 配置成功后，复制页面上显示的

   WebhookUrl
   ，然后点击“发布”。

4. 配置钉钉机器人

有了Webhook地址，就可以在钉钉应用里激活机器人了。

4.1 配置机器人

1. 访问钉钉应用列表，找到应用进入详情。
2. 在“添加应用能力”页面，找到机器人卡片，点击“添加”。
3. 打开机器人配置开关，消息接收模式选“HTTP模式”，消息接收地址填刚才复制的WebhookUrl，然后点“发布”。

4.2 发布应用版本

如果想让企业内其他人都能用，需要发布一个版本：

1. 在“应用开发”里的“钉钉应用”页面，点击目标应用。
2. 进入“版本管理与发布”，点“创建新版本”，填好版本号、版本描述，设置好应用可见范围，保存并直接发布。

4.3 测试机器人

建个群或者拉个已有群聊试试：

1. 在钉钉群的“群设置”里找到“机器人”卡片，点“添加机器人”，搜索到你刚发布的机器人名称，选中添加。
2. 在群里@机器人，随便问个问题——比如“你们手机屏幕多大？”，看它怎么回答。

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

5.1 配置知识库

刚才的机器人只能回答通用问题，要让它了解你们自家的产品，还得喂点“私货”。假设你在一家卖智能手机的公司，手头有一份产品介绍文档（比如“百炼系列手机产品介绍.docx”），里面详细列出了各机型的屏幕、电池、内存等参数。接下来三步教会它：

1. 上传文件：
   进到百炼控制台的“数据管理”，点“导入数据”，按引导上传这份文档。

2. 建立索引：
   进入“知识索引”[4]，创建一个新知识库，选中刚才上传的文件，其他参数默认就行。知识库会为文档内容建立向量索引，方便大模型检索。（选择向量存储类型时，如果希望多个应用共用同一套向量数据，可以选ADB-PG。）

3. 引用知识：
   回到“我的应用”[5]，进入刚才创建的应用设置，打开“知识检索增强”开关，选择你刚建好的知识库。测试一下效果，满意后点击发布。在发布时，Prompt会自动补充一段指令，让大模型参考检索到的信息作答。

5.2 检验效果

再来一次测试：在群里@机器人问“百炼Pro支持双卡双待吗？”或者“电池容量多少？”。你会发现，这次它能准确给出答案了——因为背后有了自家的知识库做支撑。

从创建应用到配置知识库，整个流程下来真的不到十分钟。拿去用吧，给你的钉钉团队配个AI助手，省心不少。