AgentSpace对接第三方模型需要哪些参数
详解 AgentSpace 工作区设置中自有模型的接入流程,明确服务名称、接口地址、API Key 和模型标识的填写规范,强调兼容性检测对工具调用的重要性,帮助开发者正确配置外部大模型服务。
在 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 对齐,且兼容性检测与实际小任务均通过时,才算完成了可靠的模型接入。

































