大模型接入
概述
本文说明如何在 平台配置 的 大模型接入 模块中,新增、配置与管理模型。接入成功后,MaiPlat Agent 将按策略调用已接入的模型(含默认模型、对话内切换等能力,以当前产品版本为准)。
操作指引
1. 打开大模型接入列表
进入 设置 → 平台配置,在右侧选择 大模型接入,即可查看当前已接入模型列表,并从此处发起新增或管理操作。

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

填写时请注意:
- 多模态:若模型具备**图像理解(识图)**能力,请勾选或选择 多模态 相关选项,以便 Agent 正确路由图文类请求。
- 思考能力:若模型支持 Thinking / Reasoning 类能力,请打开 思考 开关;开启后,MaiPlat Agent 对话页才会显示「思考开/关」等控制项,供终端用户按需使用。
费用预估字段
表单中的 每百万 Token 费用 为非必填,由您自行填写,用于在平台侧粗略估算用量成本。实际计费受 缓存命中、供应商调价、计费维度(输入/输出) 等影响,与控制台账单可能存在偏差;结算请以供应商官方控制台为准。
3. 查看卡片并执行常见操作
保存成功后,列表中会生成对应的 模型卡片,可快速浏览模型名称、类型、接口地址等摘要信息。

在卡片上可执行的主要动作包括:
| 操作 | 说明 |
|---|---|
| 设为默认 | 将当前模型指定为 默认模型;MaiPlat Agent 在未指定其它模型时优先调用该模型。 |
| 测试 | 检测与该模型配置的 连通性 与基础可用性(具体探测逻辑以产品实现为准)。 |
小结
大模型接入遵循「列表管理 → 表单配置 → 卡片运维」的路径;正确区分 多模态、思考 开关与 OpenAI 兼容接口 参数,有助于 Agent 侧能力与安全边界一致、可用。