AgentSpace对接第三方模型需要哪些参数

在 AgentSpace 的云端 Workspace 中，接入第三方模型并非简单的账号绑定，而是需要准确配置一系列技术参数的过程。通过工作区设置中的【自有模型】入口，用户可以将外部服务商的大模型能力引入当前工作环境。这一过程要求提供清晰的服务标识、正确的网络端点、有效的访问凭据以及精确的模型 ID，并在保存前完成严格的兼容性检测，以确保模型能够支持编程 Agent 所需的复杂交互逻辑。

在工作区设置中找到自有模型接入入口

关于【服务名称与供应商预设】

服务名称是用于在 AgentSpace 内部区分不同连接的标签。用户可以自定义一个易于识别的名称，如“团队测试模型”或“某云最新模型”，但这仅作为内部管理的显示名，不能替代实际请求中的模型标识。

当界面提供特定供应商的预设选项时，需先确认该预设是否与当前账号的实际服务端点匹配。如果使用的是自定义服务或非标准入口，应严格依据供应商官方文档填写地址，避免因品牌相同而忽略不同区域或账号类型的差异。连接成功后，自有模型会按供应商分组显示在对话模型菜单中，清晰的命名有助于快速定位。

关于【服务名称与供应商预设】

关于【接口地址】

接口地址决定了请求发送的目标位置。必须填写供应商提供的专用 API Endpoint，通常是 HTTPS 协议的公网地址。切勿将浏览器中的登录页、聊天界面或产品介绍页面 URL 当作 API 地址填入。

由于 AgentSpace 是云端服务，自定义接口必须能够从公网访问。仅在本地电脑运行的 localhost、局域网地址或公司内网服务，无法被云端 Workspace 直接调用。此外，还需注意协议能力的匹配。编程 Agent 通常依赖 Responses 或 Messages 等特定请求格式，仅支持基础 Chat Completions 的接口可能无法满足所有功能需求。具体的兼容性应以系统检测结果为准，而非仅凭地址外观判断。

填写接口地址与API Key的配置表单

关于【API Key】

API Key 是访问第三方模型服务的唯一凭据，必须属于所填写的接口地址，并具备访问目标模型的权限。网页登录状态、账号密码或订阅信息不能直接作为 API Key 使用。

在填写表单时，只需输入完整的 Key 字符串，切勿将其发送到聊天记录、项目文件或截图中，以保障安全。保存配置后，拥有运行权限的工作区成员即可使用兼容模型进行对话，无需知晓 Key 的具体内容，但调用产生的用量仍计入所有者在供应商处的账户。

若供应商支持生成独立密钥或设置预算限制，建议为此次集成配置专用的 Key 和访问范围。这样在后续核对用量账单或轮换凭据时，能更清晰地区分来自 AgentSpace 的调用与其他应用的流量。

从列表中选择准确的Model ID

关于【模型标识与兼容结果】

Model ID 是供应商系统中模型的准确标识符，必须精确填写。不能仅照抄界面上相似的显示名称，因为显示名可能随版本更新而变化，而 Model ID 才是程序调用的依据。如果连接成功发现模型，应从返回列表中选择；若无自动列表，则需手动输入文档中指定的 Model ID。

选择模型后，系统会运行兼容性检测。这一环节至关重要，它会验证模型是否支持工具调用、能否携带工具执行结果继续请求，以及是否正确处理输出结束信号。一个能回答普通文本问题的模型，未必能胜任编程 Agent 所需的复杂任务流。只有通过检测的模型，才被视为真正兼容。

兼容性检测验证工具调用能力

配置完成后，若云端环境正在运行，需按提示保存工作并重启相关服务。随后在新建对话的模型菜单中，选择该服务商分组下已通过检测的模型，尝试执行一次简单的文件读取或代码生成任务，并核对供应商后台的用量记录。只有当地址、Key、Model ID 对齐，且兼容性检测与实际小任务均通过时，才算完成了可靠的模型接入。