模型配置

接入华为云MaaS Token Plan套餐

前提条件：

接入前请确保已购买Token Plan套餐，具体请参见Token Plan个人版套餐概览。

操作步骤：

1. 在左侧导航栏，选择“模型”，单击右上角的“接入模型”，选择“接入华为云MaaS模型”，弹出如图1所示界面。
   图1 接入MaaS模型
   

2. 选择“接入类型”为“华为云MaaS Token Plan”，输入API Key。

   API Key是华为云MaaS的接口访问凭证，用于接口调用的身份鉴权。获取方式请参见获取API Key。

   图2 输入API Key
   

3. 输入完成后，单击“下一步 连通性测试”，查看模型连通性测试情况。
   

   连通性测试的状态说明：

   • ：连通性测试通过，表示该模型已开通，且能正常调用。
   • ：连通性测试不通过，可能原因包括：Token Plan个人版套餐未开通或API Key配置有误。请检查API Key是否正确，或在MaaS模型即服务开通该套餐，详细操作请参见Token Plan个人版套餐概览。
   • ：不支持连通性测试，表示该模型暂不具备在线检测能力，请通过实际调用确认其可用性。
   图3 连通性测试
   

4. 连通性测试通过后，单击“确认接入”。
   在模型界面可查看已接入的华为云MaaS Token Plan套餐内模型，如图4所示。

   图4 查看已接入的华为云MaaS Token Plan模型
   

接入华为云MaaS按需计费模型

前提条件：

接入前请确保已开通预置模型服务，具体请参见开通预置模型服务。

操作步骤：

1. 在左侧导航栏，选择“模型”，单击右上角的“接入模型”，选择“接入华为云MaaS模型”。
2. 选择“接入类型”为“华为云MaaS 按需计费”，输入API Key。
   API Key是华为云MaaS的接口访问凭证，用于接口调用的身份鉴权。获取方式请参见获取API Key。

   图5 接入华为云MaaS按需计费模型
   

3. 在选择模型区域，选择需要接入的模型（支持多选），不同模型的说明请参见模型说明。
4. 选择模型后，单击“连通性测试”，测试通过表示接入成功。
   以接入多模态理解模型“qwen2.5-vl-72b”为例，勾选qwen2.5-vl-72b模型，单击“连通性测试”，显示连通性测试通过，如图6所示。

   图6 接入模型示例
   

   

   连通性测试的状态说明：

   • ：连通性测试通过，表示该模型已开通，且能正常调用。
   • ：连通性测试不通过，可能原因包括：该模型未开通或API Key配置有误。请检查API Key是否正确，或在MaaS模型即服务开通该模型，详细操作请参见开通预置模型服务。
   • ：不支持连通性测试，表示该模型暂不具备在线检测能力，请通过实际调用确认其可用性。

5. 配置完成后，单击“确认”。
   在模型界面可查看已接入的华为云MaaS按需计费模型，如图7所示。

   图7 查看已接入的华为云MaaS按需计费模型
   

前提条件

• 已获取第三方模型服务的访问URL和API Key。
• 如需使用工具调用、图片输入等高级能力，请确认目标模型已支持对应功能。

接入第三方模型操作步骤

1. 在左侧导航栏，选择“模型”，单击右上角的“接入模型”，选择“接入第三方模型”。
2. 在弹出的对话框中，可通过选择模型供应商进行配置添加，也可以通过自定义访问URL等信息配置添加，参数说明如表4所示。
   图8 接入第三方模型-模型供应商
   
   图9 接入第三方模型-自定义配置
   

   表4 参数说明

   参数	说明	示例
   模型供应商	选择模型服务的供应商名称。	深度求索
   模型名称	用于接口调用请求体model字段的模型标识符。 接入第三方服务商模型时，填写的模型名称必须与该模型的模型 ID/模型编码完全一致，否则会导致模型不可用；请登录第三方模型厂商官网查看对应模型 ID，例如 Baichuan4、deepseek-chat、glm-4-air。 接入自建模型服务时，该名称将作为接口调用请求体model字段的值。 填写要求：由 2~64 个字符组成，可包含中英文、数字及 :._/|\-，须以中英文或数字开头和结尾。 说明： 如果需设置用户可见的友好名称，请在创建完成后通过编辑模型设置展示名称。	deepseek-v4-flash
   模型描述	模型的功能说明或适用场景描述，最大支持500字符。	DeepSeek-V4-Flash是DeepSeek-V4系列的轻量高效版本，在保持1M超长上下文能力的同时，通过更小的模型参数与激活规模，提供更为快捷、经济的API服务。
   图标	系统默认模型服务图标，单击可以智能生成图标。用户也可以自定义图标： 鼠标移动至系统默认图标上，单击鼠标左键。 在虚线框中，单击鼠标左键，上传已准备好的模型服务图标。 支持png、jpeg、jpg格式图片，且不大于200KB。	系统默认图标
   访问URL	模型服务提供API调用的完整接口地址，当前仅支持OpenAI协议。请填写以https://开头的地址。	https://api.deepseek.com
   API Key	访问模型服务的认证密钥，从第三方模型服务商处获取。 例如，如果接入深度求索的模型，则API Key请从deepseek开放平台获取。	sk-****abcd
   请求头	单击“添加”，以键值对形式添加自定义HTTP请求头，用于满足特定供应商的鉴权或路由需求。	/
   模型能力	模型能力允许用户声明模型支持的扩展能力，果办OfficeAce会根据勾选状态调整请求格式。高级配置参数说明如表5所示。	工具调用

   表5 高级配置参数说明

   选项	说明	勾选场景	果办OfficeAce调用机制
   工具调用	允许模型调用果办OfficeAce提供的工具（如文件读取、命令执行等）。	模型支持function calling，且需要模型调用外部工具完成任务时勾选。	果办OfficeAce在请求中携带可用工具列表，模型返回工具调用指令后，果办OfficeAce执行工具并将结果回传模型。
   图片输入	允许模型接收并处理图片。	模型支持视觉理解，且需要在对话中发送图片时勾选。	果办OfficeAce将图片编码后随文本一起发送给模型，模型返回图片分析结果。
   思考模式	输出模型的推理思考过程。	模型支持思维链输出，希望查看模型推理过程时勾选。	果办OfficeAce在请求中启用思维链参数，模型返回的推理过程会展示在对话界面。

3. 配置完成后，单击“测试连接”。
4. 显示“连接测试成功”后，单击“保存”。
5. 验证模型效果。

   参考新建专家，将专家智能体的模型设置为该模型。设置并保存后，在果办OfficeAce对话界面，发送对话任务，查看果办OfficeAce的响应效果。