文档中心

AgentKit

策略管理

创建访问规则

访问规则用于定义用户对资源的访问权限，即明确“哪些用户可以对哪些资源执行什么操作”，从而控制用户、部门或用户组对 Agent 和 MCP 工具的访问范围。

您无需手动编写 Cedar 策略语句，可通过四步可视化向导依次选择规则模板、配置目标资源、指定人员范围，并确认规则效果。系统会根据配置自动生成对应的策略语句，降低权限配置门槛和语法错误风险。

为什么配置访问规则

配置访问规则的作用，是将业务中的权限边界转化为系统可以执行的授权策略。当用户访问 Agent，或 Agent 调用 MCP 工具时，系统会根据当前已生效的规则进行权限判定，决定本次请求是允许还是拒绝。

控制资源访问范围

明确哪些用户、部门、用户组或登录来源可以访问指定 Agent 或 MCP 工具，避免资源向无关人员开放。

落实最小权限原则

仅向用户授予完成工作所必需的 Agent 或工具权限，减少不必要的权限暴露和过度授权。

保护敏感资源

针对涉及敏感数据、高风险操作、写操作或生产环境的资源，可以配置更严格的人员范围，或使用拒绝规则限制指定用户访问。

支持组织权限动态管理

通过部门、用户组等组织关系配置权限后，人员加入或退出对应范围时，权限可随组织关系变化，减少逐个用户维护规则的成本。

推荐场景

授权指定主体访问工具或 Agent

当某个部门、用户组或用户需要调用一个或多个工具或 Agent 时，可新建访问规则授予对应权限。例如，为某个业务团队开放指定工具调用权限，或允许特定用户访问某个 Agent。

限制部分用户访问指定资源

当某些工具或 Agent 涉及敏感数据、高风险操作或仅面向特定人群开放时，可通过访问规则限制访问范围，避免无关用户调用相关资源。

资源上线前校验权限边界

在工具、Agent 或相关能力上线前，可提前配置访问规则，并通过模拟判定验证不同用户、部门或用户组的访问结果，确保上线后权限边界符合预期。

人员或组织范围变更后调整权限

当用户加入或退出部门、用户组成员发生变化，或业务团队职责调整时，应同步检查并更新访问规则，确保新增成员获得必要权限，离开成员不再保留访问能力。

前提条件

创建用户池

访问规则需要通过用户池识别调用者身份及其所属部门、用户组等信息。请先完成用户池创建，并确保目标用户已加入用户池。已完成用户池创建，详情请参见创建用户池。

注册或创建目标资源

根据访问规则管控的对象类型，完成以下任一资源准备：

说明

工具和 Agent 两类资源可按需选择。若需要同时管控 Agent 入口和 MCP 工具调用，请分别创建对应的访问规则。

对象类型为工具：选择对象类型为工具，请先创建 MCP 服务，并在服务中配置需要管控的工具。规则将在工具调用实际发起前执行权限判定。

对象类型为 Agent：请先创建智能体运行时，并确保目标 Agent 已部署到该智能体运行时。规则将在请求进入 Agent 智能体运行时执行权限判定。

准备访问主体

根据规则所需的人员范围，完成相应配置：

按部门授权：请先在用户池中创建部门，并将目标用户加入对应部门，详情请参见部门维度管理用户。

按指定用户授权：请确认目标用户已存在于所选用户池和登录来源中，详情请参见创建用户。

操作步骤

步骤一：进入访问规则配置页面

登录AgentKit控制台。

在左侧导航树，选择“身份与权限 > 权限管控”。

单击“新建访问规则”按钮，进入访问规则配置页面。

步骤二：选模板

模板用于快速选定访问权限的基础方案。选中模板后，系统将依据模板预置授权规则，并自动展示对应的后续配置项。建议优先选用与业务需求最匹配的模板；当向导模板无法满足特殊权限条件时，再使用自定义语句，手动编写 Cedar 权限策略。

选择目标模板。不同模板适用的场景请见下表：

说明

长期权限优先按部门限定使用范围，临时或例外权限使用指定用户。避免长期维护大量个人授权。

优先按部门 / 用户组授权而非点名到个人，可显著降低后续人员变更带来的维护成本。

模板	规则效果	适用场景
全员可用	允许所选登录来源下的全部用户访问目标资源并执行指定操作。	适用于面向公司内部或特定登录来源公开的 Agent、MCP 工具等资源。使用前请确认资源不涉及敏感数据或高风险操作，避免授权范围过大。
只允许某部门	仅允许所选部门范围内的用户访问目标资源，所选部门之外的用户无法通过本条规则获得权限。	适用于仅向特定部门开放的资源，例如研发工具、部门知识助手或内部业务 Agent。配置时请选择实际需要使用该资源的部门。
只允许指定人	仅允许选中的用户访问目标资源，未被选中的用户无法通过该规则获得权限。	适用于小范围授权场景，例如项目核心成员、临时协作人员、测试用户或特定负责人。
拒绝指定人使用	明确禁止所选用户访问指定资源或执行相应操作。	适用于在已配置允许规则开放资源访问权限的基础上，叠加拒绝规则，对部分主体做权限拦截。例如：团队整体成员已获准调用某个工具，可额外配置本条拒绝规则，禁止指定人员使用该工具。系统默认策略：未命中任何允许规则的访问请求，默认拒绝。注意判定逻辑：当同一请求同时命中允许规则和拒绝规则时，拒绝规则优先生效。如果请求未命中任何允许规则，系统按照默认拒绝处理。
自定义语句	通过 Cedar 策略语句自定义访问主体、操作、目标资源和生效条件，满足标准模板无法覆盖的复杂权限需求。	适用于需要组合多个主体、资源、操作或条件表达式的精细化授权场景。建议由熟悉 Cedar 语法和业务权限模型的用户配置，并在发布前检查策略语句、执行模拟判定。说明建议优先选择可视化方式配置访问规则。只有业务权限条件无法通过可视化列表表达、内置模板无法覆盖场景时，才使用自定义语句。

请在“规则名称”输入框中填写本条访问规则的名称，便于后续快速识别、检索与管理。

该项为选填项，若不填写，系统将自动生成规则名称。

单击“下一步”按钮，进入选择资源/编写规则页面。

步骤三：选择资源或编写规则

确定访问规则的目标资源及具体授权条件，即明确规则要保护哪个 Agent 或工具，以及允许或拒绝哪些访问行为。根据步骤一选择的模板展示不同配置方式有所不同：

选择内置模板时，通过可视化选择资源。

选择“自定义语句”时，进入策略编辑区编写完整规则。

当前内置的固定模板不支持直接选择用户组。需要按用户组授权时，请选择自定义语句，并在 Cedar 策略中填写目标用户组的唯一 ID。

可视化选择资源模板

自定义语句

选定本条访问规则需要管控的资源类型，支持工具和 Agent。

说明

工具、Agent 不可同时配置，选定其中一类对象类型后，只能选择该类型下的资源。

工具：用于管控 MCP 工具的调用权限。

调用权限：当系统准备调用目标 MCP 工具时，将会立刻触发本条访问规则校验，校验通过才允许发起工具调用，拦截不符合规则的工具访问请求。

适用场景：允许或限制指定用户、用户组等调用敏感工具，例如数据写入、代码修改、文件删除等高风险操作。

Agent：用于管控 Agent 的入口调用权限。

调用权限：当外部请求送入 Agent 运行环境时，会立刻触发本条访问规则校验，校验通过后 Agent 才会继续处理该请求，拦截不符合规则的 Agent 访问请求。

适用场景：允许或限制指定用户、用户组等访问某个 Agent，例如生产环境 Agent、内部专用 Agent 或灰度测试 Agent。

根据选择的对应资源类型，选择对应的资源。

MCP 工具资源
Agent 资源
勾选需要管控的单个工具，例如 Add、Divide、Multiply、Subtract。
（可选）若找不到目标工具，可单击蓝色链接“未找到工具？按服务填写工具名”后，手动录入对应服务下的工具名称。

勾选或手动录入对应工具名称后，即为当前访问规则绑定需要管控的 MCP 工具资源。
勾选需要管控的单个 Agent 运行时实例。
（可选）在顶部搜索框输入 Agent 名称，快速检索目标 Agent。