跳转到主要内容
千问AI平台 home page
文档
构建 Agent

Agent 工具配置

Managed Agents 提供 7 个内置工具，覆盖命令执行、文件操作与产出物标记，全部在会话绑定的运行环境中执行。

工具列表

在智能体编辑页的工具区按需勾选。勾选的工具对该智能体的全部会话生效。
工具作用典型用途
bash在沙箱中执行 shell 命令运行脚本、安装包、调用 CLI
write写入文件生成报告、保存中间结果
read读取文件内容查看挂载的 CSV、日志、配置文件
edit按字符串替换修改文件小范围改动比全量写入更安全
glob按模式查找文件定位目标文件，例如 *.csv
grep在文件中搜索文本日志排查、关键词定位
mark_artifacts标记智能体产出的结果文件，返回其 file_id供业务侧按需下载或展示最终交付物

执行机制

全部内置工具在会话绑定的运行环境中执行，工具产生的文件、安装的依赖在该会话生命周期内持久保留。 智能体根据系统提示词和当前消息自主决定调用哪个工具，调用过程通过事件面板实时可见。

审批策略

在智能体编辑页的工具区展开某个工具，可单独设置该工具的审批策略，控制其被调用前是否需要人工确认：
策略行为
总是允许默认值。智能体调用该工具时直接执行，不打断流程
每次询问每次调用前暂停，等待用户在会话中确认后才继续执行
对高风险工具（如 bash）设为每次询问，可在保留自动化能力的同时，对敏感操作保留人工闸门。当工具被设为每次询问时，智能体在会话中调用它会先暂停并等待确认。通过 API 集成时，如何在事件流中接收审批请求并回应，详见 会话事件流。

审批的适用范围

工具审批仅支持主智能体，不支持在子智能体中使用。
客户端工具（function / custom 等）不参与这套审批机制，其执行由客户端自行控制。
此外，会话在创建时锁定当时的 Agent 版本。修改 Agent 的审批策略不会追溯影响已存在的会话，需新建会话才会使用新配置。

通过 API 配置审批策略

除控制台外，审批策略也可在创建 / 更新 Agent 时通过 tools 字段声明。在 builtin_toolkit 项的 default_config 中设置工具包默认策略，并可在 configs[] 中对单个工具单独覆盖： 
{
  "tools": [
    {
      "type": "builtin_toolkit",
      "default_config": {
        "enabled": true,
        "permission_policy": {"type": "always_allow"}
      },
      "configs": [
        {
          "name": "bash",
          "enabled": true,
          "permission_policy": {"type": "always_ask"}
        }
      ]
    }
  ]
}
配置规则：
  • permission_policy 只接受对象形态 {"type": "always_allow"} 或 {"type": "always_ask"}，不能传字符串，否则返回参数错误。
  • configs[] 中单个工具的策略覆盖 default_config 的同名配置；某工具未在 configs[] 指定时，沿用 default_config。
  • MCP 工具的审批策略配置在 tools[] 中 type 为 mcp_toolkit 的项的 default_config / configs 字段，不在 mcp_servers[] 中设置。
  • 全部省略时，默认策略为 always_allow。
字段完整定义详见 Agent API。

下一步

  • 定义 Agent：在智能体编辑页勾选需要的工具。
  • Agent MCP：通过 MCP 协议接入更多外部工具。
  • 发起会话：在会话中观察工具调用过程。
Agent 工具配置 - 千问AI平台