Google ADK (Agent Development Kit) ile geli\u015ftirilen TypeScript tabanl\u0131 ajanlar, modern uygulamalar\u0131n ve etkile\u015fimli sistemlerin kalbinde yer al\u0131yor. Ancak bu ak\u0131ll\u0131 ajanlar\u0131 test etmek, \u00f6zellikle de karma\u015f\u0131k diyalog ak\u0131\u015flar\u0131 ve d\u0131\u015f servis entegrasyonlar\u0131 s\u00f6z konusu oldu\u011funda, \u00e7o\u011fu zaman “c\u00fcmleleri kovalamak” gibi zorlay\u0131c\u0131 bir s\u00fcrece d\u00f6n\u00fc\u015febilir. Bu makale, TypeScript ajanlar\u0131n\u0131z\u0131 daha verimli, g\u00fcvenilir ve mod\u00fcler bir \u015fekilde test etmeniz i\u00e7in kapsaml\u0131 bir rehber sunarak, geli\u015ftirme s\u00fcrecinizi h\u0131zland\u0131rmay\u0131 ve kod kalitenizi art\u0131rmay\u0131 hedefliyor.<\/p>\n
Google ADK TypeScript ajanlar\u0131, kullan\u0131c\u0131larla etkile\u015fim kuran, belirli g\u00f6revleri otomatikle\u015ftiren veya karma\u015f\u0131k i\u015f mant\u0131\u011f\u0131n\u0131 y\u00fcr\u00fcten yaz\u0131l\u0131m bile\u015fenleridir. Bu ajanlar genellikle diyalog sistemleri (\u00f6rne\u011fin, chatbotlar, sesli asistanlar), otomasyon betikleri veya arka plan servisleri olarak i\u015flev g\u00f6r\u00fcrler. TypeScript’in sa\u011flad\u0131\u011f\u0131 tip g\u00fcvenli\u011fi ve modern dil \u00f6zellikleri, bu t\u00fcr ajanlar\u0131n geli\u015ftirilmesini kolayla\u015ft\u0131rsa da, test s\u00fcre\u00e7leri \u00e7o\u011fu zaman g\u00f6z ard\u0131 edilir veya yetersiz kal\u0131r. Geleneksel test yakla\u015f\u0131mlar\u0131, ajanlar\u0131n karma\u015f\u0131k etkile\u015fimlerini ve d\u0131\u015f ba\u011f\u0131ml\u0131l\u0131klar\u0131n\u0131 sim\u00fcle etmede yetersiz kalabilir, bu da hatalar\u0131n \u00fcretim ortam\u0131na s\u0131zmas\u0131na yol a\u00e7abilir. Bu durum, geli\u015ftiricilerin saatlerce s\u00fcren manuel testler yapmas\u0131na veya hatalar\u0131 ay\u0131klamak i\u00e7in uzun diyalog ak\u0131\u015flar\u0131n\u0131 tekrar tekrar takip etmesine neden olur; bu da makalenin ba\u015fl\u0131\u011f\u0131ndaki “c\u00fcmleleri kovalamak” metaforunu ortaya \u00e7\u0131kar\u0131r. Amac\u0131m\u0131z, bu zorluklar\u0131 a\u015fmak ve geli\u015ftiricilere, ajanlar\u0131n\u0131n temel i\u015f mant\u0131\u011f\u0131n\u0131, d\u0131\u015f entegrasyonlar\u0131n\u0131 ve u\u00e7tan uca davran\u0131\u015flar\u0131n\u0131 sistematik bir \u015fekilde test etmeleri i\u00e7in pratik stratejiler ve ara\u00e7lar sunmakt\u0131r. Bu sayede, ajanlar\u0131n\u0131z\u0131n beklenen \u015fekilde \u00e7al\u0131\u015ft\u0131\u011f\u0131ndan emin olabilir, geli\u015ftirme d\u00f6ng\u00fcs\u00fcn\u00fc k\u0131saltabilir ve daha g\u00fcvenilir uygulamalar sunabilirsiniz.<\/p>\n
Google ADK (Agent Development Kit) kavram\u0131, genellikle Google Cloud ekosisteminde, \u00f6zellikle yapay zeka ve makine \u00f6\u011frenimi servisleriyle etkile\u015fim kuran ak\u0131ll\u0131 ajanlar\u0131n geli\u015ftirilmesi i\u00e7in kullan\u0131lan bir dizi ara\u00e7, k\u00fct\u00fcphane ve \u00e7er\u00e7eveyi (framework) ifade eder. Bu ajanlar, Dialogflow gibi diyalogsal yapay zeka platformlar\u0131ndan, Google Cloud Functions veya Cloud Run \u00fczerinde \u00e7al\u0131\u015fan sunucusuz (serverless) arka u\u00e7lara kadar geni\u015f bir yelpazede konumlanabilir. Temel ama\u00e7, kullan\u0131c\u0131 giri\u015flerini i\u015flemek, belirli kararlar almak ve ilgili yan\u0131tlar\u0131 veya eylemleri tetiklemektir. \u00d6rne\u011fin, bir m\u00fc\u015fteri hizmetleri chatbotu, bir sipari\u015f takip sistemi veya bir otomasyon arac\u0131 bir Google ADK TypeScript ajan\u0131 olarak d\u00fc\u015f\u00fcn\u00fclebilir.<\/p>\n
Peki, bu ajanlar\u0131n geli\u015ftirilmesinde neden \u00f6zellikle TypeScript tercih ediliyor? JavaScript’in tip g\u00fcvenli\u011fi olmayan do\u011fas\u0131, \u00f6zellikle b\u00fcy\u00fck ve karma\u015f\u0131k projelerde, hatalara ve bak\u0131m zorluklar\u0131na yol a\u00e7abilir. TypeScript, JavaScript’in \u00fczerine in\u015fa edilmi\u015f, iste\u011fe ba\u011fl\u0131 statik tip denetimi sunan bir \u00fcst k\u00fcmedir. Bu, geli\u015ftiricilerin kodlar\u0131na tip bilgisi eklemesine olanak tan\u0131r, bu da derleme zaman\u0131nda potansiyel hatalar\u0131n yakalanmas\u0131n\u0131 sa\u011flar. Bu \u00f6zellik, \u00f6zellikle \u015fu a\u00e7\u0131lardan kritik \u00f6neme sahiptir:<\/p>\n
Ancak, TypeScript’in sa\u011flad\u0131\u011f\u0131 avantajlara ra\u011fmen, Google ADK TypeScript ajanlar\u0131n\u0131 test etmek kendi i\u00e7inde zorluklar bar\u0131nd\u0131r\u0131r. Bu zorluklar genellikle ajan\u0131n do\u011fas\u0131ndan kaynaklan\u0131r:<\/p>\n
Bu zorluklar\u0131n \u00fcstesinden gelmek, do\u011fru test stratejileri ve ara\u00e7lar\u0131n\u0131 benimsemeyi gerektirir. Bir sonraki b\u00f6l\u00fcmde, ajanlar\u0131n\u0131z\u0131 daha mod\u00fcler ve test edilebilir hale getirecek stratejilere odaklanaca\u011f\u0131z.<\/p>\n
Google ADK TypeScript ajanlar\u0131n\u0131 test etmek, geleneksel yaz\u0131l\u0131m test prensiplerini ajan\u0131n \u00f6zel do\u011fas\u0131na uyarlamay\u0131 gerektirir. “C\u00fcmleleri kovalamadan” etkin bir test s\u00fcreci olu\u015fturman\u0131n anahtar\u0131, ajan\u0131n i\u015f mant\u0131\u011f\u0131n\u0131, d\u0131\u015f ba\u011f\u0131ml\u0131l\u0131klar\u0131n\u0131 ve diyalog ak\u0131\u015flar\u0131n\u0131 m\u00fcmk\u00fcn oldu\u011funca birbirinden ay\u0131rarak mod\u00fcler bir yap\u0131 kurmakt\u0131r. Bu, testlerin daha h\u0131zl\u0131, daha g\u00fcvenilir ve daha kolay yaz\u0131labilir olmas\u0131n\u0131 sa\u011flar. Temel olarak \u00fc\u00e7 ana test seviyesi \u00fczerinde durulur: birim testleri (unit tests), entegrasyon testleri (integration tests) ve u\u00e7tan uca testler (end-to-end tests).<\/p>\n
Birim testleri, uygulaman\u0131z\u0131n en k\u00fc\u00e7\u00fck, ba\u011f\u0131ms\u0131z ve test edilebilir birimlerini (genellikle fonksiyonlar veya metotlar) test etmeye odaklan\u0131r. Bir ADK TypeScript ajan\u0131 ba\u011flam\u0131nda, bu, diyalog ak\u0131\u015f\u0131ndan veya d\u0131\u015f ba\u011f\u0131ml\u0131l\u0131klardan tamamen izole edilmi\u015f saf i\u015f mant\u0131\u011f\u0131 fonksiyonlar\u0131n\u0131 test etmek anlam\u0131na gelir. \u00d6rne\u011fin, bir sipari\u015f takip ajan\u0131n\u0131n sipari\u015f numaras\u0131n\u0131 do\u011frulayan bir fonksiyonu veya bir \u00fcr\u00fcn fiyat\u0131n\u0131 hesaplayan bir fonksiyonu birim testi ile test edilebilir.<\/p>\n
Birim testlerinin temel avantajlar\u0131 \u015funlard\u0131r:<\/p>\n
Bir ajan geli\u015ftirirken, i\u015f mant\u0131\u011f\u0131n\u0131 m\u00fcmk\u00fcn oldu\u011funca diyalog ak\u0131\u015f\u0131ndan ve platforma \u00f6zg\u00fc koddan ay\u0131rmaya \u00e7al\u0131\u015fmal\u0131s\u0131n\u0131z. \u00d6rne\u011fin, bir kullan\u0131c\u0131n\u0131n iste\u011fini i\u015fleyecek bir fonksiyon, bu iste\u011fi Dialogflow’dan m\u0131 yoksa ba\u015fka bir kaynaktan m\u0131 geldi\u011finden ba\u011f\u0131ms\u0131z olarak \u00e7al\u0131\u015fmal\u0131d\u0131r. Bu “saf fonksiyonlar” yakla\u015f\u0131m\u0131, test edilebilirli\u011fi art\u0131r\u0131r.<\/p>\n
Entegrasyon testleri, farkl\u0131 birimlerin veya mod\u00fcllerin birbiriyle ve d\u0131\u015f sistemlerle (veritabanlar\u0131, API’ler, di\u011fer servisler) nas\u0131l etkile\u015fim kurdu\u011funu test eder. Bir ADK TypeScript ajan\u0131 i\u00e7in bu, ajan\u0131n Google Cloud API’leri (Firestore, Cloud Storage gibi), \u00fc\u00e7\u00fcnc\u00fc taraf API’ler veya \u00f6zel arka u\u00e7 servisleriyle do\u011fru \u015fekilde ileti\u015fim kurup kurmad\u0131\u011f\u0131n\u0131 kontrol etmek anlam\u0131na gelir. Entegrasyon testlerinde, d\u0131\u015f ba\u011f\u0131ml\u0131l\u0131klar\u0131n ger\u00e7ek versiyonlar\u0131n\u0131 kullanmak yerine, genellikle “mock” (sahte) veya “stub” (taklit) nesneler kullan\u0131l\u0131r. Bu sayede testler daha h\u0131zl\u0131 ve izole bir \u015fekilde \u00e7al\u0131\u015f\u0131r.<\/p>\n
Entegrasyon testlerinin avantajlar\u0131:<\/p>\n
\u00d6rne\u011fin, bir ajan\u0131n bir kullan\u0131c\u0131n\u0131n sipari\u015f bilgilerini Firestore’dan \u00e7ekmesi gerekiyorsa, entegrasyon testi, Firestore istemcisinin do\u011fru parametrelerle \u00e7a\u011fr\u0131ld\u0131\u011f\u0131n\u0131 ve beklenen veriyi d\u00f6nd\u00fcrd\u00fc\u011f\u00fcn\u00fc (mocklanm\u0131\u015f bir cevapla) do\u011frular. Bu, Firestore’un kendisinin do\u011fru \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131 test etmek yerine, ajan\u0131n Firestore ile olan aray\u00fcz\u00fcn\u00fcn do\u011fru \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131 test eder.<\/p>\n
U\u00e7tan uca testler, bir uygulaman\u0131n t\u00fcm ak\u0131\u015f\u0131n\u0131, kullan\u0131c\u0131n\u0131n bak\u0131\u015f a\u00e7\u0131s\u0131ndan test eder. Bir ADK TypeScript ajan\u0131 i\u00e7in bu, bir kullan\u0131c\u0131n\u0131n ajana bir istek g\u00f6ndermesinden (\u00f6rne\u011fin, bir mesaj veya sesli komut) ajan\u0131n nihai yan\u0131t\u0131 veya eylemi ger\u00e7ekle\u015ftirmesine kadar olan t\u00fcm s\u00fcreci sim\u00fcle etmek anlam\u0131na gelir. Bu testler, genellikle ajan\u0131n da\u011f\u0131t\u0131ld\u0131\u011f\u0131 platformda (Dialogflow konsolu, \u00f6zel bir web aray\u00fcz\u00fc vb.) ger\u00e7ek veya sanal bir kullan\u0131c\u0131 etkile\u015fimini taklit eder.<\/p>\n
E2E testlerinin faydalar\u0131:<\/p>\n
Ancak E2E testleri genellikle yava\u015ft\u0131r, bak\u0131m\u0131 zordur ve bir hata durumunda hatan\u0131n tam yerini tespit etmek daha karma\u015f\u0131kt\u0131r. Bu nedenle, genellikle birim ve entegrasyon testleriyle birlikte, kritik kullan\u0131c\u0131 ak\u0131\u015flar\u0131n\u0131 kapsayacak \u015fekilde s\u0131n\u0131rl\u0131 say\u0131da kullan\u0131l\u0131rlar. \u00d6rne\u011fin, bir kullan\u0131c\u0131n\u0131n “Sipari\u015fimi takip et” demesiyle ba\u015flayan, sipari\u015f numaras\u0131n\u0131 girmesiyle devam eden ve ajan\u0131n sipari\u015f durumunu bildirmesiyle biten bir senaryo E2E testi ile kapsanabilir.<\/p>\n
Etkin bir test stratejisi i\u00e7in genellikle “Test Piramidi” yakla\u015f\u0131m\u0131 \u00f6nerilir:<\/p>\n
Bu piramit, testlerin maliyetini ve h\u0131z\u0131n\u0131 dengeleyerek en iyi kapsay\u0131c\u0131l\u0131\u011f\u0131 sa\u011flar. Bir sonraki b\u00f6l\u00fcmde, bu stratejileri uygulamak i\u00e7in TypeScript ile bir test ortam\u0131n\u0131n nas\u0131l kurulaca\u011f\u0131n\u0131 ad\u0131m ad\u0131m inceleyece\u011fiz.<\/p>\n
Google ADK TypeScript ajanlar\u0131n\u0131z\u0131 verimli bir \u015fekilde test etmek i\u00e7in sa\u011flam bir test ortam\u0131 kurmak kritik \u00f6neme sahiptir. Bu b\u00f6l\u00fcm, pop\u00fcler bir test \u00e7er\u00e7evesi olan Jest’i kullanarak TypeScript projeleriniz i\u00e7in ad\u0131m ad\u0131m bir test ortam\u0131 kurulumunu ve temel birim testi \u00f6rne\u011fini i\u00e7erecektir. Jest, s\u0131f\u0131r yap\u0131land\u0131rma (zero-config) felsefesi, h\u0131zl\u0131 \u00e7al\u0131\u015fma s\u00fcresi ve g\u00fc\u00e7l\u00fc mocking yetenekleri sayesinde TypeScript projeleri i\u00e7in ideal bir se\u00e7imdir.<\/p>\n
\u00d6ncelikle, yeni bir TypeScript projesi ba\u015flatal\u0131m veya mevcut projemizin k\u00f6k dizininde oldu\u011fumuzdan emin olal\u0131m. Gerekli ba\u011f\u0131ml\u0131l\u0131klar\u0131 y\u00fcklemek i\u00e7in terminali kullan\u0131n:<\/p>\n
\nnpm init -y\nnpm install typescript ts-node @types\/node --save-dev\nnpm install jest @types\/jest ts-jest --save-dev\n <\/code><\/pre>\n<\/div>\n\ntypescript<\/code>: TypeScript derleyicisi.<\/li>\nts-node<\/code>: TypeScript dosyalar\u0131n\u0131 do\u011frudan \u00e7al\u0131\u015ft\u0131rmak i\u00e7in (testler i\u00e7in genellikle dolayl\u0131 kullan\u0131l\u0131r).<\/li>\n@types\/node<\/code>: Node.js i\u00e7in tip tan\u0131mlar\u0131.<\/li>\njest<\/code>: Test \u00e7er\u00e7evemiz.<\/li>\n@types\/jest<\/code>: Jest i\u00e7in tip tan\u0131mlar\u0131.<\/li>\nts-jest<\/code>: Jest’in TypeScript dosyalar\u0131n\u0131 anlamas\u0131n\u0131 sa\u011flayan bir \u00f6ni\u015flemci (preprocessor).<\/li>\n<\/ul>\n2. TypeScript Yap\u0131land\u0131rmas\u0131 (tsconfig.json)<\/h3>\n
TypeScript derleyicisinin nas\u0131l davranaca\u011f\u0131n\u0131 belirtmek i\u00e7in bir tsconfig.json<\/code> dosyas\u0131 olu\u015fturun:<\/p>\n\n\n\/\/ tsconfig.json\n{\n \"compilerOptions\": {\n \"target\": \"es2020\",\n \"module\": \"commonjs\",\n \"rootDir\": \".\/src\",\n \"outDir\": \".\/dist\",\n \"esModuleInterop\": true,\n \"strict\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true\n },\n \"include\": [\"src\/**\/*.ts\"],\n \"exclude\": [\"node_modules\", \"dist\"]\n}\n <\/code><\/pre>\n<\/div>\nBu yap\u0131land\u0131rma, modern JavaScript \u00f6zelliklerini kullanmam\u0131z\u0131 ve dosyalar\u0131m\u0131z\u0131n src<\/code> dizininde oldu\u011funu varsayar. Test dosyalar\u0131 i\u00e7in ayr\u0131 bir tsconfig.json<\/code> olu\u015fturmak da m\u00fcmk\u00fcnd\u00fcr, ancak \u00e7o\u011fu k\u00fc\u00e7\u00fck ve orta \u00f6l\u00e7ekli proje i\u00e7in bu yeterlidir.<\/p>\n3. Jest Yap\u0131land\u0131rmas\u0131 (jest.config.js)<\/h3>\n
Jest’in TypeScript ile nas\u0131l \u00e7al\u0131\u015faca\u011f\u0131n\u0131 belirtmek i\u00e7in proje k\u00f6k dizinine jest.config.js<\/code> ad\u0131nda bir dosya ekleyin:<\/p>\n\n\n\/\/ jest.config.js\nmodule.exports = {\n preset: 'ts-jest',\n testEnvironment: 'node',\n testMatch: [\"**\/?(*.)+(spec|test).[jt]s?(x)\"],\n moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],\n collectCoverage: true, \/\/ Kod kapsay\u0131c\u0131l\u0131\u011f\u0131 raporlamas\u0131n\u0131 etkinle\u015ftirir\n coverageDirectory: \"coverage\",\n coveragePathIgnorePatterns: [\n \"\/node_modules\/\",\n \"\/dist\/\"\n ]\n};\n <\/code><\/pre>\n<\/div>\n\npreset: 'ts-jest'<\/code>: Jest’e TypeScript dosyalar\u0131n\u0131 ts-jest<\/code> ile i\u015flemesini s\u00f6yler.<\/li>\ntestEnvironment: 'node'<\/code>: Testlerin Node.js ortam\u0131nda \u00e7al\u0131\u015faca\u011f\u0131n\u0131 belirtir (taray\u0131c\u0131 ortam\u0131 yerine).<\/li>\ntestMatch<\/code>: Jest’in hangi dosyalar\u0131 test olarak kabul edece\u011fini tan\u0131mlar (genellikle .test.ts<\/code> veya .spec.ts<\/code> uzant\u0131l\u0131 dosyalar).<\/li>\ncollectCoverage: true<\/code>: Testlerin kod kapsam\u0131n\u0131 \u00f6l\u00e7mesini sa\u011flar.<\/li>\n<\/ul>\n4. Temel Ajan Fonksiyonu ve Birim Testi \u00d6rne\u011fi<\/h3>\n
\u015eimdi bir \u00f6rnek ajan fonksiyonu ve buna ait bir birim testi yazal\u0131m. Diyelim ki ajan\u0131z\u0131n bir par\u00e7as\u0131 olarak basit bir selamla\u015fma mesaj\u0131 \u00fcreten bir fonksiyonunuz var.<\/p>\n
src\/agentLogic.ts<\/code>:<\/p>\n\n\n\/\/ src\/agentLogic.ts\nexport function generateGreeting(name?: string): string {\n if (name) {\n return Merhaba, ${name}! Size nas\u0131l yard\u0131mc\u0131 olabilirim?<\/code>;\n }\n return \"Merhaba! Size nas\u0131l yard\u0131mc\u0131 olabilirim?\";\n}\n\nexport function calculateOrderTotal(items: { price: number; quantity: number }[]): number {\n if (!items || items.length === 0) {\n return 0;\n }\n return items.reduce((total, item) => total + (item.price * item.quantity), 0);\n}\n <\/code><\/pre>\n<\/div>\nsrc\/agentLogic.test.ts<\/code>:<\/p>\n\n\n\/\/ src\/agentLogic.test.ts\nimport { generateGreeting, calculateOrderTotal } from '.\/agentLogic';\n\ndescribe('generateGreeting', () => {\n test('isim belirtilmedi\u011finde genel bir selamla\u015fma d\u00f6nmeli', () => {\n expect(generateGreeting()).toBe('Merhaba! Size nas\u0131l yard\u0131mc\u0131 olabilirim?');\n });\n\n test('isim belirtildi\u011finde ki\u015fiselle\u015ftirilmi\u015f bir selamla\u015fma d\u00f6nmeli', () => {\n expect(generateGreeting('Ali')).toBe('Merhaba, Ali! Size nas\u0131l yard\u0131mc\u0131 olabilirim?');\n });\n\n test('bo\u015f string isimde genel selamla\u015fma d\u00f6nmeli', () => {\n expect(generateGreeting('')).toBe('Merhaba, ! Size nas\u0131l yard\u0131mc\u0131 olabilirim?'); \/\/ Kas\u0131tl\u0131 olarak bo\u015f string ile test ediyoruz\n });\n});\n\ndescribe('calculateOrderTotal', () => {\n test('bo\u015f \u00fcr\u00fcn listesi i\u00e7in 0 d\u00f6nmeli', () => {\n expect(calculateOrderTotal([])).toBe(0);\n });\n\n test('tek \u00fcr\u00fcn i\u00e7in do\u011fru toplam\u0131 hesaplamal\u0131', () => {\n const items = [{ price: 100, quantity: 1 }];\n expect(calculateOrderTotal(items)).toBe(100);\n });\n\n test('birden fazla \u00fcr\u00fcn i\u00e7in do\u011fru toplam\u0131 hesaplamal\u0131', () => {\n const items = [\n { price: 50, quantity: 2 },\n { price: 25, quantity: 3 }\n ];\n expect(calculateOrderTotal(items)).toBe(50 * 2 + 25 * 3); \/\/ 100 + 75 = 175\n });\n\n test('s\u0131f\u0131r fiyatl\u0131 \u00fcr\u00fcnleri do\u011fru i\u015flemeli', () => {\n const items = [\n { price: 0, quantity: 5 },\n { price: 10, quantity: 1 }\n ];\n expect(calculateOrderTotal(items)).toBe(10);\n });\n\n test('negatif fiyatl\u0131 \u00fcr\u00fcnler i\u00e7in hata d\u00f6nd\u00fcrmese de do\u011fru toplam\u0131 hesaplamal\u0131 (i\u015f mant\u0131\u011f\u0131na ba\u011fl\u0131)', () => {\n const items = [\n { price: -10, quantity: 2 }, \/\/ Negatif fiyatlar ger\u00e7ek d\u00fcnyada olmamal\u0131, ama test ediyoruz\n { price: 20, quantity: 1 }\n ];\n expect(calculateOrderTotal(items)).toBe(-20 + 20); \/\/ 0\n });\n});\n <\/code><\/pre>\n<\/div>\n5. Testleri \u00c7al\u0131\u015ft\u0131rma<\/h3>\n
package.json<\/code> dosyan\u0131za bir betik (script) ekleyerek testleri kolayca \u00e7al\u0131\u015ft\u0131rabilirsiniz:<\/p>\n\n\n\/\/ package.json\n{\n \/\/ ... di\u011fer alanlar\n \"scripts\": {\n \"test\": \"jest\",\n \"test:watch\": \"jest --watch\",\n \"test:coverage\": \"jest --coverage\"\n },\n \/\/ ... di\u011fer alanlar\n}\n <\/code><\/pre>\n<\/div>\n\u015eimdi terminalde npm test<\/code> komutunu \u00e7al\u0131\u015ft\u0131rarak testlerinizi \u00e7al\u0131\u015ft\u0131rabilirsiniz. \u00c7\u0131kt\u0131, testlerin ba\u015far\u0131 durumunu ve kod kapsam\u0131 raporunu g\u00f6sterecektir.<\/p>\nBu kurulumla, ajan\u0131n\u0131z\u0131n temel i\u015f mant\u0131\u011f\u0131n\u0131 izole edilmi\u015f bir \u015fekilde test etmeye ba\u015flayabilirsiniz. Bir sonraki ad\u0131m, d\u0131\u015f ba\u011f\u0131ml\u0131l\u0131klar\u0131 olan daha karma\u015f\u0131k senaryolar\u0131 nas\u0131l ele alaca\u011f\u0131m\u0131z\u0131 \u00f6\u011frenmek olacakt\u0131r.<\/p>\n
Ger\u00e7ek D\u00fcnya Senaryolar\u0131nda Ajan Testi: Vaka Analizleri ve Uygulamalar<\/h2>\n
Bir Google ADK TypeScript ajan\u0131n\u0131n ger\u00e7ek d\u00fcnya senaryolar\u0131nda nas\u0131l test edilece\u011fini anlamak, soyut test kavramlar\u0131n\u0131 somutla\u015ft\u0131rmak i\u00e7in \u00f6nemlidir. Bu b\u00f6l\u00fcmde, \u00fc\u00e7 farkl\u0131 vaka analizi \u00fczerinden ajan test stratejilerini uygulamal\u0131 olarak ele alaca\u011f\u0131z. Her senaryo, farkl\u0131 t\u00fcrde ba\u011f\u0131ml\u0131l\u0131klar ve i\u015f mant\u0131\u011f\u0131 i\u00e7erecek ve bu zorluklar\u0131n \u00fcstesinden gelmek i\u00e7in birim ve entegrasyon testlerinin nas\u0131l kullan\u0131labilece\u011fini g\u00f6sterecektir.<\/p>\n
Vaka Analizi 1: E-ticaret Sipari\u015f Takip Ajan\u0131<\/h3>\n
Senaryo:<\/strong> Bir e-ticaret platformu i\u00e7in geli\u015ftirilen bir chatbot ajan\u0131, kullan\u0131c\u0131n\u0131n sipari\u015f numaras\u0131n\u0131 alarak ilgili sipari\u015fin durumunu (\u00f6rne\u011fin, “Haz\u0131rlan\u0131yor”, “Kargoda”, “Teslim Edildi”) harici bir sipari\u015f y\u00f6netimi API’sinden sorgular ve kullan\u0131c\u0131ya geri bildirimde bulunur.<\/p>\nTest Edilmesi Gerekenler:<\/strong><\/p>\n\n- Sipari\u015f numaras\u0131n\u0131n ge\u00e7erlili\u011fi (format kontrol\u00fc).<\/li>\n
- Harici API’ye yap\u0131lan \u00e7a\u011fr\u0131n\u0131n do\u011fru parametrelerle yap\u0131lmas\u0131.<\/li>\n
- API’den gelen yan\u0131t\u0131n do\u011fru \u015fekilde i\u015flenmesi ve kullan\u0131c\u0131ya uygun mesaj\u0131n olu\u015fturulmas\u0131.<\/li>\n
- API’nin hata d\u00f6nd\u00fcrmesi durumunda ajan\u0131n nas\u0131l tepki verdi\u011fi.<\/li>\n<\/ol>\n
Uygulama ve Test Yakla\u015f\u0131m\u0131:<\/strong><\/p>\nBu senaryoda, ajan\u0131n i\u015f mant\u0131\u011f\u0131n\u0131 (sipari\u015f numaras\u0131n\u0131 do\u011frulama ve kullan\u0131c\u0131ya mesaj olu\u015fturma) harici API \u00e7a\u011fr\u0131s\u0131ndan ay\u0131rmal\u0131y\u0131z. API \u00e7a\u011fr\u0131s\u0131 k\u0131sm\u0131 entegrasyon testi ile, di\u011fer k\u0131s\u0131mlar birim testleri ile ele al\u0131nabilir.<\/p>\n
src\/orderService.ts<\/code> (Harici API ile etkile\u015fimi sim\u00fcle eden servis):<\/p>\n\n\n\/\/ src\/orderService.ts\nexport interface OrderDetails {\n orderId: string;\n status: 'Haz\u0131rlan\u0131yor' | 'Kargoda' | 'Teslim Edildi' | '\u0130ptal Edildi';\n estimatedDelivery?: string;\n}\n\nexport async function fetchOrderDetails(orderId: string): Promise {\n \/\/ Ger\u00e7ek bir senaryoda burada harici bir API \u00e7a\u011fr\u0131s\u0131 olurdu\n \/\/ \u00d6rne\u011fin: const response = await axios.get(https:\/\/api.example.com\/orders\/${orderId}<\/code>);\n \/\/ \u015eimdilik mock bir yan\u0131t d\u00f6nd\u00fcrelim:\n if (orderId === '12345') {\n return { orderId: '12345', status: 'Kargoda', estimatedDelivery: '2 g\u00fcn i\u00e7inde' };\n }\n if (orderId === '98765') {\n return { orderId: '98765', status: 'Teslim Edildi' };\n }\n return null; \/\/ Sipari\u015f bulunamad\u0131\n}\n <\/code><\/pre>\n<\/div>\nsrc\/agentFunctions.ts<\/code> (Ajan\u0131n i\u015f mant\u0131\u011f\u0131):<\/p>\n\n\n\/\/ src\/agentFunctions.ts\nimport { fetchOrderDetails, OrderDetails } from '.\/orderService';\n\nexport function isValidOrderId(orderId: string): boolean {\n return \/^\\d{5}$\/.test(orderId); \/\/ 5 haneli say\u0131 oldu\u011funu varsayal\u0131m\n}\n\nexport async function getOrderStatusMessage(orderId: string): Promise {\n if (!isValidOrderId(orderId)) {\n return 'L\u00fctfen ge\u00e7erli bir sipari\u015f numaras\u0131 girin (\u00f6rne\u011fin: 12345).';\n }\n\n const orderDetails = await fetchOrderDetails(orderId);\n\n if (!orderDetails) {\n return "${orderId}" numaral\u0131 sipari\u015f bulunamad\u0131. L\u00fctfen tekrar kontrol edin.<\/code>;\n }\n\n let message = Sipari\u015finiz (${orderDetails.orderId}) \u015fu anda "${orderDetails.status}" durumundad\u0131r.<\/code>;\n if (orderDetails.estimatedDelivery) {\n message += Tahmini teslimat: ${orderDetails.estimatedDelivery}.<\/code>;\n }\n return message;\n}\n <\/code><\/pre>\n<\/div>\nsrc\/agentFunctions.test.ts<\/code> (Testler):<\/p>\n\n\n\/\/ src\/agentFunctions.test.ts\nimport { isValidOrderId, getOrderStatusMessage } from '.\/agentFunctions';\nimport * as OrderService from '.\/orderService'; \/\/ orderService mod\u00fcl\u00fcn\u00fc mocklamak i\u00e7in\n\n\/\/ OrderService mod\u00fcl\u00fcn\u00fc tamamen mockluyoruz\njest.mock('.\/orderService');\n\ndescribe('isValidOrderId', () => {\n test('ge\u00e7erli sipari\u015f numaras\u0131n\u0131 do\u011frulamal\u0131', () => {\n expect(isValidOrderId('12345')).toBe(true);\n });\n\n test('ge\u00e7ersiz sipari\u015f numaras\u0131n\u0131 reddetmeli (yanl\u0131\u015f uzunluk)', () => {\n expect(isValidOrderId('123')).toBe(false);\n expect(isValidOrderId('123456')).toBe(false);\n });\n\n test('ge\u00e7ersiz sipari\u015f numaras\u0131n\u0131 reddetmeli (harf i\u00e7eriyor)', () => {\n expect(isValidOrderId('abcde')).toBe(false);\n });\n});\n\ndescribe('getOrderStatusMessage', () => {\n \/\/ Her testten \u00f6nce mocklanm\u0131\u015f fonksiyonlar\u0131 temizle\n beforeEach(() => {\n jest.clearAllMocks();\n });\n\n test('ge\u00e7ersiz sipari\u015f numaras\u0131 i\u00e7in uyar\u0131 mesaj\u0131 d\u00f6nmeli', async () => {\n const message = await getOrderStatusMessage('123');\n expect(message).toBe('L\u00fctfen ge\u00e7erli bir sipari\u015f numaras\u0131 girin (\u00f6rne\u011fin: 12345).');\n \/\/ fetchOrderDetails fonksiyonunun \u00e7a\u011fr\u0131lmad\u0131\u011f\u0131n\u0131 do\u011frula\n expect(OrderService.fetchOrderDetails).not.toHaveBeenCalled();\n });\n\n test('sipari\u015f bulunamad\u0131\u011f\u0131nda uyar\u0131 mesaj\u0131 d\u00f6nmeli', async () => {\n \/\/ fetchOrderDetails fonksiyonunu null d\u00f6nd\u00fcrecek \u015fekilde mockla\n (OrderService.fetchOrderDetails as jest.Mock).mockResolvedValue(null);\n\n const message = await getOrderStatusMessage('54321');\n expect(message).toBe('\"54321\" numaral\u0131 sipari\u015f bulunamad\u0131. L\u00fctfen tekrar kontrol edin.');\n expect(OrderService.fetchOrderDetails).toHaveBeenCalledWith('54321');\n });\n\n test('sipari\u015f durumu ve tahmini teslimat ile mesaj d\u00f6nmeli', async () => {\n const mockOrder: OrderService.OrderDetails = {\n orderId: '12345',\n status: 'Kargoda',\n estimatedDelivery: '2 g\u00fcn i\u00e7inde'\n };\n (OrderService.fetchOrderDetails as jest.Mock).mockResolvedValue(mockOrder);\n\n const message = await getOrderStatusMessage('12345');\n expect(message).toBe('Sipari\u015finiz (12345) \u015fu anda \"Kargoda\" durumundad\u0131r. Tahmini teslimat: 2 g\u00fcn i\u00e7inde.');\n expect(OrderService.fetchOrderDetails).toHaveBeenCalledWith('12345');\n });\n\n test('sadece sipari\u015f durumu ile mesaj d\u00f6nmeli (tahmini teslimat yoksa)', async () => {\n const mockOrder: OrderService.OrderDetails = {\n orderId: '98765',\n status: 'Teslim Edildi'\n };\n (OrderService.fetchOrderDetails as jest.Mock).mockResolvedValue(mockOrder);\n\n const message = await getOrderStatusMessage('98765');\n expect(message).toBe('Sipari\u015finiz (98765) \u015fu anda \"Teslim Edildi\" durumundad\u0131r.');\n expect(OrderService.fetchOrderDetails).toHaveBeenCalledWith('98765');\n });\n});\n <\/code><\/pre>\n<\/div>\nBu \u00f6rnekte, isValidOrderId<\/code> fonksiyonu tamamen ba\u011f\u0131ms\u0131z oldu\u011fu i\u00e7in birim testiyle kolayca test edilebilir. getOrderStatusMessage<\/code> fonksiyonu ise fetchOrderDetails<\/code>‘e ba\u011f\u0131ml\u0131d\u0131r. Bu ba\u011f\u0131ml\u0131l\u0131\u011f\u0131, Jest’in jest.mock<\/code> \u00f6zelli\u011fi ile sahte (mock) bir versiyonla de\u011fi\u015ftirerek, ger\u00e7ek API \u00e7a\u011fr\u0131s\u0131 yapmadan ajan\u0131n mant\u0131\u011f\u0131n\u0131 test edebiliyoruz. Bu, entegrasyon testi seviyesinde bir yakla\u015f\u0131md\u0131r, ancak d\u0131\u015f ba\u011f\u0131ml\u0131l\u0131\u011f\u0131 izole etti\u011fimiz i\u00e7in h\u0131zl\u0131 ve kontrol edilebilir kal\u0131r.<\/p>\nVaka Analizi 2: M\u00fc\u015fteri Hizmetleri Chatbotu – S\u0131k\u00e7a Sorulan Sorular (SSS) Ajan\u0131<\/h3>\n
Senaryo:<\/strong> Bir m\u00fc\u015fteri hizmetleri chatbotu, kullan\u0131c\u0131n\u0131n sordu\u011fu sorular\u0131 belirli anahtar kelimelerle e\u015fle\u015ftirerek \u00f6nceden tan\u0131mlanm\u0131\u015f SSS yan\u0131tlar\u0131n\u0131 d\u00f6nd\u00fcr\u00fcr. E\u011fer uygun bir SSS bulunamazsa, kullan\u0131c\u0131y\u0131 bir canl\u0131 temsilciye y\u00f6nlendirir.<\/p>\nTest Edilmesi Gerekenler:<\/strong><\/p>\n\n- Farkl\u0131 kullan\u0131c\u0131 sorular\u0131 i\u00e7in do\u011fru SSS yan\u0131t\u0131n\u0131n e\u015fle\u015ftirilmesi.<\/li>\n
- Anahtar kelime e\u015fle\u015fmesi olmad\u0131\u011f\u0131nda canl\u0131 temsilciye y\u00f6nlendirme mekanizmas\u0131n\u0131n tetiklenmesi.<\/li>\n
- B\u00fcy\u00fck\/k\u00fc\u00e7\u00fck harf duyarl\u0131l\u0131\u011f\u0131 veya benzeri kenar durumlar.<\/li>\n<\/ol>\n
Uygulama ve Test Yakla\u015f\u0131m\u0131:<\/strong><\/p>\nBu ajan, \u00f6zellikle metin i\u015fleme ve e\u015fle\u015ftirme mant\u0131\u011f\u0131na odaklan\u0131r. \u0130\u015f mant\u0131\u011f\u0131n\u0131 izole edip, sadece bu mant\u0131\u011f\u0131 test edebiliriz.<\/p>\n
src\/faqService.ts<\/code>:<\/p>\n\n\n\/\/ src\/faqService.ts\nexport interface FAQItem {\n keywords: string[];\n answer: string;\n}\n\nconst faqs: FAQItem[] = [\n { keywords: ['sipari\u015f', 'takip'], answer: 'Sipari\u015finizi takip etmek i\u00e7in sipari\u015f numaran\u0131z\u0131 girmeniz yeterlidir.' },\n { keywords: ['iade', '\u00fcr\u00fcn'], answer: '\u0130ade i\u015flemleri i\u00e7in l\u00fctfen iade politikam\u0131z\u0131 inceleyin veya m\u00fc\u015fteri hizmetleri ile ileti\u015fime ge\u00e7in.' },\n { keywords: ['kargo', 'teslimat'], answer: 'Kargo ve teslimat s\u00fcreleri \u00fcr\u00fcn\u00fcn\u00fcze ve adresinize g\u00f6re de\u011fi\u015fiklik g\u00f6sterebilir.' },\n];\n\nexport function findFAQAnswer(question: string): string | null {\n const lowerCaseQuestion = question.toLowerCase();\n for (const faq of faqs) {\n if (faq.keywords.some(keyword => lowerCaseQuestion.includes(keyword))) {\n return faq.answer;\n }\n }\n return null;\n}\n <\/code><\/pre>\n<\/div>\nsrc\/faqService.test.ts<\/code>:<\/p>\n\n\n\/\/ src\/faqService.test.ts\nimport { findFAQAnswer } from '.\/faqService';\n\ndescribe('findFAQAnswer', () => {\n test('sipari\u015f ile ilgili soruya do\u011fru yan\u0131t d\u00f6nmeli', () => {\n expect(findFAQAnswer('sipari\u015fimi takip edebilir miyim?')).toBe('Sipari\u015finizi takip etmek i\u00e7in sipari\u015f numaran\u0131z\u0131 girmeniz yeterlidir.');\n });\n\n test('iade ile ilgili soruya do\u011fru yan\u0131t d\u00f6nmeli', () => {\n expect(findFAQAnswer('\u00fcr\u00fcn iadesi nas\u0131l yapabilirim?')).toBe('\u0130ade i\u015flemleri i\u00e7in l\u00fctfen iade politikam\u0131z\u0131 inceleyin veya m\u00fc\u015fteri hizmetleri ile ileti\u015fime ge\u00e7in.');\n });\n\n test('b\u00fcy\u00fck\/k\u00fc\u00e7\u00fck harf duyarl\u0131l\u0131\u011f\u0131n\u0131 do\u011fru i\u015flemeli', () => {\n expect(findFAQAnswer('S\u0130PAR\u0130\u015e\u0130M nerede?')).toBe('Sipari\u015finizi takip etmek i\u00e7in sipari\u015f numaran\u0131z\u0131 girmeniz yeterlidir.');\n });\n\n test('e\u015fle\u015fme bulunamad\u0131\u011f\u0131nda null d\u00f6nmeli', () => {\n expect(findFAQAnswer('\u00fcr\u00fcnleriniz kaliteli mi?')).toBeNull();\n });\n\n test('birden fazla anahtar kelime i\u00e7eren soruya ilk e\u015fle\u015fen yan\u0131t\u0131 d\u00f6nmeli', () => {\n \/\/ 'sipari\u015f' ve 'iade' i\u00e7eren bir soru, 'sipari\u015f' \u00f6nce e\u015fle\u015fti\u011fi i\u00e7in onun yan\u0131t\u0131 gelmeli\n expect(findFAQAnswer('sipari\u015fimi iade etmek istiyorum')).toBe('Sipari\u015finizi takip etmek i\u00e7in sipari\u015f numaran\u0131z\u0131 girmeniz yeterlidir.');\n });\n});\n <\/code><\/pre>\n<\/div>\nBu senaryoda, findFAQAnswer<\/code> fonksiyonu saf bir fonksiyon oldu\u011fu i\u00e7in d\u0131\u015f ba\u011f\u0131ml\u0131l\u0131\u011f\u0131 yoktur ve do\u011frudan birim testleriyle test edilebilir. Bu, ajan\u0131n \u00e7ekirdek mant\u0131\u011f\u0131n\u0131n h\u0131zl\u0131 ve g\u00fcvenilir bir \u015fekilde do\u011frulanmas\u0131n\u0131 sa\u011flar.<\/p>\nVaka Analizi 3: Veri Toplama Ajan\u0131 – Form Doldurma<\/h3>\n
Senaryo:<\/strong> Bir ajan, kullan\u0131c\u0131lardan ad, soyad, e-posta gibi bilgileri ad\u0131m ad\u0131m toplayarak bir kay\u0131t formu doldurur. Her ad\u0131mda kullan\u0131c\u0131n\u0131n girdi\u011fi verinin ge\u00e7erlili\u011fini kontrol eder.<\/p>\nTest Edilmesi Gerekenler:<\/strong><\/p>\n\n- Her bir veri alan\u0131n\u0131n (ad, e-posta vb.) do\u011frulama kurallar\u0131.<\/li>\n
- Kullan\u0131c\u0131ya yanl\u0131\u015f giri\u015flerde uygun hata mesajlar\u0131n\u0131n verilmesi.<\/li>\n
- T\u00fcm veriler topland\u0131\u011f\u0131nda kay\u0131t i\u015fleminin tetiklenmesi (mock bir servise).<\/li>\n<\/ol>\n
Uygulama ve Test Yakla\u015f\u0131m\u0131:<\/strong><\/p>\nBu senaryoda, her bir veri alan\u0131n\u0131n do\u011frulama mant\u0131\u011f\u0131 birim testleriyle, kay\u0131t i\u015flemini tetikleyen k\u0131s\u0131m ise entegrasyon testiyle ele al\u0131nabilir.<\/p>\n
src\/validationService.ts<\/code>:<\/p>\n\n\n\/\/ src\/validationService.ts\nexport function isValidEmail(email: string): boolean {\n return \/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$\/.test(email);\n}\n\nexport function isValidName(name: string): boolean {\n return name.trim().length > 2;\n}\n <\/code><\/pre>\n<\/div>\nsrc\/registrationAgent.ts<\/code> (Ajan\u0131n kay\u0131t mant\u0131\u011f\u0131):<\/p>\n\n\n\/\/ src\/registrationAgent.ts\nimport { isValidEmail, isValidName } from '.\/validationService';\n\nexport interface UserRegistrationData {\n name: string;\n email: string;\n}\n\n\/\/ Mock bir kay\u0131t servisi\nasync function registerUser(data: UserRegistrationData): Promise<{ success: boolean; message: string }> {\n return new Promise((resolve) => {\n setTimeout(() => {\n if (data.email.includes('error')) {\n resolve({ success: false, message: 'Kay\u0131t ba\u015far\u0131s\u0131z oldu: E-posta zaten kullan\u0131mda.' });\n } else {\n resolve({ success: true, message: Kullan\u0131c\u0131 ${data.name} ba\u015far\u0131yla kaydedildi.<\/code> });\n }\n }, 100); \/\/ Asenkron bir i\u015flem sim\u00fclasyonu\n });\n}\n\nexport async function processRegistration(name: string, email: string): Promise {\n if (!isValidName(name)) {\n return 'L\u00fctfen ge\u00e7erli bir isim girin.';\n }\n if (!isValidEmail(email)) {\n return 'L\u00fctfen ge\u00e7erli bir e-posta adresi girin.';\n }\n\n const result = await registerUser({ name, email });\n if (result.success) {\n return result.message;\n } else {\n return Kay\u0131t i\u015flemi s\u0131ras\u0131nda bir hata olu\u015ftu: ${result.message}<\/code>;\n }\n}\n <\/code><\/pre>\n<\/div>\nsrc\/registrationAgent.test.ts<\/code>:<\/p>\n\n\n\/\/ src\/registrationAgent.test.ts\nimport { processRegistration } from '.\/registrationAgent';\nimport * as ValidationService from '.\/validationService';\n\n\/\/ ValidationService'i mocklam\u0131yoruz \u00e7\u00fcnk\u00fc saf fonksiyonlar ve do\u011frudan test edilebilirler.\n\/\/ Ancak registerUser fonksiyonunu i\u00e7eren registrationAgent mod\u00fcl\u00fcndeki registerUser'\u0131 mocklayabiliriz.\n\n\/\/ processRegistration i\u00e7inde \u00e7a\u011fr\u0131lan registerUser fonksiyonunu mocklamak i\u00e7in\n\/\/ do\u011frudan processRegistration'\u0131 i\u00e7eren dosyay\u0131 import edip i\u00e7indeki fonksiyonu spyOn ile mocklayabiliriz.\n\/\/ Ancak daha iyi bir yakla\u015f\u0131m, registerUser'\u0131 ayr\u0131 bir mod\u00fcl olarak d\u0131\u015fa aktarmak ve onu mocklamakt\u0131r.\n\/\/ Bu \u00f6rnekte, processRegistration i\u00e7inde yerle\u015fik bir fonksiyon gibi davranan registerUser'\u0131\n\/\/ ayr\u0131 bir mock edilebilir servis olarak d\u00fc\u015f\u00fcnelim veya do\u011frudan processRegistration'\u0131 test edelim.\n\ndescribe('processRegistration', () => {\n \/\/ isValidName ve isValidEmail fonksiyonlar\u0131n\u0131 mocklayabiliriz, ancak bu \u00f6rnekte\n \/\/ do\u011frudan \u00e7a\u011fr\u0131l\u0131p sonu\u00e7lar\u0131na g\u00f6re test edece\u011fiz.\n \/\/ Ger\u00e7ek bir senaryoda, registerUser'\u0131 mocklamak daha yayg\u0131n olacakt\u0131r.\n\n test('ge\u00e7ersiz isim i\u00e7in hata mesaj\u0131 d\u00f6nmeli', async () => {\n const result = await processRegistration('a', 'test@example.com');\n expect(result).toBe('L\u00fctfen ge\u00e7erli bir isim girin.');\n });\n\n test('ge\u00e7ersiz e-posta i\u00e7in hata mesaj\u0131 d\u00f6nmeli', async () => {\n const result = await processRegistration('Ali Can', 'invalid-email');\n expect(result).toBe('L\u00fctfen ge\u00e7erli bir e-posta adresi girin.');\n });\n\n test('ba\u015far\u0131l\u0131 kay\u0131t i\u00e7in onay mesaj\u0131 d\u00f6nmeli', async () => {\n \/\/ Burada registerUser'\u0131 mocklam\u0131\u015f gibi davran\u0131yoruz.\n \/\/ Ger\u00e7ek bir senaryoda, registerUser'\u0131 d\u0131\u015fa aktar\u0131p jest.mock ile mocklard\u0131k.\n const result = await processRegistration('Ay\u015fe Y\u0131lmaz', 'ayse@example.com');\n expect(result).toBe('Kullan\u0131c\u0131 Ay\u015fe Y\u0131lmaz ba\u015far\u0131yla kaydedildi.');\n });\n\n test('kay\u0131t servisi hata d\u00f6nd\u00fcrd\u00fc\u011f\u00fcnde hata mesaj\u0131 d\u00f6nmeli', async () => {\n \/\/ Hata durumunu sim\u00fcle etmek i\u00e7in \u00f6zel bir e-posta kullan\u0131yoruz\n const result = await processRegistration('Hata Test', 'error@example.com');\n expect(result).toBe('Kay\u0131t i\u015flemi s\u0131ras\u0131nda bir hata olu\u015ftu: Kay\u0131t ba\u015far\u0131s\u0131z oldu: E-posta zaten kullan\u0131mda.');\n });\n});\n <\/code><\/pre>\n<\/div>\nBu vaka analizleri, ajanlar\u0131n\u0131z\u0131n farkl\u0131 bile\u015fenlerini nas\u0131l izole edece\u011finizi ve bunlar\u0131 birim veya entegrasyon testleriyle nas\u0131l kapsayaca\u011f\u0131n\u0131z\u0131 g\u00f6stermektedir. Ba\u011f\u0131ml\u0131l\u0131klar\u0131 mocklamak, testlerin h\u0131zl\u0131 ve g\u00fcvenilir kalmas\u0131n\u0131 sa\u011flarken, ajan\u0131n temel i\u015flevselli\u011fini ve d\u0131\u015f servislerle etkile\u015fimini do\u011frular. Bir sonraki b\u00f6l\u00fcmde, bu test tekniklerini daha da ileriye ta\u015f\u0131yacak geli\u015fmi\u015f y\u00f6ntemlere odaklanaca\u011f\u0131z.<\/p>\n
\u0130leri D\u00fczey Test Teknikleri: Mocking, Stubbing ve Spy Kullan\u0131m\u0131<\/h2>\n
Google ADK TypeScript ajanlar\u0131 genellikle karma\u015f\u0131k d\u0131\u015f ba\u011f\u0131ml\u0131l\u0131klarla (API’ler, veritabanlar\u0131, di\u011fer Google Cloud servisleri) etkile\u015fim kurar ve asenkron i\u015flemler ger\u00e7ekle\u015ftirir. Bu t\u00fcr senaryolarda, sadece birim testleri yeterli olmayabilir. \u0130leri d\u00fczey test teknikleri olan mocking, stubbing ve spy kullan\u0131m\u0131, bu ba\u011f\u0131ml\u0131l\u0131klar\u0131 kontrol alt\u0131na alman\u0131za ve asenkron kodunuzu g\u00fcvenilir bir \u015fekilde test etmenize olanak tan\u0131r. Jest test \u00e7er\u00e7evesi, bu teknikleri uygulamak i\u00e7in g\u00fc\u00e7l\u00fc ara\u00e7lar sunar.<\/p>\n
Mocking (Sahte Nesne Olu\u015fturma)<\/h3>\n
Mocking, bir ba\u011f\u0131ml\u0131l\u0131\u011f\u0131n (\u00f6rne\u011fin, bir servis veya mod\u00fcl) ger\u00e7ek uygulamas\u0131n\u0131, test s\u0131ras\u0131nda kontrol edebilece\u011finiz sahte bir versiyonla de\u011fi\u015ftirmek anlam\u0131na gelir. Mock’lar sadece belirli bir de\u011feri d\u00f6nd\u00fcrmekle kalmaz, ayn\u0131 zamanda kendilerine yap\u0131lan \u00e7a\u011fr\u0131lar\u0131 da kaydedebilirler (ka\u00e7 kez \u00e7a\u011fr\u0131ld\u0131, hangi arg\u00fcmanlarla \u00e7a\u011fr\u0131ld\u0131 vb.). Bu, bir fonksiyonun d\u0131\u015f bir servisle do\u011fru \u015fekilde etkile\u015fim kurup kurmad\u0131\u011f\u0131n\u0131 do\u011frulamak i\u00e7in \u00e7ok kullan\u0131\u015fl\u0131d\u0131r.<\/p>\n
Jest ile Mod\u00fcl Mocklama:<\/strong><\/p>\nDiyelim ki bir ajan\u0131n Google Cloud Firestore ile etkile\u015fime giren bir dataService.ts<\/code> mod\u00fcl\u00fc var. Bu mod\u00fcl\u00fc test ederken ger\u00e7ek Firestore’a ba\u011flanmak istemeyiz.<\/p>\nsrc\/dataService.ts<\/code>:<\/p>\n\n\n\/\/ src\/dataService.ts\n\/\/ Ger\u00e7ek bir senaryoda burada Firebase Admin SDK veya Google Cloud Firestore SDK kullan\u0131lacakt\u0131.\n\/\/ import { Firestore } from '@google-cloud\/firestore';\n\/\/ const db = new Firestore();\n\nexport async function getUserData(userId: string): Promise<{ name: string; email: string } | null> {\n \/\/ Ger\u00e7ek Firestore sorgusu burada olurdu\n \/\/ const docRef = db.collection('users').doc(userId);\n \/\/ const doc = await docRef.get();\n \/\/ return doc.exists ? doc.data() as { name: string; email: string } : null;\n return new Promise(resolve => setTimeout(() => {\n if (userId === 'user123') {\n resolve({ name: 'Ahmet Y\u0131lmaz', email: 'ahmet@example.com' });\n } else {\n resolve(null);\n }\n }, 50));\n}\n\nexport async function updateUserData(userId: string, data: { name?: string; email?: string }): Promise {\n \/\/ Ger\u00e7ek Firestore g\u00fcncelleme i\u015flemi burada olurdu\n \/\/ await db.collection('users').doc(userId).update(data);\n return new Promise(resolve => setTimeout(resolve, 50));\n}\n <\/code><\/pre>\n<\/div>\nsrc\/agentHandler.ts<\/code> (Ajan\u0131n bu servisi kulland\u0131\u011f\u0131 yer):<\/p>\n\n\n\/\/ src\/agentHandler.ts\nimport { getUserData, updateUserData } from '.\/dataService';\n\nexport async function handleUserProfileRequest(userId: string): Promise {\n const userData = await getUserData(userId);\n if (!userData) {\n return 'Kullan\u0131c\u0131 profili bulunamad\u0131.';\n }\n return Kullan\u0131c\u0131 Ad\u0131: ${userData.name}, E-posta: ${userData.email}<\/code>;\n}\n\nexport async function updateUserName(userId: string, newName: string): Promise {\n await updateUserData(userId, { name: newName });\n return Kullan\u0131c\u0131 ${userId} i\u00e7in isim "${newName}" olarak g\u00fcncellendi.<\/code>;\n}\n <\/code><\/pre>\n<\/div>\nsrc\/agentHandler.test.ts<\/code> (Test dosyas\u0131):<\/p>\n\n\n\/\/ src\/agentHandler.test.ts\nimport { handleUserProfileRequest, updateUserName } from '.\/agentHandler';\nimport * as DataService from '.\/dataService'; \/\/ Mocklamak istedi\u011fimiz mod\u00fcl\n\n\/\/ dataService mod\u00fcl\u00fcn\u00fc mockluyoruz\njest.mock('.\/dataService');\n\ndescribe('handleUserProfileRequest', () => {\n beforeEach(() => {\n jest.clearAllMocks(); \/\/ Her testten \u00f6nce mock \u00e7a\u011fr\u0131lar\u0131n\u0131 temizle\n });\n\n test('kullan\u0131c\u0131 verisi bulundu\u011funda do\u011fru mesaj\u0131 d\u00f6nmeli', async () => {\n \/\/ getUserData fonksiyonunun mocklanm\u0131\u015f davran\u0131\u015f\u0131n\u0131 tan\u0131mla\n (DataService.getUserData as jest.Mock).mockResolvedValue({ name: 'Deniz', email: 'deniz@example.com' });\n\n const message = await handleUserProfileRequest('user456');\n expect(message).toBe('Kullan\u0131c\u0131 Ad\u0131: Deniz, E-posta: deniz@example.com');\n expect(DataService.getUserData).toHaveBeenCalledWith('user456'); \/\/ Do\u011fru arg\u00fcmanla \u00e7a\u011fr\u0131ld\u0131\u011f\u0131n\u0131 kontrol et\n expect(DataService.getUserData).toHaveBeenCalledTimes(1); \/\/ Bir kez \u00e7a\u011fr\u0131ld\u0131\u011f\u0131n\u0131 kontrol et\n });\n\n test('kullan\u0131c\u0131 verisi bulunamad\u0131\u011f\u0131nda uygun mesaj\u0131 d\u00f6nmeli', async () => {\n (DataService.getUserData as jest.Mock).mockResolvedValue(null); \/\/ Null d\u00f6necek \u015fekilde mockla\n\n const message = await handleUserProfileRequest('nonexistentUser');\n expect(message).toBe('Kullan\u0131c\u0131 profili bulunamad\u0131.');\n expect(DataService.getUserData).toHaveBeenCalledWith('nonexistentUser');\n });\n});\n\ndescribe('updateUserName', () => {\n beforeEach(() => {\n jest.clearAllMocks();\n });\n\n test('kullan\u0131c\u0131 ad\u0131 ba\u015far\u0131yla g\u00fcncellendi\u011finde onay mesaj\u0131 d\u00f6nmeli', async () => {\n \/\/ updateUserData fonksiyonunun mocklanm\u0131\u015f davran\u0131\u015f\u0131n\u0131 tan\u0131mla\n (DataService.updateUserData as jest.Mock).mockResolvedValue(undefined); \/\/ void bir fonksiyon mock'u\n\n const message = await updateUserName('user789', 'Yeni \u0130sim');\n expect(message).toBe('Kullan\u0131c\u0131 user789 i\u00e7in isim \"Yeni \u0130sim\" olarak g\u00fcncellendi.');\n expect(DataService.updateUserData).toHaveBeenCalledWith('user789', { name: 'Yeni \u0130sim' });\n expect(DataService.updateUserData).toHaveBeenCalledTimes(1);\n });\n});\n <\/code><\/pre>\n<\/div>\nStubbing (Taklit Nesne Olu\u015fturma)<\/h3>\n
Stubbing, bir fonksiyonun veya metodun belirli bir girdi i\u00e7in sabit bir \u00e7\u0131kt\u0131 d\u00f6nd\u00fcrmesini sa\u011flamakt\u0131r. Mocking’e benzerdir ancak stub’lar genellikle \u00e7a\u011fr\u0131 ge\u00e7mi\u015fini kaydetmez veya di\u011fer davran\u0131\u015flar\u0131 kontrol etmez. Sadece belirli bir sonu\u00e7 d\u00f6nd\u00fcrmekle ilgilenirler. Jest’te jest.fn().mockReturnValue()<\/code> veya .mockResolvedValue()<\/code> gibi y\u00f6ntemlerle stub’lar olu\u015fturulabilir.<\/p>\nYukar\u0131daki \u00f6rnekte (DataService.getUserData as jest.Mock).mockResolvedValue(...)<\/code> asl\u0131nda bir stubbing \u00f6rne\u011fidir; belirli bir senaryo i\u00e7in belirli bir de\u011fer d\u00f6nd\u00fcrmesini sa\u011fl\u0131yoruz.<\/p>\nSpies (Casus Fonksiyonlar)<\/h3>\n
Spy’lar, mevcut bir fonksiyonu de\u011fi\u015ftirmeden ona yap\u0131lan \u00e7a\u011fr\u0131lar\u0131 izlemenize olanak tan\u0131r. Bir fonksiyonun \u00e7a\u011fr\u0131l\u0131p \u00e7a\u011fr\u0131lmad\u0131\u011f\u0131n\u0131, ka\u00e7 kez \u00e7a\u011fr\u0131ld\u0131\u011f\u0131n\u0131 ve hangi arg\u00fcmanlarla \u00e7a\u011fr\u0131ld\u0131\u011f\u0131n\u0131 kontrol etmek istedi\u011finizde kullan\u0131\u015fl\u0131d\u0131r. Ger\u00e7ek fonksiyonun \u00e7al\u0131\u015fmas\u0131na izin verirken, ayn\u0131 zamanda onun \u00fczerindeki etkile\u015fimi de g\u00f6zlemlersiniz.<\/p>\n
Jest ile Spy Kullan\u0131m\u0131:<\/strong><\/p>\nDiyelim ki bir ajan\u0131n bir hata durumunda bir loglama fonksiyonunu \u00e7a\u011f\u0131rd\u0131\u011f\u0131ndan emin olmak istiyoruz, ancak ger\u00e7ek loglama i\u015fleminin test s\u0131ras\u0131nda ger\u00e7ekle\u015fmesini istemiyoruz.<\/p>\n
src\/logger.ts<\/code>:<\/p>\n\n\n\/\/ src\/logger.ts\nexport function logError(message: string, context?: any) {\n console.error(ERROR: ${message}<\/code>, context);\n \/\/ Ger\u00e7ek bir uygulamada burada bir loglama servisine (Cloud Logging vb.) g\u00f6nderim olurdu.\n}\n <\/code><\/pre>\n<\/div>\nsrc\/errorAgent.ts<\/code> (Hata durumunda loglama yapan ajan):<\/p>\n\n\n\/\/ src\/errorAgent.ts\nimport { logError } from '.\/logger';\n\nexport function processCriticalOperation(data: any): string {\n if (!data || !data.isValid) {\n logError('Kritik i\u015flem i\u00e7in ge\u00e7ersiz veri al\u0131nd\u0131.', { data });\n return '\u0130\u015flem ba\u015far\u0131s\u0131z oldu: Ge\u00e7ersiz veri.';\n }\n \/\/ Ba\u015far\u0131l\u0131 i\u015flem mant\u0131\u011f\u0131\n return '\u0130\u015flem ba\u015far\u0131yla tamamland\u0131.';\n}\n <\/code><\/pre>\n<\/div>\nsrc\/errorAgent.test.ts<\/code>:<\/p>\n\n\n\/\/ src\/errorAgent.test.ts\nimport { processCriticalOperation } from '.\/errorAgent';\nimport * as Logger from '.\/logger'; \/\/ Spy'layaca\u011f\u0131m\u0131z mod\u00fcl\n\ndescribe('processCriticalOperation', () => {\n let logErrorSpy: jest.SpyInstance;\n\n beforeEach(() => {\n \/\/ Logger.logError fonksiyonunu spy'la\n logErrorSpy = jest.spyOn(Logger, 'logError');\n logErrorSpy.mockImplementation(() => {}); \/\/ Ger\u00e7ek loglama i\u015flemini engelle\n });\n\n afterEach(() => {\n logErrorSpy.mockRestore(); \/\/ Spy'\u0131 orijinal haline geri d\u00f6nd\u00fcr\n });\n\n test('ge\u00e7ersiz veri ile \u00e7a\u011fr\u0131ld\u0131\u011f\u0131nda hata loglamal\u0131 ve uygun mesaj\u0131 d\u00f6nmeli', () => {\n const result = processCriticalOperation({ isValid: false });\n expect(result).toBe('\u0130\u015flem ba\u015far\u0131s\u0131z oldu: Ge\u00e7ersiz veri.');\n expect(logErrorSpy).toHaveBeenCalledTimes(1);\n expect(logErrorSpy).toHaveBeenCalledWith('Kritik i\u015flem i\u00e7in ge\u00e7ersiz veri al\u0131nd\u0131.', { data: { isValid: false } });\n });\n\n test('ge\u00e7erli veri ile \u00e7a\u011fr\u0131ld\u0131\u011f\u0131nda hata loglamamal\u0131 ve ba\u015far\u0131l\u0131 mesaj\u0131 d\u00f6nmeli', () => {\n const result = processCriticalOperation({ isValid: true });\n expect(result).toBe('\u0130\u015flem ba\u015far\u0131yla tamamland\u0131.');\n expect(logErrorSpy).not.toHaveBeenCalled(); \/\/ Hata loglanmamal\u0131\n });\n});\n <\/code><\/pre>\n<\/div>\nBu \u00f6rnekte, jest.spyOn<\/code> ile Logger.logError<\/code> fonksiyonunu izliyoruz. mockImplementation(() => {})<\/code> ile ger\u00e7ek console.error<\/code> \u00e7a\u011fr\u0131s\u0131n\u0131 engelliyoruz, b\u00f6ylece test \u00e7\u0131kt\u0131m\u0131z kirlenmiyor. toHaveBeenCalled<\/code> gibi matcher’lar ile fonksiyonun do\u011fru \u015fekilde \u00e7a\u011fr\u0131l\u0131p \u00e7a\u011fr\u0131lmad\u0131\u011f\u0131n\u0131 kontrol ediyoruz.<\/p>\nAsenkron Kodun Etkin Testi<\/h3>\n
ADK ajanlar\u0131 s\u0131kl\u0131kla asenkron i\u015flemlerle u\u011fra\u015f\u0131r (API \u00e7a\u011fr\u0131lar\u0131, veritaban\u0131 i\u015flemleri). Jest, asenkron testleri kolayla\u015ft\u0131rmak i\u00e7in \u00e7e\u015fitli y\u00f6ntemler sunar:<\/p>\n
\n- Promises:<\/strong>
async\/await<\/code> veya .then().catch()<\/code> zincirlerini kullanarak testler yazabilirsiniz. Jest, bir testin Promise d\u00f6nd\u00fcrd\u00fc\u011f\u00fcn\u00fc otomatik olarak alg\u0131lar ve Promise \u00e7\u00f6z\u00fcmlenene kadar bekler.<\/li>\n.resolves<\/code> \/ .rejects<\/code> Matcher’lar\u0131:<\/strong> Bir Promise’in ba\u015far\u0131yla \u00e7\u00f6z\u00fcmlenmesini veya reddedilmesini do\u011frudan beklemek i\u00e7in bu matcher’lar\u0131 kullanabilirsiniz.<\/li>\n<\/ul>\n\n\n\/\/ Asenkron fonksiyon \u00f6rne\u011fi\nasync function fetchData(): Promise