如何设置AgentSpace模型调用权限

在 AgentSpace 中，模型调用权限并非单一开关，而是分散在工作区成员管理、自有模型连接和外部 API 密钥三个层面。理解这些区域的分工，能避免“给了权限却跑不通”或“担心额度失控”的问题。本文基于 agent.space 网页版界面，梳理 Windows 浏览器环境下的配置逻辑。

概述

设置前需明确控制对象：是限制同事在工作区内的操作，还是管理接入的供应商模型，亦或是控制外部工具通过 API 调用。这三者相互独立又彼此关联。成员拥有编辑权不代表能随意调用所有模型；模型已接入也不代表当前账户有足够额度。只有将角色、模型兼容性和 API 限制分开核对，才能精准定位权限缺口。

AgentSpace 工作区权限配置概览，展示成员、模型与 API Key 的关系

关于【成员与角色】

工作区内的权限基础是成员角色。从 Workspace 的【成员】入口发起邀请时，需根据对方职责选择对应身份。对方使用自己的账户确认加入后，其操作范围即被限定在该角色的权限内。

• Owner：负责管理工作区成员、整体权限设置及所有权转移。
• Editor：可修改共享文件，创建或继续 Agent 对话，适合需要实际执行任务的用户。
• Viewer：仅能查看文件、对话历史及获准预览的内容，无法发送 Agent 任务。

若只需对方查阅成果，分配 Viewer 即可；若需其参与任务执行，则赋予 Editor 权限。注意，修改现有成员角色必须由 Owner 操作，且应定期核对成员列表，确保加入的是正确账号与工作区，避免通过共用所有者登录来替代精细化的角色配置。

关于【成员与角色】

关于【自有模型连接】

当工作区需要接入外部供应商模型时，由 Owner 进入【工作区设置】中的【自有模型】页面进行配置。此处需填写供应商地址、API Key 并选择待用模型，系统会逐个进行兼容性检测。

自有模型连接设置界面，显示供应商配置与兼容性检测状态

只有通过检测且适配当前 Agent 的模型，才会出现在可选列表中。具备运行权限的成员（如 Editor）可以直接选用这些已配置的兼容模型，而无需知晓供应商 Key 的具体内容。需注意，只读成员（Viewer）即使身处已接入自有模型的工作区，也无法自动获得发起任务的能力；调用权限首先取决于角色，其次取决于模型与 Agent 的适配状态。

此外，自有模型的调用费用计入所有者的供应商账户。若需控制成本，应在供应商端设置预算或访问范围，不能简单地将 Workspace 的角色权限等同于供应商账号的资源权限。

关于【Model API Key 限制】

若需允许外部客户端或工具调用 AgentSpace 的模型，需通过侧边栏【更多】菜单进入【Model API Key】页面，即 Developer API 设置区。这与在工作区内接入供应商模型的方向截然不同。

Model API Key 设置面板，展示模型选择、额度限制与过期时间配置

建议为不同用途创建名称清晰的 Key。在 Key 的详细设置中，可指定允许的模型范围、花费上限、重置周期及过期日期。对于只需固定模型的工具，应明确勾选对应模型；若未设置模型限制，则默认允许访问全部可用模型；日期留空则表示永不过期。切勿将空白选项误认为默认禁止。

这些限制仅作用于新的 API 请求。页面上成功创建 Key 并不代表某次请求必然成功，仍需满足 API 使用资格、Key 自身限制以及当次用量余额等多重条件。涉及查看或重新生成等敏感操作时，系统会要求完成身份验证。

关于【调用验证与记录】

权限配置完成后，建议按实际路径进行小范围验证。工作区成员可尝试在新对话中选中目标 Agent 与模型，发送简短任务以确认功能正常；Viewer 角色则应确认其仅能查看而无法修改，无需刻意尝试突破权限。

API 调用记录查询界面，显示请求时间、模型及用量详情

对于外部客户端，在使用新 Key 完成一次小请求后，应返回 API 页面核对该 Key 的请求时间、所用模型及用量记录。若客户端收到回复但后台无对应记录，需检查客户端是否仍沿用旧配置或其他 Key。密钥应妥善保存在相应配置位置，严禁放入聊天记录、共享文件或截图中。如需收回外部访问权限，直接在 Key 管理入口撤销或更换，并同步更新受影响的客户端；工作区成员权限的调整则回到成员管理中处理，确保每次权限变更都能对应到具体的调用路径。