跳到主要内容

大模型接入

概述

本文说明如何在 平台配置大模型接入 模块中,新增、配置与管理模型。接入成功后,MaiPlat Agent 将按策略调用已接入的模型(含默认模型、对话内切换等能力,以当前产品版本为准)。

操作指引

1. 打开大模型接入列表

进入 设置 → 平台配置,在右侧选择 大模型接入,即可查看当前已接入模型列表,并从此处发起新增或管理操作。

平台配置中的大模型接入列表

2. 新增并填写模型信息

点击 新增模型,在弹出表单中填写供应商与模型参数。当前版本仅支持 OpenAI 兼容(通用)接口;请按您所用供应商的 API 文档填写 Base URLAPI Key模型名称 等必填项。

新增模型:配置表单与接口说明

填写时请注意:

  • 多模态:若模型具备**图像理解(识图)**能力,请勾选或选择 多模态 相关选项,以便 Agent 正确路由图文类请求。
  • 思考能力:若模型支持 Thinking / Reasoning 类能力,请打开 思考 开关;开启后,MaiPlat Agent 对话页才会显示「思考开/关」等控制项,供终端用户按需使用。
费用预估字段

表单中的 每百万 Token 费用非必填,由您自行填写,用于在平台侧粗略估算用量成本。实际计费受 缓存命中、供应商调价、计费维度(输入/输出) 等影响,与控制台账单可能存在偏差结算请以供应商官方控制台为准

3. 查看卡片并执行常见操作

保存成功后,列表中会生成对应的 模型卡片,可快速浏览模型名称、类型、接口地址等摘要信息。

大模型列表中的模型卡片

在卡片上可执行的主要动作包括:

操作说明
设为默认将当前模型指定为 默认模型;MaiPlat Agent 在未指定其它模型时优先调用该模型。
测试检测与该模型配置的 连通性 与基础可用性(具体探测逻辑以产品实现为准)。

小结

大模型接入遵循「列表管理 → 表单配置 → 卡片运维」的路径;正确区分 多模态思考 开关与 OpenAI 兼容接口 参数,有助于 Agent 侧能力与安全边界一致、可用。