managed-agents-tools

# 智能体 — 工具与技能 ## 工具 ### 服务器工具 vs 客户端工具 | 类型 | 运行者 | 工作原理 | |---|---|---| | **预构建 Claude 智能体工具** (`agent_toolset_20260401`) | Anthropic，在会话容器中 | 文件操作、bash、网页搜索等。一次性启用全部或通过 `enabled: true/false` 单独配置。 | | **MCP 工具** (`mcp_toolset`) | Anthropic，在会话容器中 | 由连接的 MCP 服务器暴露的功能。通过工具集按服务器授予访问权限。 | | **自定义工具** | **您** — 您的应用程序处理调用并返回结果 | 智能体发出 `agent.custom_tool_use` 事件，会话进入 `idle`，您发回 `user.custom_tool_result` 事件。 | **建议：** 通过 `agent_toolset_20260401` 启用所有预构建工具，然后根据需要单独禁用。 **版本控制：** 工具集是一个有版本的静态资源。当底层工具发生变化时，会创建一个新的工具集版本（因此有 `_20260401`），这样您总是确切地知道您在使用什么。 ### 智能体工具集 `agent_toolset_20260401` 提供以下内置工具： | 工具 | 说明 | | ---------------------- | ---------------------------------------- | | `bash` | 在 shell 会话中执行 bash 命令 | | `read` | 从本地文件系统读取文件，包括文本、图像、PDF 和 Jupyter 笔记本 | | `write` | 将文件写入本地文件系统 | | `edit` | 在文件中执行字符串替换 | | `glob` | 使用 glob 模式进行快速文件匹配 | | `grep` | 使用正则表达式进行文本搜索 | | `web_fetch` | 从 URL 获取内容 | | `web_search` | 在网络上搜索信息 | 启用完整工具集： { "tools": [ { "type": "agent_toolset_20260401" } ] } ### 单个工具配置 覆盖单个工具的默认设置。此示例启用了除 bash 之外的所有工具： { "tools": [ { "type": "agent_toolset_20260401", "default_config": { "enabled": true }, "configs": [ { "name": "bash", "enabled": false } ] } ] } | 字段 | 必填 | 说明 | |---|---|---| | `type` | ✅ | `"agent_toolset_20260401"` | | `default_config` | ❌ | 应用于所有工具。`{ "enabled": bool, "permission_policy": {...} }` | | `configs` | ❌ | 单个工具覆盖：`[{ "name": "...", "enabled": bool, "permission_policy": {...} }]` | ### 权限策略 控制服务器执行工具（智能体工具集 + MCP）的运行时间