怎么测试AgentSpace模型连通性

在 Agent.Space 中接入自有模型（BYOK），目标不仅仅是让模型回复一句“你好”，更要确认它能顺利调用工具，并在获取工具返回结果后继续完成回答。下面以网页云端 Workspace 为例，演示如何完成连接检测和一次只读文件测试，从而验证模型与工作区的实际连通能力。

准备阶段，你需要拥有一个具备“自有模型”入口的工作区，以及由所有者配置好的供应商连接信息。同时，准备一份已保存在工作区可读位置的非敏感小文本文件，下文称为 connectivity-test.txt。操作前请先打开该文件，记下其具体内容以便后续核对。

AgentSpace工作区自有模型设置界面，显示服务名、接口地址和Model ID配置区域

1. 核对目标供应商与模型

首先由工作区所有者进入【工作区设置】下的【自有模型】页面。在此处确认目标连接的服务名称、接口地址以及所选的 Model ID。务必确保接口地址与 API Key 属于同一服务商，且模型标识使用的是供应商实际提供的准确值。

需要注意的是，自定义接口必须使用云端能够访问的公网 HTTPS 地址。即使你本机浏览器能打开 localhost 或内网服务，也不能直接证明云端环境可以连接。此外，API Key 应仅保留在连接配置表单中，切勿粘贴到测试请求或项目文件中，以防泄露。

2. 运行模型兼容性检测

在配置保存后，选择本次准备测试的少量模型，运行界面提供的兼容性检测功能。逐个阅读检测结果及其适用的 Agent 类型。请注意，连接保存成功与模型检测通过是两个独立的检查项，不要仅凭保存成功的提示就认为连通性验收已完成。

模型兼容性检测结果页面，显示检测状态和适用Agent列表

兼容性检测会尝试进行流式工具调用，并在带回工具结果后继续发起请求，同时检查输出是否正常结束。如果出现不匹配提示，请保留具体的错误原因，不要试图通过随意修改型号名称来绕开兼容判断。

这一步会向供应商发送真实请求，可能产生用量费用。如果测试失败，应先理解返回的错误信息再进行调整，避免连续重复测试来碰运气。

3. 按提示加载配置并选择组合

如果云端电脑正在运行，新增或修改连接后需按照页面提示处理重启。操作前先保存当前工作并与团队成员确认，避免中断其他任务，然后再重新打开对话中的模型菜单。

点击【新建对话】，选择当前可用的 Agent。在输入框附近找到目标供应商分组，选中与该 Agent 兼容的模型。只有通过检测的模型才会进入相应的可选列表；如果在菜单中找不到目标模型，请回到检测结果和重启提示处进行核对。

新建对话界面，展示供应商分组和兼容模型选择菜单

4. 发送一次只读文件测试

确认当前工作区中可以找到 connectivity-test.txt 文件，将实际路径写入下面的测试任务中。注意，文件内容不要预先粘贴进消息框，否则仅收到摘要不足以判断模型是否真的读取了文件。

请读取工作区中的connectivity-test.txt。
引用第一行文字，再用一句话概括文件内容。
只读取，不修改文件，不安装依赖，不访问外部网站。
如果没有读到文件，请直接说明原因，不猜测内容。

如果实际文件位于子目录，请替换为对应路径后再发送。此任务仅用于检查一个小范围的读取与回答过程，确保模型具备基本的文件访问能力。

4. 发送一次只读文件测试

5. 对照工具过程和文件内容

阅读对话中可见的工作记录，确认发生了文件读取操作，再检查工具返回后模型是否继续生成了有效回答。将模型引用的第一行文字与自己打开文件看到的内容进行对照，不能只凭回复里写着“连接成功”就判断测试通过。

如果模型只在工具调用后失败，请保留该位置的提示与供应商响应信息；这与完全无法建立连接是不同的故障线索。一次成功只验证了这组模型、Agent 和小任务的有效性，不代表长对话、全部附件与所有工具都已经通过测试。

6. 留下这次测试的核对信息

最后，记录测试时间、工作区名称、使用的 Agent、准确模型标识、文件路径和实际结果。如果供应商提供调用记录，再核对对应时间与模型调用情况。截图或笔记中不要保留完整的 API Key。

只有当连接检测结果、只读任务过程与实际文件内容都能对应上时，才算完成本次小范围验收。保留原来的文件和脱敏后的错误信息，后续更换接口或模型时，仍可用同一份材料比较结果，快速定位问题。

6. 留下这次测试的核对信息