LLM 函式呼叫：2026 年多供應商完整指南

{
  "name": "get_weather",
  "description": "Get the current weather for a given city. Returns temperature, conditions, and humidity.",
  "parameters": {
    "type": "object",
    "properties": {
      "city": {
        "type": "string",
        "description": "The city name, e.g. 'San Francisco'"
      },
      "unit": {
        "type": "string",
        "enum": ["celsius", "fahrenheit"],
        "description": "Temperature unit"
      }
    },
    "required": ["city"]
  }
}

from openai import OpenAI
import json

client = OpenAI()

# Step 1: Define the tool
tools = [
    {
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get current weather for a city. Returns temperature, conditions, and humidity.",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {
                        "type": "string",
                        "description": "The city name, e.g. 'San Francisco'"
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"],
                        "description": "Temperature unit"
                    }
                },
                "required": ["city"]
            }
        }
    }
]

# Step 2: Send request with tools
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "What's the weather in Berlin?"}],
    tools=tools,
    tool_choice="auto"  # "auto", "required", "none", or specific function
)

message = response.choices[0].message

# Step 3: Check if the LLM wants to call a function
if message.tool_calls:
    tool_call = message.tool_calls[0]
    args = json.loads(tool_call.function.arguments)

    # Step 4: Execute the function (your code!)
    weather_result = get_weather(args["city"], args.get("unit", "celsius"))

    # Step 5: Return result to the LLM
    follow_up = client.chat.completions.create(
        model="gpt-4o",
        messages=[
            {"role": "user", "content": "What's the weather in Berlin?"},
            message,  # assistant message with tool_calls
            {
                "role": "tool",
                "tool_call_id": tool_call.id,
                "content": json.dumps(weather_result)
            }
        ],
        tools=tools
    )
    print(follow_up.choices[0].message.content)

import anthropic
import json

client = anthropic.Anthropic()

# Step 1: Define the tool (note: input_schema, not parameters)
tools = [
    {
        "name": "get_weather",
        "description": "Get current weather for a city. Returns temperature, conditions, and humidity.",
        "input_schema": {
            "type": "object",
            "properties": {
                "city": {
                    "type": "string",
                    "description": "The city name, e.g. 'San Francisco'"
                },
                "unit": {
                    "type": "string",
                    "enum": ["celsius", "fahrenheit"],
                    "description": "Temperature unit"
                }
            },
            "required": ["city"]
        }
    }
]

# Step 2: Send request with tools
response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[{"role": "user", "content": "What's the weather in Berlin?"}],
    tools=tools,
    tool_choice={"type": "auto"}  # "auto", "any", or {"type": "tool", "name": "..."}
)

# Step 3: Check for tool_use content blocks
for block in response.content:
    if block.type == "tool_use":
        # Step 4: Execute the function
        weather_result = get_weather(block.input["city"], block.input.get("unit", "celsius"))

        # Step 5: Return tool_result to Claude
        follow_up = client.messages.create(
            model="claude-sonnet-4-20250514",
            max_tokens=1024,
            messages=[
                {"role": "user", "content": "What's the weather in Berlin?"},
                {"role": "assistant", "content": response.content},
                {
                    "role": "user",
                    "content": [
                        {
                            "type": "tool_result",
                            "tool_use_id": block.id,
                            "content": json.dumps(weather_result)
                        }
                    ]
                }
            ],
            tools=tools
        )
        print(follow_up.content[0].text)

from google import genai
from google.genai import types
import json

client = genai.Client()

# Step 1: Define the tool using FunctionDeclaration
get_weather_func = types.FunctionDeclaration(
    name="get_weather",
    description="Get current weather for a city. Returns temperature, conditions, and humidity.",
    parameters=types.Schema(
        type=types.Type.OBJECT,
        properties={
            "city": types.Schema(
                type=types.Type.STRING,
                description="The city name, e.g. 'San Francisco'"
            ),
            "unit": types.Schema(
                type=types.Type.STRING,
                enum=["celsius", "fahrenheit"],
                description="Temperature unit"
            )
        },
        required=["city"]
    )
)

weather_tool = types.Tool(function_declarations=[get_weather_func])

# Step 2: Send request with tools
response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="What's the weather in Berlin?",
    config=types.GenerateContentConfig(
        tools=[weather_tool],
        tool_config=types.ToolConfig(
            function_calling_config=types.FunctionCallingConfig(mode="AUTO")
            # Modes: AUTO, ANY, NONE
        )
    )
)

# Step 3: Check for function_call parts
part = response.candidates[0].content.parts[0]
if part.function_call:
    args = dict(part.function_call.args)

    # Step 4: Execute the function
    weather_result = get_weather(args["city"], args.get("unit", "celsius"))

    # Step 5: Return function_response
    follow_up = client.models.generate_content(
        model="gemini-2.5-flash",
        contents=[
            types.Content(parts=[types.Part(text="What's the weather in Berlin?")], role="user"),
            response.candidates[0].content,  # assistant response with function_call
            types.Content(
                parts=[types.Part(
                    function_response=types.FunctionResponse(
                        name="get_weather",
                        response=weather_result
                    )
                )],
                role="user"
            )
        ],
        config=types.GenerateContentConfig(tools=[weather_tool])
    )
    print(follow_up.text)

import asyncio
import json
from openai import OpenAI

client = OpenAI()

async def execute_tool_call(tool_call):
    """Execute a single tool call and return the result message."""
    args = json.loads(tool_call.function.arguments)

    # Dispatch to the right function
    if tool_call.function.name == "get_weather":
        result = await async_get_weather(args["city"], args.get("unit", "celsius"))
    else:
        result = {"error": f"Unknown function: {tool_call.function.name}"}

    return {
        "role": "tool",
        "tool_call_id": tool_call.id,
        "content": json.dumps(result)
    }

async def handle_parallel_calls(response_message):
    """Execute all tool calls concurrently."""
    if not response_message.tool_calls:
        return []

    # Fire all tool calls in parallel
    tasks = [execute_tool_call(tc) for tc in response_message.tool_calls]
    results = await asyncio.gather(*tasks)
    return list(results)

import asyncio
import json
from pydantic import ValidationError

# Registry of allowed functions and their Pydantic models
TOOL_REGISTRY = {
    "get_weather": {
        "function": get_weather,
        "model": WeatherArgs,  # Pydantic model for argument validation
        "timeout": 10  # seconds
    }
}

async def safe_execute_tool(tool_name: str, raw_args: str) -> str:
    """Execute a tool call with full error handling."""

    # Guard against hallucinated function names
    if tool_name not in TOOL_REGISTRY:
        return json.dumps({
            "error": f"Unknown function '{tool_name}'. Available: {list(TOOL_REGISTRY.keys())}"
        })

    tool = TOOL_REGISTRY[tool_name]

    # Validate arguments with Pydantic
    try:
        args = tool["model"].model_validate_json(raw_args)
    except ValidationError as e:
        return json.dumps({
            "error": f"Invalid arguments for {tool_name}: {e.errors()}"
        })

    # Execute with timeout
    try:
        result = await asyncio.wait_for(
            tool["function"](**args.model_dump()),
            timeout=tool["timeout"]
        )
    except asyncio.TimeoutError:
        return json.dumps({
            "error": f"{tool_name} timed out after {tool['timeout']}s. Try again or use different parameters."
        })
    except Exception as e:
        # Descriptive error, never raw stack traces
        return json.dumps({
            "error": f"{tool_name} failed: {type(e).__name__}: {str(e)}"
        })

    # Sanitize result size
    result_str = json.dumps(result)
    if len(result_str) > 10_000:
        return json.dumps({
            "warning": "Result truncated due to size",
            "data": result_str[:10_000]
        })

    return result_str