/ agent-scan / tools / batch / batch_schema.xml
batch_schema.xml
 1  <?xml version="1.0" encoding="UTF-8"?>
 2  <tools>
 3  <tool name="batch">
 4    <description>
 5      Execute multiple tool calls in a single request for optimal performance.
 6      
 7      IMPORTANT RULES:
 8      - Maximum of 10 tool calls per batch
 9      - Cannot nest batch calls (no batch within batch)
10      - Cannot call 'finish' tool within batch
11      - Tools are executed serially to maintain order
12      
13      Use batch when you need to:
14      - Read multiple files at once
15      - Perform several independent operations
16      - Improve response time by reducing round trips
17    </description>
18    <parameters>
19      <parameter name="tool_calls" type="array" required="true">
20        Array of tool calls to execute. Each element must have:
21        - tool: The name of the tool to execute (string)
22        - parameters: Parameters for the tool (object)
23        
24        Example:
25        [
26          {"tool": "read", "parameters": {"file_path": "file1.py"}},
27          {"tool": "read", "parameters": {"file_path": "file2.py"}}
28        ]
29      </parameter>
30    </parameters>
31    <returns>
32      <field name="success" type="boolean">Whether all calls succeeded</field>
33      <field name="title" type="string">Summary of execution</field>
34      <field name="output" type="string">Human-readable result summary</field>
35      <field name="metadata" type="object">
36        Contains: total_calls, successful, failed, tools, details
37      </field>
38    </returns>
39  </tool>
40  </tools>
41