Skip to content

大模型接入 ​

平台上的模型有两个来源:生态市场一键下发(现成的、带计费的,见生态市场),或者自己接一个三方模型——拿供应商的 API Key,在模型管理里配一条,空间里立刻能用。本篇讲后者。

自己接的好处很直接:走你自己的账号、你自己的额度,模型版本、上下文长度、输出上限都由你定;换模型不用改智能体,改这一条配置就行。

一、模型管理在哪 ​

空间左侧「组件资源 → 模型管理」。

模型管理列表:所有人 / 由我创建两个页签,右上角「+ 模型」
  • 所有人 是当前空间能用的全部模型(含管理员配的平台公共模型、别人共享给你的);由我创建 只看自己加的;
  • 卡片上四样信息最有用:模型名称、最近编辑、已启用/未启用、模型类型标签;
  • 右上角 + 模型 就是接入入口。

这里的"模型"是空间级的,只对本空间可见。平台级公共模型、授权与管控是管理员在「系统管理 → 模型管理」里做的,两套不冲突——分工见下一节。

二、先分清三个地方:谁能配「全平台」,谁只能配「自己空间」 ​

平台里有三处跟「模型」有关的设置,常被当成同一件事。它们的分工其实很清楚:

位置谁在用管的是什么范围
系统管理 → 模型管理管理员全平台:把模型接进平台、开启管控后按角色/用户组授权、给模型定定价。配一次,所有空间都能用
系统配置 → 系统设置 → 默认模型设置管理员全平台默认走哪个模型:默认会话、会话总结、问题建议、长任务、编码视觉、知识库向量化、文档预处理各选一个
组件资源 → 模型管理你自己只有你所在的空间:在个人空间配的,只你可见可用;在团队空间配的,只这个团队的成员可见可用

换成一句话:管理员配的是「全平台都能用的」,你配的是「自己这个空间能用的」。

三者怎么配合:

  • 管理员接好的公共模型,会直接出现在你空间「模型管理 → 所有人」列表里,你不用再自己接一遍;
  • 你自己接的模型只在本空间生效,既不会影响别人的空间,也不能被别的空间调用——这正是团队想用私有 Key、私有额度时的正确做法;
  • 「默认模型设置」只决定你没手动选的时候走哪个,不会覆盖你在智能体里手选的模型。

找不到该去哪配?

  • 要给整个平台加模型、管授权、定价格 → 找管理员,走「系统管理」;
  • 要在自己空间/团队空间加一个私有模型(自己的 Key、自己的额度)→ 就在本篇,走「组件资源 → 模型管理」。

系统管理侧的完整说明见模型管理(平台级)与模型管理说明;默认模型的七项设置见系统配置。

三、接入一个三方模型,四步 ​

  1. 拿 API Key:到供应商控制台创建一个 Key(DeepSeek、智谱、MiniMax、阿里云百炼、OpenAI 等都一样);
  2. 回平台点 + 模型,先选供应商,再选模型标识;
  3. 把 API Key 贴进「接口配置」里的 API KEY;
  4. 点左下角 模型连通性测试,通了再点 确认。

第 2 步是关键:选完模型标识,表单里大部分字段会自动填好,你真正需要动手的常常只有一个 API Key。

四、表单字段逐个说 ​

弹窗分上下两段。上半段是模型是什么:

新增模型上半部分:供应商、模型名称与标识、介绍、类型、输出 token、上下文长度、函数调用、每日上限

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

新增模型下半部分:是否启用、可用范围、接口协议、接口配置(URL / 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
函数调用支持支持流式函数调用
URLhttps://api.deepseek.com
权重 / 代理1 / 开启

只有 API KEY 是空的——它是你的,平台不可能知道。贴进去、点连通性测试,就完事了。

自动填的也能改

自动带出的值是"这个模型官方给的推荐值",不是硬约束。你有套餐限制、或者只想给某个场景开小一点的输出,都可以手动改。但上下文与输出这两个数不要往上乱调,超过模型真实能力会直接被接口拒绝。

下拉里没有你的模型?

说明供应商目录还没收录这个模型。这时模型标识可以手填,但名称、类型、上下文、输出上限、函数调用、URL 都得自己按供应商文档填全——填错任何一项,表现都是"连通但答不出来"。

六、最容易配错的两个数 ​

最大输出 token 数 ​

这是一次回答的上限,不是总预算。它和"模型能记住多少"是两件事。

配小了会怎样:回答写到一半被硬截断。放在智能体里更明显——通用型智能体要自己规划、调工具、拼文件,输出被截断就等于活干到一半停了,最后交不出完整交付物。所以接通用型智能体的模型,这一项要给足。

配大了会怎样:只要不超过模型真实上限,多填没有坏处(实际消耗按生成量算,不是按上限算)。

最大上下文长度 ​

它决定一次能"看"多少内容:系统提示词 + 历史对话 + 挂载的知识库片段 + 工具返回,全算在里面。长文档问答、连续几十轮的会话,配小了会在中途报上下文超限。

七、可用范围:决定了在哪能选到它 ​

可用范围勾了之后
网页应用网页应用开发时可选
通用智能体通用型智能体的模型下拉里出现
问答智能体问答型智能体可用
工作流工作流里的模型节点可用
外部API调用通过开放 API 调用时可用

默认全勾最省事。如果智能体里怎么都选不到这个模型,先回来检查这一栏和「是否启用」——这两处是最常见的"模型明明配了却找不到"。

八、配完要做的一件事:连通性测试 ​

表单左下角 模型连通性测试,点一下会真的发一次请求过去。它验证的是 URL、API Key、协议、代理这四件事一起对不对,比保存之后再去智能体里试要快得多。

不通的时候按这个顺序查:

  1. Key 对不对:有没有多余空格、是不是复制少了几位、有没有过期;
  2. URL 对不对:是不是照抄的供应商地址,有没有自己多加 /v1;
  3. 协议对不对:这家供应商支不支持 OpenAI 兼容协议;
  4. 代理:开关切一下再测;
  5. 额度/权限:Key 有没有被授权这个模型、账户里还有没有余额。

测试通过再点 确认,卡片上会显示「已启用」。

九、在智能体里用起来 ​

模型配好后,去智能体编排页的模型下拉里选它——前提是「可用范围」勾了对应的场景。

智能体的效果不只取决于模型本身:提示词怎么写、挂了哪些工具、知识库里有什么,往往比"换一个更贵的模型"影响更大。选型的实际建议是——先用够用的模型把流程跑通,再针对性升级。

十、注意事项 ​

  • 模型标识别手打。能用下拉就用下拉,手打错一个字符,症状是"连通性测试就失败",很难一眼看出来。
  • 类型要选对。知识库的向量模型、图像理解、语音识别都靠类型标签筛选,标错了那个场景里根本看不到它。
  • 函数调用决定能不能挂工具。不支持的模型,插件和工作流挂上去也不会被调用。
  • 一个模型可以有多组接口配置。多把 Key、多个接入点,靠权重分流,比"再建一个同名模型"更好管理。
  • 先启用再验证。建议流程:配好 → 连通性测试 → 建个最简智能体跑一句 → 再给团队用。
  • 计费在供应商那边。自己接的模型,费用与限流由你与供应商结算,平台只负责转发调用。
  • 生态市场下发的模型也在这里。想省掉手填配置这一步,可以先去生态市场一键下发,下发完同样在模型管理里能看到。
  • 配图取自正式环境个人空间,模型列表为测试用条目,与你的实际配置无关。