如何在AgentSpace中添加自定义模型
详解如何在 AgentSpace 工作区设置中接入自有模型。包括填写 API Key、配置接口地址、进行工具调用兼容性检测,以及重启后验证模型在实际任务中的表现。
在 AgentSpace 网页工作区中添加自定义模型,核心是通过“自有模型”功能接入外部供应商的 API。这一过程由具备管理权限的成员操作,将外部算力引入当前项目,而非简单地在聊天框中切换显示名称。本文将梳理从连接配置到实际验证的完整路径,明确各区域的功能边界。
概述
自定义模型的配置入口位于“工作区设置”下的“自有模型”板块,通常仅对 Workspace 所有者或特定管理员开放。这里的作用是将外部模型服务接进共享工作区,供有权限的成员调用。需要注意的是,这与“Developer API”方向相反:后者是将 AgentSpace 的能力输出给外部客户端,而前者是将外部能力引入内部。
在开始之前,请准备好供应商文档中的接口地址(Endpoint)、具有目标模型访问资格的 API Key,以及准确的模型标识 ID。不同工作区的界面细节可能存在差异,请以当前实际显示的菜单为准,不要完全依赖其他环境的截图。

工作区设置中的自有模型入口位置
关于自有模型入口
进入工作区设置后,找到并点击“自有模型”,随后选择“接入模型 API”。这一配置属于整个共享工作区的基础设施,一旦保存,所有拥有执行权限的成员均可在对话菜单中看到该模型选项。
所有者负责维护连接的稳定性与安全性。成员能否运行任务,依然取决于其原有的角色权限;共享模型不会自动赋予只读成员额外的执行权。此外,有权限的成员可以使用接入的模型,但无法查看所有者填写的 API Key 明文,从而保障凭据安全。

关于自有模型入口
关于服务连接表单
在连接表单中,主要填写三项内容:服务名称、接口地址和 API Key。服务名称用于在界面中识别供应商;接口地址决定请求发往何处;API Key 则必须属于该项服务,且具备调用目标模型的权限。
如果系统提供了匹配供应商的预设选项,可以直接选择并填入对应的 Endpoint。若使用自定义地址,必须确保该地址是云端服务器能够访问的公网 HTTPS 接口。仅在本地电脑 localhost 或公司内网能打开的服务,无法直接被云端工作区连通。
请务必注意,Key 只能填写在连接表单中,严禁放入任务提示词、项目文件或任何截图中。同时,要区分模型订阅的账号登录凭据与 API Key,不要将账号密码粘贴进 Key 字段。

服务连接表单填写示例
关于模型选择与兼容性检测
连接保存后,系统会尝试发现可用的模型列表。建议先勾选少量准备使用的型号,模型标识必须以供应商实际提供的 ID 为准。如果未返回可用列表,可以使用界面提供的手动 Model ID 输入框,切勿自行编造或改写相似名称。
接下来的兼容性检测至关重要。系统会检查模型是否支持工具调用,以及在收到工具返回结果后能否继续生成回答。供应商显示“保存成功”仅代表连接通畅,不代表某个具体模型通过了 Agent 工作流的检测。有些模型可能仅能生成文字,却无法处理复杂的工具交互。
检测过程会向供应商发送真实请求,因此可能产生费用。只有通过相应检测、且适合当前 Agent 类型的模型,才会最终进入可选列表。

模型兼容性检测状态展示
关于对话模型菜单与实际使用
当云端工作环境正在运行时,新增或修改连接后通常需要按页面提示重启服务。重启前请保存当前工作进度,并确认不会打断其他成员的进行中任务。重启完成后,重新打开对话界面中的模型选择菜单。
自有模型通常会按供应商分组,显示在菜单的靠前位置。选择兼容模型后,建议使用一份不含敏感信息的现有材料进行小规模测试。例如,要求模型读取指定文件并总结内容,暂不执行修改文件的操作。
观察重点在于模型是否实际读取了材料,以及在工具返回结果后能否逻辑连贯地继续回答,而不仅仅是看最终生成的文字是否通顺。这些模型的调用费用由外部供应商向所有者结算,不消耗 AgentSpace 的套餐额度或积分。在确认连接稳定、检测通过且小任务运行正常后,再逐步扩大使用范围。

在对话菜单中选择自有模型

































