文档中心

火山方舟

定义 Agent

工具权限策略

工具权限策略用于控制 Agent 发起工具调用时，是自动执行，还是暂停等待业务应用确认。

当前权限策略只作用于服务端执行的工具：

权限策略类型

权限策略的默认值取决于是否提供整个 default_config：

配置	内置工具集	MCP 工具集
省略整个 default_config	服务端保存 enabled=true 和 always_allow。	服务端保存 enabled=true 和 always_allow。
提供 default_config，但省略 permission_policy	运行时使用 always_allow。	运行时使用 always_ask。
显式配置 permission_policy	使用配置的策略。	使用配置的策略。

为了让 Agent 回显和运行时行为可直接核对，建议始终显式配置 default_config.enabled 和 default_config.permission_policy。

为整个工具集设置权限策略

你可以在 default_config.permission_policy 中为整个工具集配置统一策略。

下面的示例把内置工具集的默认策略改成 always_ask：

Curl

不要只传 default_config.enabled 而省略 permission_policy。内置工具和 MCP 工具对空策略采用不同的运行时默认值。

为单个工具覆盖权限策略

除了为整个工具集设置默认策略外，你还可以在 configs 中对单个工具做更细粒度的覆盖。

下面的示例保留内置工具集默认自动执行，但要求 bash 每次执行前都先确认：

Curl

这种覆盖关系适合把大部分低风险工具保持自动执行，只对高风险工具额外加一道确认。

为 MCP 工具集设置权限策略

下面的示例将可信 MCP Server 的工具集显式设置为 always_allow，便于直接核对自动执行范围：

Curl

注意

只有在确认 MCP Server 及其暴露工具都可信时，才将策略显式设置为 always_allow。如果 MCP Server 后续新增工具，工具集级的自动放行策略也会作用于新增工具。

使用建议

工具集配置以及 user.tool_confirmation 对应的运行时事件流，详见 Tools。如果你要管理 MCP Server 及其工具，详情请参见 MCP。