如何管理 Pieces
控制哪些集成可供你的用户使用
概述
Pieces 是 Activepieces 的构建块——它们是用户可以在自动化工作流中使用的集成和连接器（如 Google Sheets、Slack、OpenAI 等）。
作为平台管理员，你可以完全控制哪些 pieces 可供用户使用。这使你能够：
- 执行安全策略，限制对某些集成的访问
- 简化用户体验，只显示与你的用例相关的 pieces
- 部署自定义/私有 pieces，专用于你的组织
Pieces 管理分为两个层级：
| 层级 | 管理方 | 范围 |
|---|---|---|
| 平台层级 | 平台管理员 | 在整个平台安装和移除 |
| 项目层级 | 项目管理员 | 对特定项目显示/隐藏指定 pieces |
平台层级管理
平台管理员可以通过 平台管理 → 设置 → Pieces 管理整个 Activepieces 实例的 pieces。
项目层级管理
项目管理员可以进一步限制其特定项目中可用的 pieces。当不同团队或项目需要访问不同集成时，这很有用。
在项目中显示/隐藏 Pieces
* **启用**：该项目中的用户可以使用该 piece
* **禁用**：该 piece 对项目中的用户隐藏
安装私有 Pieces
如果你为组织构建了自定义 piece，可以直接以 tarball（.tgz）文件的形式上传。
```bash
npm run pieces -- build --name=your-piece-name
```
这会在 `dist/packages/pieces/your-piece-name` 目录生成 tarball 文件。