AgentSpace如何完成大模型接入配置

手里已经有模型服务商的 API Key，填进 AgentSpace 后却找不到模型，或者模型能聊天、用工具就报错，这往往不是少点了一次保存那么简单。接入成功和能够顺利完成 Agent 任务，其实是两个需要分开检查的环节。

先明确一下范围：本文以 agent.space 网页版的 Workspace 自有模型配置为例，在 Windows 浏览器环境中操作，把外部供应商接进你的工作空间。如果你只是使用平台已经提供的内置模型，在新对话里直接选兼容组合即可，不必折腾外部 API 配置。

1. 找对入口：区分自有模型与开发者接口

由工作区所有者打开【工作区设置】，找到【自有模型】栏目，点击【接入模型 API】。这个入口才是用来接收供应商接口地址和 Key 的地方。

这里有个常见的误区：别把它和【Developer API】搞混了。后者是让外部客户端调用 Agent.Space 模型服务的，方向完全相反。如果把两套地址照搬过来，肯定连不上。

在工作区设置中找到【自有模型】并点击【接入模型 API】

准备好供应商提供的准确 API 地址、能访问目标模型的 Key，以及一两个待测试的 Model ID。注意，接口地址与 Key 必须来自同一服务。模型名称相似不代表 ID 相同，网页里显示的商品名也不一定能直接作为请求标识，最好去供应商文档里抄准确的 ID。

按界面选择匹配的供应商预设，或者填写自定义地址。如果是自定义地址，必须是能被云端访问的公网 HTTPS 服务。仅在你自己电脑的 localhost 或公司内网能打开，并不代表云端也能访问，这一点务必确认。

2. 通过检测：不只是能聊天

连接后，系统会从发现的结果中列出模型。如果供应商没有返回模型列表，可以使用界面提供的手动 Model ID 输入框，填入供应商文档给出的准确值，然后运行兼容性检测。

这个检测不只是让模型回答一句话那么简单。它会检查调用工具、接收工具结果并继续下一轮对话，以及输出流能否正常结束。所以，要逐个查看模型结果和适用 Agent 的情况，不能因为供应商保存成功，就推断整个列表都可用。

运行兼容性检测，查看模型对工具调用的支持情况

某些服务只提供 Chat Completions，或只笼统标注“兼容”，这并不足以证明它能承接当前 Agent 需要的 Responses、Messages 或其他请求字段。如果检测失败，保留接口提示和脱敏后的报错信息，先核对协议与模型能力，不要靠把型号改成另一个名字来蒙混过关。

3. 保存后没出现：检查环境与菜单

如果云端电脑已经在运行，按页面提示处理重启要求。先保存正在进行的工作，确认没有同事的任务会被中断，再执行必要的环境重启。不要把反复保存连接当作重新加载配置，有时候环境不重启，新配置确实不生效。

随后新建一个对话，选择目标 Agent，重新打开输入框附近的模型菜单。通过检测的自有模型会按供应商分组显示在前面。是否能选择，还要看它与当前 Agent 的兼容结果。

在输入框附近的模型菜单中选择通过检测的自有模型

如果发现模型只在另一个 Agent 下可用，先回到检测结果查原因，而不是认定平台丢了配置。如果需要换 Agent，应新建对话并交代项目背景；确认模型和环境无误后，再发送实际任务。

4. 实测验证：做一个小任务

配置完别急着跑大项目，先准备一份不含敏感信息的简单文本文件，让 Agent 读取并概括其中两项内容，明确只分析、不修改。核对工作记录是否真的读取了文件，工具返回后是否还能给出有效回答。只有流畅的文字，不能证明工具流程已跑通。

查看Agent工作记录，确认文件读取和工具返回正常

如果供应商提供用量记录，可以再对照测试时间和模型进行二次确认。要注意，Workspace 自有模型的调用由外部供应商向所有者计费，不消耗 Agent.Space 的模型套餐额度或积分，但这也不等于其他服务费用一并归零。

Key 只填在连接表单里，不要放进聊天或项目文件中。成员有运行权限后可以使用兼容模型，但不需要获得 Key 全文。首次小任务通过，再扩大使用范围。按“方向、接口、检测、菜单、实际任务”逐项核对，比一口气加入整个模型目录更容易找到问题。