docs/docs/cn/ai-employees/permission.md
AI 员工的权限管理包含两个层面:
本文档将详细说明这两种权限的配置方式和工作原理。
进入 User & Permissions 页面，点击 Roles & Permissions 标签页，进入角色配置页面。
选择一个角色，点击 Permissions 标签页，然后点击 AI employees 标签页，这里会显示 AI 员工插件中管理的 AI 员工列表。
点击 AI 员工列表 Available 列的勾选框，控制当前角色是否可以访问该 AI 员工。
当 AI 员工处理数据时，权限控制方式取决于使用的工具类型:
以下工具会严格按照当前用户的数据权限进行数据访问:
| 工具名称 | 说明 |
|---|---|
| Data source query | 使用数据源、数据表和字段查询数据库 |
| Data source records counting | 使用数据源、数据表和字段统计记录总数 |
工作原理:
当 AI 员工调用这些工具时，系统会:
示例场景:
假设销售人员 A 只能查看自己负责的客户数据，当他使用 AI 员工 Viz 分析客户时:
Data source query 查询客户表这确保了 AI 员工不会突破用户自身的数据访问边界。
通过工作流自定义的业务查询工具，其权限控制独立于用户权限，由工作流的业务逻辑决定。
这类工具通常用于:
在 CRM Demo 中，Overall Analytics 是一个模板化的业务分析引擎:
| 特性 | 说明 |
|---|---|
| 实现方式 | 工作流读取预配置的 SQL 模板，执行只读查询 |
| 权限控制 | 不受当前用户权限限制，输出由模板定义的固定业务数据 |
| 适用场景 | 针对特定业务对象(如线索、商机、客户)提供标准化的整体分析 |
| 安全性 | 所有查询模板由管理员预先配置和审核，避免动态生成 SQL |
工作流程:
flowchart TD
A[AI 员工接收任务] --> B[调用 Overall Analytics 工具]
B --> C[传入 collection_name 参数]
C --> D[工作流匹配对应的分析模板]
D --> E[执行预配置的 SQL 查询]
E --> F[返回业务分析数据]
F --> G[AI 员工生成图表和洞察]
关键特性:
在 CRM Demo 中，SQL Execution 是一个更灵活但需要严格控制的工具:
| 特性 | 说明 |
|---|---|
| 实现方式 | 允许 AI 生成并执行 SQL 语句 |
| 权限控制 | 由工作流控制谁可以访问，通常仅限管理员 |
| 适用场景 | 高级数据分析、探索性查询、跨表聚合分析 |
| 安全性 | 需在工作流中限制只读操作(SELECT)，并通过任务配置控制可用性 |
安全建议:
示例配置:
任务提示词约束:
- 只能查询 CRM 相关表(leads, opportunities, accounts, contacts)
- 只能执行 SELECT 查询
- 时间范围限制在最近 1 年内
- 返回结果不超过 1000 条记录
| 业务场景 | 推荐工具类型 | 权限策略 | 原因 |
|---|---|---|---|
| 销售人员查看自己的客户 | 系统内置查询工具 | 遵循用户权限 | 确保数据隔离，保护业务安全 |
| 部门经理查看团队数据 | 系统内置查询工具 | 遵循用户权限 | 自动应用部门数据范围 |
| 高管查看全局业务分析 | 工作流自定义工具 / Overall Analytics | 独立业务逻辑 | 提供标准化的整体视角 |
| 数据分析师探索性查询 | SQL Execution | 严格限制可用对象 | 需要灵活性，但必须控制访问范围 |
| 普通用户查看标准报表 | Overall Analytics | 独立业务逻辑 | 固定分析口径，无需关心底层权限 |
对于敏感业务场景，建议采用多层权限控制:
示例:
场景:只有财务部门可以使用 AI 进行财务分析
- AI 员工权限:仅财务角色可访问 "Finance Analyst" AI 员工
- 任务配置:财务分析任务仅在财务模块显示
- 工具设计:财务工作流工具验证用户部门
- 数据权限:财务表的访问权限仅授予财务角色
A: 取决于使用的工具类型:
A: 采用多层防护:
A: 使用工作流自定义业务工具:
A:
| 对比维度 | Overall Analytics | SQL Execution |
|---|---|---|
| 灵活性 | 低(仅能使用预配置模板) | 高(可动态生成查询) |
| 安全性 | 高(所有查询预先审核) | 中(需要约束和验证) |
| 适用对象 | 普通业务人员 | 管理员或高级分析师 |
| 维护成本 | 需要维护分析模板 | 无需维护，但需要监控 |
| 数据一致性 | 强(标准化口径) | 弱(查询结果可能不一致) |