# 模型配置 模型服务为专家智能体提供核心推理能力，是专家智能体实现自主决策和任务执行的基础。通过为专家智能体接入大语言模型，使其具备文本对话、图像理解、文本向量化检索等能力。 在果办OfficeAce中，您可以免费使用平台预置的模型，也可以自行接入华为云[MaaS模型即服务](https://www.huaweicloud.com/product/modelarts/studio.html)中的模型或第三方模型。配置模型后，您可以在创建或编辑专家智能体时，为专家智能体指定所使用的模型。 ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/note_3.0-zh-cn.png) 如果选用PPT Skill，为达到最佳效果，建议使用GLM-5系列模型（GLM-5系列在汇报材料内容理解和结构生成方面表现更优）。 #### 模型选择建议 针对不同使用场景，建议配置不同的模型。 表1模型选择建议 | 使用场景 | 推荐模型特性 | |:---|:---| | 文案创作、内容生成 | 创意表达能力强的模型 | | 数据分析、逻辑推理 | 推理能力强的模型 | | 快速问答、日常助理 | 响应速度快的轻量模型 | | 代码编写、技术文档 | 代码理解能力强的模型 | #### 查看平台预置模型 在左侧导航栏，选择"模型"，在"华为云MaaS"区域可查看平台预置的模型，如[图1]所示。 图1查看平台预置模型 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724296360.png "点击放大") #### 接入华为云MaaS模型 如果平台预置的模型不能满足您的需求，您可以接入[MaaS模型即服务](https://www.huaweicloud.com/product/modelarts/studio.html)的其他模型。支持接入**华为云MaaS Token Plan** 和**按需计费模型**两种类型。 表2MaaS Token Plan套餐与按需计费模型对比 | 对比维度 | MaaS Token Plan套餐 | MaaS按需计费模型 | |:---|:---|:---| | 付费方式 | 预付费。 按照订单的购买周期结算。 | 后付费。 实际使用的Tokens数量、图片生成数量或视频时长计费。 | | 计费周期 | 按订单的购买周期计费。 | 资源用量按小时计费或按5分钟计费。 | | 模型范围 | 特定热门模型。 目前支持的模型系列包括：GLM-5.1、Kimi-K2.6、DeepSeek-V4-Flash等，您可以在这些模型间自由切换。 | 全类型预置模型，详情请参考[预置服务模型](https://support.huaweicloud.com/model-list-maas/model_list_0001.html)。 覆盖面更广，支持文本生成、视频生成、图片生成、图像理解、文本向量化、重排序等多种类型。 | | 适用场景 | **仅支持个人用户购买。** 适用于可预估资源使用周期的场景，价格比按需计费模式更优惠。对于长期使用者，推荐该方式。 - 模型选型对比：您需要在GLM-5.1、Kimi-K2.6、DeepSeek-V4-Flash等主流模型间频繁切换，以测试不同模型在您业务中的表现。 - 特定模型深度用户：您的应用主要依赖上述列表中的特定文本对话模型，且调用量较大，希望通过套餐模型降低单位调用成本。 - 开发者个人学习：希望以较低的固定成本持续体验最新版本的大模型。 | 支持在线体验和模型调用。 适用于tokens用量有波动的场景，按照实际使用量收费。 - 用量波动较大或测试验证：您处于项目初期验证阶段，调用链不确定，希望按照实际用量付费，避免资源闲置浪费。 - 企业级复杂业务流：需要组合使用多种模型能力，需要调用预置服务中的全量API类型。 - 多模态或RAG应用开发：您的业务不仅包括文本生成，还需要视频生成、图片生成、图像理解、文本向量化、重排序等功能。 | | 详细计费说明 | 参见[MaaS Token Plan计费项](https://support.huaweicloud.com/price-maas/price-maas-0035.html) | 参见[MaaS模型服务计费项](https://support.huaweicloud.com/price-maas/price-maas-0001.html) | #### 接入华为云MaaS Token Plan套餐 **前提条件：** 接入前请确保已购买Token Plan套餐，具体请参见[Token Plan个人版套餐概览](https://support.huaweicloud.com/Token-plan-maas/tokenplan-maas-0001.html)。 **操作步骤：** 1. 在左侧导航栏，选择"模型"，单击右上角的"接入模型"，选择"接入华为云MaaS模型"，弹出如[图2]所示界面。 图2接入MaaS模型 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002753896057.png "点击放大") 2. 选择"接入类型"为"华为云MaaS Token Plan"，输入API Key。 API Key是华为云MaaS的接口访问凭证，用于接口调用的身份鉴权。获取方式请参见[获取API Key](https://support.huaweicloud.com/model-call-maas/model-call-049.html)。 图3输入API Key ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724456330.png "点击放大") 3. 输入完成后，单击"下一步 连通性测试"，查看模型连通性测试情况。 ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/note_3.0-zh-cn.png) 连通性测试的状态说明： - ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724296362.png)：连通性测试通过，表示该模型已开通，且能正常调用。 - ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724296364.png)：连通性测试不通过，可能原因包括：Token Plan个人版套餐未开通或API Key配置有误。请检查API Key是否正确，或在[MaaS模型即服务](https://console.huaweicloud.com/modelarts/?#/model-studio/resourcePlanManagement)开通该套餐，详细操作请参见[Token Plan个人版套餐概览](https://support.huaweicloud.com/Token-plan-maas/tokenplan-maas-0001.html)。 - ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724456324.png)：不支持连通性测试，表示该模型暂不具备在线检测能力，请通过实际调用确认其可用性。 图4连通性测试 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724296358.png "点击放大") 4. 连通性测试通过后，单击"确认接入"。 在模型界面可查看已接入的华为云MaaS Token Plan套餐内模型，如[图5]所示。 图5查看已接入的华为云MaaS Token Plan模型 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002753896045.png "点击放大") #### 接入华为云MaaS按需计费模型 **前提条件**： 接入前请确保已开通预置模型服务，具体请参见[开通预置模型服务](https://support.huaweicloud.com/qs-maas/qs-maas-0001.html#section3)。 **操作步骤：** 1. 在左侧导航栏，选择"模型"，单击右上角的"接入模型"，选择"接入华为云MaaS模型"。 2. 选择"接入类型"为"华为云MaaS 按需计费"，输入API Key。 API Key是华为云MaaS的接口访问凭证，用于接口调用的身份鉴权。获取方式请参见[获取API Key](https://support.huaweicloud.com/model-call-maas/model-call-049.html)。 图6接入华为云MaaS按需计费模型 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724456320.png "点击放大") 3. 在选择模型区域，选择需要接入的模型（支持多选），不同模型的说明请参见[模型说明](https://support.huaweicloud.com/model-list-maas/model_list_0001.html)。 4. 选择模型后，单击"连通性测试"，测试通过表示接入成功。 以接入多模态理解模型"qwen2.5-vl-72b"为例，勾选qwen2.5-vl-72b模型，单击"连通性测试"，显示连通性测试通过，如[图7]所示。 图7接入模型示例 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724456316.png "点击放大") ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/note_3.0-zh-cn.png) 连通性测试的状态说明： - ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724296366.png)：连通性测试通过，表示该模型已开通，且能正常调用。 - ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724296368.png)：连通性测试不通过，可能原因包括：该模型未开通或API Key配置有误。请检查API Key是否正确，或在[MaaS模型即服务](https://console.huaweicloud.com/modelarts/?#/model-studio/deployment)开通该模型，详细操作请参见[开通预置模型服务](https://support.huaweicloud.com/qs-maas/qs-maas-0001.html#section2)。 - ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724456328.png)：不支持连通性测试，表示该模型暂不具备在线检测能力，请通过实际调用确认其可用性。 5. 配置完成后，单击"确认"。 在模型界面可查看已接入的华为云MaaS按需计费模型，如[图8]所示。 图8查看已接入的华为云MaaS按需计费模型 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724456326.png "点击放大") #### 接入第三方模型 果办OfficeAce默认提供预置模型，但在特定业务场景下，您可能需要使用自建的模型或第三方模型服务，常见的场景如[表3]所示。 表3常见场景 | 您的场景 | 您怎么做 | 果办OfficeAce做什么 | 您拿到什么 | |:---|:---|:---|:---| | 数据合规要求私有部署。 | 填入企业私有模型的访问URL和API Key。 | 将对话请求路由到私有模型服务。 | 符合合规要求的AI推理结果。 | | 需要更优的推理效果。 | 接入特定供应商模型。 | 调用该模型处理对话任务。 | 更高质量的回答内容。 | | 需要视觉理解能力。 | 接入支持图片输入的模型并勾选"图片输入"。 | 将图片发送给模型并返回分析结果。 | 图片内容识别与理解。 | 通过"接入第三方模型"功能，您可以将外部模型服务注册到果办OfficeAce，配置访问地址和认证密钥后，即可在对话中使用该模型处理任务。 #### 前提条件 - 已获取第三方模型服务的**访问URL** 和**API Key**。 - 如需使用工具调用、图片输入等高级能力，请确认目标模型已支持对应功能。 #### 接入第三方模型操作步骤 1. 在左侧导航栏，选择"模型"，单击右上角的"接入模型"，选择"接入第三方模型"。 2. 在弹出的对话框中，可通过选择模型供应商进行配置添加，也可以通过自定义访问URL等信息配置添加，参数说明如[表4]所示。 图9接入第三方模型-模型供应商 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724456322.png "点击放大") 图10接入第三方模型-自定义配置 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002754016141.png "点击放大") 表4参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 模型供应商 | 选择模型服务的供应商名称。 | 深度求索 | | 模型名称 | 用于接口调用请求体model字段的模型标识符。 - 接入第三方服务商模型时，填写的模型名称必须与该模型的模型 ID/模型编码完全一致，否则会导致模型不可用；请登录第三方模型厂商官网查看对应模型 ID，例如 Baichuan4、deepseek-chat、glm-4-air。 - 接入自建模型服务时，该名称将作为接口调用请求体model字段的值。 填写要求：由 2\~64 个字符组成，可包含中英文、数字及 :._/\|\\-，须以中英文或数字开头和结尾。 说明： 如果需设置用户可见的友好名称，请在创建完成后通过编辑模型设置展示名称。 | deepseek-v4-flash | | 模型描述 | 模型的功能说明或适用场景描述，最大支持500字符。 | DeepSeek-V4-Flash是DeepSeek-V4系列的轻量高效版本，在保持1M超长上下文能力的同时，通过更小的模型参数与激活规模，提供更为快捷、经济的API服务。 | | 图标 | 系统默认模型服务图标，单击![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724456318.png)可以智能生成图标。用户也可以自定义图标： 1. 鼠标移动至系统默认图标上，单击鼠标左键。 2. 在虚线框中，单击鼠标左键，上传已准备好的模型服务图标。 支持png、jpeg、jpg格式图片，且不大于200KB。 | 系统默认图标 | | 访问URL | 模型服务提供API调用的完整接口地址，当前仅支持OpenAI协议。请填写以https://开头的地址。 | https://api.deepseek.com | | API Key | 访问模型服务的认证密钥，从第三方模型服务商处获取。 例如，如果接入深度求索的模型，则API Key请从[deepseek开放平台](https://platform.deepseek.com/usage)获取。 | sk-\*\*\*\*abcd | | 请求头 | 单击"添加"，以键值对形式添加自定义HTTP请求头，用于满足特定供应商的鉴权或路由需求。 | / | | 模型能力 | 模型能力允许用户声明模型支持的扩展能力，果办OfficeAce会根据勾选状态调整请求格式。高级配置参数说明如[表5]所示。 | 工具调用 | 表5高级配置参数说明 | 选项 | 说明 | 勾选场景 | 果办OfficeAce调用机制 | |:---|:---|:---|:---| | 工具调用 | 允许模型调用果办OfficeAce提供的工具（如文件读取、命令执行等）。 | 模型支持function calling，且需要模型调用外部工具完成任务时勾选。 | 果办OfficeAce在请求中携带可用工具列表，模型返回工具调用指令后，果办OfficeAce执行工具并将结果回传模型。 | | 图片输入 | 允许模型接收并处理图片。 | 模型支持视觉理解，且需要在对话中发送图片时勾选。 | 果办OfficeAce将图片编码后随文本一起发送给模型，模型返回图片分析结果。 | | 思考模式 | 输出模型的推理思考过程。 | 模型支持思维链输出，希望查看模型推理过程时勾选。 | 果办OfficeAce在请求中启用思维链参数，模型返回的推理过程会展示在对话界面。 | 3. 配置完成后，单击"测试连接"。 4. 显示"连接测试成功"后，单击"保存"。 5. 验证模型效果。 参考[新建专家](https://support.huaweicloud.com/usermanual-officeace/officeace_02_0013.html#officeace_02_0013__section10739954153113)，将专家智能体的模型设置为该模型。设置并保存后，在果办OfficeAce对话界面，发送对话任务，查看果办OfficeAce的响应效果。 #### 更多操作 表6更多操作 | 操作 | 说明 | |:---|:---| | 编辑模型 | 鼠标悬浮至自定义模型或华为云MaaS模型卡片，单击"编辑"，在弹出的对话框中，可修改模型的配置信息。 | | 删除模型 | 鼠标悬浮至自定义模型或华为云MaaS模型卡片，单击"删除"，可删除模型。 警告： 删除模型后，所有使用该模型的专家将无法正常工作，且正在进行的对话会被中断。删除前请确认没有专家正在使用该模型。如需临时停用，建议在专家配置中更换模型，而非删除模型。 | #### 后续操作 模型接入完成后，您可以在[新建专家](https://support.huaweicloud.com/usermanual-officeace/officeace_02_0013.html#officeace_02_0013__section10739954153113)时为专家智能体选择所使用的模型。