---

name: tool-calling description: Implement tool calling - function schemas, API integration, validation, and error handling sasmp_version: "1.3.0" bonded_agent: 04-tool-calling bond_type: PRIMARY_BOND version: "2.0.0"

Tool Calling

Enable LLMs to call functions and interact with external systems.

When to Use This Skill

Invoke this skill when:

• Adding function calling to agents
• Designing tool schemas
• Integrating external APIs
• Implementing validation and error handling

Parameter Schema

Quick Start

Claude Tool Use

Copyfrom anthropic import Anthropic

tools = [{
    "name": "get_weather",
    "description": "Get weather for a location",
    "input_schema": {
        "type": "object",
        "properties": {
            "location": {"type": "string"}
        },
        "required": ["location"]
    }
}]

response = client.messages.create(
    model="claude-sonnet-4-20250514",
    tools=tools,
    messages=[{"role": "user", "content": "Weather in Tokyo?"}]
)

LangChain Tools

Copyfrom langchain_core.tools import tool

@tool
def search(query: str) -> str:
    """Search the web for information."""
    return web_search(query)

Schema Best Practices

Copy# Good: verb_noun, clear description
{
    "name": "search_products",
    "description": """Search product database.
    USE WHEN: User asks about products.
    DO NOT USE: For order status (use get_order instead)."""
}

# Bad: vague
{"name": "helper", "description": "Helps with stuff"}

Troubleshooting

Best Practices

• Use verb_noun naming convention
• Keep tool count under 20
• Include usage examples in descriptions
• Return errors as tool results

Related Skills

• ai-agent-basics - Agent loops
• llm-integration - API setup
• agent-safety - Input validation

References

• Anthropic Tool Use
• OpenAI Functions