Execute shell commands for system operations, directory creation, and script execution. When you need to run system commands, execute scripts, install packages, or manage processes. Note - if commands fail consecutively, try different approaches.
インストールする前に、エージェントに与えられる指示の中身を確認できます。
执行 Shell 命令。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| command | string | 是 | 要执行的 Shell 命令 |
| cwd | string | 否 | 工作目录（可选） |
| timeout | integer | 否 | 超时时间（秒），默认 60，范围 10-600 |
列出目录:
{"command": "ls -la"}
安装依赖:
{"command": "pip install requests", "timeout": 300}
在指定目录执行:
{"command": "npm install", "cwd": "/path/to/project"}
系统会自动将 PowerShell 命令通过 -EncodedCommand（Base64 UTF-16LE）编码执行，
避免 cmd.exe → PowerShell 的多层引号/特殊字符转义破坏。直接传入 PowerShell 命令即可。
| 场景 | 推荐方式 | 原因 |
|---|---|---|
| 简单系统查询（进程/服务/文件列表） | PowerShell cmdlet | Get-Process, Get-ChildItem 等一行搞定 |
| 复杂文本处理（正则、URL 提取、HTML/JSON 解析） | Python 脚本 | 避免 PowerShell 正则 one-liner 的复杂性 |
| 批量文件操作（重命名、过滤、转换） | Python 脚本 | 更可靠，不受 PowerShell 管道转义影响 |
| 网络下载/HTTP 请求 | Python 脚本 | requests/urllib 比 Invoke-WebRequest 更灵活 |
对于复杂文本处理任务，务必使用 write_file + run_shell 组合：
步骤 1: write_file 写入 data/temp/task_xxx.py
步骤 2: run_shell "python data/temp/task_xxx.py"
禁止：在 run_shell 中写包含复杂正则的 PowerShell one-liner，例如：
# 禁止这种写法
powershell -Command "Get-Content file.html | Select-String -Pattern '(?<=src=\")[^\"]+' | ForEach-Object { $_.Matches.Value } | Sort-Object -Unique | Out-File urls.txt"
应改为写 Python 脚本：
import re
from pathlib import Path
html = Path("file.html").read_text(encoding="utf-8")
urls = sorted(set(re.findall(r'src="([^"]+)"', html)))
Path("urls.txt").write_text("\n".join(urls), encoding="utf-8")
get_session_logs 查看详细日志write-file: 写入文件read-file: 读取文件まだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
Record important information to long-term memory for learning user preferences, successful patterns, and error lessons. When you need to remember user preferences, save successful patterns, or record lessons from errors.
日本語の概要は準備中です。原文の説明を表示しています。
Click page elements by CSS selector or text content. When you need to click buttons, links, or select options. PREREQUISITE - must use browser_navigate to open target page first.
日本語の概要は準備中です。原文の説明を表示しています。
Extract page content and element text from current webpage. When you need to read page information, get element values, scrape data, or verify page content.
日本語の概要は準備中です。原文の説明を表示しています。
List all open browser tabs with their index, URL and title. When you need to check what pages are open, manage multiple tabs, or find a specific tab to switch to.
日本語の概要は準備中です。原文の説明を表示しています。
Navigate browser to specified URL to open a webpage. When you need to open webpages or start web automation. PREREQUISITE - must call before browser_click/type operations. Auto-starts browser if not running.
日本語の概要は準備中です。原文の説明を表示しています。
Open new browser tab and navigate to URL (keeps current page open). When you need to open additional page without closing current, or multi-task across pages. PREREQUISITE - must confirm browser is running first.
日本語の概要は準備中です。原文の説明を表示しています。