@google/genai SDK'sı ile Next.js Projelerinde Yapay Zeka Ajanları Geliştirmek

Yapay zeka modellerini uygulamalarımıza entegre etmek artık bir lüks değil, standart haline geldi. Google'ın yeni çıkardığı resmi

@google/genai

SDK'sı, Gemini modellerini web projelerimize entegre etmeyi hiç olmadığı kadar kolaylaştırıyor.

Neden Yeni SDK?

Eski

@google/generative-ai

kütüphanesine kıyasla, yeni

@google/genai

SDK'sı:

• Çok daha temiz ve modern bir API sunar.
• Multimodal (görsel, ses, video) girdileri tek bir fonksiyon altında birleştirir.
• Ajan mimarileri için kritik olan Function Calling (Fonksiyon Çağırma) mekanizmasını yerleşik olarak destekler.

Next.js API Route ile Gemini Entegrasyonu

Gelin, Next.js API handler'ı üzerinden bir soru-cevap servisi oluşturalım:

import { GoogleGenAI } from "@google/genai";
import { NextResponse } from "next/server";

// SDK'yı API anahtarı ile başlatıyoruz
const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

export async function POST(req: Request) {
  try {
    const { prompt } = await req.json();
    
    const response = await ai.models.generateContent({
      model: "gemini-2.5-flash",
      contents: prompt,
    });
    
    return NextResponse.json({ text: response.text });
  } catch (error) {
    return NextResponse.json({ error: "İstek işlenirken hata oluştu" }, { status: 500 });
  }
}

Function Calling ile Ajan Tasarımı

Gemini'ın en güçlü özelliklerinden biri, modelin veritabanınızla veya üçüncü parti API'lerle konuşabilmesidir. Örneğin, modelin güncel hava durumunu veya stok bilgisini getirmesini sağlayacak fonksiyonları tanımlayabilirsiniz:

const response = await ai.models.generateContent({
  model: "gemini-2.5-flash",
  contents: "Bugün İstanbul'da hava nasıl ve şemsiye almalı mıyım?",
  config: {
    tools: [{
      functionDeclarations: [{
        name: "getWeather",
        description: "Belirtilen şehrin anlık hava durumunu döner.",
        parameters: {
          type: "OBJECT",
          properties: {
            city: { type: "STRING" }
          },
          required: ["city"]
        }
      }]
    }]
  }
});

Model size doğrudan cevap vermek yerine,

getWeather(city: "Istanbul")

fonksiyonunu çağırmanız gerektiğini belirten bir veri döner. Fonksiyonu kendi sunucunuzda çalıştırıp sonucu tekrar Gemini'a beslediğinizde, kullanıcıya güncel ve doğru bilgiyle harika bir cevap üretir.

Bu SDK sayesinde Next.js projelerinizde kendi kendini yöneten akıllı geliştirici asistanları ve müşteri temsilcileri inşa etmeye bugünden başlayabilirsiniz!