AgentSpace模型接入身份认证怎么配置

模型地址填好了，一点检测却提示认证失败；手边明明有账号密码，又不知道该往哪里填。接入外部模型时，最容易卡住的恰好是这一步。

在 Agent.Space 网页工作区的“自有模型”里，认证使用供应商提供的 API Key。先把接口地址、Key 和模型权限对齐，再检查 Agent 兼容性，比在不同输入框里轮流试密码更有效。下面按工作区接入自有模型这条路径操作。

先拿对凭据，再找工作区所有者

进入模型供应商的 API 管理入口，准备允许访问目标模型的 Key，并核对该账号对应的接口地址。网页聊天的登录密码、桌面客户端的订阅登录，都不能直接当作 API Key 填入。

拿到一串 Key 也不等于准备完毕。确认它属于准备接入的服务、仍然有效，并有目标模型的调用权限。供应商如果提供单独的集成 Key、预算或用量提醒，可以按项目用途设置，后续更容易分辨这条连接的消耗。

回到 Agent.Space，确认当前是目标 Workspace，并由所有者管理连接。成员能选择已接入模型，不代表需要拿到所有者的完整 Key；只读角色也不会因为模型共享就自动获得运行 Agent 的权限。

在供应商后台获取有效的API Key并确认权限

在“自有模型”表单里配成一组

打开“工作区设置”里的“自有模型”，点击“接入模型 API”，填写便于辨认的服务名称、供应商接口地址和对应 Key。已有连接需要更新凭据时，编辑原连接，避免为同一个服务反复新增相似记录。

接口地址按供应商当前说明填写。选择预设前，确认它与账号实际 Endpoint 相符；自定义地址则要满足云端可访问的公网 HTTPS 条件。只在自己电脑上能访问的服务，不能据此判断云端也能连接。

Key 只放进连接表单。不要让 Agent 从聊天内容里“记住密钥”，也别把它写入项目说明、公开代码或求助截图。如果复制后认证仍失败，回供应商管理页面确认凭据状态和权限，不要靠修改模型显示名称解决认证问题。

这里配置的是把外部供应商接入工作区。“更多”里的“Model API Key”用于让外部客户端调用 Agent.Space，接入方向和凭据用途不同，不能互相顶替。

在AgentSpace工作区设置中填写接口地址和API Key

认证能过，还要让模型完成工具循环

选择供应商返回的目标模型；没有返回模型列表时，按页面提供的手动输入方式填写准确 Model ID，再运行兼容性检测。检测会实际向供应商发请求，可能产生用量，先用少量目标模型就够了。

查看具体结果，而不是只看连接是否保存。认证错误优先核对 Key、地址与访问权限；若错误出现在工具调用后的后续请求，则要继续检查模型和接口是否支持当前 Agent。换一把 Key 未必能解决能力不匹配。

如果云端电脑已经运行，新增或修改连接后，按页面提示让配置重新加载；需要重启时，先保存工作并协调其他成员的任务。接着在新对话选择 Agent，从供应商分组中选用通过检测的兼容模型。

运行兼容性检测并查看模型支持情况

用小任务确认，密钥变更也留好接续

准备一个不含敏感信息的小文件，让 Agent 读取并概括，明确要求暂不修改。对照文件内容和工具执行记录，确认它确实读取了材料，并在工具返回后继续回答。单纯聊通一句话，还不足以验证实际工作流程。

供应商提供调用记录时，按测试时间和模型核对用量。通过自有模型发出的请求由对应供应商向所有者计费；成员看不到 Key，也可能在运行任务时产生供应商消耗。

如果 Key 泄露，先到供应商处撤销或轮换，再更新工作区连接，并重新检测。求助时保留时间、模型 ID、连接路径和脱敏报错即可，完整密钥不应跟着截图流转。先确认凭据，再过兼容性检测，最后做一次小任务，认证配置是否可用就有了具体落点。