Hangi formatlar destekleniyor?

Vercel AI SDK 4.x (Zod), OpenAI Function Calling (JSON Schema), Anthropic Claude Tools ve TypeScript Interface formatları desteklenmektedir.

AI Function Calling & Tool Definition Builder

OpenAI, Claude ve Vercel AI SDK için tip güvenli araç şemaları (Tool Schemas) ve Zod modelleri oluşturun.

AI Fonksiyon ve Araç (Tool) Tanımlayıcı

OpenAI, Anthropic Claude ve Vercel AI SDK için tip güvenli araç şemaları üretin.

Hazır Şablon:

Fonksiyon Adı (snake_case)

Fonksiyon Açıklaması (LLM Talimatı)

Parametreler (2)

Zorunlu

import { tool } from 'ai'
import { z } from 'zod'

/**
 * Belirtilen coğrafi konum için güncel sıcaklık, nem ve hava durumunu sorgular.
 */
export const getWeatherTool = tool({
  description: 'Belirtilen coğrafi konum için güncel sıcaklık, nem ve hava durumunu sorgular.',
  parameters: z.object({
    location: z.string().describe('Hava durumunun sorgulanacağı şehir veya ilçe adı (örn: Istanbul, TR).'),
    unit: z.enum(['celsius', 'fahrenheit']).describe('Sıcaklık gösterim birimi.').optional(),
  }),
  execute: async ({ location, unit }) => {
    // TODO: Gerçek API çağrısı veya iş mantığınızı burada yürütün
    return {
      success: true,
      timestamp: new Date().toISOString(),
      data: { location, unit },
    }
  },
})

AI Function Calling & Tool Use: Ajanları Dünyaya Bağlayan Köprü

Geleneksel chatbotlar yalnızca metin üretirken, modern yapay zeka ajanları (AI Agents) veritabanı sorgulama, API çağırma, e-posta gönderme veya finansal hesaplamalar yapma gibi gerçek dünya eylemlerini Function Calling (Araç Kullanımı) mekanizmasıyla gerçekleştirir.

LLM'lerin araçları doğru zamanda ve doğru parametrelerle çağırabilmesi için fonksiyon şemalarının (JSON Schema) ve parametre açıklamalarının hatasız tanımlanması gerekir. Bu araç; Vercel AI SDK 4.x (Zod), OpenAI Function Calling, Anthropic Claude Tools ve TypeScript Interface formatlarını tek bir görsel form üzerinden saniyeler içinde üretmenizi sağlar.

Etkili Tool ve Parametre Tanımlama İpuçları

🎯 Açıklama (Description) Kalitesi

Yapay zeka modeli, kodu değil parametre açıklamalarınızı okur. Parametrenin beklenen formatını, birimini (örn: Celsius vs Fahrenheit) veya örnek girdisini .describe() içinde açıkça belirtmek halüsinasyonları %90 oranında engeller.

🛡️ Enum ve Katı Tip Sınırları

Sonsuz string seçenekleri yerine sabit değerler varsa mutlaka enum kullanın. Modelin rastgele metinler üretmesini kısıtlayarak deterministik ve güvenli API çağrıları elde edersiniz.

⚡ Vercel AI SDK 4.x Zod Avantajı

Vercel AI SDK, Zod şemasını otomatik olarak OpenAI/Claude uyumlu JSON Schema'ya dönüştürür. İstemci tarafında hem tip güvenliği sağlar hem de execute bloğuyla doğrudan asenkron iş mantığı yürütür.

Function Calling Sıkça Sorulan Sorular (SSS)

Yapay zeka bu fonksiyonları doğrudan kendi mi çalıştırır?↓

Hayır, LLM doğrudan kod çalıştırmaz. Model, kullanıcının sorusuna yanıt verebilmek için hangi aracı hangi argümanlarla çağırmak istediğini JSON formatında size bildirir (tool call). Sunucunuz bu çağrıyı yürütüp sonucunu tekrar modele iletir ve model nihai cevabı üretir.

OpenAI ile Anthropic Claude tool formatları arasındaki fark nedir?↓

OpenAI { type: "function", function: { ... } } sarmalayıcısını kullanırken, Anthropic Claude doğrudan { name, description, input_schema } yapısını kullanır. Aracımız her iki formatı da eksiksiz biçimde üretir.

Vercel AI SDK ile Next.js Route Handler içinde nasıl kullanılır?↓

Üretilen tool tanımını streamText({ model, tools: { myTool }, maxSteps: 5 }) içine vermeniz yeterlidir. maxSteps sayesinde model otomatik olarak fonksiyonu çalıştırıp çıktıyı okuyarak kullanıcıya yanıt verebilir.