更新时间：2026-09-21 GMT+08:00
内置工具
配置智能体的工具。Managed Agents提供内置工具，在会话中执行。
可用工具
智能体内置工具集包含以下工具。
| 工具名称 | 描述 |
|---|---|
| * | 包含所有命令，可以在会话中执行bash命令或文件操作。 |
| bash | 在会话中执行bash命令。 |
| read_file | 读取文本、图片、PDF、Jupyter Notebook、Office文档。 |
| write_file | 写入文件内容（覆盖式）。 |
| edit_file | 精确字符串替换编辑已有文件。 |
| glob | 使用glob模式查找文件。 |
| list_files | 列出目录内容。 |
| grep | 在文件中搜索内容，支持正则表达式。 |
在智能体中使用工具
在自定义创建智能体时，选择工具。
使用工具后显示效果示例
- 场景一：启用工具—文件写入成功
前提条件：在“内置工具（可选）”中勾选“write_file”工具。
命令格式：
python managed_agents_client.py --url "ws://{endpoint}/runtimes/{runtime_name}/ws" --auth "Bearer {api_key}" --message "使用工具write_file创建一个 hello.txt 文件，内容写 Hello World"
终端输出：
[2/5] 已连接 ws://gateway-xxx/ws [3/5] 服务端就绪 [4/5] 已发送: 帮我创建一个 hello.txt 文件，内容写 Hello World [Frame] {"tag":"TOOL_PERMISSION","decision":"ASK","tool":"write_file","rule":"allow_write","source":"system"} [Frame] {"response_kind":"e2a.chunk","status":"in_progress","body":{"event_type":"chat.delta","delta":"我已为您创建了 hello.txt 文件，内容为 Hello World。"}} 我已为您创建了 hello.txt 文件，内容为 Hello World。 [Frame] {"response_kind":"e2a.complete","status":"succeeded","is_final":true,"body":{"result":{"content":"我已为您创建了 hello.txt 文件，内容为 Hello World。"}}} ======================================== ======================================== 回复: 我已为您创建了 hello.txt 文件，内容为 Hello World。 ======================================== [5/5] 已断开 - 场景二：禁用工具—文件写入失败
前提条件：在“内置工具（可选）”中未勾选“write_file”工具。
命令格式：
python managed_agents_client.py --url "ws://{endpoint}/runtimes/{runtime_name}/ws" --auth "Bearer {api_key}" --message "使用工具write_file创建一个 hello.txt 文件，内容写 Hello World"
终端输出：
[2/5] 已连接 ws://gateway-xxx/ws [3/5] 服务端就绪 [4/5] 已发送: 帮我创建一个 hello.txt 文件，内容写 Hello World [Frame] {"response_kind":"e2a.chunk","status":"in_progress","body":{"event_type":"chat.delta","delta":"抱歉，文件写入工具当前不可用，无法为您创建文件。您可以在工具配置中启用 write_file 后重试。"}} 抱歉，文件写入工具当前不可用，无法为您创建文件。您可以在工具配置中启用 write_file 后重试。 [Frame] {"response_kind":"e2a.complete","status":"succeeded","is_final":true,"body":{"result":{"content":"抱歉，文件写入工具当前不可用，无法为您创建文件。您可以在工具配置中启用 write_file 后重试。"}}} ======================================== 回复: 抱歉，文件写入工具当前不可用，无法为您创建文件。您可以在工具配置中启用 write_file 后重试。 ======================================== [5/5] 已断开
