大模型接入
平台上的模型有两个来源:生态市场一键下发(现成的、带计费的,见生态市场),或者自己接一个三方模型——拿供应商的 API Key,在模型管理里配一条,空间里立刻能用。本篇讲后者。
自己接的好处很直接:走你自己的账号、你自己的额度,模型版本、上下文长度、输出上限都由你定;换模型不用改智能体,改这一条配置就行。
一、模型管理在哪
空间左侧「组件资源 → 模型管理」。

所有人是当前空间能用的全部模型(含管理员配的平台公共模型、别人共享给你的);由我创建只看自己加的;- 卡片上四样信息最有用:模型名称、最近编辑、已启用/未启用、模型类型标签;
- 右上角
+ 模型就是接入入口。
这里的"模型"是空间级的,只对本空间可见。平台级公共模型、授权与管控是管理员在「系统管理 → 模型管理」里做的,两套不冲突——分工见下一节。
二、先分清三个地方:谁能配「全平台」,谁只能配「自己空间」
平台里有三处跟「模型」有关的设置,常被当成同一件事。它们的分工其实很清楚:
| 位置 | 谁在用 | 管的是什么范围 |
|---|---|---|
| 系统管理 → 模型管理 | 管理员 | 全平台:把模型接进平台、开启管控后按角色/用户组授权、给模型定定价。配一次,所有空间都能用 |
| 系统配置 → 系统设置 → 默认模型设置 | 管理员 | 全平台默认走哪个模型:默认会话、会话总结、问题建议、长任务、编码视觉、知识库向量化、文档预处理各选一个 |
| 组件资源 → 模型管理 | 你自己 | 只有你所在的空间:在个人空间配的,只你可见可用;在团队空间配的,只这个团队的成员可见可用 |
换成一句话:管理员配的是「全平台都能用的」,你配的是「自己这个空间能用的」。
三者怎么配合:
- 管理员接好的公共模型,会直接出现在你空间「模型管理 → 所有人」列表里,你不用再自己接一遍;
- 你自己接的模型只在本空间生效,既不会影响别人的空间,也不能被别的空间调用——这正是团队想用私有 Key、私有额度时的正确做法;
- 「默认模型设置」只决定你没手动选的时候走哪个,不会覆盖你在智能体里手选的模型。
找不到该去哪配?
- 要给整个平台加模型、管授权、定价格 → 找管理员,走「系统管理」;
- 要在自己空间/团队空间加一个私有模型(自己的 Key、自己的额度)→ 就在本篇,走「组件资源 → 模型管理」。
三、接入一个三方模型,四步
- 拿 API Key:到供应商控制台创建一个 Key(DeepSeek、智谱、MiniMax、阿里云百炼、OpenAI 等都一样);
- 回平台点
+ 模型,先选供应商,再选模型标识; - 把 API Key 贴进「接口配置」里的
API KEY; - 点左下角 模型连通性测试,通了再点
确认。
第 2 步是关键:选完模型标识,表单里大部分字段会自动填好,你真正需要动手的常常只有一个 API Key。
四、表单字段逐个说
弹窗分上下两段。上半段是模型是什么:

下半段是能不能用、怎么调:

| 字段 | 必填 | 说明 |
|---|---|---|
| 供应商 | ✅ | 先选服务商(阿里云、Anthropic、DeepSeek、月之暗面、MiniMax、Nuwax、OpenAI 等),选完下面的模型标识才有可选项 |
| 模型名称 | ✅ | 平台里显示的名字,可以改。建议带上供应商,一眼能分清 |
| 模型标识 | ✅ | 真正发给接口的模型名,比如 deepseek-chat。一般从下拉里选,不要手打——手打错一个字就连不通 |
| 模型介绍 | ✅ | 最多 2000 字,写给使用这个模型的人(和智能体编排时)看 |
| 模型类型 | ✅ | 可多选:文本生成 / 图像理解 / 语音识别 / 视频理解 / 文本向量 / 深度思考。它决定这个模型能出现在哪些场景,比如知识库只能选「文本向量」的模型 |
| 最大输出 token 数 | ✅ | 一次回答最多能写多长。这一项最容易配错,见下一节 |
| 最大上下文长度 | ✅ | 一次请求能带多少内容(提示词 + 历史 + 资料)。长文档、长会话靠它 |
| 函数调用支持 | ✅ | 能不能调用外部工具。要挂插件、工作流、MCP,必须选支持的那一档(如「支持流式函数调用」) |
| 每用户每日 Token 上限 | 留空或填 0 = 不限制。团队空间用它给单个成员设天花板,防止一个长会话烧掉整个额度 | |
| 是否启用 | ✅ | 先配好、测试通过再启用;配错了禁用即可,不用删 |
| 可用范围 | ✅ | 网页应用 / 通用智能体 / 问答智能体 / 工作流 / 外部API调用,可多选。勾了才在对应场景的下拉里出现 |
| 接口协议 | ✅ | 一般是 OpenAI(绝大多数供应商都兼容);供应商支持 Anthropic 原生协议时也可切过去 |
| 接口配置 · URL | ✅ | 接口地址,如 https://api.deepseek.com。照抄供应商文档,别自己补 /v1,多数平台会自动拼路径 |
| 接口配置 · API KEY | ✅ | 供应商控制台创建的那把 Key |
| 接口配置 · 权重 | ✅ | 默认 1。同一个模型配了多组 URL/KEY 时,权重越大被选中的概率越高,用来做负载与容灾 |
| 接口配置 · 代理 | 请求是否经平台代理转发。测试连不通时,先开关它再试一次,能省很多排查 | |
| 接口配置 · + | 加一组新的 URL/KEY。同一模型的多把 Key、多个接入点都放这里 |
五、最省事的地方:自动带出
这套表单是供应商目录驱动的:选了供应商,再选模型标识,平台知道这个模型长什么样,于是把名称、介绍、类型、上下文、输出上限、函数调用、URL、权重、代理一次性填好。
以 DeepSeek Chat 为例,选完标识后自动变成:
| 字段 | 自动填成 |
|---|---|
| 模型名称 | DeepSeek Chat |
| 模型标识 | deepseek-chat |
| 模型类型 | 文本生成 |
| 最大输出 token 数 | 384000 |
| 最大上下文长度 | 1000000 |
| 函数调用支持 | 支持流式函数调用 |
| URL | https://api.deepseek.com |
| 权重 / 代理 | 1 / 开启 |
只有 API KEY 是空的——它是你的,平台不可能知道。贴进去、点连通性测试,就完事了。
自动填的也能改
自动带出的值是"这个模型官方给的推荐值",不是硬约束。你有套餐限制、或者只想给某个场景开小一点的输出,都可以手动改。但上下文与输出这两个数不要往上乱调,超过模型真实能力会直接被接口拒绝。
下拉里没有你的模型?
说明供应商目录还没收录这个模型。这时模型标识可以手填,但名称、类型、上下文、输出上限、函数调用、URL 都得自己按供应商文档填全——填错任何一项,表现都是"连通但答不出来"。
六、最容易配错的两个数
最大输出 token 数
这是一次回答的上限,不是总预算。它和"模型能记住多少"是两件事。
配小了会怎样:回答写到一半被硬截断。放在智能体里更明显——通用型智能体要自己规划、调工具、拼文件,输出被截断就等于活干到一半停了,最后交不出完整交付物。所以接通用型智能体的模型,这一项要给足。
配大了会怎样:只要不超过模型真实上限,多填没有坏处(实际消耗按生成量算,不是按上限算)。
最大上下文长度
它决定一次能"看"多少内容:系统提示词 + 历史对话 + 挂载的知识库片段 + 工具返回,全算在里面。长文档问答、连续几十轮的会话,配小了会在中途报上下文超限。
七、可用范围:决定了在哪能选到它
| 可用范围 | 勾了之后 |
|---|---|
| 网页应用 | 网页应用开发时可选 |
| 通用智能体 | 通用型智能体的模型下拉里出现 |
| 问答智能体 | 问答型智能体可用 |
| 工作流 | 工作流里的模型节点可用 |
| 外部API调用 | 通过开放 API 调用时可用 |
默认全勾最省事。如果智能体里怎么都选不到这个模型,先回来检查这一栏和「是否启用」——这两处是最常见的"模型明明配了却找不到"。
八、配完要做的一件事:连通性测试
表单左下角 模型连通性测试,点一下会真的发一次请求过去。它验证的是 URL、API Key、协议、代理这四件事一起对不对,比保存之后再去智能体里试要快得多。
不通的时候按这个顺序查:
- Key 对不对:有没有多余空格、是不是复制少了几位、有没有过期;
- URL 对不对:是不是照抄的供应商地址,有没有自己多加
/v1; - 协议对不对:这家供应商支不支持 OpenAI 兼容协议;
- 代理:开关切一下再测;
- 额度/权限:Key 有没有被授权这个模型、账户里还有没有余额。
测试通过再点 确认,卡片上会显示「已启用」。
九、在智能体里用起来
模型配好后,去智能体编排页的模型下拉里选它——前提是「可用范围」勾了对应的场景。
智能体的效果不只取决于模型本身:提示词怎么写、挂了哪些工具、知识库里有什么,往往比"换一个更贵的模型"影响更大。选型的实际建议是——先用够用的模型把流程跑通,再针对性升级。
十、注意事项
- 模型标识别手打。能用下拉就用下拉,手打错一个字符,症状是"连通性测试就失败",很难一眼看出来。
- 类型要选对。知识库的向量模型、图像理解、语音识别都靠类型标签筛选,标错了那个场景里根本看不到它。
- 函数调用决定能不能挂工具。不支持的模型,插件和工作流挂上去也不会被调用。
- 一个模型可以有多组接口配置。多把 Key、多个接入点,靠权重分流,比"再建一个同名模型"更好管理。
- 先启用再验证。建议流程:配好 → 连通性测试 → 建个最简智能体跑一句 → 再给团队用。
- 计费在供应商那边。自己接的模型,费用与限流由你与供应商结算,平台只负责转发调用。
- 生态市场下发的模型也在这里。想省掉手填配置这一步,可以先去生态市场一键下发,下发完同样在模型管理里能看到。
- 配图取自正式环境个人空间,模型列表为测试用条目,与你的实际配置无关。
