接入和使用DeepSeek模型

案例概述

AgentArts支持接入兼容OpenAI接口规范的第三方大语言模型。本实践以自定义接入和使用DeepSeek模型为例，指导您完成从获取API密钥、接入自定义模型到创建问答助手智能体的完整流程。

完成本实践后，您将获得一个基于DeepSeek大模型的问答助手智能体，并可参考相同流程接入其他兼容OpenAI接口的第三方模型（如Moonshot、GLM等）。

前提条件

• 已开通AgentArts服务。
• 已注册DeepSeek开放平台账号，并确保账户有可用余额。

操作流程

接入DeepSeek模型并搭建问答助手智能体，仅需以下四步即可完成从模型接入到智能体上线的完整流程。

图1 接入DeepSeek模型并搭建问答助手智能体

步骤一：获取DeepSeek API Key

本步骤指导您在DeepSeek开放平台创建API Key，用于后续在AgentArts中接入模型时的身份鉴权。

1. 访问DeepSeek开放平台，登录您的账号。
2. 在左侧导航栏选择“API Keys”，单击“创建API Key”。
   图2 创建API Key
   

3. 在弹出的对话框中输入API Key名称，例如“chat”，单击“创建”。
4. 在创建成功的对话框中，单击“复制”，将API Key复制并保存到本地安全位置。
   

   API Key仅在创建时展示一次，关闭对话框后将无法再次查看。如果遗失，需要重新创建。请妥善保管，避免泄露。

5. 记录表2信息，后续步骤中将使用。更多内容可参考DeepSeek官方文档。
   图3 DeepSeek官网API调用示例
   

   表2 DeepSeek 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智能体平台。
2. 在左侧导航栏，选择“开发中心 > 开发配置”，选择“自定义模型”页签，单击“新建模型供应商”。
3. 在“新建模型供应商”页面，如图4所示配置参数信息，具体参数说明请参考表3。
   图4 新建模型供应商
   

   表3 新建模型供应商参数说明

   参数	示例	说明
   供应商图标	系统默认图标	系统默认供应商图标，也可自定义图标。
   供应商名称	深度求索	供应商的名称。由2~64个字符组成，包含中英文、数字、下划线、中划线、空格、竖线。
   供应商英文名称	DeepSeek	供应商的英文名称。由2~64个字符组成，包含英文、数字、下划线、中划线、空格、竖线。
   描述	深度求索（DeepSeek），是量化巨头幻方探索AGI（通用人工智能）的新组织，成立于2023年，专注于研究世界领先的通用人工智能底层模型与技术，挑战人工智能前沿性难题。	非必填。供应商的描述信息。由0~1000个字符组成。
   选择认证方式	Api-key	本示例选用Api-key方式进行认证。 关于密钥加密：鼠标移动至“选择认证方式”右侧的上，可查看密钥的加密方式。平台默认使用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接口规范。
   流控配置	无限制	超出流控值将触发限流，用户的请求会因为流控而失败。
   选择标签		可选项。当“类型”为“文本对话”或“图像理解”时可配置。选择标签后，在应用中选择大模型时显示在大模型右侧。 工具：当该大模型支持应用调用外部工具时，例如，MCP服务、插件、知识库，可以选择该标签。 思考：该大模型具备思维推理时，可以选择该标签。 联网：该大模型具备联网搜索能力时，可以选择该标签。
   是否支持关闭思维链输出	关闭	当“选择标签”选择了思考时显示此参数。 开启：模型在调测、使用时，显示“深度思考”参数。 关闭（默认）：模型在调测、使用时，不显示“深度思考”参数。
   自定义标签	-	可选项。最多支持添加5个标签。单击输入标签内容后按Enter键确认。添加后在应用中选择大模型时显示在大模型右侧。
   模型服务描述	deepseek-chat对应DeepSeek-V3的非思考模式	可选项。模型服务的描述信息，展示在模型服务卡片中。由0~1000个字符组成。

6. 在创建好的“文本对话模型”卡片上，单击“ > 调测”，进入“模型调测”界面。
7. 在“效果预览”窗口输入测试问题，验证模型是否可正常响应。如果模型返回了合理的回答内容，说明模型配置正确。关于模型调测的更多操作可参考调测模型。
   图5 模型调测效果预览
   

8. 确认模型可用后，返回“自定义模型”页签，在已创建的模型服务卡片，单击“ > 发布”，当模型服务卡片状态显示为“已发布”，表示该模型已可在智能体中使用。
   “已发布”的模型不支持“编辑”或者“删除”操作，如需编辑或删除请先单击“取消发布”。

   图6 已发布模型
   

步骤三：创建问答助手单智能体

本步骤指导您基于已接入的DeepSeek模型创建一个问答助手单智能体。通过配置模型、提示词及可选能力组件，可以快速搭建一个面向实际业务场景的智能问答助手。

1. 返回AgentArts智能体平台“总览”页，单击“快速创建智能体”卡片上的“手动创建”链接。
   图7 手动快速创建智能体
   

2. 填写智能体的“名称”与“描述”，赋予智能体基本的身份标识，填写完成后单击“确定”跳转至“单智能体配置”界面。
   图8 快速创建智能体
   

   表5 快速创建智能体

   参数	配置示例	说明
   名称	问答助手	智能体的显示名称，便于在列表中识别与管理。
   描述	通用问答助手。	对智能体用途的简要说明。系统将基于名称和描述自动生成头像与初始提示词，因此建议填写清晰、准确的描述，以获得更贴合业务场景的初始配置。

3. 进入“单智能体配置”界面后，系统会根据已填写的“名称”和“描述”自动生成头像和提示词。您可以直接使用，也可以根据实际需求手动调整。

   提示词是智能体的“行为准则”，决定了智能体的角色定位、回答风格、能力边界与约束规则。一份好的提示词能够显著提升回答质量与一致性。

   例如：明确“不确定时如实告知”可以降低模型编造信息的概率；明确“分步骤解答复杂问题”可以提升回答的条理性。建议根据业务场景持续优化提示词。

4. 在“模型配置”模块，单击“模型”参数下拉框，选择步骤二：在AgentArts接入自定义模型中已接入的“deepseek-chat”模型。
   模型的选择直接决定了智能体的基础能力上限。不同模型在通用对话、推理、代码生成等方面各有侧重。

   图9 选择模型
   

5. （可选）完成基础的模型与提示词配置后，智能体已具备通用问答能力。但在实际业务场景中，一个优秀的问答助手往往还需要：
   • 查得到：能够检索内部知识或调用外部数据源，而非仅依赖模型自身的训练知识。
   • 做得了：能够执行查询、提交、创建等实际操作，而非只能说不能做。
   • 记得住：能够记住用户偏好或接收外部传入的上下文，实现个性化、确定性的回答。

   AgentArts通过技能、知识库、记忆三类能力组件来满足上述需求。

   技能、知识库、记忆

   • 参考表6为智能体配置更多能力组件。

     表6 智能体能力配置

     配置项		说明	配置说明与示例	验证是否生效
     技能	MCP服务	基于MCP协议的连接器，用于对接外部数据源或本地工具集，扩展智能体能力。	配置说明：添加需要接入的MCP服务并完成安装。部分MCP服务需要配置鉴权信息，请在安装过程中按提示填写。添加完成后，建议在“提示词”中明确说明“什么场景下调用什么MCP工具解决哪些问题”，以提升调用准确率。详情请参考MCP介绍。 示例：加入“制度检索”MCP服务；当用户询问“差旅报销标准是什么？”时，智能体调用制度检索MCP服务检索权威条款，并引用要点回答。	在右侧“预览调试”窗口提问，观察模型思考过程中是否显示“已调用XX工具”； 或“预览调试”窗口右上角的图标，通过调用链路确认工具执行的具体参数和返回结果。 如果未显示调用且直接回答，则需检查模型是否支持工具调用标签，或在提示词中进一步加强指令引导。
     	插件	用于让智能体调用外部服务获取实时数据或执行操作。	配置说明：添加需要接入的插件并完成添加。部分插件需要配置鉴权信息，请在安装过程中按提示填写。添加完成后，建议在“提示词”中明确说明“什么场景下调用什么插件解决哪些问题”，以提升调用准确率。详情请参考插件介绍。 示例：加入“工单查询”插件；当用户询问“我的工单处理到哪一步了？”时，智能体调用工单查询插件获取最新状态，并基于返回结果进行回复。
     	工作流	用于将固定处理逻辑编排成可复用流程，适合“问答 + 处理”的场景。	配置说明：添加前须确保该工作流已完成编排与发布，未发布的工作流无法被智能体引用。添加完成后，建议在"提示词"中说明触发该工作流的条件与预期行为。详情请参考为应用添加工作流。 示例：加入“故障排查并建单”工作流；当用户反馈“设备无法启动”时，智能体触发工作流：收集型号/错误码 → 输出排查步骤 → 未解决则自动创建工单并返回工单号。
     知识库		为智能体提供可检索的知识，用于提高回答准确性与一致性。	配置说明：添加前须确保知识库已完成创建并导入数据，空知识库或未完成配置的知识库将无法提供有效检索结果。添加完成后，建议在"提示词"中明确引导智能体"优先检索知识库回答，未命中则如实告知"，避免模型编造内容。详情请参考为应用添加知识库。 示例：加入“产品FAQ与手册”知识库；当用户询问“某功能怎么配置/支持哪些限制？”时，智能体优先检索知识库并基于命中内容回答；未命中则说明未查到依据并提示补充信息。
     记忆	入参变量	用于从外部调用时注入确定性上下文，或为组件参数提供固定值，从而提升回答的确定性与可控性。	配置说明：添加入参变量并填写入参变量信息。添加后可在以下位置引用： 提示词：以{{input.入参变量名}}格式引用，为智能体注入固定的背景信息或约束条件。 组件入参：在插件、MCP服务、工作流的参数配置中引用，为组件绑定固定参数值。 需固定参数值时请关闭“可见性”开关，避免参数值在与智能体对话过程中被修改。详情请参考为应用添加记忆章节。 示例：加入“工单查询”插件并新增入参变量固定工单单号值并在插件参数中引用，无论用户如何提问，服务始终查询该工单的信息。	在右侧“预览调试”窗口提问，单击右上角的记忆图标，进入“入参变量”页签，即可查看入参变量的取值。

   对话体验、安全

   • AgentArts提供“对话体验”和“安全”两类配置，帮助您优化问答助手的交互表现并保障内容安全。
     参考表7提升智能体的对话体验，详情请参考提升对话体验。

     表7 提升对话体验

     配置项		说明
     对话体验	开场白	开场白将在对话界面作为开场展示，降低首次使用门槛，可单击“”图标AI生成开场白。
     	推荐问题	推荐问题显示为对话框上方的快捷气泡，用户无需打字，用于引导用户提问，可单击“”图标AI生成推荐问题。
     	追问	智能体回答完用户问题后，将根据配置的追问规则和上下文自动生成的3个追问问题，能有效引导用户进行多轮对话。
     	引用和归属	在单智能体配置并使用了联网搜索或知识库等工具时，开启“引用和归属”功能，模型生成的回答将包含引用来源，帮助核实信息的准确性与时效性。
     安全	内容审核配置	通过配置敏感词的过滤、替换和兜底回复匹配处理输入输出内容，保护用户免受不良信息的影响。

步骤四：调试并发布单智能体

1. 配置完成后，可在右侧“预览调试”模块随时输入问题进行问答调试，支持上传文件和使用语音进行提问。
   图10 预览调试
   

   表8 预览调试功能

   预览调试功能	说明
   删除	删除当前界面上的所有对话内容，回归至开场白界面，不会清除上下文记忆。
   调试	选择对话，查看其运行结果和调用详情，用于定位和排查问题。
   展开	展开预览调试板块，专注智能体调试对话过程。

2. 完成智能体调试后，单击“单智能体配置”界面右上角的“提交版本”。
3. 系统将默认以单击提交版本的时间填写版本名称，按需修改版本名称和版本描述后，单击“确定”。
4. 进入“部署智能体”页面，配置部署信息如图11所示，参数配置请参考表9。
   图11 部署智能体
   

   表9 部署智能体

   参数	说明
   智能体名称	为步骤三：创建问答助手单智能体自定义的智能体名称，不可修改。
   智能体版本	为3的版本名称。默认为最新版本名称，可以在下拉框中切换。
   运行时名称	运行时的名称，系统默认，仅第一次部署时支持自定义修改。由2~48个字符组成，包含小写字母、数字、中划线，以小写字母开头，以小写字母或数字结尾。
   入站身份认证	选择调用此API接口时，使用的认证鉴权方式，如何进行认证鉴权请参考认证鉴权。默认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计费说明。
   日志记录	默认开启。 开启日志记录功能后，智能体产生的日志会上报到云日志服务 LTS，便于日志的集中管理和分析。日志管理费用按需收取，具体计费详情请参考LTS计费说明。 日志信息展示在“观测与优化 > 观测 > 调用链分析”的详情页的“日志”页签中。
   指标	默认开启。 开启指标功能后，智能体产生的指标数据会上报到应用运维管理 AOM，便于实时监控和分析应用的运行状态。指标管理费用按需收取，具体计费详情请参考AOM计费说明。 指标信息展示在“观测与优化 > 观测 > 调用链分析”的详情页的“指标”页签中。
   调用链	默认开启。 开启调用链功能后，智能体产生的调用链数据会上报到应用性能管理 APM，帮助开发者追踪和分析应用的性能问题。调用链管理费用按需收取，具体计费详情请参考APM计费说明。 调用链信息展示在“观测与优化 > 观测 > 调用链分析”的详情页的“链路信息”页签中。
   智能体卫士	默认关闭。 开启后，实时检测智能体执行链路与操作轨迹，监控全量行为并识别安全异常。不同安全风险处理规则和检测记录可参考企业主机安全 HSS管理及查看。HSS的智能体卫士当前为公测阶段，暂不收费。

5. 单击“确定”，单击“分享”进入“渠道管理”界面。
   • 调用方式

     已提交版本的智能体应用支持以API的形式分享调用，单击“查看API”弹出API详情页，提供详细的API描述文档与示例代码供您参考。更多操作请参考通过API调用单智能体应用。

     图12 API调用
     
   • 分享渠道

     支持将应用分享至多个渠道，分享范围仅限“当前租户可用”，非同一账户下的用户无法打开该链接。详情请参考发布应用至云商店。

更多操作：

单击“渠道管理”界面右上角的版本历史图标，可查看当前单智能体发布历史记录。

更多进阶场景

本实践以DeepSeek模型+问答助手场景为例，完成了从模型接入到智能体创建的完整流程。您可以基于相同的思路，进一步探索以下进阶场景：

常见问题