İleri Düzey Gemini API Entegrasyonu ile Akıllı Web Asistanı

Giriş: Modern Web Uygulamalarında LLM Devrimi

Yazılım geliştirme dünyasında kullanıcı deneyimini bir üst seviyeye taşımak artık büyük ölçüde yapay zeka entegrasyonlarından geçiyor. Google'ın güçlü dil modeli Gemini, sunduğu esnek API yetenekleriyle projelerimize akıllı asistanlar kazandırmamızı oldukça kolaylaştırıyor. Bu makalede, Gemini API kullanarak web siteniz için nasıl otonom bir asistan geliştireceğinizi teknik detaylarıyla inceleyeceğiz.

Mimari Tasarım ve Gereksinimler

Akıllı web asistanı geliştirirken istemci (client) ile sunucu (server) arasındaki iletişimi güvenli ve performanslı kurmak kritik önem taşır. API anahtarlarını asla doğrudan istemci tarafında (frontend) açığa çıkarmamalıyız. Bunun yerine, bir aracı backend servisi (Node.js veya Python/FastAPI) üzerinden istekleri yönetmeliyiz.

Temel Bileşenler:

• Frontend: Kullanıcı arayüzü ve WebSocket/REST istekleri.
• Backend Proxy: API anahtarlarını gizleyen ve istekleri filtreleyen katman.
• Gemini API: Doğal dil işleme ve yanıt üretme motoru.

Python ve FastAPI ile Backend Servisi Kurulumu

Öncelikle FastAPI kullanarak hafif ve hızlı bir uç nokta (endpoint) oluşturalım. Bu servis, frontend'den gelen kullanıcı girdilerini alıp Gemini API'ye iletecek.

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel
import google.generativeai as genai

app = FastAPI()
genai.configure(api_key='YOUR_GEMINI_API_KEY')

class PromptRequest(BaseModel):
    prompt: str

@app.post('/api/asistan')
async def ask_assistant(request: PromptRequest):
    try:
        model = genai.GenerativeModel('gemini-1.5-pro')
        response = model.generate_content(request.prompt)
        return {'response': response.text}
    except Exception as e:
        raise HTTPException(status_code=500, detail=str(e))

Mimari Uyarı: Üretim ortamında (production) rate limiting ve token maliyetlerini kontrol altında tutmak için istekleri önbelleğe (cache) almayı unutmayın.

Frontend Entegrasyonu

Backend servisimiz hazır olduğuna göre, artık modern JavaScript fetch API kullanarak kullanıcı arayüzümüzden asistanımıza bağlanabiliriz.

async function sendMessage(userPrompt) {
    try {
        const res = await fetch('https://api.hidircanmutlu.com/api/asistan', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({ prompt: userPrompt })
        });
        const data = await res.json();
        console.log('Asistan Yanıtı:', data.response);
    } catch (error) {
        console.error('Bağlantı hatası:', error);
    }
}

Sonuç

Gemini API entegrasyonu, doğru mimari desenler ve güvenlik önlemleri alındığında web uygulamalarınıza katma değeri yüksek özellikler kazandırır. Bu temel yapıyı genişleterek bağlamsal hafıza (context memory) ekleyebilir ve asistanınızı daha akıllı hale getirebilirsiniz.