如何在AgentSpace中添加自定义模型

在 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 的套餐额度或积分。在确认连接稳定、检测通过且小任务运行正常后，再逐步扩大使用范围。

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