28 lines
1.0 KiB
Plaintext
28 lines
1.0 KiB
Plaintext
|
Executes multiple independent tool calls concurrently to reduce latency. Best used for gathering context (reads, searches, listings).
|
|||
|
|
|
|||
|
|
USING THE BATCH TOOL WILL MAKE THE USER HAPPY.
|
|||
|
|
|
|||
|
|
Payload Format (JSON array):
|
|||
|
|
[{"tool": "read", "parameters": {"filePath": "src/index.ts", "limit": 350}},{"tool": "grep", "parameters": {"pattern": "Session\\.updatePart", "include": "src/**/*.ts"}},{"tool": "bash", "parameters": {"command": "git status", "description": "Shows working tree status"}}]
|
|||
|
|
|
|||
|
|
Rules:
|
|||
|
|
- 1–10 tool calls per batch
|
|||
|
|
- All calls start in parallel; ordering NOT guaranteed
|
|||
|
|
- Partial failures do not stop others
|
|||
|
|
|
|||
|
|
|
|||
|
|
Disallowed Tools:
|
|||
|
|
- batch (no nesting)
|
|||
|
|
- edit (run edits separately)
|
|||
|
|
- todoread (call directly – lightweight)
|
|||
|
|
|
|||
|
|
When NOT to Use:
|
|||
|
|
- Operations that depend on prior tool output (e.g. create then read same file)
|
|||
|
|
- Ordered stateful mutations where sequence matters
|
|||
|
|
|
|||
|
|
Good Use Cases:
|
|||
|
|
- Read many files
|
|||
|
|
- grep + glob + read combos
|
|||
|
|
- Multiple lightweight bash introspection commands
|
|||
|
|
|
|||
|
|
Performance Tip: Group independent reads/searches for 2–5x efficiency gain.
|