AgentSpace对接开源大模型实操方法

手里明明下载了最新的开源模型权重，打开 AgentSpace 却发现在模型列表里根本选不到？这其实是很多刚接触本地或私有部署的朋友最容易踩的坑：把“拥有模型文件”等同于“拥有一个可供 Agent 调用的服务”。

这两者之间，还隔着一层推理服务、网络访问地址以及工具兼容性的鸿沟。别急着去折腾显卡服务器或内网穿透，我们先看看如何在 Windows 浏览器环境下，通过标准的 API 接口把现有的开源模型服务接进 AgentSpace 的工作空间。

先把权重名称换成一份可用的连接资料

在动手配置之前，请先确认你手头持有的不只是一个文件夹，而是一组有效的连接凭证。如果你使用的是第三方提供的开源模型 API 服务，需要准备好 HTTPS 地址、对应的 API Key 以及准确的模型 ID。

这里有个细节容易出错：不能只凭服务商宣传的“支持开源模型”就随意填写一个名称。必须确认该服务实际提供的是哪一个具体版本，比如是 Llama-3-8b 还是 Qwen-2-72b，标识符必须精确。

准备HTTPS地址、API Key和准确模型ID

如果是团队内部自己部署的服务，同样要检查网络可达性。仅在 localhost 或企业私网内能访问的地址，AgentSpace 的云端环境是无法直接连接的。为了安全起见，不建议为了照抄教程而临时开放公网端口，应优先采用团队认可的网关或代理接入方式。

这一步的最终产出，应该是一张写明了地址、密钥和模型标识的清单，而不是一个几 GB 大的模型下载目录。

到工作空间设置里填，别把密钥发给 Agent

配置入口位于 Workspace 的设置页面。由空间的 Owner 进入设置，找到【Your models】选项，选择【Connect model API】（部分界面可能显示为【Your own models】）。

如果有匹配的预设提供商，直接选择即可；如果是自定义连接，则需要按照服务文档填写基础地址。服务名称建议起得直观一些，比如“资料整理专用开源模型”，方便后续识别。

在Your models中配置Connect model API

API Key 填入连接表单后，系统通常会尝试自动拉取模型列表。如果列表无法正常发现，不要慌，使用界面提供的手动 ID 输入功能，复制提供方给出的准确标识粘贴进去。切记，不要把本地的项目文件名当作模型名填进去，那是两码事。

另外请注意，侧栏的【Model API Key】是用于外部客户端调用 AgentSpace 服务的，方向正好相反。配置完成后，千万不要把刚才填写的 Key 追加进聊天窗口让“Agent 帮忙检查一下”，这会带来严重的安全风险。后续成员使用共享模型时，只需选择模型，无需知晓所有者的密钥。

能聊天之后，还得能接住工具结果

保存配置后，系统通常会运行一次连接兼容检查。这一步非常关键，因为它决定了你的模型能不能真正干活。开源与否并不直接决定检查结果，Agent 需要的是接口规范、工具调用能力以及续答行为符合预期。

查看模型是否支持工具调用和工作流

你可能会遇到这种情况：文字问候能正常返回，但一旦让模型读取文件，它就卡住或报错。这说明服务可能只提供了普通的 Chat Completions 接口，而不支持 AgentSpace 所需的 Responses 或 Messages 工作流。此时应按检测信息核对提供方的实现文档，不要试图通过给模型改名来“强行适配”。

如果界面提示需要重启云端电脑以应用变更，请先保存当前工作并与共用空间的成员协调时间，再执行重启。重新打开模型菜单，在提供方分组中选择已通过检查、且适合当前 Agent 任务的模型。如果依然没有出现，请回看之前的检测失败原因。

用一个真实小文件收尾

配置是否成功，最终要靠实战检验。先挑选工作空间中已有、且不敏感的一份材料，例如 materials/brief.txt。给所选模型下达一个明确的任务：“读取这份文件，指出两个已明确的事项和一个仍缺的信息，只读不修改；如果读不到就说明原因。”

注意，示例路径要换成你在【Files】面板里确认过的实际路径。提交任务后，核对回答是否符合材料内容，并查看任务活动中的读取记录。

模型读取brief.txt并返回结构化信息

如果提供方后台有请求或用量记录，对照时间和模型 ID，确认这次调用确实到达了预期的服务节点。不要把一句简单的“连接正常”当成完成记录，真正的成功是模型能理解文件内容并给出结构化反馈。

最后提醒一点，自有模型调用通常由外部提供方账户承担费用，开源权重不代表 API 推理免费。建议把通过验证的模型 ID、Agent 组合和检查时间记在项目交接说明里，但不要保存密钥。先让这一项小任务走通，再扩大到长文整理或代码任务，后续出问题也更容易找回可用的起点。