
# 接入和使用DeepSeek模型
#### 案例概述
AgentArts支持接入兼容OpenAI接口规范的第三方大语言模型。本实践以自定义接入和使用DeepSeek模型为例，指导您完成从获取API密钥、接入自定义模型到创建问答助手智能体的完整流程。
完成本实践后，您将获得一个基于DeepSeek大模型的问答助手智能体，并可参考相同流程接入其他兼容OpenAI接口的第三方模型（如Moonshot、GLM等）。
#### 前提条件
- 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)。
- 已注册[DeepSeek开放平台](https://platform.deepseek.com)账号，并确保账户有可用余额。
 
#### 操作流程
接入DeepSeek模型并搭建问答助手智能体，仅需以下四步即可完成从模型接入到智能体上线的完整流程。
图1接入DeepSeek模型并搭建问答助手智能体   
![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389753.png)
表1操作流程 
| 操作步骤                                                              | 说明                                                              |
|:---|:---|
| [步骤一：获取DeepSeek API Key]  | 在DeepSeek开放平台注册账号并创建API Key，获取模型接入所需的鉴权密钥与API地址等关键信息。           |
| [步骤二：在AgentArts接入自定义模型] | 将DeepSeek模型作为自定义模型接入AgentArts平台，完成模型配置、连通性验证与发布，使模型可在智能体中选用。    |
| [步骤三：创建问答助手单智能体]       | 基于已接入的DeepSeek模型创建单智能体，配置提示词与模型参数，并按需添加插件、知识库、记忆等能力组件，打造专属问答助手。 |
| [步骤四：调试并发布单智能体]         | 在"预览调试"窗口进行实时对话验证，确认问答助手能够正常响应并满足业务预期后，分享发布使用。                  |
   
 #### 步骤一：获取DeepSeek API Key
本步骤指导您在DeepSeek开放平台创建API Key，用于后续在AgentArts中接入模型时的身份鉴权。
1. 访问[DeepSeek开放平台](https://platform.deepseek.com/)，登录您的账号。
2. 在左侧导航栏选择"API Keys"，单击"创建API Key"。 
   图2创建API Key   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549587.png "点击放大")
   
   
3. 在弹出的对话框中输入API Key名称，例如"chat"，单击"创建"。
4. 在创建成功的对话框中，单击"复制"，将API Key复制并保存到本地安全位置。 
   ![](https://support.huaweicloud.com/bestpractice-agentarts/public_sys-resources/caution_3.0-zh-cn.png)
   API Key仅在创建时展示一次，关闭对话框后将无法再次查看。如果遗失，需要重新创建。请妥善保管，避免泄露。
   
   
5. 记录[表2]信息，后续步骤中将使用。更多内容可参考[DeepSeek官方文档](https://api-docs.deepseek.com/zh-cn/)。
   
   图3DeepSeek官网API调用示例   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549577.png "点击放大")
    表2DeepSeek API关键信息 
   | 参数           | 值                                         | 说明               |
   |:---|:---|:---|
   | API Base URL | https://api.deepseek.com/chat/completions | DeepSeek API请求地址 |
   | API Key      | sk-xxxxxxxxxx                             | 获取的API Key       |
   | 模型名称         | deepseek-chat                             | DeepSeek模型标识     |
      
   
   
 
 #### 步骤二：在AgentArts接入自定义模型
本步骤指导您将DeepSeek模型作为自定义模型接入AgentArts，接入后即可在智能体中选用该模型。
1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。
2. 在左侧导航栏，选择"开发中心 \> 开发配置"，选择"自定义模型"页签，单击"新建模型供应商"。
3. 在"新建模型供应商"页面，如[图4]所示配置参数信息，具体参数说明请参考[表3]。
   
   图4新建模型供应商   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949968.png "点击放大")
    表3新建模型供应商参数说明 
   | 参数      | 示例                                                                                    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   |:---|:---|:---|
   | 供应商图标   | 系统默认图标                                                                                | 系统默认供应商图标，也可自定义图标。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   | 供应商名称   | 深度求索                                                                                  | 供应商的名称。由2\~64个字符组成，包含中英文、数字、下划线、中划线、空格、竖线。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   | 供应商英文名称 | DeepSeek                                                                              | 供应商的英文名称。由2\~64个字符组成，包含英文、数字、下划线、中划线、空格、竖线。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | 描述      | 深度求索（DeepSeek），是量化巨头幻方探索AGI（通用人工智能）的新组织，成立于2023年，专注于研究世界领先的通用人工智能底层模型与技术，挑战人工智能前沿性难题。 | 非必填。供应商的描述信息。由0\~1000个字符组成。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | 选择认证方式  | Api-key                                                                               | 本示例选用Api-key方式进行认证。 关于密钥加密：鼠标移动至"选择认证方式"右侧的![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687790122.png)上，可查看密钥的加密方式。平台默认使用**KMS加密+默认密钥**方式对认证密钥进行加密存储，防止信息泄露。 - 加密机制：使用用户选择的密钥派生DEK进行加密，默认密钥为kms-agentarts/default。  - 费用说明：实例不收费，每月提供20,000次免费调用次数。解密时支持缓存，但敏感数据较多时可能超出免费次数。   |
      
   
   
4. 完成DeepSeek供应商创建后，单击卡片进入"供应商详情"界面，单击"新建模型服务"。
5. 在"新建模型服务"页面，参考[表4]配置参数信息，完成后单击"确定"。
   
    表4新建模型服务参数说明 
   | 参数          | 示例                                                                                           | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   |:---|:---|:---|
   | 模型服务图标      | 系统默认图标                                                                                       | 系统默认模型服务图标，也可自定义图标。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   | 模型服务名称      | deepseek-chat                                                                                | 自定义模型服务名称，用于模型标识。 由2\~64个字符组成，包含中英文、数字及:._/\|\\-，以中英文、数字开头结尾。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   | 模型名称        | deepseek-chat                                                                                | 填写模型的模型ID/模型编码。参考[表2]中的"模型名称"填写。 由2\~64个字符组成，包含中英文、数字及:._/\|\\-，以中英文、数字开头结尾。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   | 类型          | 文本对话                                                                                         | 选择模型类型。DeepSeek-V3为文本对话模型。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   | 模型服务API地址   | https://api.deepseek.com/chat/completions                                                    | 填写模型的API地址。参考[表2]中的"API Base URL"填写。字符长度不大于255个字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   | API接口协议     | 标准OpenAI协议                                                                                   | 选择模型使用的接口协议。DeepSeek兼容OpenAI接口规范，此处选择"标准OpenAI协议"。协议规范详情请参见[接入模型服务API接口规范](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0192.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   | 流控配置        | 无限制                                                                                          | 超出流控值将触发限流，用户的请求会因为流控而失败。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   | 选择标签        | ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389693.png) | 可选项。当"类型"为"文本对话"或"图像理解"时可配置。选择标签后，在应用中选择大模型时显示在大模型右侧。 - ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549593.png)**工具**：当该大模型支持应用调用外部工具时，例如，MCP服务、插件、知识库，可以选择该标签。  - ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549603.png)**思考**：该大模型具备思维推理时，可以选择该标签。  - ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687790134.png)**联网**：该大模型具备联网搜索能力时，可以选择该标签。   |
   | 是否支持关闭思维链输出 | 关闭                                                                                           | 当"选择标签"选择了![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549619.png)**思考**时显示此参数。 - 开启：模型在调测、使用时，显示"深度思考"参数。  - 关闭（默认）：模型在调测、使用时，不显示"深度思考"参数。                                                                                                                                                                                                                                                                                                                                                       |
   | 自定义标签       | -                                                                                            | 可选项。最多支持添加5个标签。单击![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687790092.png)输入标签内容后按Enter键确认。添加后在应用中选择大模型时显示在大模型右侧。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   | 模型服务描述      | deepseek-chat对应DeepSeek-V3的非思考模式                                                             | 可选项。模型服务的描述信息，展示在模型服务卡片中。由0\~1000个字符组成。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
      
   
   
6. 在创建好的"文本对话模型"卡片上，单击"![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549599.png) \> 调测"，进入"模型调测"界面。
7. 在"效果预览"窗口输入测试问题，验证模型是否可正常响应。如果模型返回了合理的回答内容，说明模型配置正确。关于模型调测的更多操作可参考[调测模型](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0187.html)。
   
   图5模型调测效果预览   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389721.png "点击放大")
   
   
8. 确认模型可用后，返回"自定义模型"页签，在已创建的模型服务卡片，单击"![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389709.png) \> 发布"，当模型服务卡片状态显示为"已发布"，表示该模型已可在智能体中使用。
   
   "已发布"的模型不支持"编辑"或者"删除"操作，如需编辑或删除请先单击"取消发布"。
   图6已发布模型   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389713.png)
   
   
 
 #### 步骤三：创建问答助手单智能体
本步骤指导您基于已接入的DeepSeek模型创建一个问答助手单智能体。通过配置模型、提示词及可选能力组件，可以快速搭建一个面向实际业务场景的智能问答助手。
1. 返回[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)"总览"页，单击"快速创建智能体"卡片上的"手动创建"链接。
   
   图7手动快速创建智能体   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687790104.png "点击放大")
   
   
2. 填写智能体的"名称"与"描述"，赋予智能体基本的身份标识，填写完成后单击"确定"跳转至"单智能体配置"界面。 
   图8快速创建智能体   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389737.png "点击放大")
   表5快速创建智能体 
   | 参数 | 配置示例    | 说明                                                                 |
   |:---|:---|:---|
   | 名称 | 问答助手    | 智能体的显示名称，便于在列表中识别与管理。                                              |
   | 描述 | 通用问答助手。 | 对智能体用途的简要说明。系统将基于名称和描述自动生成头像与初始提示词，因此建议填写清晰、准确的描述，以获得更贴合业务场景的初始配置。 |
      
   
   
3. 进入"单智能体配置"界面后，系统会根据已填写的"名称"和"描述"自动生成头像和提示词。您可以直接使用，也可以根据实际需求手动调整。 
   **提示词**是智能体的"行为准则"，决定了智能体的角色定位、回答风格、能力边界与约束规则。一份好的提示词能够显著提升回答质量与一致性。
   例如：明确"不确定时如实告知"可以降低模型编造信息的概率；明确"分步骤解答复杂问题"可以提升回答的条理性。建议根据业务场景持续优化提示词。
   
   
4. 在"模型配置"模块，单击"模型"参数下拉框，选择[步骤二：在AgentArts接入自定义模型]中已接入的"deepseek-chat"模型。
   
   **模型** 的选择直接决定了智能体的基础能力上限。不同模型在通用对话、推理、代码生成等方面各有侧重。
   图9选择模型   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389705.png "点击放大")
   
   
5. （可选）完成基础的模型与提示词配置后，智能体已具备通用问答能力。但在实际业务场景中，一个优秀的问答助手往往还需要： 
   - 查得到：能够检索内部知识或调用外部数据源，而非仅依赖模型自身的训练知识。
   
   - 做得了：能够执行查询、提交、创建等实际操作，而非只能说不能做。
   
   - 记得住：能够记住用户偏好或接收外部传入的上下文，实现个性化、确定性的回答。
   
   
   AgentArts通过技能、知识库、记忆三类能力组件来满足上述需求。
   技能、知识库、记忆
   - 参考[表6]为智能体配置更多能力组件。
      表6智能体能力配置 
     | 配置项       || 说明                                           | 配置说明与示例                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 验证是否生效                                                                                                                                                                                                                                                                                             |
     |:---|---|:---|:---|:---|
     | 技能 | MCP服务 | 基于MCP协议的连接器，用于对接外部数据源或本地工具集，扩展智能体能力。         | **配置说明：** 添加需要接入的MCP服务并完成安装。部分MCP服务需要配置鉴权信息，请在安装过程中按提示填写。添加完成后，建议在"提示词"中明确说明"什么场景下调用什么MCP工具解决哪些问题"，以提升调用准确率。详情请参考[MCP介绍](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0135.html)。 **示例：**加入"制度检索"MCP服务；当用户询问"差旅报销标准是什么？"时，智能体调用制度检索MCP服务检索权威条款，并引用要点回答。                                                                                                                                                                                                                                                                          | 在右侧"预览调试"窗口提问，观察模型思考过程中是否显示"已调用XX工具"； 或"预览调试"窗口右上角的![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687790088.png)图标，通过调用链路确认工具执行的具体参数和返回结果。 如果未显示调用且直接回答，则需检查模型是否支持工具调用标签，或在提示词中进一步加强指令引导。 |
     | 技能 | 插件    | 用于让智能体调用外部服务获取实时数据或执行操作。                     | **配置说明：** 添加需要接入的插件并完成添加。部分插件需要配置鉴权信息，请在安装过程中按提示填写。添加完成后，建议在"提示词"中明确说明"什么场景下调用什么插件解决哪些问题"，以提升调用准确率。详情请参考[插件介绍](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0123.html)。 **示例：**加入"工单查询"插件；当用户询问"我的工单处理到哪一步了？"时，智能体调用工单查询插件获取最新状态，并基于返回结果进行回复。                                                                                                                                                                                                                                                                                 | 在右侧"预览调试"窗口提问，观察模型思考过程中是否显示"已调用XX工具"； 或"预览调试"窗口右上角的![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687790088.png)图标，通过调用链路确认工具执行的具体参数和返回结果。 如果未显示调用且直接回答，则需检查模型是否支持工具调用标签，或在提示词中进一步加强指令引导。 |
     | 技能 | 工作流   | 用于将固定处理逻辑编排成可复用流程，适合"问答 + 处理"的场景。            | **配置说明：** 添加前须确保该[工作流已完成编排与发布](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0047.html)，未发布的工作流无法被智能体引用。添加完成后，建议在"提示词"中说明触发该工作流的条件与预期行为。详情请参考[为应用添加工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0023.html)。 **示例：**加入"故障排查并建单"工作流；当用户反馈"设备无法启动"时，智能体触发工作流：收集型号/错误码 → 输出排查步骤 → 未解决则自动创建工单并返回工单号。                                                                                                                                                                                                           | 在右侧"预览调试"窗口提问，观察模型思考过程中是否显示"已调用XX工具"； 或"预览调试"窗口右上角的![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687790088.png)图标，通过调用链路确认工具执行的具体参数和返回结果。 如果未显示调用且直接回答，则需检查模型是否支持工具调用标签，或在提示词中进一步加强指令引导。 |
     | 知识库       || 为智能体提供可检索的知识，用于提高回答准确性与一致性。                  | **配置说明：** 添加前须确保知识库[已完成创建并导入数据](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0148.html)，空知识库或未完成配置的知识库将无法提供有效检索结果。添加完成后，建议在"提示词"中明确引导智能体"优先检索知识库回答，未命中则如实告知"，避免模型编造内容。详情请参考[为应用添加知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0025.html)。 **示例：**加入"产品FAQ与手册"知识库；当用户询问"某功能怎么配置/支持哪些限制？"时，智能体优先检索知识库并基于命中内容回答；未命中则说明未查到依据并提示补充信息。                                                                                                                                                                       | 在右侧"预览调试"窗口提问，观察模型思考过程中是否显示"已调用XX工具"； 或"预览调试"窗口右上角的![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687790088.png)图标，通过调用链路确认工具执行的具体参数和返回结果。 如果未显示调用且直接回答，则需检查模型是否支持工具调用标签，或在提示词中进一步加强指令引导。 |
     | 记忆 | 入参变量  | 用于从外部调用时注入确定性上下文，或为组件参数提供固定值，从而提升回答的确定性与可控性。 | 配置说明：添加入参变量并填写入参变量信息。添加后可在以下位置引用： - 提示词：以*{{input.入参变量名}}*格式引用，为智能体注入固定的背景信息或约束条件。  - 组件入参：在插件、MCP服务、工作流的参数配置中引用，为组件绑定固定参数值。   需固定参数值时请关闭"可见性"开关，避免参数值在与智能体对话过程中被修改。详情请参考[为应用添加记忆](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0026.html)章节。 **示例：**加入"工单查询"插件并新增入参变量固定工单单号值并在插件参数中引用，无论用户如何提问，服务始终查询该工单的信息。 | 在右侧"预览调试"窗口提问，单击右上角的![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549629.png)记忆图标，进入"入参变量"页签，即可查看入参变量的取值。                                                                                                                                                       |
        
     
    
   对话体验、安全
   - AgentArts提供"对话体验"和"安全"两类配置，帮助您优化问答助手的交互表现并保障内容安全。
     参考[表7]提升智能体的对话体验，详情请参考[提升对话体验](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0027.html)。
      表7提升对话体验 
     | 配置项          || 说明                                                                                                                                             |
     |:---|---|:---|
     | 对话体验 | 开场白    | 开场白将在对话界面作为开场展示，降低首次使用门槛，可单击"![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549623.png)"图标AI生成开场白。           |
     | 对话体验 | 推荐问题   | 推荐问题显示为对话框上方的快捷气泡，用户无需打字，用于引导用户提问，可单击"![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549581.png)"图标AI生成推荐问题。 |
     | 对话体验 | 追问     | 智能体回答完用户问题后，将根据配置的追问规则和上下文自动生成的3个追问问题，能有效引导用户进行多轮对话。                                                                                           |
     | 对话体验 | 引用和归属  | 在单智能体配置并使用了联网搜索或知识库等工具时，开启"引用和归属"功能，模型生成的回答将包含引用来源，帮助核实信息的准确性与时效性。                                                                             |
     | 安全   | 内容审核配置 | 通过配置敏感词的过滤、替换和兜底回复匹配处理输入输出内容，保护用户免受不良信息的影响。                                                                                                    |
        
     
    
   
   
 
 #### 步骤四：调试并发布单智能体
1. 配置完成后，可在右侧"预览调试"模块随时输入问题进行问答调试，支持上传文件和使用语音进行提问。 
   图10预览调试   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949994.png "点击放大")
   表8预览调试功能 
   | 预览调试功能                                                                                                | 说明                                 |
   |:---|:---|
   | ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687790140.png)删除        | 删除当前界面上的所有对话内容，回归至开场白界面，不会清除上下文记忆。 |
   | ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687790114.png "点击放大")调试 | 选择对话，查看其运行结果和调用详情，用于定位和排查问题。       |
   | ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549597.png "点击放大")展开 | 展开预览调试板块，专注智能体调试对话过程。              |
      
   
   
2. 完成智能体调试后，单击"单智能体配置"界面右上角的"提交版本"。
3. 系统将默认以单击提交版本的时间填写版本名称，按需修改版本名称和版本描述后，单击"确定"。
4. 进入"部署智能体"页面，配置部署信息如[图11]所示，参数配置请参考[表9]。
   
   图11部署智能体   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687790100.png "点击放大")
    表9部署智能体 
   | 参数     | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   |:---|:---|
   | 智能体名称  | 为[步骤三：创建问答助手单智能体]自定义的智能体名称，不可修改。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   | 智能体版本  | 为[3]的版本名称。默认为最新版本名称，可以在下拉框中切换。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   | 运行时名称  | 运行时的名称，系统默认，**仅第一次部署时支持自定义修改。**由2\~48个字符组成，包含小写字母、数字、中划线，以小写字母开头，以小写字母或数字结尾。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   | 入站身份认证 | 选择调用此API接口时，使用的认证鉴权方式，如何进行认证鉴权请参考[认证鉴权](https://support.huaweicloud.com/api-agentarts/agentarts_07_0005.html)。默认IAM认证，**仅第一次部署时支持选择。** - IAM认证：将华为云IAM身份配置为入站身份认证，以验证调用者的身份。适用于华为云内部系统或已接入华为云IAM的系统，集成复杂度低，安全等级高。  - OAuth 2.0认证：将JWT（如OAuth令牌）配置为入站身份认证，以验证传入的令牌签名和范围。适用于已有身份提供商（如Okta、Cognito等）的企业系统，集成复杂度高，安全等级高。 - Discovery URL：身份提供商（例如Okta、Cognito等）提供的Discovery URL，该URL通常可在该提供商的文档中找到。  - JWT授权配置：配置JWT令牌的访问控制规则。 - 允许的受众：指定的受众是否在Agent Identity运行中指定的受众匹配或为其子集。  - 允许的客户端：指定的客户端标识符是否被允许访问Agent Identity。  - 允许的范围：仅当令牌包含此处配置的至少一个必须范围时，才允许访问自定义声明。  - 自定义声明：仅当令牌中的特定声明与预定义字符串值相匹配时，才允许访问。      - API Key认证：将预设的密钥对（键和值）配置为入站身份认证，以验证请求中携带的密钥合法性。适用于内部测试或轻量级集成，集成复杂度低，安全等级中。 注意： 身份认证凭证在凭据管理服务（DEW）托管，托管按需计费，使用DEW产生的费用请参考[DEW计费说明](https://support.huaweicloud.com/price-dew/dew_03_0001.html)。    |
   | 日志记录   | 默认开启。 开启日志记录功能后，智能体产生的日志会上报到云日志服务 LTS，便于日志的集中管理和分析。日志管理费用按需收取，具体计费详情请参考[LTS计费说明](https://support.huaweicloud.com/price-lts/lts_001_04.html)。 日志信息展示在"运营运维 \> 观测 \> 调用链分析"的详情页的"日志"页签中。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   | 指标     | 默认开启。 开启指标功能后，智能体产生的指标数据会上报到应用运维管理 AOM，便于实时监控和分析应用的运行状态。指标管理费用按需收取，具体计费详情请参考[AOM计费说明](https://support.huaweicloud.com/price-aom2/aom_07_0004.html)。 指标信息展示在"运营运维 \> 观测 \> 调用链分析"的详情页的"指标"页签中。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   | 调用链    | 默认开启。 开启调用链功能后，智能体产生的调用链数据会上报到应用性能管理 APM，帮助开发者追踪和分析应用的性能问题。调用链管理费用按需收取，具体计费详情请参考[APM计费说明](https://support.huaweicloud.com/price-apm2/apm_07_0019.html)。 调用链信息展示在"运营运维 \> 观测 \> 调用链分析"的详情页的"链路信息"页签中。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | 智能体卫士  | 默认关闭。 开启后，实时检测智能体执行链路与操作轨迹，监控全量行为并识别安全异常。不同安全风险处理规则和检测记录可参考[企业主机安全 HSS](https://support.huaweicloud.com/usermanual-hss2.0/hss_01_0048.html)管理及查看。HSS的智能体卫士当前为公测阶段，暂不收费。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
      
   
   
5. 单击"确定"，单击"分享"进入"渠道管理"界面。 
   - 调用方式 已提交版本的智能体应用支持以API的形式分享调用，单击"查看API"弹出API详情页，提供详细的API描述文档与示例代码供您参考。更多操作请参考[通过API调用单智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0038.html)。
     图12API调用   
     ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949954.png "点击放大") 
   
   - 分享渠道 支持将应用分享至多个渠道，分享范围仅限"当前租户可用"，非同一账户下的用户无法打开该链接。详情请参考[发布应用至云商店](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0034.html)。
     
   
   
   
   
**更多操作：**
单击"渠道管理"界面右上角的版本历史图标![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687790120.png)，可查看当前单智能体发布历史记录。
#### 更多进阶场景
本实践以DeepSeek模型+问答助手场景为例，完成了从模型接入到智能体创建的完整流程。您可以基于相同的思路，进一步探索以下进阶场景：
表10更多进阶场景 
| 场景        | 说明                                                                       | 参考文档                                                                                   |
|:---|:---|:---|
| 接入更多第三方模型 | 将Moonshot（Kimi）、GLM（智谱）、Qwen（通义千问）等兼容OpenAI协议的模型接入AgentArts，在不同智能体中按需选用。 | [接入自定义的模型服务](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0189.html) |
| 配置模型路由策略  | 当接入多个同类型模型时，配置主备切换策略提升服务稳定性。                                             | [配置模型服务路由策略](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0194.html) |
| 开发工作流应用   | 将问答与固定业务流程结合，实现"问答+自动处理"的复合场景。                                           | [开发工作流应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0040.html)    |
| 开发多智能体应用  | 将多个专业智能体编排协作，实现更复杂的业务场景。                                                 | [开发多智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0102.html)   |
   
#### 常见问题
表11常见问题 
| 问题                   | 解决思路                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|
| 接入的外部模型无法使用？         | 请依次检查以下事项： - API Key是否正确粘贴，无多余空格或换行符。  - DeepSeek账户是否有可用余额。  - 模型服务API地址是否填写正确（https://api.deepseek.com/chat/completions）。  - "模型名称"参数是否填写了正确的模型编码（如deepseek-chat），而非自定义名称。   |
| 如何切换为DeepSeek深度思考模型？ | 参照[步骤二]重新接入一个自定义模型，将"模型名称"填写为"deepseek-reasoner"，"选择标签"设置为"思考"，并根据需要配置"是否支持关闭思维链输出"。接入完成后，在智能体编排页面切换至该模型即可。                                                                                                                                                                                                                                                                                                                                                                   |
| 配置了插件/MCP服务但调试时未被调用？ | 请依次排查： - 所选模型是否支持工具调用能力（模型服务是否配置了"工具"标签）。  - 提示词中是否明确说明了"在什么场景下调用什么工具"。  - 插件/MCP服务的鉴权是否配置正确、服务是否正常可用。                                                                                                                                                   |
   
