Deepseek模型与钉钉机器人集成-阿里云帮助中心

本实验旨在指导初学者利用阿里云百炼平台控制台，实现 DeepSeek 模型与知识库（RAG）的集成，并通过零代码方式将智能体发布到钉钉，最终构建一个智能电商客服与商品推荐助手。

实验简介

背景知识

DeepSeek 模型：DeepSeek 系列模型以其卓越的性能和高性价比在大模型领域脱颖而出。在阿里云百炼平台上，用户可以方便地将 DeepSeek 模型作为智能体的核心推理引擎，利用其强大的理解和推理能力，高效处理复杂的客服问答和商品推荐逻辑。
阿里云百炼平台：百炼平台是阿里云提供的一站式大模型服务平台，它不仅提供模型调用服务，更重要的是提供了智能体应用的快速构建和多渠道发布能力。本实验将重点利用百炼平台提供的知识库（RAG）和钉钉集成功能。
知识库（RAG - Retrieval-Augmented Generation）：在电商客服场景中，RAG 技术至关重要。它允许智能体从企业的产品手册、售后政策、常见问题（FAQ）等文档中检索信息，从而提供比通用大模型更准确、更专业的回答，极大地提升了客服效率和用户体验。
钉钉集成：阿里云百炼平台支持将智能体应用直接发布为钉钉机器人。这是一种零代码的 API 调用验证方式，用户在钉钉群聊中与机器人互动，即可验证智能体（DeepSeek模型+知识库）的最终效果，从而证明 API 调用的成功和应用的可用性。

实验室资源方式简介

进入实操前，请确保阿里云账号满足以下条件：

个人账号资源
- 使用您个人的云资源进行操作，资源归属于个人。
- 所有实验操作将保留至您的账号，请谨慎操作。
- 平台仅提供手册参考，不会对资源做任何操作。
确保已完成云工开物300元代金券领取。
已通过实名认证且账户余额≥0元。
本实验费用以实际使用的token量为准，以qwen-Plus为例，输入 0.0008元/千tokens，输出0.002元/千tokens。
本实验产生的费用优先使用优惠券。如果您调整了资源规格、使用时长，或执行了本方案以外的操作，可能导致费用发生变化，请以控制台显示的实际价格和最终账单为准。
实操结束后，如通过云工开物代金券购买的产品，无需进行注销；如注销产品，代金券不会返还。
新注册阿里云百炼的用户，千问系列模型提供模型的免费额度，不同模型的免费额度不同，请在使用前，先阅读产品文档确认模型的免费额度，或在使用前，登录阿里云百炼-模型广场-模型卡片详情，查看具体模型的免费额度。注意在使用过程中的token消耗。模型列表只有开通阿里云百炼服务后才能体验模型的免费额度。

领取专属权益及开通资源

第一步：在开始实验之前，请先点击屏幕的“开始实操”再进行后续操作

第二步：本次实验需要您通过领取阿里云云工开物学生专属300元抵扣券兑换本次实操的云资源，如未领取请先点击领取。（若已领取请跳过）

重要

实验产生的费用优先使用优惠券，优惠券使用完毕后需您自行承担。

学生认证

实验步骤

说明

本实验的所有操作均在阿里云百炼平台控制台中完成，无需安装任何本地软件或编写代码。

1、获取 API-KEY
- 点击进入阿里云百炼控制台
  - 进入【应用】—【应用管理】，点击【立即登录】
  - 若之前未登录开通过阿里云百炼请按以下步骤操作，若已开通过阿里云百炼服务请跳过此步
    - 阅读服务协议并点击【同意】
- 在左侧导航栏找到【密钥管理】，点击【创建 API-KEY】，并妥善保存生成的 API-KEY。此密钥是后续 API 调用的身份凭证。
- 勾选归属账号、选择归属业务空间，点击【确定】
  创建成功
2、创建智能体应用与 DeepSeek 模型配置
- 点击【应用】——【应用管理】——【创建应用】
- 选择【智能体应用】-【Agent 1.0】-【应用名称】-【立即创建】
  应用名称：修改为“智能电商客服助手”
  描述信息：基于Deepseek模型和商品知识库，提供专业的电商客服问答和商品推荐服务。
- 模型选择： DeepSeek 系列模型，下拉列表没有的话，点击【更多模型】进行搜索
3、提示词
我们需要设计一个专业的系统提示词，以定义智能体的角色和行为规范，并引导其使用知识库。
示例提示词：
你是一个专业的电商客服和商品推荐助手。你的职责是友好、准确地回答用户关于商品、订单、物流、售后政策的问题。你的回答必须基于你所拥有的知识库内容。如果知识库中没有相关信息，请礼貌地告知用户你无法回答。在回答完客服问题后，请尝试根据用户的提问内容，推荐一款相关的商品。
输入提示词后，点击右上角的【优化】，平台将基于当前输入提供更专业的系统提示词建议，以进一步完善智能体的角色定义、行为规范和知识库使用引导
4、知识库
- 在智能体应用配置界面，点击左侧的【知识】选项卡，在【文档】模块右侧点击【+】按钮，点击【创建新知识库】
- 跳转创建知识库页面，填写后点击【下一步】
  输入名称：智能电商客服与商品知识库
  知识库描述：本知识库专为智能电商客服场景设计，旨在通过集成产品手册、售后政策、常见问题（FAQ）等核心文档，构建一个高准确性、专业化的知识检索增强生成（RAG）系统。它以 DeepSeek 模型为核心驱动力，提供基础文档问答和图文并茂回复能力。知识库内容经过向量化处理，确保智能体能快速、精准地从海量资料中检索信息，用于回答用户关于商品详情、订单状态、退换货流程、会员权益等问题。
- 将模拟好的电商产品手册或售后政策文档拖拽到文件上传处（例如：包含“退换货流程”、“尺码对照表”、“会员权益”等内容的文档），上传后点击【下一步】
  示例文件：
  文件1：服装尺码对照表（男士上衣）.pdf
  文件2：服装尺码对照表（女士上衣）.pdf
  文件3：会员权益体系.pdf
  文件4：裤装尺码对照表（男女通用）.pdf
  文件5：售后政策：退换货流程.pdf
- 其他选项保持默认设置，点击【完成】
- 系统自动进行文档解析。文档解析需要一定时间，请您耐心等待，直至状态变更为“解析完成”状态，才能在后续的文档问答过程中被检索到。
- 返回应用管理进入到刚才创建的智能体配置界面，左侧页面下滑到知识模块，点击【＋】，可以导入或移除已有的知识库。
- 重要
  注意：
  如后续不再使用阿里云百炼知识库，请在实验结束后删除！！如在实验结束后继续使用知识库，将按小时进行资源计费，费用参考：0.03 元/知识库/小时（标准版）和0.2 元/RCU/小时（旗舰版）
5、模型上下文协议（MCP）实践
- 智能体应用不仅需要知识库来回答静态信息，还需要通过集成MCP服务（Model Context Protocol Service）来获取实时数据和执行特定任务，从而扩展其能力边界。这些服务充当智能体的“工具”，使其能够处理物流查询、图像识别等动态业务需求，极大地提升了电商客服的实用性和用户体验。
- 要开始集成，首先在智能体应用配置页面，在左侧导航栏的【技能】选项卡，然后在页面中找到【MCP 服务】模块。点击该模块右侧的【+】按钮，系统将弹出【选择 MCP 服务】窗口，展示所有可用的工具列表，点击【未开通】。
- 搜索“商品条码查询”、“OCR文字识别”和“全国快递物流查询”，点击【立即开通】
- 勾选并点击【立即开通】
- 点击【添加全部】，将这些工具集成到智能体应用中，其他两个工具添加方式同理
- 添加成功
- 最后，为了使这些新的工具能力在应用中生效，用户必须点击页面右上角的【发布】按钮，将最新的配置部署到智能体应用中。
6、钉钉集成与 API 调用验证（零代码）
本步骤将通过阿里云百炼平台与钉钉开放平台、 AppFlow 的零代码集成，将已配置 DeepSeek 模型和知识库的智能体发布到钉钉机器人，以验证其 API 调用和 RAG 能力是否成功。整个流程涉及三个主要平台：阿里云百炼平台（智能体应用）、钉钉开放平台（创建钉钉应用和机器人）、阿里云 AppFlow（连接流，实现百炼与钉钉的通信）。
- 钉钉开放平台准备工作
  - 进入发布配置界面
    在阿里云百炼控制台，进入创建的智能体应用的配置页面。然后点击左侧导航栏的【发布】选项卡。在发布渠道列表中，找到【钉钉机器人】，点击【创建】
  - 获取钉钉关键配置信息
    在创建页面，我们看到配置钉钉机器人需要获取钉钉的模板ID,Client ID以及Client Secret。接下来我们将逐一获取这些关键配置
  - 首先，我们需要在钉钉中新建一个组织名为“阿里智能电商客服测试”，然后访问钉钉开放平台，选择刚才创建的组织
  - 然后点击左上角的应用开发，选中钉钉应用，再点击创建应用。
  - 在创建钉钉应用面板，填写应用名称为“阿里智能电商客服”并且填写应用描述，上传应用图标，完成后点击保存。然后在左侧菜单选择凭证与基础信息，复制 Client ID 和 Client Secret，用于创建连接流以及填写配置机器人页面。
  - 然后，访问卡片页面，获取钉钉模板ID，点击新建模板。
  - 然后，访问卡片页面，获取钉钉模板ID，点击新建模板。
  - 在模拟编辑页面，保存并发布模板。然后点击返回模板列表页面。
  - 复制模板ID，用于创建钉钉连接流使用。
  - 创建卡片后，还需要给应用授予发送卡片消息的权限。我们继续访问钉钉应用列表。找到刚刚创建的应用，点击应用名称进入详情页面。在左侧菜单选择开发配置 > 权限管理，在左侧搜索框分别输入Card.Streaming.Write和Card.Instance.Write，并在操作列点击申请权限。
  - 然后我们回到百炼控制台的发布渠道列表，进入到钉钉机器人的配置页面，将之前步骤获取到的Client ID 和 Client Secret以及钉钉模板ID填到页面中去，填完之后点击确认。
- 创建钉钉连接流
  - AppFlow 可以在不写代码的情况下，通过界面配置就可以将大模型应用和钉钉链接起来，点击链接。
  - 在连接流的账户授权配置向导页，点击添加新凭证。在创建凭证对话框中，填入之前步骤获取的钉钉应用的 Client ID 和 Client Secret，并设置一个自定义凭证名称为“钉钉阿里智能电商客服”。
  - 然后将之前在百炼创建应用的ID和钉钉的模板ID填写到页面中。
  - 界面提示流程配置成功后，复制 WebhookUrl，接着点击发布。
  - 访问钉钉应用列表，找到刚刚创建的应用，点击应用名称进入详情页面。在添加应用能力页面，找到机器人卡片，点击添加。
  - 在机器人配置页面，打开机器人配置开关，可以参考下图完成配置。消息接收模式请选择HTTP模式，消息接收地址为刚刚的 WebhookUrl。然后点击发布。
  - 应用创建完成后，我们还需要发布一个版本。在钉钉应用页面的目标应用开发导航栏，点击版本管理与发布，在版本管理与发布页面，点击创建新版本。进入版本详情页面，输入应用版本号（例如v1）和版本描述信息（专业的电商客服和商品推荐助手），选择合适的应用可见范围（实验选择为所有人），完成后点击保存，并在弹窗中点击直接发布。
  - 然后我们需要在钉钉群管理中添加机器人。进入钉钉群群设置页面，点击机器人卡片区域，在机器人管理页面，点击添加机器人。在添加机器人的搜索文本框中输入目标机器人名称，并选中要添加的机器人。点击添加，完成后再点击完成添加。
  - 在钉钉群中或私聊时@机器人，进行交流和互动，例如可以发送：“我的身高是170，性别为男，给我推荐一下合适的服装”。
- 通过以上详细的实验步骤，我们成功地在阿里云百炼平台上完成了 DeepSeek 模型与知识库（RAG）的集成，并利用 MCP 服务扩展了智能体的工具能力。最重要的是，我们通过零代码的方式，将这一智能体应用发布到了钉钉机器人。这一过程不仅验证了 DeepSeek 模型在复杂业务场景下的强大推理和问答能力，也展示了阿里云百炼平台在简化大模型应用开发、实现快速部署和多渠道集成方面的卓越效率。用户现在可以直观地在实际应用场景中，体验到基于大模型的智能客服所带来的专业性和便捷性，从而证明了 API 调用与集成方案的成功与实用性。

7、实验资源释放
- 释放阿里云百炼平台资源
  - 重要
    注意：为了避免不必要的资源占用和潜在的费用产生，实验结束后请务必按照以下步骤清理在阿里云百炼平台和钉钉开放平台创建的资源
    实验结束后，阿里云百炼账号无需注销
    在阿里云百炼，模型训练部署等需要付费，请谨慎操作。模型体验、构建应用等需要消耗Token，在测试前请先确认是否有免费额度。
  - 删除智能体应用
    登录阿里云百炼控制台，进入应用管理页面。找到创建的智能体应用，点击应用名称进入详情页。在应用配置页面，找到删除应用的选项并确认删除。此操作将释放与该应用关联的模型配置、MCP服务集成以及知识库关联。
  - 删除知识库
    如后续不再使用阿里云百炼知识库，请在实验结束后删除！！如在实验结束后继续使用知识库，将按小时进行资源计费，费用参考：0.03 元/知识库/小时（标准版）和0.2 元/RCU/小时（旗舰版）
  - 删除 API-KEY
    在百炼控制台左侧导航栏，进入密钥管理页面。找到在实验中创建和使用的 API-KEY，点击删除按钮并确认。
- 释放钉钉开放平台资源
  - 删除钉钉应用和机器人
    访问钉钉开放平台，进入应用开发。找到创建的钉钉应用（例如：阿里智能电商客服），进入详情页。在凭证与基础信息界面，先停用然后找到删除应用的选项并确认删除。
  - 删除连接流（AppFlow）
    访问阿里云 AppFlow 控制台，找到创建的连接流，将其停止运行，然后点击删除按钮并确认。