一、引言

设想一下，你只需花费短短10分钟，甚至无需编写任何代码，就能在钉钉上为团队部署一个全天候在线、专门解答私域问题的智能AI助手。这个机器人随时可用，无论是产品咨询还是技术支持，它都能从容应对——它就像是你业务的专属客服，能够显著提升用户的整体体验。

本次活动，就是带领大家亲手操作全流程，将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助手，能显著提升工作效率和用户体验。