Ne Aramıştınız?
Makaleler, projeler ve kaynaklar arasında arama yaparak size özel fikirler, bilgiler ve ilham kaynakları keşfedin.
Takip et
Ne Aramıştınız?
Makaleler, projeler ve kaynaklar arasında arama yaparak size özel fikirler, bilgiler ve ilham kaynakları keşfedin.
Takip et
Kategoriler
Son Yazılar

Yapay Zeka Destekli Topluluk Asistanı: Google Cloud, Vercel AI SDK ve Takvim API Entegrasyonu

Topluluk yönetimi, günümüzün dijital dünyasında hiç olmadığı kadar kritik bir role sahip. Etkinlik planlamadan üye etkileşimine kadar birçok sorumluluk, yöneticiler için zaman alıcı ve yorucu olabilir. Peki, yapay zekanın gücünü kullanarak bu süreci nasıl otomatikleştirebilir ve topluluğunuzu bir üst seviyeye taşıyabilirsiniz? Bu makalede, Google Cloud Platform, Vercel AI SDK ve Google Calendar API’yi bir araya getirerek akıllı bir topluluk asistanı geliştirme sürecini adım adım inceleyeceğiz.

Modern topluluklar, çevrimiçi forumlardan sosyal medya gruplarına, hatta özel mesajlaşma platformlarına kadar geniş bir yelpazede faaliyet gösteriyor. Bu dinamik ekosistemlerde üyelerin etkileşimini sürdürmek, etkinlikleri düzenlemek, duyuruları yapmak ve soruları yanıtlamak gibi görevler, manuel olarak yönetildiğinde büyük bir yük haline gelebilir. İşte tam da bu noktada yapay zeka (YZ) destekli bir asistanın potansiyeli devreye giriyor. YZ, rutin görevleri otomatikleştirmekle kalmaz, aynı zamanda kişiselleştirilmiş deneyimler sunarak topluluk üyelerinin bağlılığını artırır.

Bir topluluk asistanı, doğal dil işleme (NLP) yetenekleri sayesinde üyelerden gelen soruları anlayabilir, toplantı veya etkinlik taleplerini işleyebilir ve hatta takvim entegrasyonuyla otomatik olarak randevular oluşturabilir. Örneğin, bir üye “Gelecek hafta salı günü saat 14:00’te bir geliştirici buluşması ayarlayabilir misin?” dediğinde, YZ asistanı bu isteği analiz eder, uygun takvim aralığını bulur ve gerekli etkinliği otomatik olarak oluşturur. Bu, sadece zaman kazandırmakla kalmaz, aynı zamanda insan hatasını da minimize eder. Ayrıca, YZ asistanları, topluluk içindeki eğilimleri, sık sorulan soruları veya popüler konuları analiz ederek yöneticilere değerli içgörüler sunabilir. Böylece, topluluk stratejileri daha veri odaklı ve etkili bir şekilde belirlenebilir. Verimlilik artışı ve daha iyi topluluk etkileşimi, YZ entegrasyonunun temel faydaları arasındadır. Özellikle büyük ve aktif topluluklarda, mesaj hacmi ve etkinlik sayısı arttıkça bu tür bir otomasyonun değeri katlanarak artar. Yapay zeka, topluluk yöneticilerinin daha stratejik görevlere odaklanmasını sağlayarak, topluluğun genel büyümesine ve gelişimine katkıda bulunur.

Bu bağlamda, Google Cloud Platform (GCP) sağladığı ölçeklenebilir altyapı ve güçlü YZ hizmetleriyle ön plana çıkarken, Vercel AI SDK geliştiricilere yapay zeka entegrasyonunu kolaylaştıran modern bir araç seti sunar. Google Calendar API ise asistanın takvim yönetimini gerçekleştirmesini sağlayan köprü görevi görür. Bu üçlünün uyumu, sadece bir sohbet botundan çok daha fazlasını vaat eden, gerçekten akıllı ve proaktif bir asistanın temelini oluşturur. Bu sistem, topluluk üyelerinin soru sorma, etkinlik kaydı yapma veya bilgi edinme süreçlerini basitleştirirken, yöneticilerin de operasyonel yükünü hafifletir. Sonuç olarak, yapay zeka, topluluk yönetimini daha etkili, daha katılımcı ve daha sürdürülebilir bir hale getirme potansiyeline sahiptir.

AI Destekli Asistanın Temel Bileşenleri Nelerdir? (Mimariye Derin Bir Bakış)

Bir yapay zeka destekli topluluk asistanı geliştirmek, doğru teknolojileri doğru şekilde bir araya getirmekle mümkündür. Bu bölümde, projemizin temel yapı taşları olan Google Cloud Platform, Vercel AI SDK ve Google Calendar API’yi detaylıca inceleyeceğiz ve bu bileşenlerin birbiriyle nasıl entegre olduğunu anlamaya çalışacağız. Bu mimari, asistanın hem güçlü hem de esnek olmasını sağlayacak bir temel sunar.

Google Cloud Platform (GCP) Neden Önemli?

Google Cloud Platform (GCP), dünyanın en büyük bulut hizmet sağlayıcılarından biri olup, projemiz için sağlam ve ölçeklenebilir bir altyapı sunar. GCP’nin sunduğu hizmetler, yapay zeka modellerimizi çalıştırmaktan, veritabanı yönetimine, API anahtarlarımızı güvenli bir şekilde saklamaya kadar geniş bir yelpazeyi kapsar. Özellikle:

  • Compute Engine / Cloud Run: Sunucusuz (serverless) mimari ile ölçeklenebilir ve maliyet etkin bir şekilde kodumuzu çalıştırabiliriz. Cloud Run, kapsayıcılı uygulamaları otomatik olarak ölçeklendirerek trafik arttığında sorunsuz bir performans sunar.
  • Vertex AI: Google’ın kapsamlı makine öğrenimi platformudur. Büyük dil modellerini (LLM’ler) barındırmak, eğitmek ve özel kullanım senaryolarımıza göre ince ayar yapmak için ideal bir ortam sağlar. Projemizde Gemini gibi modelleri bu platform üzerinden kullanabiliriz.
  • Firestore: NoSQL belge tabanlı bir veritabanı olarak, kullanıcı verilerini, sohbet geçmişlerini veya özel yapılandırmaları kolayca depolayabiliriz. Gerçek zamanlı senkronizasyon yeteneği, asistanın dinamik verilerle çalışmasını kolaylaştırır.
  • Cloud Functions: Belirli olaylara (örneğin, bir takvim etkinliği oluşturma isteği) yanıt veren hafif, sunucusuz işlevler oluşturmak için kullanılabilir. Bu, Calendar API ile entegrasyonları kolaylaştırır.
  • Secret Manager: API anahtarları ve hassas verileri güvenli bir şekilde depolamak için kullanılır. Bu, uygulama güvenliği için hayati öneme sahiptir.

GCP, bu hizmetlerin birbiriyle sorunsuz entegrasyonunu sağlayarak, geliştiricilerin altyapı yönetimi yerine uygulama geliştirmeye odaklanmasına olanak tanır. Ayrıca, global dağıtılmış ağ yapısı sayesinde asistanımızın düşük gecikmeyle tüm dünyadaki kullanıcılara hizmet vermesini sağlar.

Vercel AI SDK ile Hızlı Geliştirme Nasıl Yapılır?

Vercel AI SDK, yapay zeka tabanlı sohbet uygulamaları geliştirmeyi inanılmaz derecede kolaylaştıran modern bir kütüphanedir. React ve Next.js gibi popüler frontend çerçeveleriyle uyumlu çalışır ve büyük dil modelleriyle (LLM’ler) entegrasyonu basitleştirir. Temel özellikleri şunlardır:

  • Akış Desteği (Streaming): LLM’lerden gelen yanıtları anında, kelime kelime göstererek kullanıcı deneyimini iyileştirir. Bu, kullanıcının uzun bir yanıtı beklemesini engeller ve daha interaktif bir his yaratır.
  • Çeşitli Model Entegrasyonu: OpenAI (GPT serisi), Anthropic (Claude), Google (Gemini) gibi farklı LLM sağlayıcılarıyla kolay entegrasyon sunar. Bu esneklik, projenin ihtiyaçlarına göre en uygun modeli seçme imkanı tanır.
  • React Hooks: useChat gibi özel React hook’ları ile sohbet durumunu yönetmek, mesajları göndermek ve almak oldukça basittir. Bu, geliştirme sürecini hızlandırır ve kodun temiz kalmasını sağlar.
  • Edge Runtime Desteği: Vercel’in kendi Edge Functions’ları ile birleştiğinde, YZ çağrılarını kullanıcıya en yakın sunucularda işleyerek gecikmeyi minimuma indirir.

Vercel AI SDK, özellikle Next.js ile birlikte kullanıldığında, sunucu tarafında (API rotaları) ve istemci tarafında (UI bileşenleri) yapay zeka tabanlı bir sohbet arayüzünü hızlıca kurmamıza olanak tanır. Bu sayede, karmaşık YZ entegrasyonu yerine, kullanıcı deneyimine odaklanabiliriz.

Google Calendar API Entegrasyonu Ne İşe Yarar?

Bir topluluk asistanının en önemli işlevlerinden biri, etkinlikleri yönetmektir. Google Calendar API, bu ihtiyacı karşılamak için güçlü ve esnek bir araçtır. Bu API sayesinde asistanımız:

  • Etkinlik Oluşturma: Kullanıcı isteği üzerine otomatik olarak takvimde yeni etkinlikler oluşturabilir. Bu, buluşmalar, webinarlar, eğitimler gibi topluluk faaliyetleri için idealdir.
  • Etkinlik Sorgulama ve Listeleme: Belirli bir tarihteki veya yaklaşan etkinlikleri sorgulayabilir ve kullanıcıya sunabilir. “Gelecek haftaki tüm etkinlikleri listeler misin?” gibi sorulara yanıt verebilir.
  • Etkinlik Güncelleme/Silme: Mevcut etkinliklerin detaylarını değiştirebilir veya iptal edebilir.
  • Yetkilendirme: OAuth 2.0 protokolü aracılığıyla kullanıcıların takvimlerine güvenli bir şekilde erişim sağlar. Bu, kullanıcıların kendi takvimleri üzerinde kontrol sahibi olmasını temin eder.

Calendar API, Google ekosistemiyle derinlemesine entegre olduğu için, oluşturulan etkinlikler doğrudan kullanıcıların Google Takvim’lerinde görünür ve bildirimler almalarını sağlar. Bu, topluluk üyelerinin etkinliklerden haberdar olmalarını ve katılımı artırmalarını kolaylaştırır. Asistanımızın “akıllı” olma yeteneği, büyük ölçüde bu API sayesinde takvim verilerini anlama ve manipüle etme becerisinden gelir.

Adım Adım Yapay Zeka Destekli Topluluk Asistanı Nasıl Geliştirilir? (Uygulamalı Rehber)

Artık teorik temelleri anladığımıza göre, yapay zeka destekli topluluk asistanımızı gerçek hayatta nasıl inşa edeceğimize odaklanabiliriz. Bu bölümde, projenin kurulumundan temel entegrasyonlara kadar adım adım bir yol haritası sunacağız. Her aşama, önceki bilgilerin üzerine inşa edilerek, uygulamanın nasıl şekillendiğini gösterecektir.

GCP Ortamının Hazırlanması ve API Anahtarlarının Yapılandırılması

Projemizin omurgasını oluşturacak olan Google Cloud Platform üzerinde gerekli hazırlıkları yapmakla başlayalım. Bu adımlar, asistanımızın YZ modellerine erişebilmesi ve Google Takvim ile etkileşime geçebilmesi için elzemdir.

  1. GCP Projesi Oluşturma: Google Cloud Console’a gidin ve yeni bir proje oluşturun. Projenize anlamlı bir isim verin (örn. community-ai-assistant).
  2. Gerekli API’leri Etkinleştirme: Oluşturduğunuz projede aşağıdaki API’leri etkinleştirin:
    • Google Calendar API
    • Vertex AI API (veya istediğiniz başka bir LLM sağlayıcının API’si)
  3. Hizmet Hesabı Oluşturma ve Anahtar Üretme:
    • IAM & Admin > Service Accounts bölümüne gidin ve yeni bir hizmet hesabı oluşturun.
    • Bu hizmet hesabına Calendar Editor (Takvim Düzenleyici) ve Vertex AI User (Vertex AI Kullanıcısı) gibi gerekli rolleri atayın. Bu roller, asistanımızın takvimde etkinlik oluşturabilmesi ve YZ modellerini kullanabilmesi için gereklidir.
    • Hizmet hesabının JSON anahtarını oluşturun ve bilgisayarınıza indirin. Bu dosya, uygulamanızın GCP hizmetlerine yetkili bir şekilde erişmesini sağlayacaktır. Bu dosyayı asla genel depolara yüklemeyin ve güvenli bir şekilde saklayın.
  4. OAuth 2.0 İstemci Kimliği Oluşturma (Calendar API için):
    • APIs & Services > Credentials bölümüne gidin.
    • Create Credentials > OAuth client ID seçeneğini tıklayın.
    • Uygulama türü olarak Web application seçin.
    • Authorized JavaScript origins ve Authorized redirect URIs alanlarını uygulamanızın Vercel üzerinde dağıtılacağı URL’ler (örn. https://your-app.vercel.app ve https://your-app.vercel.app/api/auth/callback) ile doldurun. Geliştirme ortamı için http://localhost:3000 adresini de ekleyebilirsiniz.
    • Oluşturulan istemci kimliğini (Client ID) ve istemci sırrını (Client Secret) not alın. Bunları daha sonra ortam değişkenleri olarak kullanacağız.
  5. Ortam Değişkenlerinin Yapılandırılması:

    Projenizin kök dizininde bir .env.local dosyası oluşturarak hassas bilgileri buraya kaydedin:

    GOOGLE_CLIENT_ID=YOUR_GOOGLE_CLIENT_ID
            GOOGLE_CLIENT_SECRET=YOUR_GOOGLE_CLIENT_SECRET
            GOOGLE_REDIRECT_URI=http://localhost:3000/api/auth/callback # veya dağıtılan URL
            GOOGLE_API_KEY=YOUR_VERTEX_AI_API_KEY # veya diğer LLM sağlayıcınızın anahtarı
            # GCP hizmet hesabı anahtarını doğrudan .env dosyasına yapıştırmayın,
            # bunun yerine bir dosya yolu veya Vercel Secret Manager kullanın.

    Vercel'e dağıtım yaparken bu değişkenleri Vercel projenizin ayarlarından eklemeyi unutmayın.

Vercel AI SDK ile Sohbet Arayüzü Nasıl Oluşturulur?

Şimdi sıra, kullanıcıların asistanımızla etkileşime geçeceği arayüzü kurmaya geldi. Next.js ve Vercel AI SDK bu süreçte bize büyük kolaylıklar sağlayacak.

  1. Next.js Projesi Oluşturma: 
    npx create-next-app@latest community-assistant --typescript --tailwind --eslint
            cd community-assistant

  2. Vercel AI SDK Kurulumu: 
    npm install @vercel/ai google-auth-library @google/generative-ai
            npm install --save-dev @types/google-auth-library

    Burada @google/generative-ai, Google'ın Gemini gibi modelleriyle etkileşim kurmak için kullanılır. Eğer OpenAI kullanacaksanız openai paketini kurmanız gerekir.

  3. Sohbet API Rotası Oluşturma (app/api/chat/route.ts):

    Bu dosya, istemciden gelen sohbet mesajlarını alacak ve bir dil modeline ileterek yanıtı geri gönderecek sunucu tarafı mantığı içerir.

    import { GoogleGenerativeAI } from '@google/generative-ai';
            import { StreamingTextResponse, streamText } from 'ai';

            // Next.js Edge Runtime'ı etkinleştir
            export const runtime = 'edge';

            const genAI = new GoogleGenerativeAI(process.env.GOOGLE_API_KEY || '');

            export async function POST(req: Request) {
              const { messages } = await req.json();

              // GenAI modelini başlat
              const model = genAI.getGenerativeModel({ model: 'gemini-pro' });

              // Sohbet geçmişini modele gönder
              const result = await model.generateContent(messages.map((m: any) => m.content).join('\n'));
              const responseText = result.response.text();

              // Vercel AI SDK ile akışı döndür
              const stream = streamText(responseText); // Bu kısım daha sofistike hale getirilebilir

              return new StreamingTextResponse(stream);
            }

    Uzman İpucu: Gerçek bir akış deneyimi için model.generateContent yerine model.generateContentStream kullanabilir ve yanıtı kelime kelime işleyebilirsiniz. Vercel AI SDK'nın AIStream yardımcı fonksiyonları ile bu süreci daha da optimize edebilirsiniz.
  4. Sohbet Arayüzü Bileşeni Oluşturma (app/page.tsx veya components/Chat.tsx):

    Bu bileşen, kullanıcının mesaj göndereceği ve asistanın yanıtlarını göreceği temel UI'yi sağlar.

    'use client';

            import { useChat } from 'ai/react';

            export default function Chat() {
              const { messages, input, handleInputChange, handleSubmit } = useChat();

              return (
                
    
                  {messages.map(m => (
                    
    
                      {m.role === 'user' ? 'Kullanıcı: ' : 'Asistan: '}
                      {m.content}
                    
    
                  ))}

                  
    
                    
                  
    
                
    
              );
            }

    Bu temel kurulum, projenizin sohbet özellikli çekirdeğini oluşturur. Kullanıcı artık mesaj gönderebilir ve YZ modelinden yanıt alabilir. Bir sonraki adımda, bu çekirdeği Google Takvim ile entegre ederek asistanımıza gerçek bir işlevsellik kazandıracağız.

    Google Calendar API Entegrasyonu ve Yetkilendirme İşlemleri

    Asistanımızın takvimde etkinlik oluşturabilmesi için Google Calendar API ile entegrasyon kurmamız ve kullanıcıdan yetki almamız gerekiyor. Bu süreç OAuth 2.0 tabanlıdır ve kullanıcının güvenliğini ön planda tutar.

    1. OAuth 2.0 Akışı İçin Yardımcı Fonksiyonlar (lib/google-auth.ts):

      Kullanıcının kimlik doğrulamasını başlatacak ve erişim belirtecini (access token) yönetecek yardımcı fonksiyonları oluşturalım. Bu kısım genellikle NextAuth.js gibi kütüphanelerle daha kolay yönetilebilir ancak temel mantığı göstermek için manuel bir yaklaşım sunulmuştur.

      // lib/google-auth.ts
            import { google } from 'googleapis';
            import { OAuth2Client } from 'google-auth-library';

            const CLIENT_ID = process.env.GOOGLE_CLIENT_ID;
            const CLIENT_SECRET = process.env.GOOGLE_CLIENT_SECRET;
            const REDIRECT_URI = process.env.GOOGLE_REDIRECT_URI;

            if (!CLIENT_ID || !CLIENT_SECRET || !REDIRECT_URI) {
              throw new Error('Missing Google OAuth environment variables');
            }

            export const oauth2Client = new OAuth2Client(
              CLIENT_ID,
              CLIENT_SECRET,
              REDIRECT_URI
            );

            // Gerekli yetkilendirme kapsamları
            const scopes = [
              'https://www.googleapis.com/auth/calendar.events',
              'https://www.googleapis.com/auth/calendar.readonly'
            ];

            export function getAuthUrl() {
              return oauth2Client.generateAuthUrl({
                access_type: 'offline',
                scope: scopes,
                prompt: 'consent', // Kullanıcının her zaman onay vermesi için
              });
            }

            export async function getTokens(code: string) {
              const { tokens } = await oauth2Client.getToken(code);
              return tokens;
            }

            export async function getAuthenticatedClient(accessToken: string): Promise {
              oauth2Client.setCredentials({ access_token: accessToken });
              return oauth2Client;
            }

            export async function createCalendarEvent(accessToken: string, eventDetails: any) {
              const auth = await getAuthenticatedClient(accessToken);
              const calendar = google.calendar({ version: 'v3', auth });

              const event = {
                summary: eventDetails.summary,
                description: eventDetails.description,
                start: {
                  dateTime: eventDetails.startDateTime,
                  timeZone: 'Europe/Istanbul', // veya dinamik bir zaman dilimi
                },
                end: {
                  dateTime: eventDetails.endDateTime,
                  timeZone: 'Europe/Istanbul',
                },
                reminders: {
                  useDefault: false,
                  overrides: [
                    { method: 'email', minutes: 24 * 60 },
                    { method: 'popup', minutes: 30 },
                  ],
                },
              };

              const response = await calendar.events.insert({
                calendarId: 'primary', // Kullanıcının birincil takvimi
                requestBody: event,
              });

              return response.data;
            }

            export async function listCalendarEvents(accessToken: string, timeMin: string, timeMax: string) {
              const auth = await getAuthenticatedClient(accessToken);
              const calendar = google.calendar({ version: 'v3', auth });

              const response = await calendar.events.list({
                calendarId: 'primary',
                timeMin: timeMin,
                timeMax: timeMax,
                singleEvents: true,
                orderBy: 'startTime',
              });

              return response.data.items;
            }

    2. OAuth Geri Çağrı Rotası (app/api/auth/callback/route.ts):

      Google'dan gelen yetkilendirme kodunu işleyecek ve erişim belirteçlerini alacak bir rota oluşturun. Bu belirteçler, bir veritabanında (Firestore gibi) kullanıcıyla ilişkilendirilerek saklanmalıdır.

      // app/api/auth/callback/route.ts
            import { getTokens, oauth2Client } from '../../../lib/google-auth';
            import { NextResponse } from 'next/server';

            export async function GET(request: Request) {
              const url = new URL(request.url);
              const code = url.searchParams.get('code');

              if (!code) {
                return NextResponse.redirect('/error?message=No code found');
              }

              try {
                const tokens = await getTokens(code);
                // Tokens'ı (accessToken, refreshToken) veritabanına kaydet
                // Örneğin: await saveUserTokens({ userId: 'some-user-id', tokens });
                console.log('Tokenlar başarıyla alındı:', tokens);

                // Ana uygulamaya yönlendir
                return NextResponse.redirect('/?auth=success');
              } catch (error) {
                console.error('Token alınamadı:', error);
                return NextResponse.redirect('/error?message=Failed to get tokens');
              }
            }

    3. Yetkilendirme Başlatma (Frontend):

      Kullanıcının Google ile oturum açmasını sağlayacak bir buton ekleyin:

      // app/page.tsx veya ayrı bir bileşende
            import { getAuthUrl } from '../lib/google-auth'; // Sunucu tarafında çağrılacak

            export default function Home({ authUrl }: { authUrl: string }) {
              return (
                
      
                  
      Topluluk Asistanı
      
                  Google ile Takvim'e Bağlan
                  {/* Sohbet bileşeni */}
                  
                
      
              );
            }

            // Sunucu tarafında getAuthUrl'yi çağırmak için
            export async function getServerSideProps() {
              const authUrl = getAuthUrl();
              return { props: { authUrl } };
            }

      Uzman İpucu: getServerSideProps yerine Next.js 13/14 App Router kullanıyorsanız, getAuthUrl fonksiyonunu bir sunucu bileşeninde doğrudan çağırabilir veya bir API rotası üzerinden sunabilirsiniz. Erişim belirteçlerini güvenli bir şekilde sunucu tarafında yönetmek ve istemciye sadece gerekli durumlarda aktarmak güvenlik için çok önemlidir.

    Bu adımlarla, asistanımızın Google Takvim ile yetkili bir şekilde etkileşime girmesi için gerekli altyapıyı kurmuş olduk. Artık asistanımız, bir kullanıcının takvimine etkinlik ekleyebilir veya mevcut etkinlikleri sorgulayabilir. Bir sonraki bölümde, bu yetenekleri yapay zeka modelimizle nasıl birleştireceğimizi inceleyeceğiz.

    Yapay Zeka ve Takvim Entegrasyonunu Birleştirme: Akıllı Etkinlik Planlama Nasıl Sağlanır?

    Asistanımızın gerçek gücü, yapay zeka modelinin doğal dil anlayışını Google Calendar API'nin işlevselliğiyle birleştirmesinden gelir. Bu bölüm, kullanıcının doğal dilindeki istekleri anlayarak takvimde otomatik işlemler yapmayı nasıl sağlayacağımızı ele alacaktır. Bu, projemizin en "akıllı" kısmını oluşturur.

    Doğal Dil İşleme (NLP) ile Kullanıcı İsteklerini Anlama

    YZ modelimizin (örn. Gemini veya GPT) en kritik görevlerinden biri, kullanıcının doğal dildeki ifadelerini anlamak ve bir "niyet" (intent) ile "varlıklar" (entities) çıkarmaktır. Örneğin, "Gelecek Çarşamba öğleden sonra ekip toplantısı planla" cümlesinden modelin çıkarması gerekenler şunlardır:

    • Niyet: Etkinlik planlama (create_calendar_event)
    • Varlıklar:
      • Konu (Summary): Ekip toplantısı
      • Tarih (Date): Gelecek Çarşamba
      • Zaman (Time): Öğleden sonra (örneğin 13:00-14:00 olarak yorumlanabilir)

    Bu yetenek, genellikle prompt engineering ve "fonksiyon çağrısı" (function calling) veya "araç kullanımı" (tool use) adı verilen tekniklerle sağlanır. Model, belirli bir formatta tanımladığımız araçları (API fonksiyonları) tanıyacak şekilde eğitilir.

    // app/api/chat/route.ts içinde geliştirilmiş bir örnek
    // Not: Bu örnek, gerçek bir LLM'in function calling özelliğini taklit eder.
    // Gemini'da veya OpenAI'da bu, modellerin kendi SDK'ları ile daha direkt yapılır.

    import { GoogleGenerativeAI } from '@google/generative-ai';
    import { StreamingTextResponse, streamText } from 'ai';
    import { createCalendarEvent, listCalendarEvents } from '../../../lib/google-auth'; // Calendar API fonksiyonlarımız

    export const runtime = 'edge';

    const genAI = new GoogleGenerativeAI(process.env.GOOGLE_API_KEY || '');
    const model = genAI.getGenerativeModel({
      model: 'gemini-pro',
      // 'tools' özelliği ile LLM'e hangi fonksiyonları kullanabileceğini öğretiriz
      tools: [
        {
          functionDeclarations: [
            {
              name: 'createCalendarEvent',
              description: 'Google Takvimde yeni bir etkinlik oluşturur.',
              parameters: {
                type: 'OBJECT',
                properties: {
                  summary: { type: 'STRING', description: 'Etkinliğin başlığı' },
                  description: { type: 'STRING', description: 'Etkinliğin açıklaması' },
                  startDateTime: { type: 'STRING', description: 'Etkinliğin başlangıç tarihi ve saati (ISO 8601 formatında)' },
                  endDateTime: { type: 'STRING', description: 'Etkinliğin bitiş tarihi ve saati (ISO 8601 formatında)' },
                },
                required: ['summary', 'startDateTime', 'endDateTime'],
              },
            },
            {
              name: 'listCalendarEvents',
              description: 'Belirli bir zaman aralığındaki Google Takvim etkinliklerini listeler.',
              parameters: {
                type: 'OBJECT',
                properties: {
                  timeMin: { type: 'STRING', description: 'Başlangıç tarihi ve saati (ISO 8601 formatında)' },
                  timeMax: { type: 'STRING', description: 'Bitiş tarihi ve saati (ISO 8601 formatında)' },
                },
                required: ['timeMin', 'timeMax'],
              },
            },
          ],
        },
      ],
    });

    export async function POST(req: Request) {
      const { messages, accessToken } = await req.json(); // Kullanıcı accessToken'ını da gönderiyoruz

      const chat = model.startChat({
        history: messages.slice(0, -1).map((m: any) => ({
          role: m.role === 'user' ? 'user' : 'model',
          parts: [{ text: m.content }],
        })),
      });

      const result = await chat.sendMessage(messages[messages.length - 1].content);
      const response = result.response;

      if (response.functionCall) {
        const { name, args } = response.functionCall;
        console.log('LLM bir fonksiyon çağırmak istedi:', name, args);

        try {
          let funcResult;
          if (name === 'createCalendarEvent') {
            funcResult = await createCalendarEvent(accessToken, args);
            return new StreamingTextResponse(streamText(Harika! '${args.summary}' etkinliğini takvime ekledim. Detaylar: ${funcResult.htmlLink}));
          } else if (name === 'listCalendarEvents') {
            const events = await listCalendarEvents(accessToken, args.timeMin, args.timeMax);
            const eventSummaries = events.length > 0
              ? events.map((e: any) => - ${e.summary} (${e.start.dateTime || e.start.date})).join('\n')
              : 'Belirtilen aralıkta etkinlik bulunamadı.';
            return new StreamingTextResponse(streamText(Belirtilen aralıktaki etkinlikler:\n${eventSummaries}));
          }
        } catch (error) {
          console.error(Fonksiyon çağrılırken hata (${name}):, error);
          return new StreamingTextResponse(streamText('Üzgünüm, isteğinizi işlerken bir hata oluştu. Lütfen tekrar deneyin.'));
        }
      } else if (response.text()) {
        const stream = streamText(response.text());
        return new StreamingTextResponse(stream);
      }

      return new StreamingTextResponse(streamText('Üzgünüm, isteğinizi anlayamadım.'));
    }

    Yukarıdaki örnekte, YZ modelimize createCalendarEvent ve listCalendarEvents adında iki fonksiyonumuz olduğunu ve bu fonksiyonların hangi parametreleri beklediğini öğrettik. Model, kullanıcı girdisini analiz ettiğinde, uygun durumlarda bu fonksiyonlardan birini çağırmak için bir "fonksiyon çağrısı" isteği döndürecektir. Bizim API rotamız da bu isteği yakalayarak gerçek Calendar API çağrısını yapacaktır.

    Dinamik Yanıtlar ve Takvim İşlemleri

    YZ modelinden gelen fonksiyon çağrısı isteği işlendikten sonra, elde edilen sonuca göre kullanıcıya geri bildirim sağlamak önemlidir. Bu, sadece işlemin başarılı olup olmadığını bildirmekle kalmaz, aynı zamanda kullanıcı deneyimini de geliştirir. Örneğin:

    • Başarılı Etkinlik Oluşturma: "Harika! 'Ekip Toplantısı' etkinliğini 17 Mayıs Salı 13:00'e ekledim. Buradan görebilirsiniz: [Etkinlik Linki]"
    • Başarısız Etkinlik Oluşturma: "Üzgünüm, etkinliği oluştururken bir sorun oluştu. Takvim erişiminizde bir problem olabilir mi?"
    • Etkinlik Listeleme: "Gelecek haftaki etkinlikleriniz: [Liste]"

    Bu dinamik yanıtlar, kullanıcının asistanın ne yaptığını net bir şekilde anlamasını sağlar. Hata durumlarında kullanıcıya yol göstermek, güveni artırır. Modelden gelen yanıtı işlerken, eğer bir fonksiyon çağrısı yoksa, modelin doğrudan metin yanıtını kullanıcıya iletmeliyiz.

    Vaka Analizi: "Topluluk buluşmaları için otomatik takvim oluşturma"

    Örneğin, bir geliştirici topluluğu her ayın üçüncü perşembe günü bir çevrimiçi buluşma düzenliyor. Topluluk yöneticisi her ay takvime manuel olarak bu etkinliği eklemek zorunda kalıyor. YZ destekli asistanımızla, yönetici sadece "Her ayın üçüncü perşembe günü 'Geliştirici Buluşması' etkinliğini takvime ekle" diyebilir. Asistan, bu komutu algılayarak tekrar eden etkinlikleri otomatik olarak takvime işleyebilir. Hatta "Katılımcıların listesini takip et" gibi ek bir yönerge verildiğinde, Firestore'a kaydolan kullanıcıları da takip edebilir.

    Bu entegrasyon modeli, sadece basit etkinlikleri değil, aynı zamanda daha karmaşık topluluk senaryolarını da otomatikleştirebilir. Örneğin, bir "mentörlük programına kaydol" isteği üzerine, asistan müsait mentörleri listeler, bir eşleşme yapar ve hem mentörün hem de menti'nin takvimlerine otomatik olarak ilk buluşmayı ekler. Bu tür yetenekler, asistanın topluluk içindeki değerini katlayarak artırır.

    Performans Optimizasyonu ve Güvenlik İpuçları Nelerdir? (İleri Düzey Kullanıcılar İçin)

    Uygulamamızın temel işlevselliğini inşa ettik, ancak gerçek dünya senaryolarında bir uygulamanın sadece çalışması yeterli değildir. Performans ve güvenlik, özellikle hassas takvim verileriyle çalıştığımız ve harici API'lere bağımlı olduğumuz bir uygulamada hayati öneme sahiptir. Bu bölümde, asistanımızı daha sağlam, daha güvenli ve daha duyarlı hale getirmek için ileri düzey ipuçlarını inceleyeceğiz.

    Önbellekleme ve Oran Sınırlama (Rate Limiting)

    Her API çağrısı bir maliyet ve gecikme anlamına gelir. Özellikle sık tekrarlanan veya sabit veriler için gereksiz API çağrılarını önlemek, hem performansı artırır hem de maliyetleri düşürür.

    • Önbellekleme (Caching):

      Eğer asistan sık sık "Gelecek 7 gün içindeki etkinlikleri listele" gibi bir istek alıyorsa ve bu etkinlik listesi kısa bir süre içinde değişmeyecekse, ilk sorgunun sonucunu önbellekte tutabiliriz. GCP'de Memorystore (Redis için) gibi hizmetler, bu tür bir önbellekleme için idealdir. Örneğin, son 5 dakikadaki etkinlik sorgularının sonuçlarını önbelleğe alabilir ve aynı sorgu tekrar geldiğinde doğrudan önbellekten yanıt verebiliriz. Bu, LLM'e yapılan çağrıları ve Calendar API'ye yapılan çağrıları azaltır, bu da maliyet ve gecikme açısından önemli iyileştirmeler sağlar.

      // Örnek önbellekleme yapısı (sözde kod)
            import NodeCache from 'node-cache'; // Örneğin basit bir in-memory cache

            const myCache = new NodeCache({ stdTTL: 300, checkperiod: 120 }); // 5 dakika TTL

            async function getOrListCalendarEvents(accessToken: string, timeMin: string, timeMax: string) {
              const cacheKey = events-${accessToken}-${timeMin}-${timeMax};
              let events = myCache.get(cacheKey);

              if (events) {
                console.log('Etkinlikler önbellekten alındı.');
                return events;
              }

              console.log('Etkinlikler API üzerinden çekiliyor.');
              events = await listCalendarEvents(accessToken, timeMin, timeMax);
              myCache.set(cacheKey, events);
              return events;
            }

    • Oran Sınırlama (Rate Limiting):

      Uygulamanızın, özellikle halka açık API rotaları üzerinden, kötü niyetli veya aşırı isteklerle karşılaşması olasıdır. Oran sınırlama, belirli bir zaman diliminde bir kullanıcının veya IP adresinin yapabileceği istek sayısını kısıtlayarak sunucunuzu korur ve API sağlayıcınızın limitlerini aşmanızı engeller. Vercel'de middleware'ler veya Redis tabanlı çözümler bu amaçla kullanılabilir.

      // Örnek bir rate limit middleware (sözde kod)
            // import { Ratelimit } from "@upstash/ratelimit";
            // import { Redis } from "@upstash/redis";

            // const ratelimit = new Ratelimit({
            //   redis: Redis.fromEnv(),
            //   limiter: Ratelimit.slidingWindow(10, "10s"), // 10 saniyede 10 istek
            //   analytics: true,
            // });

            // export async function middleware(req: NextRequest) {
            //   const ip = req.ip ?? "127.0.0.1";
            //   const { success } = await ratelimit.limit(ip);

            //   if (!success) {
            //     return new NextResponse("Too many requests", { status: 429 });
            //   }
            //   return NextResponse.next();
            // }

    Veri Güvenliği ve Yetkilendirme Best Practices

    Kullanıcıların takvim verileri hassas bilgiler içerir. Bu nedenle, uygulamanın güvenliği en üst düzeyde tutulmalıdır.

    • OAuth 2.0 Kapsamları (Scopes): Kullanıcıdan sadece uygulamanızın ihtiyaç duyduğu minimum yetkileri isteyin. Örneğin, sadece etkinlik oluşturmanız gerekiyorsa https://www.googleapis.com/auth/calendar.events kapsamını kullanın, tüm takvime erişim sağlayan https://www.googleapis.com/auth/calendar kapsamından kaçının.
    • Erişim Belirteçlerinin Güvenli Depolanması: Kullanıcılardan alınan erişim belirteçleri (access token) ve yenileme belirteçleri (refresh token) asla istemci tarafında (tarayıcıda) depolanmamalıdır. Bunlar sunucu tarafında (örn. Firestore veya Secret Manager'da şifreli olarak) saklanmalı ve her API çağrısı için sunucudan alınmalıdır. Yenileme belirteçleri, erişim belirteçleri sona erdiğinde yeni bir erişim belirteci almak için kullanılır ve ömürleri daha uzundur.
    • Ortam Değişkenlerinin Güvenliği: .env dosyalarını gitignore'a ekleyin. Vercel gibi platformlarda ortam değişkenlerini arayüz üzerinden veya CLI ile güvenli bir şekilde tanımlayın. Hassas anahtarları asla doğrudan koda gömmeyin.
    • Giriş Doğrulama (Input Validation): Kullanıcıdan veya YZ modelinden gelen verileri her zaman doğrulayın. Örneğin, takvim etkinliği oluştururken tarih ve saat formatlarının doğru olduğundan emin olun.
    • Hata Yönetimi: API çağrılarında veya YZ model etkileşimlerinde oluşabilecek hataları uygun şekilde yakalayın ve loglayın. Kullanıcıya genel ve bilgilendirici hata mesajları sunarken, detaylı hata bilgilerini sunucu loglarında tutun.

    Mobil Uyumluluk ve Duyarlı Tasarım

    Topluluk üyeleri asistanınıza farklı cihazlardan erişebilir. Bu nedenle, uygulamanın mobil uyumlu ve duyarlı bir tasarıma sahip olması kritik öneme sahiptir. Next.js ve Tailwind CSS gibi araçlar, bu konuda önemli avantajlar sağlar.

    • CSS Media Query Örnekleri: CSS kullanarak ekran boyutlarına göre düzeni ve stilini ayarlayın.

    • Esnek Düzenler ve Bileşenler: Flexbox veya Grid gibi modern CSS özelliklerini kullanarak düzeninizi esnek tutun. Bileşenlerinizi (örneğin sohbet kutusu, mesaj balonları) farklı ekran boyutlarına uyum sağlayacak şekilde tasarlayın.
    • Dokunmatik Odaklı Tasarım: Butonlar ve etkileşimli öğeler için yeterince büyük dokunma alanları sağlayın. Mobil klavye kullanımı için input alanlarının doğru tiplere sahip olduğundan emin olun (örn. type="datetime-local").
    Uzman İpucu: Vercel üzerinde Next.js ile geliştirme yaparken, otomatik ölçeklenme ve Edge Functions desteği sayesinde performans avantajlarından doğal olarak faydalanırsınız. Ancak, LLM API çağrılarının maliyetli ve yavaş olabileceğini unutmayın. Bu nedenle, önbellekleme ve prompt optimizasyonu bu tür uygulamalarda vazgeçilmezdir.

    Bu performans ve güvenlik ipuçları, uygulamanızın sadece çalışmasını değil, aynı zamanda kullanıcılar için güvenli, hızlı ve sorunsuz bir deneyim sunmasını sağlayacaktır. Özellikle topluluk asistanı gibi hassas verilere erişen ve sürekli etkileşimde olan uygulamalarda bu detaylara dikkat etmek, uzun vadeli başarı için kritiktir.

    Yapay Zeka Destekli Topluluk Asistanı ile Gelecekte Neler Yapılabilir? (Vizyon ve Sıkça Sorulan Sorular)

    Bugün ele aldığımız yapay zeka destekli topluluk asistanı, topluluk yönetimini dönüştürmek için güçlü bir başlangıç noktasıdır. Google Cloud Platform'un sağlam altyapısı, Vercel AI SDK'nın modern geliştirme yetenekleri ve Google Calendar API'nin esnek entegrasyonu sayesinde, artık rutin görevleri otomatikleştirebilen, üyelerin sorularına yanıt verebilen ve etkinlikleri yönetebilen akıllı bir araca sahibiz. Bu asistan, topluluk yöneticilerinin üzerindeki yükü hafifleterek, onların daha stratejik görevlere odaklanmasını sağlar. Üyeler için ise, daha hızlı yanıtlar, daha kolay etkinlik kaydı ve daha iyi organize edilmiş bir topluluk deneyimi anlamına gelir. Kısacası, verimlilik ve kullanıcı memnuniyeti açısından önemli bir sıçrama sağlamış oluyoruz.

    Peki, bu teknolojinin geleceği neler vaat ediyor? Oluşturduğumuz bu temel yapı, hayal gücümüzle sınırlı olmayan birçok ileri düzey özelliğe kapı açıyor. Örneğin, topluluk üyelerinin duygu analizini yaparak genel ruh halini anlayabilen, proaktif olarak etkinlik önerileri sunabilen veya kişiselleştirilmiş içerik dağıtımı yapabilen bir asistan düşünebiliriz. Ayrıca, asistanın Slack, Discord veya özel forumlar gibi diğer topluluk platformlarıyla derinlemesine entegrasyonu, deneyimi daha da zenginleştirebilir. Belki de, yeni üyelerin onboarding sürecini tamamen otomatikleştirerek onlara kişisel bir rehberlik sunabiliriz. Yapay zeka yeteneklerinin sürekli gelişmesiyle, bu asistanlar zamanla daha karmaşık görevleri üstlenerek, toplulukların adeta canlı, nefes alan organizmalara dönüşmesine yardımcı olabilir. Gelecekte, asistanların sadece metin tabanlı değil, sesli ve hatta görsel etkileşim yetenekleriyle de donatıldığını görebiliriz, bu da erişilebilirliği ve kullanım kolaylığını artıracaktır. Bu vizyon, toplulukların daha bağlı, daha bilgili ve daha etkileşimli hale gelmesine olanak tanıyacaktır.

    Sıkça Sorulan Sorular

    Bu heyecan verici teknoloji hakkında aklınızda oluşabilecek bazı soruları yanıtlayalım:

    S1: Bu asistanı kurmak için ne kadar teknik bilgiye ihtiyacım var?

    C1: Temel düzeyde JavaScript/TypeScript, Next.js ve genel bulut bilişim (Google Cloud Platform) bilgisi gereklidir. Vercel AI SDK ve Google Calendar API'nin kullanımı için belirli kütüphanelere aşina olmak da faydalı olacaktır. Ancak, adım adım rehberimiz ve sağlanan kod örnekleri sayesinde orta seviye geliştiriciler de bu projeyi başarıyla uygulayabilir.

    S2: Güvenlik riskleri nelerdir ve nasıl yönetilir?

    C2: En büyük risk, hassas kullanıcı verileri (takvim bilgileri, kimlik doğrulama belirteçleri) ve API anahtarlarının sızdırılmasıdır. Bu riskleri yönetmek için OAuth 2.0 ile yetkilendirme, erişim belirteçlerinin sunucu tarafında güvenli bir şekilde depolanması (asla istemci tarafında olmamalıdır), GCP Secret Manager kullanımı, ortam değişkenlerinin doğru şekilde yapılandırılması ve giriş verisi doğrulama gibi best practices'leri uygulamak hayati önem taşır.

    S3: Asistanı farklı platformlarla entegre edebilir miyim?

    C3: Evet, kesinlikle! Google Calendar API, belirli bir ekosistemle sınırlı değildir. Benzer şekilde, Slack API, Discord API veya özel bir CRM'in API'si gibi diğer platformlarla entegrasyonlar geliştirerek asistanın erişim alanını genişletebilirsiniz. Vercel AI SDK ve GCP'nin modüler yapısı, yeni entegrasyonları kolayca eklemenizi sağlar. Örneğin, bir kullanıcıdan gelen bir soruyu Slack kanalına yönlendirebilir veya Discord'da bir etkinlik oluşturabilirsiniz.

    S4: Bu projenin maliyetleri nasıl yönetilir?

    C4: Maliyetler, kullanılan GCP hizmetlerine (özellikle Vertex AI/LLM çağrıları, Firestore depolama ve Compute Engine/Cloud Run kullanımı) ve Vercel'in kendi kullanım limitlerine bağlıdır. Başlangıçta birçok bulut hizmeti ücretsiz katmanlar sunar. Ancak topluluğunuz büyüdükçe ve kullanım arttıkça maliyetler de artacaktır. Önbellekleme, verimli API çağrıları ve gereksiz YZ model etkileşimlerinden kaçınma gibi optimizasyon teknikleri, maliyetleri önemli ölçüde düşürmenize yardımcı olabilir. Düzenli olarak GCP ve Vercel faturalandırma raporlarınızı kontrol etmek, beklenmedik maliyet artışlarını önleyecektir.

byFatih Soysal
0
Yorumlar
İçeriği beğendiniz mi? Bir tartışma başlatın veya görüşlerinizi paylaşın.
Yorum Yaz

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

Gönder

Aşağıdaki içerikler de ilgilinizi çekebilir:

E-posta Bülteni
Yazılım Topluluğuna Katılın
En son güncellemeleri, yaratıcı ipuçlarını ve özel kaynakları doğrudan e-posta kutunuza alın. Tasarım ve inovasyonun geleceğini birlikte keşfedelim.
Exit mobile version