# Dify
客服系统是企业与消费者沟通的重要桥梁，然而传统的人工客服存在着人工成本高昂、数据收集和分析困难、难以24小时提供服务等痛点。
随着AI大模型的崛起，如何利用先进的大语言模型构建AI智能客服系统，提供更加自然、流畅的对话体验，提高用户使用效率，实现24\*7的无间断服务，降低企业在客服场景下的投入成本，提升用户满意度成为企业和用户关注的热门领域。
基于开源框架Dify构建智能对话助手，系统支持用户直接调用大模型进行开放式问答，适用于智能客服、知识库问答、个性化推荐等多种业务场景。MaaS集成了DeepSeek、GLM等系列大模型，基于昇腾AI云服务进行全面适配和优化，使得精度和性能显著提升。
本文以GLM-5.1模型为例，介绍如何使用MaaS的模型API接入Dify（开源Agent平台），快速构建AI对话机器人并将其嵌入在网页中。
#### 方案架构
图1方案架构   
![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002661209409.png "点击放大")
1. 用户通过Dify搭建的客服机器人界面提交问题请求。
2. Dify将请求发送给MaaS 模型服务。
3. MaaS 大语言模型处理请求后将结果返回给Dify。
4. Dify将结果优化处理后通过客服机器人界面返回给用户。
 
#### 计费说明
本文支持使用预置服务进行调用。计费如下：
预置服务：提供商用级别的推理API服务，无需等待部署，开通后您可直接体验或调用模型服务，按Tokens数量计费。详细信息，请参见[推理服务计费项](https://support.huaweicloud.com/price-maas/price-maas-0001.html)。
#### 约束限制
该功能仅支持"西南-贵阳一"区域。
#### 前提条件
- 已注册华为云账号，并进行实名认证。具体操作，请参见[注册华为账号并开通华为云](https://support.huaweicloud.com/usermanual-account/account_id_001.html)和[实名认证](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0071343161.html)。
- 请参考[配置MaaS访问授权](https://support.huaweicloud.com/permission-maas/maas-modelarts-0016.html)进行委托授权。
 
#### 步骤一：基于云服务器单机部署Dify平台
Dify是一个能力丰富的开源AI应用开发平台，为大型语言模型（LLM）应用的开发而设计。它巧妙地结合了后端即服务（Backend as Service）和LLMOps的理念，提供了一套易用的界面和API，加速了开发者构建可扩展的生成式AI应用的过程。
1. 基于Flexus云服务器X实例快速部署Dify平台。具体操作，请参见[快速搭建Dify-LLM应用开发平台](https://support.huaweicloud.com/dify-aislt/dify_03.html)云服务器单机部署方式。
   **部署Dify平台的区域要与MaaS体验模型的区域一致**，本文选择在"西南-贵阳一"区域部署Dify平台。
   
2. 部署完成后，登录Dify。 **首次登录需注册管理员账号**，依次填写邮箱、账号、密码后，单击"设置"进行保存后，即可登录使用。
   图2注册管理员账户
   ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002661335787.png "点击放大")
   
   
 
 #### 步骤二：获取MaaS平台的模型信息
在MaaS平台，您可以调用预置服务模型。在模型调用时，需要获取模型服务的API地址和模型名称，并创建API Key。
- [使用预置服务]
  1. 在[MaaS控制台](https://console.huaweicloud.com/modelarts/#/model-studio/homepage)左侧导航栏，选择"模型推理 \> 在线推理"。
  
  2. 在"预置服务"页签，在目标服务右侧的"操作"列，单击"开通服务"。
  
  3. 在开通预置模型服务对话框，按需勾选预置服务，勾选"我已阅读并同意上述说明，及《MaaS 模型即服务声明》"，单击"一键开通"。 勾选目标预置服务后，会自动开通该服务下的所有模型版本。
     
  
  4. 在已开通的预置服务右侧，单击"操作"列下的"API调用"，选择版本。
  
  5. 在"API调用说明"页面，单击"创建 API Key"，配置相关参数，单击"确定"。
     API Key用于接口的鉴权认证，最多可创建30个密钥。API Key的标签在创建完成后，不支持修改。每个密钥仅在创建时显示一次，请确保妥善保存。如果密钥丢失，无法找回，需要重新创建API Key以获取新的访问密钥。关于API Key参数说明，请参见[创建API Key](https://support.huaweicloud.com/model-call-maas/model-call-049.html)。
     图3创建API Key   
     ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002523688026.png "点击放大") 
  
  6. 在"您的API Key"对话框，复制密钥并保存至安全位置。保存完毕后，单击"我已保存，确认关闭"。 单击"我已保存，确认关闭"后将无法再次查看密钥。
     
  
  7. 在"API调用说明"页面，查看调用该服务需要的API地址和模型名称信息，在后续Dify配置中使用。
   
#### 步骤三：在Dify平台对接MaaS模型服务
1. 打开您的Dify平台，单击右上角"插件"按钮。
   图4Dify平台   
   ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002630997588.png "点击放大")
   
   
2. 单击"探索Marketplace"按钮，在搜索框输入"MaaS"，选择"华为云MaaS平台"，单击"安装"按钮，弹出"安装插件"页面。
   图5搜索插件   
   ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002661077083.png "点击放大")
   
   
3. 在"安装插件"页面，单击"安装"，安装MaaS插件。
   图6安装插件   
   ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002661077645.png "点击放大")
   
   ![](https://support.huaweicloud.com/model-call-maas/public_sys-resources/note_3.0-zh-cn.png)
   如已安装MaaS插件，需要更新MaaS插件至最新版本。
   
4. MaaS插件安装成功之后，单击Dify页面右上角用户名称，下拉并单击"设置"，进入设置界面。
   图7设置界面   
   ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002661479515.png "点击放大")
   
   
5. 在左侧导航栏单击"模型供应商"，单击MaaS插件右侧的"设置"按钮，配置API 密钥，如下图所示：
   图8模型供应商   
   ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002661241033.png "点击放大")
   
   
6. 在API 密钥授权配置界面，填写[步骤二：获取MaaS平台的模型信息]获取的API Key，单击"保存"，密钥授权成功。
   图9API 密钥授权设置   
   ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002631002778.png "点击放大")
   
   
7. 在插件下方单击"显示N个模型"，弹出模型列表，如下图所示。
   图10添加模型   
   ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002631005552.png "点击放大")
   
   图11模型列表   
   ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002631005624.png "点击放大")
   
   
 
#### 步骤四：在Dify中创建客服机器人
1. 进入Dify平台"工作室"，单击"创建空白应用"。
   图12创建空白应用   
   ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002661087815.png "点击放大")
   
   
2. 在"创建空白应用"页面，选择"聊天助手"，填写"应用名称 \& 图标"，单击"创建"，客服机器人创建成功。
   图13创建应用   
   ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002630849436.png "点击放大")
   
   
3. 客服机器人创建成功后，自动进入应用调试界面。右上角选择已开通的模型，在下方聊天框输入信息，模型正常答复后，说明客服机器人调试成功。
   图14应用调试页面   
   ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002661262833.png "点击放大")
   
   
4. 页面右上角单击"发布"，应用发布成功。可根据实际应用场景对该应用进行"发布更新"、"运行"、"嵌入网站"等操作，如下图所示：
   图15应用发布页面   
   ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002630858424.png)
   
   
 
#### 相关文档
Dify平台的更多应用，详情请参考[使用Dify](https://support.huaweicloud.com/dify-aislt/dify_06.html)。
#### 常见问题
**在MaaS创建API Key后需要等待多久才能生效？**
MaaS API Key在创建后不会立即生效，通常需要等待几分钟才能生效。