API Key 使用手册
什么是 API Key
API Key 是企业文件管理为外部 Agent（AI 智能体）提供的身份凭证，用于安全地连接和访问企业网盘中的数据。
通过 API Key，企业管理员可以：
让Qoder、Qoderwork、OpenClaw等Agent 安全访问企业文件
精细控制每个 Agent 能访问的空间范围和操作权限
设置有效期，到期自动失效，保障数据安全
随时启用、禁用或删除 Key，一键切断 Agent 的数据访问
核心原则：1 个 API Key = 1 个 Agent 身份。 建议为每一个 Agent 用途分配独立的 Key，便于权限隔离和审计追踪。
前置条件
条件 | 说明 |
角色要求 | 企业管理员（超级管理员或具备 API Key 管理权限的管理员） |
配额限制 | API Key 可创建数量每个用户2个 |
开启API Key
开启该功能后，用户可创建 API Key，通过 PDS Skill 授权 Agent 直接读写网盘文件，并将生成的文档、图片、视频等内容保存至网盘。
API Key 创建后，权限默认小于等于该用户在网盘内的权限范围，用户可进一步缩小Agent可访问范围。
常见问题
Q：禁用 API Key 后，Agent 端会有什么反应？
A：使用该 Key 的 Agent 在调用时会收到错误响应，提示 Key 已被禁用。Agent 无法继续访问企业数据，直至管理员重新启用该 Key。
Q：API Key 过期后会怎样？
A：过期后 Key 自动失效，状态变为「已过期」（红色标识）。使用该 Key 的 Agent 将无法调用。管理员可修改过期时间以恢复使用，或创建新的 Key。
Q：多个 Agent 可以共用一个 API Key 吗？
A：不建议。建议为每个 Agent 用途分配独立的 Key，便于权限隔离、用量审计和安全管控。
Q：删除 API Key 后，审计日志还在吗？
A：在。删除 Key 会释放配额，但历史调用审计日志仍会保留，不会被删除。
Q：「保持与登录用户的空间与权限一致」和「自定义」有什么区别？
A：前者让 Key 的权限随使用者的登录身份动态变化，适合个人助手场景；后者在创建时固定权限范围，适合需要精确控制数据边界的场景（如只允许访问法务部文件）。
如有更多问题，请联系企业管理员或提交工单咨询。