Tool Calling Safety and Validation

Documentation Index

Fetch the complete documentation index at: https://docs.ai-stats.phaseo.app/llms.txt

Use this file to discover all available pages before exploring further.

​

Safety checklist

• Keep tool schemas minimal and explicit.
• Validate parsed arguments before execution.
• Allowlist tool names; reject unknown tools.
• Add timeouts and retries for external calls.
• Log call id, tool name, and validation failures.

​

Request validation example (TypeScript + Zod)

import { z } from "zod";

const WeatherArgs = z.object({
  city: z.string().min(1),
});

function executeToolCall(name: string, rawArgs: string) {
  if (name !== "get_weather") {
    throw new Error(`Unsupported tool: ${name}`);
  }

  const parsed = WeatherArgs.parse(JSON.parse(rawArgs));
  return getWeather(parsed.city);
}

​

Failure strategy

1. Do not execute the tool.
2. Return a controlled error payload into the next model turn.
3. Ask the model to retry with corrected arguments.

​

Streaming note