aws-cleanrooms – 隐私增强数据协作 Skill

Skill 详细介绍

aws/agent-toolkit-for-aws#aws-cleanrooms 是 AWS 官方 agent-toolkit-for-aws 仓库中面向 AWS Clean Rooms 的 Agent Skill。它的定位是给 AI Agent 提供一套 AWS Clean Rooms 的操作知识，帮助用户在隐私增强的数据协作场景中更快完成任务。

它本身不是独立运行的软件，也不是一个独立的 AWS 服务。真正的计算、权限管理和数据协作能力来自 AWS Clean Rooms 服务本身，这个 Skill 提供的是让 Agent 理解并操作 Clean Rooms 的指令、流程和最佳实践。

核心用途

– 帮助创建和管理 AWS Clean Rooms 协作（Collaboration）
– 指导配置成员、分析规则和查询模板
– 协助编写与调试 Clean Rooms SQL 查询
– 解释 Clean Rooms 的隐私保护机制，比如差分隐私和聚合阈值
– 在多个参与方之间搭建受控的数据分析流程

主要解决的问题

AWS Clean Rooms 的配置链路比较长：需要创建协作、邀请成员、配置数据表、定义分析规则、运行查询。对不熟悉的用户来说，每一步都有权限和隐私上的要求。这个 Skill 让 Agent 能理解这套流程，在用户描述业务需求后给出具体的配置步骤和查询方案。

适合谁

– 使用 AWS Clean Rooms 做跨组织数据分析的数据工程师
– 需要在广告、零售、金融等场景做隐私合规数据协作的团队
– 已经在用 AWS 全家桶、希望把 Clean Rooms 接入日常 Agent 工作流的开发者

不适合

– 想找数据分析可视化工具的用户
– 没有 AWS 账号或不打算使用 AWS 云服务的用户
– 单纯需要 SQL 查询帮助、不涉及跨组织数据协作的场景

和普通 Agent 能力的区别

普通 Agent 对 AWS Clean Rooms 的理解通常停留在通用知识层面，容易在协作配置、分析规则、隐私参数这些细节上给出泛泛或过时的建议。这个 Skill 把 Clean Rooms 的具体操作路径注入 Agent 上下文，让 Agent 在回答问题时更贴近实际控制台和 API 的行为。

需要注意的是，Skill 本身不等于服务。真正执行查询、管理数据和计费的是 AWS Clean Rooms，Agent 不会绕过 AWS 的权限体系直接访问数据。

Skill 安全评估

总体判断：这是一个来源可信、行为边界比较清晰的 AWS 官方 Skill。它主要涉及的是对 AWS 服务的使用指导，不是执行任意本地命令的工具。

来源可信度

该 Skill 来自 AWS 官方仓库 aws/agent-toolkit-for-aws，属于云服务厂商自己维护的 Agent 工具集。相比第三方重新发布的同名内容，来源上更值得信任。

可能涉及的行为

– 网络访问：在协助操作 Clean Rooms 时，Agent 可能需要调用 AWS CLI、SDK 或 API，产生对 AWS 端点的网络请求。
– AWS 凭证：要真正执行操作，需要有效的 AWS 凭证（如 access key、IAM 角色或 SSO 会话）。这是操作 AWS 服务的通用前提，不是这个 Skill 独有的要求。
– 文件读取：如果用户让 Agent 读取本地 SQL 文件、配置或数据 schema，会发生文件读取。
– Shell 执行：如果用户希望 Agent 直接运行 AWS CLI 命令，会涉及 Shell 权限。

需要关注的风险点

1. 凭证泄露：把 AWS 凭证放进对话上下文或让 Agent 代为执行命令，凭证可能被记录在对话历史、日志或本地文件中。建议使用权限最小化的 IAM 角色，必要时用临时凭证。
2. 权限过宽：如果给 Agent 使用的 IAM 身份权限过大，一旦误操作可能影响生产资源。建议为 Agent 单独创建受限的 IAM 用户或角色。
3. 自动执行命令：让 Agent 自动执行 AWS CLI 有误删、误改资源的可能。对删除协作、修改分析规则这类破坏性操作，建议保留人工确认环节。
4. 数据合规：Clean Rooms 场景本身涉及跨组织数据协作，把真实数据 schema、成员信息、查询内容交给 Agent 处理时，需要遵守所在组织的数据治理要求。

降低风险的建议

– 如果只是需要 Skill 帮助生成配置步骤或 SQL，可以关闭 Agent 自动执行 Shell 的权限，由用户手动复制执行。
– 为 Agent 使用独立、权限最小化的 AWS 身份，不要复用管理员账号。
– 不要在对话中粘贴长期有效的 access key，优先使用临时凭证或 IAM 角色。
– 涉及删除、修改协作的操作，先让 Agent 只输出命令，人工审核后再执行。

Skill 使用要求

一、Agent / 客户端

这个 Skill 来自 AWS 官方 agent-toolkit-for-aws 仓库。官方没有提供完整的第三方 Agent 兼容列表。从 Agent Skill 的工作方式来看，在支持 Skills、自定义 Skill 或类似指令加载机制的环境中，通常可以尝试在 Claude Code、Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent 中使用，不同 Agent 的加载方式和兼容程度可能不同，具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

| 项目 | 要求 |
|—|—|
| Agent | 支持 Skill 加载机制的 Agent，优先在官方主要面向的 Agent 中使用 |
| AWS 账号 | 要实际使用 Clean Rooms 相关功能时必需 |
| AWS CLI 或 AWS SDK | 当需要 Agent 协助执行或生成命令时，通常需要本地已配置好 |
| 网络 | 需要访问 AWS 服务端点 |
| 其他依赖 | 官方资料未明确列出额外运行时依赖，以该 Skill 当前官方说明为准 |

具体的 Python、Node.js 版本等硬性依赖，官方资料未明确说明，使用前可查看该 Skill 自身说明。

三、权限

– 文件读取：可选，用于读取用户提供的 SQL、schema 或配置文件
– 文件写入：可选，用于保存生成的脚本或配置
– Shell / CLI 执行：可选，用于实际运行 AWS CLI 命令
– 网络访问：必需，用于访问 AWS 服务
– AWS 凭证：要实际调用 AWS 时必需

哪些权限是必需、哪些是可选，取决于用户是只想让 Agent 给出方案，还是希望 Agent 直接执行。

四、账号 / API Key

该 Skill 本身不需要额外的账号或 API Key。但如果要让 Agent 实际操作 AWS Clean Rooms，用户的 AWS 环境中需要有对应的账号、IAM 权限和已配置好的凭证。这两者不要混在一起：Skill 是知识层，AWS 凭证是执行层的需求。

最小使用条件

1. 一个支持 Skill 加载的 AI Agent
2. 一个 AWS 账号（要实际执行操作时）
3. 本地已配置 AWS CLI / SDK 与有效凭证（要执行操作时）
4. 可访问 AWS 服务端点的网络环境

Skill 安装、使用与卸载教程

一、安装

可以直接复制本页面提供的 Skill 安装指令，粘贴到对应 Agent 或终端执行。

如果不清楚自己的 Agent 如何安装 Skill，可以直接询问当前 Agent：

如何安装 aws/agent-toolkit-for-aws#aws-cleanrooms？

如何在 Claude Code 中安装 aws/agent-toolkit-for-aws#aws-cleanrooms？

如何在 Cursor 中安装 aws/agent-toolkit-for-aws#aws-cleanrooms？

让 Agent 根据自己的 Skill 加载与管理机制来指导安装，比手动猜测目录更稳妥。

二、安装后如何使用

安装后，Agent 在遇到 AWS Clean Rooms 相关任务时会自动参考该 Skill。用户也可以显式点名使用。

适合交给这个 Skill 的任务：

– 设计一个跨组织的数据协作方案
– 编写 Clean Rooms 查询 SQL
– 排查协作配置中的权限或规则问题
– 梳理 Clean Rooms 的计费与隐私参数

自然语言使用示例：

使用 aws-cleanrooms，帮我设计一个和广告合作伙伴做受众匹配的 Clean Rooms 协作方案。

使用 aws-cleanrooms，帮我写一段在 Clean Rooms 里做聚合统计的 SQL，并说明聚合阈值怎么设置。

使用 aws-cleanrooms，检查我现在的协作配置，看看成员权限和分析规则有没有问题。

描述需求时，尽量写清楚参与方数量、数据类型、期望的分析方式，Agent 给出的方案会更贴近实际情况。

三、卸载

不同 Agent 的 Skill 安装位置和管理方式可能不同。可以：

– 使用对应 Agent / Skill 管理器提供的删除方式
– 删除对应的 Skill 文件或目录
– 直接询问当前 Agent：“如何卸载 aws/agent-toolkit-for-aws#aws-cleanrooms？”

如果没有统一的卸载命令，直接问当前 Agent 通常更稳妥。

常见问题

这个 Skill 会自己访问我的 AWS 数据吗？

不会。Skill 本身是知识层，真正访问 AWS 的是 Agent 通过你配置的凭证发起的调用。如果你不给 Agent 执行权限，它只能生成方案和命令。

没有 AWS 账号能用吗？

可以阅读它给出的方案和 SQL 思路，但无法实际执行 Clean Rooms 操作。要真正跑起来必须有 AWS 账号和相应权限。

它和通用的 AWS 知识有什么区别？

通用知识偏原理，这个 Skill 更贴近 Clean Rooms 的实际操作路径，包括协作配置、分析规则和隐私参数这些细节。具体差异以该 Skill 当前官方内容为准。

可以同时装到多个 Agent 里吗？

可以。Skill 是文件/指令层的资源，只要目标 Agent 支持 Skill 加载，就能分别安装。注意各 Agent 的加载方式可能不同。

Skill 更新后需要重装吗？

取决于 Agent 的 Skill 管理方式。如果 Agent 支持自动同步或重新拉取，通常不需要手动重装；如果是手动复制安装，可能需要重新获取最新版本。建议直接询问当前 Agent。

在中国大陆使用有网络要求吗？

需要能访问 AWS 服务端点。具体连通性以你所处的网络环境和 AWS 区域配置为准。

安装后 Agent 好像没识别到 Skill，怎么办？

先确认 Skill 是否放到了 Agent 期望的目录，再确认 Agent 是否需要重启或重新加载。可以直接问当前 Agent：“我安装了 aws/agent-toolkit-for-aws#aws-cleanrooms，但没生效，帮我排查一下。”