Agent Space权限设置不生效，通常因RAM策略未绑定到实际操作账号、Agent容器以root身份运行、工具调用绕过权限代理层、数据集共享链接覆盖权限或缓存未刷新所致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Agent Space权限设置不生效，意味着你已配置RAM策略、空间级角色或数据集访问控制，但Agent仍能越权读取敏感文档、调用未授权工具，或被无权限用户直接进入空间后台。这通常不是策略没保存，而是权限链路中某一层被绕过或未生效。
检查AgentSpace绑定的RAM权限策略是否真正生效
登录阿里云RAM控制台 → 进入“权限管理” → 找到你为该AgentSpace关联的RAM用户/用户组 → 点击“权限策略”标签页 → 查看是否已附加AliyunAgentLoopFullAccess或自定义策略。
重点验证：该策略是否绑定在当前登录并操作AgentSpace的RAM用户上，而非仅绑定在主账号或另一个子用户。很多团队误将策略绑在“运维管理员”账号，但实际用“业务助理”账号登录控制台创建Agent，导致权限不继承。
若使用自定义策略，请确认其Version字段为1，且Resource中明确包含AgentSpace资源ARN（格式如acs:agentloop:cn-shanghai:1234567890123456:agentspace/your-space-name），否则策略默认拒绝所有操作。
确认Agent执行时使用的身份不是root或系统默认账号
AgentSpace本身不运行代码，它调度的Agent实例（如HermesAgent容器）才是实际执行单元。如果容器以root身份运行，它会绕过所有空间级权限控制——因为Linux内核层面的UID=0拥有全部能力，AgentLoop的RBAC策略在进程启动后才介入，此时已晚。
方法一：检查容器启动参数
进入AgentSpace对应ECS或ACK集群，执行：docker inspect hermes-agent | grep -A 5 User。若输出为"User": ""或"User": "0"，说明正以root运行。
方法二：查看Agent日志中的身份声明
在AgentSpace控制台打开“执行日志”，搜索effective uid或running as。若出现uid=0(everybody)，即证实问题根源。
【必须修改】所有生产环境Agent容器禁止使用UID=0启动。应在docker run或compose中显式指定非特权用户，例如--user 1001:1001，并确保镜像中该UID存在且home目录可写。
排查Agent内部工具调用是否跳过权限代理层
AgentSpace的权限控制只作用于“Agent向平台发起的API请求”，比如get_dataset、invoke_tool。但如果Agent代码里硬编码了直连OSS Bucket、Jira API或数据库连接串，并自行发起HTTP请求，这些流量完全绕过AgentSpace网关，权限策略形同虚设。
第一步：在Agent代码中全局搜索requests.get(、urllib.request、httpx.post(等网络调用关键词，确认是否存在未经agentloop-sdk封装的直连逻辑。
第二步：检查Agent所用SDK版本。低于v0.8.3的agentloop-python-sdk存在权限透传缺陷：当Agent调用tool_client.invoke("jira-search")时，若未在调用前显式传入space_id参数，SDK会 fallback 到默认空间上下文，导致权限校验失效。
第三步：启用AgentSpace审计日志。在SLS日志Project中查询__topic__: agent_audit AND action: "bypass_auth"，若返回结果非空，说明至少有一个工具调用被检测为绕过鉴权路径。
验证数据集权限是否被“共享链接”意外覆盖
第一步：进入AgentSpace控制台 → “数据管理” → 找到目标数据集 → 点击“权限设置”。
第二步：检查“共享方式”是否为“仅限本空间成员”，而非“生成公开链接”或“允许通过链接访问”。一旦开启链接分享，任何人拿到URL即可绕过所有RAM和空间角色限制直接下载原始文件。
第三步：在“成员列表”中确认该数据集未被添加进“全局可读”分组（如名为all-employees的RAM用户组）。AgentSpace会优先匹配最宽泛的权限组，即使你给单个用户设了“只读”，只要他属于某个“管理员”组，权限就会上升为“可编辑”。
注意：数据集权限变更后不会实时生效，Agent需重启或清除本地缓存（如~/.hermes/cache/dataset_meta.json）才能加载最新策略。
强制刷新AgentSpace权限缓存
① 登录AgentLoop控制台 → 进入目标AgentSpace → 点击右上角“设置”图标 → 选择“刷新权限缓存”。
② 等待页面提示“缓存刷新任务已提交”，此过程约需40–90秒，期间新权限策略暂不生效。
③ 在“执行日志”中筛选event: "permission_cache_reloaded"，确认日志时间戳与你点击刷新的时间一致。
④ 重新触发一次Agent调用（例如发送测试消息），观察日志中auth_decision字段是否从ALLOWED变为DENIED（或反之），以此验证缓存已更新。
