Agent Tool Use Principles

Overview

Tool calling is the primary way Agents interact with the external world, enabling them to take actual actions.

Workflow

1. LLM generates tool call request
2. Runtime parses tool name and parameters
3. Execute corresponding tool function
4. Return result to LLM
5. LLM generates final response

Tool Definition Format

{
  "name": "search",
  "description": "Search web",
  "parameters": {
    "query": {"type": "string"}
  }
}

Parameter Parsing

LLM outputs JSON format parameters, Runtime automatically parses and validates.

Error Handling

When tool execution fails, error info is returned to LLM for retry or adjustment.