Projenizin k\u00f6k dizininde bir .env.local<\/code> dosyas\u0131 olu\u015fturarak hassas bilgileri buraya kaydedin:<\/p>\n
\nGOOGLE_CLIENT_ID=YOUR_GOOGLE_CLIENT_ID\n            GOOGLE_CLIENT_SECRET=YOUR_GOOGLE_CLIENT_SECRET\n            GOOGLE_REDIRECT_URI=http:\/\/localhost:3000\/api\/auth\/callback # veya da\u011f\u0131t\u0131lan URL\n            GOOGLE_API_KEY=YOUR_VERTEX_AI_API_KEY # veya di\u011fer LLM sa\u011flay\u0131c\u0131n\u0131z\u0131n anahtar\u0131\n            # GCP hizmet hesab\u0131 anahtar\u0131n\u0131 do\u011frudan .env dosyas\u0131na yap\u0131\u015ft\u0131rmay\u0131n,\n            # bunun yerine bir dosya yolu veya Vercel Secret Manager kullan\u0131n.<\/pre>\n<\/code>\n            <\/div>\n
Vercel'e da\u011f\u0131t\u0131m yaparken bu de\u011fi\u015fkenleri Vercel projenizin ayarlar\u0131ndan eklemeyi unutmay\u0131n.<\/p>\n<\/li>\n<\/ol>\n
Vercel AI SDK ile Sohbet Aray\u00fcz\u00fc Nas\u0131l Olu\u015fturulur?<\/h3>\n\u015eimdi s\u0131ra, kullan\u0131c\u0131lar\u0131n asistan\u0131m\u0131zla etkile\u015fime ge\u00e7ece\u011fi aray\u00fcz\u00fc kurmaya geldi. Next.js ve Vercel AI SDK bu s\u00fcre\u00e7te bize b\u00fcy\u00fck kolayl\u0131klar sa\u011flayacak.<\/p>\n
\nNext.js Projesi Olu\u015fturma:<\/strong>\n\nnpx create-next-app@latest community-assistant --typescript --tailwind --eslint\n            cd community-assistant<\/pre>\n<\/code>\n            <\/div>\n<\/li>\n
Vercel AI SDK Kurulumu:<\/strong>\n\nnpm install @vercel\/ai google-auth-library @google\/generative-ai\n            npm install --save-dev @types\/google-auth-library<\/pre>\n<\/code>\n            <\/div>\n
Burada @google\/generative-ai<\/code>, Google'\u0131n Gemini gibi modelleriyle etkile\u015fim kurmak i\u00e7in kullan\u0131l\u0131r. E\u011fer OpenAI kullanacaksan\u0131z openai<\/code> paketini kurman\u0131z gerekir.<\/p>\n<\/li>\n
Sohbet API Rotas\u0131 Olu\u015fturma (app\/api\/chat\/route.ts<\/code>):<\/strong>\nBu dosya, istemciden gelen sohbet mesajlar\u0131n\u0131 alacak ve bir dil modeline ileterek yan\u0131t\u0131 geri g\u00f6nderecek sunucu taraf\u0131 mant\u0131\u011f\u0131 i\u00e7erir.<\/p>\n
\nimport { GoogleGenerativeAI } from '@google\/generative-ai';\n            import { StreamingTextResponse, streamText } from 'ai';\n\n            \/\/ Next.js Edge Runtime'\u0131 etkinle\u015ftir\n            export const runtime = 'edge';\n\n            const genAI = new GoogleGenerativeAI(process.env.GOOGLE_API_KEY || '');\n\n            export async function POST(req: Request) {\n              const { messages } = await req.json();\n\n              \/\/ GenAI modelini ba\u015flat\n              const model = genAI.getGenerativeModel({ model: 'gemini-pro' });\n\n              \/\/ Sohbet ge\u00e7mi\u015fini modele g\u00f6nder\n              const result = await model.generateContent(messages.map((m: any) => m.content).join('\\n'));\n              const responseText = result.response.text();\n\n              \/\/ Vercel AI SDK ile ak\u0131\u015f\u0131 d\u00f6nd\u00fcr\n              const stream = streamText(responseText); \/\/ Bu k\u0131s\u0131m daha sofistike hale getirilebilir\n\n              return new StreamingTextResponse(stream);\n            }<\/pre>\n<\/code>\n            <\/div>\n
\n                Uzman \u0130pucu: Ger\u00e7ek bir ak\u0131\u015f deneyimi i\u00e7in model.generateContent<\/code> yerine model.generateContentStream<\/code> kullanabilir ve yan\u0131t\u0131 kelime kelime i\u015fleyebilirsiniz. Vercel AI SDK'n\u0131n AIStream<\/code> yard\u0131mc\u0131 fonksiyonlar\u0131 ile bu s\u00fcreci daha da optimize edebilirsiniz.\n            <\/div>\n<\/li>\nSohbet Aray\u00fcz\u00fc Bile\u015feni Olu\u015fturma (app\/page.tsx<\/code> veya components\/Chat.tsx<\/code>):<\/strong>\nBu bile\u015fen, kullan\u0131c\u0131n\u0131n mesaj g\u00f6nderece\u011fi ve asistan\u0131n yan\u0131tlar\u0131n\u0131 g\u00f6rece\u011fi temel UI'yi sa\u011flar.<\/p>\n
\n'use client';\n\n            import { useChat } from 'ai\/react';\n\n            export default function Chat() {\n              const { messages, input, handleInputChange, handleSubmit } = useChat();\n\n              return (\n                \n                  {messages.map(m => (\n                    \n                      {m.role === 'user' ? 'Kullan\u0131c\u0131: ' : 'Asistan: '}\n                      {m.content}\n                    <\/div>\n                  ))}\n\n                  \n                    \n                  <\/form>\n                <\/div>\n              );\n            }<\/pre>\n<\/code>\n            <\/div>\n
Bu temel kurulum, projenizin sohbet \u00f6zellikli \u00e7ekirde\u011fini olu\u015fturur. Kullan\u0131c\u0131 art\u0131k mesaj g\u00f6nderebilir ve YZ modelinden yan\u0131t alabilir. Bir sonraki ad\u0131mda, bu \u00e7ekirde\u011fi Google Takvim ile entegre ederek asistan\u0131m\u0131za ger\u00e7ek bir i\u015flevsellik kazand\u0131raca\u011f\u0131z.<\/p>\n
Google Calendar API Entegrasyonu ve Yetkilendirme \u0130\u015flemleri<\/h3>\nAsistan\u0131m\u0131z\u0131n takvimde etkinlik olu\u015fturabilmesi i\u00e7in Google Calendar API ile entegrasyon kurmam\u0131z ve kullan\u0131c\u0131dan yetki almam\u0131z gerekiyor. Bu s\u00fcre\u00e7 OAuth 2.0 tabanl\u0131d\u0131r ve kullan\u0131c\u0131n\u0131n g\u00fcvenli\u011fini \u00f6n planda tutar.<\/p>\n
\nOAuth 2.0 Ak\u0131\u015f\u0131 \u0130\u00e7in Yard\u0131mc\u0131 Fonksiyonlar (lib\/google-auth.ts<\/code>):<\/strong>\nKullan\u0131c\u0131n\u0131n kimlik do\u011frulamas\u0131n\u0131 ba\u015flatacak ve eri\u015fim belirtecini (access token) y\u00f6netecek yard\u0131mc\u0131 fonksiyonlar\u0131 olu\u015ftural\u0131m. Bu k\u0131s\u0131m genellikle NextAuth.js gibi k\u00fct\u00fcphanelerle daha kolay y\u00f6netilebilir ancak temel mant\u0131\u011f\u0131 g\u00f6stermek i\u00e7in manuel bir yakla\u015f\u0131m sunulmu\u015ftur.<\/p>\n
\n\/\/ lib\/google-auth.ts\n            import { google } from 'googleapis';\n            import { OAuth2Client } from 'google-auth-library';\n\n            const CLIENT_ID = process.env.GOOGLE_CLIENT_ID;\n            const CLIENT_SECRET = process.env.GOOGLE_CLIENT_SECRET;\n            const REDIRECT_URI = process.env.GOOGLE_REDIRECT_URI;\n\n            if (!CLIENT_ID || !CLIENT_SECRET || !REDIRECT_URI) {\n              throw new Error('Missing Google OAuth environment variables');\n            }\n\n            export const oauth2Client = new OAuth2Client(\n              CLIENT_ID,\n              CLIENT_SECRET,\n              REDIRECT_URI\n            );\n\n            \/\/ Gerekli yetkilendirme kapsamlar\u0131\n            const scopes = [\n              'https:\/\/www.googleapis.com\/auth\/calendar.events',\n              'https:\/\/www.googleapis.com\/auth\/calendar.readonly'\n            ];\n\n            export function getAuthUrl() {\n              return oauth2Client.generateAuthUrl({\n                access_type: 'offline',\n                scope: scopes,\n                prompt: 'consent', \/\/ Kullan\u0131c\u0131n\u0131n her zaman onay vermesi i\u00e7in\n              });\n            }\n\n            export async function getTokens(code: string) {\n              const { tokens } = await oauth2Client.getToken(code);\n              return tokens;\n            }\n\n            export async function getAuthenticatedClient(accessToken: string): Promise {\n              oauth2Client.setCredentials({ access_token: accessToken });\n              return oauth2Client;\n            }\n\n            export async function createCalendarEvent(accessToken: string, eventDetails: any) {\n              const auth = await getAuthenticatedClient(accessToken);\n              const calendar = google.calendar({ version: 'v3', auth });\n\n              const event = {\n                summary: eventDetails.summary,\n                description: eventDetails.description,\n                start: {\n                  dateTime: eventDetails.startDateTime,\n                  timeZone: 'Europe\/Istanbul', \/\/ veya dinamik bir zaman dilimi\n                },\n                end: {\n                  dateTime: eventDetails.endDateTime,\n                  timeZone: 'Europe\/Istanbul',\n                },\n                reminders: {\n                  useDefault: false,\n                  overrides: [\n                    { method: 'email', minutes: 24 * 60 },\n                    { method: 'popup', minutes: 30 },\n                  ],\n                },\n              };\n\n              const response = await calendar.events.insert({\n                calendarId: 'primary', \/\/ Kullan\u0131c\u0131n\u0131n birincil takvimi\n                requestBody: event,\n              });\n\n              return response.data;\n            }\n\n            export async function listCalendarEvents(accessToken: string, timeMin: string, timeMax: string) {\n              const auth = await getAuthenticatedClient(accessToken);\n              const calendar = google.calendar({ version: 'v3', auth });\n\n              const response = await calendar.events.list({\n                calendarId: 'primary',\n                timeMin: timeMin,\n                timeMax: timeMax,\n                singleEvents: true,\n                orderBy: 'startTime',\n              });\n\n              return response.data.items;\n            }<\/pre>\n<\/code>\n            <\/div>\n<\/li>\n
OAuth Geri \u00c7a\u011fr\u0131 Rotas\u0131 (app\/api\/auth\/callback\/route.ts<\/code>):<\/strong>\nGoogle'dan gelen yetkilendirme kodunu i\u015fleyecek ve eri\u015fim belirte\u00e7lerini alacak bir rota olu\u015fturun. Bu belirte\u00e7ler, bir veritaban\u0131nda (Firestore gibi) kullan\u0131c\u0131yla ili\u015fkilendirilerek saklanmal\u0131d\u0131r.<\/p>\n
\n\/\/ app\/api\/auth\/callback\/route.ts\n            import { getTokens, oauth2Client } from '..\/..\/..\/lib\/google-auth';\n            import { NextResponse } from 'next\/server';\n\n            export async function GET(request: Request) {\n              const url = new URL(request.url);\n              const code = url.searchParams.get('code');\n\n              if (!code) {\n                return NextResponse.redirect('\/error?message=No code found');\n              }\n\n              try {\n                const tokens = await getTokens(code);\n                \/\/ Tokens'\u0131 (accessToken, refreshToken) veritaban\u0131na kaydet\n                \/\/ \u00d6rne\u011fin: await saveUserTokens({ userId: 'some-user-id', tokens });\n                console.log('Tokenlar ba\u015far\u0131yla al\u0131nd\u0131:', tokens);\n\n                \/\/ Ana uygulamaya y\u00f6nlendir\n                return NextResponse.redirect('\/?auth=success');\n              } catch (error) {\n                console.error('Token al\u0131namad\u0131:', error);\n                return NextResponse.redirect('\/error?message=Failed to get tokens');\n              }\n            }<\/pre>\n<\/code>\n            <\/div>\n<\/li>\n
Yetkilendirme Ba\u015flatma (Frontend):<\/strong>\nKullan\u0131c\u0131n\u0131n Google ile oturum a\u00e7mas\u0131n\u0131 sa\u011flayacak bir buton ekleyin:<\/p>\n
\n\/\/ app\/page.tsx veya ayr\u0131 bir bile\u015fende\n            import { getAuthUrl } from '..\/lib\/google-auth'; \/\/ Sunucu taraf\u0131nda \u00e7a\u011fr\u0131lacak\n\n            export default function Home({ authUrl }: { authUrl: string }) {\n              return (\n                \n                  Topluluk Asistan\u0131<\/h1>\n                  Google ile Takvim'e Ba\u011flan<\/a>\n                  {\/* Sohbet bile\u015feni *\/}\n                  \n                <\/div>\n              );\n            }\n\n            \/\/ Sunucu taraf\u0131nda getAuthUrl'yi \u00e7a\u011f\u0131rmak i\u00e7in\n            export async function getServerSideProps() {\n              const authUrl = getAuthUrl();\n              return { props: { authUrl } };\n            }<\/pre>\n<\/code>\n            <\/div>\n
\n                Uzman \u0130pucu: getServerSideProps<\/code> yerine Next.js 13\/14 App Router kullan\u0131yorsan\u0131z, getAuthUrl<\/code> fonksiyonunu bir sunucu bile\u015feninde do\u011frudan \u00e7a\u011f\u0131rabilir veya bir API rotas\u0131 \u00fczerinden sunabilirsiniz. Eri\u015fim belirte\u00e7lerini g\u00fcvenli bir \u015fekilde sunucu taraf\u0131nda y\u00f6netmek ve istemciye sadece gerekli durumlarda aktarmak g\u00fcvenlik i\u00e7in \u00e7ok \u00f6nemlidir.\n            <\/div>\n<\/li>\n<\/ol>\nBu ad\u0131mlarla, asistan\u0131m\u0131z\u0131n Google Takvim ile yetkili bir \u015fekilde etkile\u015fime girmesi i\u00e7in gerekli altyap\u0131y\u0131 kurmu\u015f olduk. Art\u0131k asistan\u0131m\u0131z, bir kullan\u0131c\u0131n\u0131n takvimine etkinlik ekleyebilir veya mevcut etkinlikleri sorgulayabilir. Bir sonraki b\u00f6l\u00fcmde, bu yetenekleri yapay zeka modelimizle nas\u0131l birle\u015ftirece\u011fimizi inceleyece\u011fiz.<\/p>\n
Yapay Zeka ve Takvim Entegrasyonunu Birle\u015ftirme: Ak\u0131ll\u0131 Etkinlik Planlama Nas\u0131l Sa\u011flan\u0131r?<\/h2>\nAsistan\u0131m\u0131z\u0131n ger\u00e7ek g\u00fcc\u00fc, yapay zeka modelinin do\u011fal dil anlay\u0131\u015f\u0131n\u0131 Google Calendar API'nin i\u015flevselli\u011fiyle birle\u015ftirmesinden gelir. Bu b\u00f6l\u00fcm, kullan\u0131c\u0131n\u0131n do\u011fal dilindeki istekleri anlayarak takvimde otomatik i\u015flemler yapmay\u0131 nas\u0131l sa\u011flayaca\u011f\u0131m\u0131z\u0131 ele alacakt\u0131r. Bu, projemizin en \"ak\u0131ll\u0131\" k\u0131sm\u0131n\u0131 olu\u015fturur.<\/p>\n
Do\u011fal Dil \u0130\u015fleme (NLP) ile Kullan\u0131c\u0131 \u0130steklerini Anlama<\/h3>\nYZ modelimizin (\u00f6rn. Gemini veya GPT) en kritik g\u00f6revlerinden biri, kullan\u0131c\u0131n\u0131n do\u011fal dildeki ifadelerini anlamak ve bir \"niyet\" (intent) ile \"varl\u0131klar\" (entities) \u00e7\u0131karmakt\u0131r. \u00d6rne\u011fin, \"Gelecek \u00c7ar\u015famba \u00f6\u011fleden sonra ekip toplant\u0131s\u0131 planla\" c\u00fcmlesinden modelin \u00e7\u0131karmas\u0131 gerekenler \u015funlard\u0131r:<\/p>\n
\nNiyet:<\/strong> Etkinlik planlama (create_calendar_event<\/code>)<\/li>\n
Varl\u0131klar:<\/strong>\n\nKonu (Summary):<\/strong> Ekip toplant\u0131s\u0131<\/li>\n
Tarih (Date):<\/strong> Gelecek \u00c7ar\u015famba<\/li>\n
Zaman (Time):<\/strong> \u00d6\u011fleden sonra (\u00f6rne\u011fin 13:00-14:00 olarak yorumlanabilir)<\/li>\n<\/ul>\n<\/li>\n<\/ul>\nBu yetenek, genellikle prompt engineering ve \"fonksiyon \u00e7a\u011fr\u0131s\u0131\" (function calling) veya \"ara\u00e7 kullan\u0131m\u0131\" (tool use) ad\u0131 verilen tekniklerle sa\u011flan\u0131r. Model, belirli bir formatta tan\u0131mlad\u0131\u011f\u0131m\u0131z ara\u00e7lar\u0131 (API fonksiyonlar\u0131) tan\u0131yacak \u015fekilde e\u011fitilir.<\/p>\n
\n\/\/ app\/api\/chat\/route.ts i\u00e7inde geli\u015ftirilmi\u015f bir \u00f6rnek\n    \/\/ Not: Bu \u00f6rnek, ger\u00e7ek bir LLM'in function calling \u00f6zelli\u011fini taklit eder.\n    \/\/ Gemini'da veya OpenAI'da bu, modellerin kendi SDK'lar\u0131 ile daha direkt yap\u0131l\u0131r.\n\n    import { GoogleGenerativeAI } from '@google\/generative-ai';\n    import { StreamingTextResponse, streamText } from 'ai';\n    import { createCalendarEvent, listCalendarEvents } from '..\/..\/..\/lib\/google-auth'; \/\/ Calendar API fonksiyonlar\u0131m\u0131z\n\n    export const runtime = 'edge';\n\n    const genAI = new GoogleGenerativeAI(process.env.GOOGLE_API_KEY || '');\n    const model = genAI.getGenerativeModel({\n      model: 'gemini-pro',\n      \/\/ 'tools' \u00f6zelli\u011fi ile LLM'e hangi fonksiyonlar\u0131 kullanabilece\u011fini \u00f6\u011fretiriz\n      tools: [\n        {\n          functionDeclarations: [\n            {\n              name: 'createCalendarEvent',\n              description: 'Google Takvimde yeni bir etkinlik olu\u015fturur.',\n              parameters: {\n                type: 'OBJECT',\n                properties: {\n                  summary: { type: 'STRING', description: 'Etkinli\u011fin ba\u015fl\u0131\u011f\u0131' },\n                  description: { type: 'STRING', description: 'Etkinli\u011fin a\u00e7\u0131klamas\u0131' },\n                  startDateTime: { type: 'STRING', description: 'Etkinli\u011fin ba\u015flang\u0131\u00e7 tarihi ve saati (ISO 8601 format\u0131nda)' },\n                  endDateTime: { type: 'STRING', description: 'Etkinli\u011fin biti\u015f tarihi ve saati (ISO 8601 format\u0131nda)' },\n                },\n                required: ['summary', 'startDateTime', 'endDateTime'],\n              },\n            },\n            {\n              name: 'listCalendarEvents',\n              description: 'Belirli bir zaman aral\u0131\u011f\u0131ndaki Google Takvim etkinliklerini listeler.',\n              parameters: {\n                type: 'OBJECT',\n                properties: {\n                  timeMin: { type: 'STRING', description: 'Ba\u015flang\u0131\u00e7 tarihi ve saati (ISO 8601 format\u0131nda)' },\n                  timeMax: { type: 'STRING', description: 'Biti\u015f tarihi ve saati (ISO 8601 format\u0131nda)' },\n                },\n                required: ['timeMin', 'timeMax'],\n              },\n            },\n          ],\n        },\n      ],\n    });\n\n    export async function POST(req: Request) {\n      const { messages, accessToken } = await req.json(); \/\/ Kullan\u0131c\u0131 accessToken'\u0131n\u0131 da g\u00f6nderiyoruz\n\n      const chat = model.startChat({\n        history: messages.slice(0, -1).map((m: any) => ({\n          role: m.role === 'user' ? 'user' : 'model',\n          parts: [{ text: m.content }],\n        })),\n      });\n\n      const result = await chat.sendMessage(messages[messages.length - 1].content);\n      const response = result.response;\n\n      if (response.functionCall) {\n        const { name, args } = response.functionCall;\n        console.log('LLM bir fonksiyon \u00e7a\u011f\u0131rmak istedi:', name, args);\n\n        try {\n          let funcResult;\n          if (name === 'createCalendarEvent') {\n            funcResult = await createCalendarEvent(accessToken, args);\n            return new StreamingTextResponse(streamText(Harika! '${args.summary}' etkinli\u011fini takvime ekledim. Detaylar: ${funcResult.htmlLink}<\/code>));\n          } else if (name === 'listCalendarEvents') {\n            const events = await listCalendarEvents(accessToken, args.timeMin, args.timeMax);\n            const eventSummaries = events.length > 0\n              ? events.map((e: any) => - ${e.summary} (${e.start.dateTime || e.start.date})<\/code>).join('\\n')\n              : 'Belirtilen aral\u0131kta etkinlik bulunamad\u0131.';\n            return new StreamingTextResponse(streamText(Belirtilen aral\u0131ktaki etkinlikler:\\n${eventSummaries}<\/code>));\n          }\n        } catch (error) {\n          console.error(Fonksiyon \u00e7a\u011fr\u0131l\u0131rken hata (${name}):<\/code>, error);\n          return new StreamingTextResponse(streamText('\u00dczg\u00fcn\u00fcm, iste\u011finizi i\u015flerken bir hata olu\u015ftu. L\u00fctfen tekrar deneyin.'));\n        }\n      } else if (response.text()) {\n        const stream = streamText(response.text());\n        return new StreamingTextResponse(stream);\n      }\n\n      return new StreamingTextResponse(streamText('\u00dczg\u00fcn\u00fcm, iste\u011finizi anlayamad\u0131m.'));\n    }<\/pre>\n<\/code>\n    <\/div>\n
Yukar\u0131daki \u00f6rnekte, YZ modelimize createCalendarEvent<\/code> ve listCalendarEvents<\/code> ad\u0131nda iki fonksiyonumuz oldu\u011funu ve bu fonksiyonlar\u0131n hangi parametreleri bekledi\u011fini \u00f6\u011frettik. Model, kullan\u0131c\u0131 girdisini analiz etti\u011finde, uygun durumlarda bu fonksiyonlardan birini \u00e7a\u011f\u0131rmak i\u00e7in bir \"fonksiyon \u00e7a\u011fr\u0131s\u0131\" iste\u011fi d\u00f6nd\u00fcrecektir. Bizim API rotam\u0131z da bu iste\u011fi yakalayarak ger\u00e7ek Calendar API \u00e7a\u011fr\u0131s\u0131n\u0131 yapacakt\u0131r.<\/p>\n
Dinamik Yan\u0131tlar ve Takvim \u0130\u015flemleri<\/h3>\nYZ modelinden gelen fonksiyon \u00e7a\u011fr\u0131s\u0131 iste\u011fi i\u015flendikten sonra, elde edilen sonuca g\u00f6re kullan\u0131c\u0131ya geri bildirim sa\u011flamak \u00f6nemlidir. Bu, sadece i\u015flemin ba\u015far\u0131l\u0131 olup olmad\u0131\u011f\u0131n\u0131 bildirmekle kalmaz, ayn\u0131 zamanda kullan\u0131c\u0131 deneyimini de geli\u015ftirir. \u00d6rne\u011fin:<\/p>\n
\nBa\u015far\u0131l\u0131 Etkinlik Olu\u015fturma:<\/strong> \"Harika! 'Ekip Toplant\u0131s\u0131' etkinli\u011fini 17 May\u0131s Sal\u0131 13:00'e ekledim. Buradan g\u00f6rebilirsiniz: [Etkinlik Linki]\"<\/li>\n
Ba\u015far\u0131s\u0131z Etkinlik Olu\u015fturma:<\/strong> \"\u00dczg\u00fcn\u00fcm, etkinli\u011fi olu\u015ftururken bir sorun olu\u015ftu. Takvim eri\u015fiminizde bir problem olabilir mi?\"<\/li>\n
Etkinlik Listeleme:<\/strong> \"Gelecek haftaki etkinlikleriniz: [Liste]\"<\/li>\n<\/ul>\nBu dinamik yan\u0131tlar, kullan\u0131c\u0131n\u0131n asistan\u0131n ne yapt\u0131\u011f\u0131n\u0131 net bir \u015fekilde anlamas\u0131n\u0131 sa\u011flar. Hata durumlar\u0131nda kullan\u0131c\u0131ya yol g\u00f6stermek, g\u00fcveni art\u0131r\u0131r. Modelden gelen yan\u0131t\u0131 i\u015flerken, e\u011fer bir fonksiyon \u00e7a\u011fr\u0131s\u0131 yoksa, modelin do\u011frudan metin yan\u0131t\u0131n\u0131 kullan\u0131c\u0131ya iletmeliyiz.<\/p>\n
Vaka Analizi: \"Topluluk bulu\u015fmalar\u0131 i\u00e7in otomatik takvim olu\u015fturma\"<\/h4>\n\u00d6rne\u011fin, bir geli\u015ftirici toplulu\u011fu her ay\u0131n \u00fc\u00e7\u00fcnc\u00fc per\u015fembe g\u00fcn\u00fc bir \u00e7evrimi\u00e7i bulu\u015fma d\u00fczenliyor. Topluluk y\u00f6neticisi her ay takvime manuel olarak bu etkinli\u011fi eklemek zorunda kal\u0131yor. YZ destekli asistan\u0131m\u0131zla, y\u00f6netici sadece \"Her ay\u0131n \u00fc\u00e7\u00fcnc\u00fc per\u015fembe g\u00fcn\u00fc 'Geli\u015ftirici Bulu\u015fmas\u0131' etkinli\u011fini takvime ekle\" diyebilir. Asistan, bu komutu alg\u0131layarak tekrar eden etkinlikleri otomatik olarak takvime i\u015fleyebilir. Hatta \"Kat\u0131l\u0131mc\u0131lar\u0131n listesini takip et\" gibi ek bir y\u00f6nerge verildi\u011finde, Firestore'a kaydolan kullan\u0131c\u0131lar\u0131 da takip edebilir.<\/p>\n
Bu entegrasyon modeli, sadece basit etkinlikleri de\u011fil, ayn\u0131 zamanda daha karma\u015f\u0131k topluluk senaryolar\u0131n\u0131 da otomatikle\u015ftirebilir. \u00d6rne\u011fin, bir \"ment\u00f6rl\u00fck program\u0131na kaydol\" iste\u011fi \u00fczerine, asistan m\u00fcsait ment\u00f6rleri listeler, bir e\u015fle\u015fme yapar ve hem ment\u00f6r\u00fcn hem de menti'nin takvimlerine otomatik olarak ilk bulu\u015fmay\u0131 ekler. Bu t\u00fcr yetenekler, asistan\u0131n topluluk i\u00e7indeki de\u011ferini katlayarak art\u0131r\u0131r.<\/p>\n
Performans Optimizasyonu ve G\u00fcvenlik \u0130pu\u00e7lar\u0131 Nelerdir? (\u0130leri D\u00fczey Kullan\u0131c\u0131lar \u0130\u00e7in)<\/h2>\nUygulamam\u0131z\u0131n temel i\u015flevselli\u011fini in\u015fa ettik, ancak ger\u00e7ek d\u00fcnya senaryolar\u0131nda bir uygulaman\u0131n sadece \u00e7al\u0131\u015fmas\u0131 yeterli de\u011fildir. Performans ve g\u00fcvenlik, \u00f6zellikle hassas takvim verileriyle \u00e7al\u0131\u015ft\u0131\u011f\u0131m\u0131z ve harici API'lere ba\u011f\u0131ml\u0131 oldu\u011fumuz bir uygulamada hayati \u00f6neme sahiptir. Bu b\u00f6l\u00fcmde, asistan\u0131m\u0131z\u0131 daha sa\u011flam, daha g\u00fcvenli ve daha duyarl\u0131 hale getirmek i\u00e7in ileri d\u00fczey ipu\u00e7lar\u0131n\u0131 inceleyece\u011fiz.<\/p>\n
\u00d6nbellekleme ve Oran S\u0131n\u0131rlama (Rate Limiting)<\/h3>\nHer API \u00e7a\u011fr\u0131s\u0131 bir maliyet ve gecikme anlam\u0131na gelir. \u00d6zellikle s\u0131k tekrarlanan veya sabit veriler i\u00e7in gereksiz API \u00e7a\u011fr\u0131lar\u0131n\u0131 \u00f6nlemek, hem performans\u0131 art\u0131r\u0131r hem de maliyetleri d\u00fc\u015f\u00fcr\u00fcr.<\/p>\n
\n\u00d6nbellekleme (Caching):<\/strong>\nE\u011fer asistan s\u0131k s\u0131k \"Gelecek 7 g\u00fcn i\u00e7indeki etkinlikleri listele\" gibi bir istek al\u0131yorsa ve bu etkinlik listesi k\u0131sa bir s\u00fcre i\u00e7inde de\u011fi\u015fmeyecekse, ilk sorgunun sonucunu \u00f6nbellekte tutabiliriz. GCP'de Memorystore (Redis i\u00e7in) gibi hizmetler, bu t\u00fcr bir \u00f6nbellekleme i\u00e7in idealdir. \u00d6rne\u011fin, son 5 dakikadaki etkinlik sorgular\u0131n\u0131n sonu\u00e7lar\u0131n\u0131 \u00f6nbelle\u011fe alabilir ve ayn\u0131 sorgu tekrar geldi\u011finde do\u011frudan \u00f6nbellekten yan\u0131t verebiliriz. Bu, LLM'e yap\u0131lan \u00e7a\u011fr\u0131lar\u0131 ve Calendar API'ye yap\u0131lan \u00e7a\u011fr\u0131lar\u0131 azalt\u0131r, bu da maliyet ve gecikme a\u00e7\u0131s\u0131ndan \u00f6nemli iyile\u015ftirmeler sa\u011flar.<\/p>\n
\n\/\/ \u00d6rnek \u00f6nbellekleme yap\u0131s\u0131 (s\u00f6zde kod)\n            import NodeCache from 'node-cache'; \/\/ \u00d6rne\u011fin basit bir in-memory cache\n\n            const myCache = new NodeCache({ stdTTL: 300, checkperiod: 120 }); \/\/ 5 dakika TTL\n\n            async function getOrListCalendarEvents(accessToken: string, timeMin: string, timeMax: string) {\n              const cacheKey = events-${accessToken}-${timeMin}-${timeMax}<\/code>;\n              let events = myCache.get(cacheKey);\n\n              if (events) {\n                console.log('Etkinlikler \u00f6nbellekten al\u0131nd\u0131.');\n                return events;\n              }\n\n              console.log('Etkinlikler API \u00fczerinden \u00e7ekiliyor.');\n              events = await listCalendarEvents(accessToken, timeMin, timeMax);\n              myCache.set(cacheKey, events);\n              return events;\n            }<\/pre>\n<\/code>\n            <\/div>\n<\/li>\n
Oran S\u0131n\u0131rlama (Rate Limiting):<\/strong>\nUygulaman\u0131z\u0131n, \u00f6zellikle halka a\u00e7\u0131k API rotalar\u0131 \u00fczerinden, k\u00f6t\u00fc niyetli veya a\u015f\u0131r\u0131 isteklerle kar\u015f\u0131la\u015fmas\u0131 olas\u0131d\u0131r. Oran s\u0131n\u0131rlama, belirli bir zaman diliminde bir kullan\u0131c\u0131n\u0131n veya IP adresinin yapabilece\u011fi istek say\u0131s\u0131n\u0131 k\u0131s\u0131tlayarak sunucunuzu korur ve API sa\u011flay\u0131c\u0131n\u0131z\u0131n limitlerini a\u015fman\u0131z\u0131 engeller. Vercel'de middleware'ler veya Redis tabanl\u0131 \u00e7\u00f6z\u00fcmler bu ama\u00e7la kullan\u0131labilir.<\/p>\n
\n\/\/ \u00d6rnek bir rate limit middleware (s\u00f6zde kod)\n            \/\/ import { Ratelimit } from \"@upstash\/ratelimit\";\n            \/\/ import { Redis } from \"@upstash\/redis\";\n\n            \/\/ const ratelimit = new Ratelimit({\n            \/\/   redis: Redis.fromEnv(),\n            \/\/   limiter: Ratelimit.slidingWindow(10, \"10s\"), \/\/ 10 saniyede 10 istek\n            \/\/   analytics: true,\n            \/\/ });\n\n            \/\/ export async function middleware(req: NextRequest) {\n            \/\/   const ip = req.ip ?? \"127.0.0.1\";\n            \/\/   const { success } = await ratelimit.limit(ip);\n\n            \/\/   if (!success) {\n            \/\/     return new NextResponse(\"Too many requests\", { status: 429 });\n            \/\/   }\n            \/\/   return NextResponse.next();\n            \/\/ }<\/pre>\n<\/code>\n            <\/div>\n<\/li>\n<\/ul>\n
Veri G\u00fcvenli\u011fi ve Yetkilendirme Best Practices<\/h3>\nKullan\u0131c\u0131lar\u0131n takvim verileri hassas bilgiler i\u00e7erir. Bu nedenle, uygulaman\u0131n g\u00fcvenli\u011fi en \u00fcst d\u00fczeyde tutulmal\u0131d\u0131r.<\/p>\n
\nOAuth 2.0 Kapsamlar\u0131 (Scopes):<\/strong> Kullan\u0131c\u0131dan sadece uygulaman\u0131z\u0131n ihtiya\u00e7 duydu\u011fu minimum yetkileri isteyin. \u00d6rne\u011fin, sadece etkinlik olu\u015fturman\u0131z gerekiyorsa https:\/\/www.googleapis.com\/auth\/calendar.events<\/code> kapsam\u0131n\u0131 kullan\u0131n, t\u00fcm takvime eri\u015fim sa\u011flayan https:\/\/www.googleapis.com\/auth\/calendar<\/code> kapsam\u0131ndan ka\u00e7\u0131n\u0131n.<\/li>\n
Eri\u015fim Belirte\u00e7lerinin G\u00fcvenli Depolanmas\u0131:<\/strong> Kullan\u0131c\u0131lardan al\u0131nan eri\u015fim belirte\u00e7leri (access token) ve yenileme belirte\u00e7leri (refresh token) asla istemci taraf\u0131nda (taray\u0131c\u0131da) depolanmamal\u0131d\u0131r. Bunlar sunucu taraf\u0131nda (\u00f6rn. Firestore veya Secret Manager'da \u015fifreli olarak) saklanmal\u0131 ve her API \u00e7a\u011fr\u0131s\u0131 i\u00e7in sunucudan al\u0131nmal\u0131d\u0131r. Yenileme belirte\u00e7leri, eri\u015fim belirte\u00e7leri sona erdi\u011finde yeni bir eri\u015fim belirteci almak i\u00e7in kullan\u0131l\u0131r ve \u00f6m\u00fcrleri daha uzundur.<\/li>\n
Ortam De\u011fi\u015fkenlerinin G\u00fcvenli\u011fi:<\/strong> .env<\/code> dosyalar\u0131n\u0131 gitignore'a ekleyin. Vercel gibi platformlarda ortam de\u011fi\u015fkenlerini aray\u00fcz \u00fczerinden veya CLI ile g\u00fcvenli bir \u015fekilde tan\u0131mlay\u0131n. Hassas anahtarlar\u0131 asla do\u011frudan koda g\u00f6mmeyin.<\/li>\n
Giri\u015f Do\u011frulama (Input Validation):<\/strong> Kullan\u0131c\u0131dan veya YZ modelinden gelen verileri her zaman do\u011frulay\u0131n. \u00d6rne\u011fin, takvim etkinli\u011fi olu\u015ftururken tarih ve saat formatlar\u0131n\u0131n do\u011fru oldu\u011fundan emin olun.<\/li>\n
Hata Y\u00f6netimi:<\/strong> API \u00e7a\u011fr\u0131lar\u0131nda veya YZ model etkile\u015fimlerinde olu\u015fabilecek hatalar\u0131 uygun \u015fekilde yakalay\u0131n ve loglay\u0131n. Kullan\u0131c\u0131ya genel ve bilgilendirici hata mesajlar\u0131 sunarken, detayl\u0131 hata bilgilerini sunucu loglar\u0131nda tutun.<\/li>\n<\/ul>\nMobil Uyumluluk ve Duyarl\u0131 Tasar\u0131m<\/h3>\nTopluluk \u00fcyeleri asistan\u0131n\u0131za farkl\u0131 cihazlardan eri\u015febilir. Bu nedenle, uygulaman\u0131n mobil uyumlu ve duyarl\u0131 bir tasar\u0131ma sahip olmas\u0131 kritik \u00f6neme sahiptir. Next.js ve Tailwind CSS gibi ara\u00e7lar, bu konuda \u00f6nemli avantajlar sa\u011flar.<\/p>\n
\nCSS Media Query \u00d6rnekleri:<\/strong> CSS kullanarak ekran boyutlar\u0131na g\u00f6re d\u00fczeni ve stilini ayarlay\u0131n.\n\n