# 内置工具
配置智能体的工具。Managed Agents提供内置工具，在会话中执行。
#### 可用工具
智能体内置工具集包含以下工具。
表1内置工具 
| 工具名称      | 描述                                     |
|:---|:---|
| \*            | 包含所有命令，可以在会话中执行bash命令或文件操作。               |
| bash        | 在会话中执行bash命令。                            |
| read_file  | 读取文本、图片、PDF、Jupyter Notebook、Office文档。 |
| write_file | 写入文件内容（覆盖式）。                            |
| edit_file   | 精确字符串替换编辑已有文件。                           |
| glob        | 使用glob模式查找文件。                             |
| list_files | 列出目录内容。                                  |
| grep      | 在文件中搜索内容，支持正则表达式。                       |
   
#### 在智能体中使用工具
在自定义创建智能体时，选择工具。
![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002759376541.png)
#### 使用工具后显示效果示例
- **场景一：启用工具---文件写入成功**
  前提条件：在"内置工具（可选）"中勾选"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] 已断开
  ```
  
 
#### 后续步骤
[将工作交给智能体](https://support.huaweicloud.com/managedagents-agentarts/agentarts_13_0015.html)