{"id":42879,"date":"2026-06-27T09:02:04","date_gmt":"2026-06-27T06:02:04","guid":{"rendered":"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/"},"modified":"2026-06-27T09:02:04","modified_gmt":"2026-06-27T06:02:04","slug":"bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek","status":"publish","type":"post","link":"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/","title":{"rendered":"Be\u015f D\u00fcz Metin Dosyas\u0131 ile \u00dc\u00e7 Yapay Zeka Ajan\u0131n\u0131 Y\u00f6netmek"},"content":{"rendered":"

Be\u015f D\u00fcz Metin Dosyas\u0131 ile \u00dc\u00e7 Yapay Zeka Ajan\u0131n\u0131 Y\u00f6netmek<\/h2>\n

Karma\u015f\u0131k yapay zeka sistemlerini y\u00f6netmek i\u00e7in binlerce sat\u0131r koda veya pahal\u0131 orkestrasyon ara\u00e7lar\u0131na ihtiyac\u0131n\u0131z oldu\u011funu mu d\u00fc\u015f\u00fcn\u00fcyorsunuz? Asl\u0131nda, sadece be\u015f adet d\u00fcz metin (plain-text) dosyas\u0131 kullanarak \u00fc\u00e7 farkl\u0131 yapay zeka ajan\u0131n\u0131 m\u00fckemmel bir uyumla y\u00f6netmek m\u00fcmk\u00fcnd\u00fcr. Bu rehberde, b\u00fcy\u00fck dil modellerinin (LLM) g\u00fcc\u00fcn\u00fc en yal\u0131n ve s\u00fcrd\u00fcr\u00fclebilir \u015fekilde nas\u0131l kontrol edebilece\u011finizi ad\u0131m ad\u0131m \u00f6\u011freneceksiniz.<\/p>\n

Yapay zeka d\u00fcnyas\u0131nda son d\u00f6nemde en \u00e7ok konu\u015fulan konulardan biri otonom ajanlard\u0131r. Ancak bu ajanlar\u0131n koordinasyonu, genellikle yaz\u0131l\u0131mc\u0131lar i\u00e7in b\u00fcy\u00fck bir karma\u015faya d\u00f6n\u00fc\u015f\u00fcr. A\u011f\u0131r k\u00fct\u00fcphaneler, karma\u015f\u0131k ba\u011f\u0131ml\u0131l\u0131klar ve s\u00fcrekli de\u011fi\u015fen API yap\u0131lar\u0131 projeleri \u00e7\u0131kmaza sokabilir. \u0130\u015fte tam bu noktada, d\u00fcz metin dosyalar\u0131n\u0131n g\u00fcc\u00fc devreye giriyor. Sadece basit metinler yazarak, sisteminizin esnekli\u011fini art\u0131rabilir ve ajanlar\u0131n\u0131z\u0131 kolayca denetleyebilirsiniz.<\/p>\n

Yapay Zeka Ajan\u0131 (AI Agent) Nedir ve Neden Y\u00f6netilmelidir?<\/h2>\n

\u00d6ncelikle temel kavramlar\u0131 netle\u015ftirmek gerekir. Bir yapay zeka ajan\u0131n\u0131, belirli bir g\u00f6revi yerine getirmek \u00fczere \u00f6zelle\u015ftirilmi\u015f, karar verme yetene\u011fine sahip bir LLM (B\u00fcy\u00fck Dil Modeli) yap\u0131land\u0131rmas\u0131 olarak tan\u0131mlayabiliriz. Bu ajanlar, sadece sorulan sorulara cevap vermekle kalmaz; ellerindeki ara\u00e7lar\u0131 (tools) kullanarak veritabanlar\u0131na eri\u015febilir, e-posta g\u00f6nderebilir veya harici API’ler ile etkile\u015fime ge\u00e7ebilirler.<\/p>\n

Ancak, tek bir ajana t\u00fcm g\u00f6revleri y\u00fcklemek b\u00fcy\u00fck bir hata olur. \u00d6rne\u011fin, hem m\u00fc\u015fteri ili\u015fkilerini y\u00f6neten, hem fatura kesen, hem de sistem g\u00fcvenli\u011fini denetleyen tek bir ajan tasarlarsan\u0131z, bu ajan k\u0131sa s\u00fcrede “ba\u011flam kaymas\u0131” (context drift) ya\u015fayacakt\u0131r. Bu durum, yapay zekan\u0131n hal\u00fcsinasyon g\u00f6rmesine veya yanl\u0131\u015f kararlar almas\u0131na yol a\u00e7ar. Bu nedenle, i\u015fleri b\u00f6lerek birden fazla uzman ajan kullanmak en mant\u0131kl\u0131 \u00e7\u00f6z\u00fcmd\u00fcr.<\/p>\n

\u00c7oklu ajan sistemlerinde (multi-agent systems) en b\u00fcy\u00fck zorluk koordinasyondur. Ajanlar\u0131n ne zaman devreye girece\u011fini, hangi bilgileri payla\u015faca\u011f\u0131n\u0131 ve s\u0131n\u0131rlar\u0131n\u0131n ne oldu\u011funu belirlemek gerekir. Orkestrasyon (orchestration) ad\u0131 verilen bu s\u00fcreci kodun i\u00e7ine g\u00f6mmek yerine, d\u0131\u015far\u0131dan okunabilir d\u00fcz metin dosyalar\u0131yla y\u00f6netmek bize inan\u0131lmaz bir esneklik sa\u011flar. B\u00f6ylece yaz\u0131l\u0131m koduna dokunmadan, sadece bir metin dosyas\u0131n\u0131 g\u00fcncelleyerek t\u00fcm sistemin davran\u0131\u015f\u0131n\u0131 de\u011fi\u015ftirebiliriz.<\/p>\n

Y\u00f6netim Sistemimizin Omurgas\u0131: Be\u015f D\u00fcz Metin Dosyas\u0131 Nedir?<\/h2>\n

Sistemimizi y\u00f6netmek i\u00e7in kullanaca\u011f\u0131m\u0131z be\u015f d\u00fcz metin dosyas\u0131, ajanlar\u0131m\u0131z\u0131n anayasas\u0131, g\u00f6rev tan\u0131mlar\u0131 ve ileti\u015fim protokolleridir. Bu dosyalar\u0131n her biri belirli bir amaca hizmet eder ve insan taraf\u0131ndan kolayca okunup d\u00fczenlenebilir. A\u015fa\u011f\u0131daki tabloda bu dosyalar\u0131n i\u015flevlerini ve formatlar\u0131n\u0131 inceleyebilirsiniz:<\/p>\n\n\n\n\n\n\n\n\n\n
Dosya Ad\u0131<\/th>\nFormat\u0131<\/th>\nTemel Amac\u0131<\/th>\n<\/tr>\n<\/thead>\n
global_rules.txt<\/code><\/td>\nD\u00fcz Metin (Plain-text)<\/td>\nSistem genelinde ge\u00e7erli etik kurallar, dil tonu ve KVKK s\u0131n\u0131rlar\u0131.<\/td>\n<\/tr>\n
agent_registry.txt<\/code><\/td>\nJSON \/ YAML (Metin tabanl\u0131)<\/td>\nSistemdeki ajanlar\u0131n isimleri, rolleri ve uzmanl\u0131k alanlar\u0131.<\/td>\n<\/tr>\n
routing_matrix.txt<\/code><\/td>\nD\u00fcz Metin (Kurallar listesi)<\/td>\nGelen talebin hangi ajana y\u00f6nlendirilece\u011fini belirleyen matris.<\/td>\n<\/tr>\n
shared_context.txt<\/code><\/td>\nD\u00fcz Metin (Dinamik)<\/td>\nAjanlar\u0131n ortakla\u015fa kulland\u0131\u011f\u0131 g\u00fcncel oturum ve durum bilgileri.<\/td>\n<\/tr>\n
tool_manifest.txt<\/code><\/td>\nJSON \/ YAML (Metin tabanl\u0131)<\/td>\nAjanlar\u0131n eri\u015febilece\u011fi harici ara\u00e7lar\u0131n ve fonksiyonlar\u0131n listesi.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Bu be\u015f dosya, sistemimizin “kontrol merkezi” olarak i\u015flev g\u00f6r\u00fcr. Herhangi bir kodlama bilgisine sahip olmayan bir \u00fcr\u00fcn y\u00f6neticisi bile, sadece global_rules.txt<\/code> dosyas\u0131n\u0131 d\u00fczenleyerek yapay zekan\u0131n m\u00fc\u015fterilere kar\u015f\u0131 tak\u0131naca\u011f\u0131 tavr\u0131 an\u0131nda de\u011fi\u015ftirebilir. Bu durum, yaz\u0131l\u0131m geli\u015ftirme s\u00fcre\u00e7lerinde inan\u0131lmaz bir h\u0131z ve ba\u011f\u0131ms\u0131zl\u0131k kazand\u0131r\u0131r.<\/p>\n

Ad\u0131m Ad\u0131m Kurulum: \u00dc\u00e7 Ajanl\u0131 Senaryomuzu Nas\u0131l Tasarl\u0131yoruz?<\/h2>\n

Bu sistemi daha iyi anlamak i\u00e7in ger\u00e7ek\u00e7i bir senaryo \u00fczerinden ilerleyelim. T\u00fcrkiye pazar\u0131nda faaliyet g\u00f6steren “YoreselLezzetler.com” ad\u0131nda bir e-ticaret sitemiz oldu\u011funu hayal edelim. Bu sitede m\u00fc\u015fteri memnuniyetini sa\u011flamak, sipari\u015fleri takip etmek ve g\u00fcvenli\u011fi denetlemek i\u00e7in \u00fc\u00e7 farkl\u0131 yapay zeka ajan\u0131 tasarlayaca\u011f\u0131z:<\/p>\n

    \n
  • M\u00fc\u015fteri \u0130li\u015fkileri Ajan\u0131 (MIA):<\/strong> M\u00fc\u015fteriyi samimi bir dille kar\u015f\u0131lar, sorular\u0131 dinler ve ilk analizi yapar.<\/li>\n
  • Sipari\u015f ve Lojistik Ajan\u0131 (SLA):<\/strong> Kargo takibi, iade s\u00fcre\u00e7leri ve stok kontrolleri gibi operasyonel i\u015fleri y\u00fcr\u00fct\u00fcr.<\/li>\n
  • Kalite ve G\u00fcvenlik Denet\u00e7isi (KGD):<\/strong> G\u00f6r\u00fc\u015fmeleri KVKK (Ki\u015fisel Verilerin Korunmas\u0131 Kanunu) a\u00e7\u0131s\u0131ndan denetler, kredi kart\u0131 veya adres gibi hassas verileri maskeler.<\/li>\n<\/ul>\n

    \u015eimdi bu \u00fc\u00e7 ajan\u0131 y\u00f6netmek i\u00e7in kullanaca\u011f\u0131m\u0131z be\u015f metin dosyas\u0131n\u0131n i\u00e7eriklerini haz\u0131rlayal\u0131m. \u0130lk olarak global_rules.txt<\/code> dosyam\u0131z\u0131 olu\u015ftural\u0131m. Bu dosya, t\u00fcm ajanlar\u0131n uymas\u0131 gereken k\u0131rm\u0131z\u0131 \u00e7izgileri belirler:<\/p>\n

    \n
    [S\u0130STEM GENEL\u0130 KURALLARI]\n1. Dil her zaman T\u00fcrk\u00e7e, profesyonel ama samimi olmal\u0131d\u0131r.\n2. Kesinlikle siyaset, din veya toplumsal hassasiyeti olan konulara girilmeyecektir.\n3. Kullan\u0131c\u0131dan asla \u015fifre, kredi kart\u0131 CVV kodu gibi hassas bilgiler talep edilmeyecektir.\n4. KVKK kurallar\u0131 gere\u011fi, adres ve telefon bilgileri payla\u015f\u0131lmadan \u00f6nce maskelenmelidir.\n5. Bilinmeyen veya emin olunmayan durumlarda \"Bilmiyorum\" denmeli, uydurma bilgi verilmemelidir.<\/code><\/pre>\n<\/div>\n
    \u0130kinci olarak, sistemdeki ajanlar\u0131m\u0131z\u0131 tan\u0131mlayan agent_registry.txt<\/code> dosyas\u0131n\u0131 haz\u0131rl\u0131yoruz. Bu dosya, her bir ajan\u0131n kimli\u011fini ve yetki alan\u0131n\u0131 netle\u015ftirir:<\/p>\n
    \n
    {\n  \"agents\": {\n    \"MIA\": {\n      \"name\": \"M\u00fc\u015fteri \u0130li\u015fkileri Ajan\u0131\",\n      \"description\": \"Kullan\u0131c\u0131y\u0131 kar\u015f\u0131lar, genel sorular\u0131 yan\u0131tlar ve \u015fikayetleri dinler.\",\n      \"allowed_tools\": [\"search_faq\"]\n    },\n    \"SLA\": {\n      \"name\": \"Sipari\u015f ve Lojistik Ajan\u0131\",\n      \"description\": \"Sipari\u015f durumunu sorgular, kargo takibi yapar ve iade taleplerini i\u015fler.\",\n      \"allowed_tools\": [\"check_order_status\", \"trigger_refund\"]\n    },\n    \"KGD\": {\n      \"name\": \"Kalite ve G\u00fcvenlik Denet\u00e7isi\",\n      \"description\": \"S\u00fcre\u00e7lerin g\u00fcvenli\u011fini denetler, hassas verileri filtreler.\",\n      \"allowed_tools\": [\"mask_sensitive_data\"]\n    }\n  }\n}<\/code><\/pre>\n<\/div>\n
    Kod \u00dczerinde G\u00f6relim: Python ile D\u00fcz Metin Dosyalar\u0131n\u0131 Okumak ve Ajanlar\u0131 Y\u00f6netmek<\/h3>\n
    Olu\u015fturdu\u011fumuz bu d\u00fcz metin dosyalar\u0131n\u0131 Python tabanl\u0131 bir orkestrat\u00f6r (y\u00f6nlendirici) ile nas\u0131l hayata ge\u00e7irece\u011fimizi g\u00f6relim. A\u015fa\u011f\u0131daki kod blo\u011fu, dosyalar\u0131 okuyarak gelen kullan\u0131c\u0131 mesaj\u0131n\u0131 do\u011fru ajana nas\u0131l y\u00f6nlendirece\u011fimizi basit\u00e7e g\u00f6stermektedir:<\/p>\n
    \n
    import json\n\ndef load_text_file(file_path):\n    with open(file_path, 'r', encoding='utf-8') as file:\n        return file.read()\n\ndef load_json_file(file_path):\n    with open(file_path, 'r', encoding='utf-8') as file:\n        return json.load(file)\n\n# Dosyalar\u0131 y\u00fckl\u00fcyoruz\nglobal_rules = load_text_file('global_rules.txt')\nagent_registry = load_json_file('agent_registry.txt')\nrouting_matrix = load_text_file('routing_matrix.txt')\n\ndef route_user_query(query):\n    print(f\"Gelen Kullan\u0131c\u0131 Talebi: {query}\")\n    # Basit bir y\u00f6nlendirme mant\u0131\u011f\u0131 (Ger\u00e7ek senaryoda LLM karar verir)\n    if \"kargo\" in query or \"sipari\u015f\" in query or \"iade\" in query:\n        target_agent = \"SLA\"\n    elif \"kart\" in query or \"\u015fifre\" in query or \"adres\" in query:\n        target_agent = \"KGD\"\n    else:\n        target_agent = \"MIA\"\n    \n    agent_info = agent_registry[\"agents\"][target_agent]\n    print(f\"Y\u00f6nlendirilen Ajan: {agent_info['name']}\")\n    print(f\"Uygulanan Kurallar: {global_rules[:100]}...\")\n    return target_agent\n\n# Test ediyoruz\nselected_agent = route_user_query(\"Ge\u00e7en hafta verdi\u011fim Trabzon tereya\u011f\u0131 sipari\u015fim hala kargoya verilmedi, durum nedir?\")\n<\/code><\/pre>\n<\/div>\n
    Yukar\u0131daki Python kodu, sistemimizin ne kadar mod\u00fcler \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131n en temel kan\u0131t\u0131d\u0131r. Kodun kendisi olduk\u00e7a basittir; \u00e7\u00fcnk\u00fc t\u00fcm i\u015f mant\u0131\u011f\u0131, kurallar ve ajan tan\u0131mlar\u0131 d\u00fcz metin dosyalar\u0131nda tutulmaktad\u0131r. Bu sayede, gelecekte yeni bir kural eklemek veya bir ajan\u0131n yetkisini de\u011fi\u015ftirmek istedi\u011fimizde Python kodunu de\u011fi\u015ftirmemiz veya yeniden deploy etmemiz (yay\u0131na almam\u0131z) gerekmez.<\/p>\n
    Ajanlar Aras\u0131 \u0130leti\u015fim ve Y\u00f6nlendirme (Routing) Nas\u0131l Sa\u011flan\u0131r?<\/h2>\n
    \u00c7oklu ajan sistemlerinde en kritik a\u015fama, bir ajan\u0131n i\u015fi bitti\u011finde veya yetkisini a\u015fan bir durumla kar\u015f\u0131la\u015ft\u0131\u011f\u0131nda g\u00f6revi di\u011fer ajana nas\u0131l devredece\u011fidir (handoff). Bu s\u00fcreci y\u00f6netmek i\u00e7in routing_matrix.txt<\/code> dosyas\u0131n\u0131 kullan\u0131yoruz. Bu dosya, ajanlar aras\u0131ndaki ge\u00e7i\u015f yollar\u0131n\u0131 tan\u0131mlayan basit bir y\u00f6nlendirme k\u0131lavuzudur.<\/p>\n
    \u00d6rne\u011fin, bir m\u00fc\u015fteri “Sipari\u015fim nerede?” diye sordu\u011funda, ilk olarak MIA (M\u00fc\u015fteri \u0130li\u015fkileri Ajan\u0131) devreye girer. Ancak MIA, do\u011frudan veritaban\u0131na eri\u015fip sipari\u015f sorgulayamaz. Bu durumda MIA, talebi SLA’ya (Sipari\u015f ve Lojistik Ajan\u0131) devretmek zorundad\u0131r. \u0130\u015fte routing_matrix.txt<\/code> dosyam\u0131z\u0131n i\u00e7eri\u011fi bu ge\u00e7i\u015fleri \u015f\u00f6yle tan\u0131mlar:<\/p>\n
    \n
    [Y\u00d6NLEND\u0130RME KURALLARI]\nIF user_intent CONTAINS \"kargo, sipari\u015f, iade, stok\" -> TRANSFER_TO(SLA)\nIF user_input CONTAINS \"adres, telefon, tc, email\" -> EXECUTE_FIRST(KGD) -> THEN_TRANSFER\nIF agent_response CONTAINS \"hata, sistem ar\u0131zas\u0131\" -> TRANSFER_TO(HUMAN_SUPPORT)\nIF user_intent IS \"genel_sohbet, te\u015fekk\u00fcr, kar\u015f\u0131lama\" -> TRANSFER_TO(MIA)<\/code><\/pre>\n<\/div>\n
    Bu matris sayesinde, ana y\u00f6nlendirici (router) LLM, kullan\u0131c\u0131n\u0131n girdisini analiz ederek bir sonraki ad\u0131mda hangi ajan\u0131n konu\u015fmas\u0131 gerekti\u011fine karar verir. Bu durum, gereksiz token (anlaml\u0131 kelime par\u00e7ac\u0131klar\u0131) harcamas\u0131n\u0131 \u00f6nler ve sistemin yan\u0131t s\u00fcresini (latency) ciddi oranda d\u00fc\u015f\u00fcr\u00fcr.<\/p>\n
    Ger\u00e7ek D\u00fcnya Vaka Analizi: Yerel E-Ticaret Sitemizde Ajan Y\u00f6netimi<\/h2>\n
    Sistemimizin ba\u015far\u0131s\u0131n\u0131 \u00f6l\u00e7mek i\u00e7in ger\u00e7ek bir senaryoyu sim\u00fcle edelim. M\u00fc\u015fterimiz Ahmet Bey, “YoreselLezzetler.com” \u00fczerinden ald\u0131\u011f\u0131 Kars ka\u015far\u0131n\u0131n bozuk \u00e7\u0131kt\u0131\u011f\u0131n\u0131 iddia ederek sisteme ba\u015fvuruyor ve iade talep ediyor. S\u00fcrecin arka planda nas\u0131l i\u015fledi\u011fini ad\u0131m ad\u0131m inceleyelim:<\/p>\n
    Ad\u0131m 1: Kar\u015f\u0131lama ve Analiz (MIA):<\/strong> Ahmet Bey sisteme yazar: “Merhaba, d\u00fcn gelen Kars ka\u015far\u0131 k\u00fcflenmi\u015fti. \u0130ade etmek istiyorum. Adresim: Kad\u0131k\u00f6y\/\u0130stanbul, Tel: 0532…” MIA mesaj\u0131 al\u0131r. global_rules.txt<\/code> dosyas\u0131ndaki KVKK kurallar\u0131n\u0131 hat\u0131rlar. Ancak do\u011frudan adrese m\u00fcdahale edemedi\u011fi i\u00e7in \u00f6nce g\u00fcvenlik filtresini tetikler.<\/p>\n
    Ad\u0131m 2: G\u00fcvenlik Denetimi (KGD):<\/strong> routing_matrix.txt<\/code> gere\u011fi, girdi i\u00e7erisinde adres ve telefon oldu\u011fu i\u00e7in KGD devreye girer. Hassas verileri maskeler: “Adresim: [MASKELEND\u0130], Tel: [MASKELEND\u0130]”. Temizlenen veriyi ortak haf\u0131za dosyas\u0131 olan shared_context.txt<\/code> i\u00e7erisine yazar.<\/p>\n
    Ad\u0131m 3: Operasyon ve \u0130ade (SLA):<\/strong> Temizlenen talep SLA’ya iletilir. SLA, tool_manifest.txt<\/code> dosyas\u0131nda tan\u0131ml\u0131 olan check_order_status<\/code> arac\u0131n\u0131 kullanarak Ahmet Bey’in d\u00fcn ger\u00e7ekten bir Kars ka\u015far\u0131 sipari\u015fi verip vermedi\u011fini kontrol eder. Sipari\u015f do\u011frulan\u0131r ve iade s\u00fcreci ba\u015flat\u0131l\u0131r.<\/p>\n
    Ad\u0131m 4: Kapan\u0131\u015f (MIA):<\/strong> SLA i\u015flemini tamamlad\u0131ktan sonra g\u00f6revi tekrar MIA’ya devreder. MIA, Ahmet Bey’e samimi bir dille yan\u0131t verir: “Ahmet Bey, ya\u015fad\u0131\u011f\u0131n\u0131z bu olumsuz deneyim i\u00e7in \u00e7ok \u00fczg\u00fcn\u00fcz. K\u00fcflenmi\u015f Kars ka\u015far\u0131 sipari\u015finiz i\u00e7in iade i\u015flemini ba\u015flatt\u0131k. \u00dccret iadeniz 3 i\u015f g\u00fcn\u00fc i\u00e7inde kart\u0131n\u0131za yans\u0131yacakt\u0131r.”<\/p>\n
    Bu s\u00fcre\u00e7 boyunca hi\u00e7bir insan m\u00fcdahalesi olmam\u0131\u015f, ancak sistem son derece g\u00fcvenli, KVKK kurallar\u0131na uygun ve tutarl\u0131 bir \u015fekilde \u00e7al\u0131\u015fm\u0131\u015ft\u0131r. T\u00fcm bu koordinasyon, sadece arka plandaki be\u015f d\u00fcz metin dosyas\u0131n\u0131n s\u0131n\u0131rlar\u0131 i\u00e7erisinde ger\u00e7ekle\u015fmi\u015ftir.<\/p>\n
    \u0130leri D\u00fczey \u0130pu\u00e7lar\u0131: Performans\u0131 Art\u0131rmak ve Hatalar\u0131 \u00d6nlemek<\/h2>\n
    Bu sistemi kendi projelerinizde uygularken performans kayb\u0131 ya\u015famamak ve maliyetleri optimize etmek i\u00e7in dikkat etmeniz gereken baz\u0131 ileri d\u00fczey p\u00fcf noktalar\u0131 vard\u0131r. D\u00fcz metin dosyalar\u0131yla \u00e7al\u0131\u015fmak her ne kadar kolay olsa da, \u00f6l\u00e7eklenebilirlik a\u015famas\u0131nda baz\u0131 yap\u0131land\u0131rma stratejilerine ihtiya\u00e7 duyar.<\/p>\n
    Bununla birlikte, en s\u0131k kar\u015f\u0131la\u015f\u0131lan sorunlardan biri “dosya \u015fi\u015fmesi” (file bloating) durumudur. \u00d6zellikle shared_context.txt<\/code> gibi dinamik dosyalar, konu\u015fma uzad\u0131k\u00e7a \u00e7ok fazla yer kaplayabilir. Bu durum, LLM’e her istek g\u00f6nderildi\u011finde y\u00fcksek token t\u00fcketimine yol a\u00e7ar. Bunu \u00f6nlemek i\u00e7in, her 5 konu\u015fma d\u00f6n\u00fc\u015f\u00fcnde bir eski ba\u011flam\u0131 \u00f6zetleyen (summarization) bir mekanizma kurmal\u0131s\u0131n\u0131z.<\/p>\n
    Ayr\u0131ca, d\u00fcz metin dosyalar\u0131n\u0131z\u0131 Git gibi bir versiyon kontrol sistemi (version control system) ile takip etmeniz hayati \u00f6nem ta\u015f\u0131r. Prompt engineering (y\u00f6nerge m\u00fchendisli\u011fi) s\u00fcre\u00e7lerinde yapaca\u011f\u0131n\u0131z k\u00fc\u00e7\u00fck bir kelime de\u011fi\u015fikli\u011fi, ajanlar\u0131n davran\u0131\u015f\u0131n\u0131 tamamen de\u011fi\u015ftirebilir. Dosyalar\u0131n\u0131z\u0131 Git \u00fczerinde tutarak, olas\u0131 bir hatada “g\u00fcvenli s\u00fcr\u00fcme” (rollback) saniyeler i\u00e7inde geri d\u00f6nebilirsiniz.<\/p>\n
    Sonu\u00e7 ve S\u0131k\u00e7a Sorulan Sorular<\/h2>\n
    Sonu\u00e7 olarak, yapay zeka ajanlar\u0131n\u0131 y\u00f6netmek i\u00e7in karma\u015f\u0131k ve a\u011f\u0131r framework’lere (yaz\u0131l\u0131m \u00e7er\u00e7evelerine) mahkum de\u011filsiniz. Be\u015f basit d\u00fcz metin dosyas\u0131 kullanarak hem sisteminizin kontrol\u00fcn\u00fc elinizde tutabilir, hem de geli\u015ftirme maliyetlerini minimuma indirebilirsiniz. Bu yakla\u015f\u0131m, sisteminizi gelecekte \u00e7\u0131kacak yeni LLM modellerine entegre etmeyi de son derece kolayla\u015ft\u0131r\u0131r; \u00e7\u00fcnk\u00fc tek yapman\u0131z gereken, ayn\u0131 metin dosyalar\u0131n\u0131 yeni modele beslemektir.<\/p>\n
    S\u0131k\u00e7a Sorulan Sorular<\/h3>\n
    1. Bu d\u00fcz metin dosyalar\u0131n\u0131 hangi s\u0131kl\u0131kla g\u00fcncellemeliyim?<\/strong>
    \nSisteminizin kurallar\u0131 veya i\u015f s\u00fcre\u00e7leriniz de\u011fi\u015ftik\u00e7e bu dosyalar\u0131 g\u00fcncelleyebilirsiniz. Kod g\u00fcncellemesi gerektirmedi\u011fi i\u00e7in, canl\u0131 ortamdaki (production) sisteme an\u0131nda yans\u0131r.<\/p>\n
    2. JSON yerine tamamen d\u00fcz metin (.txt) kullanabilir miyim?<\/strong>
    \nEvet, kullanabilirsiniz. Ancak ajan tan\u0131mlar\u0131 ve ara\u00e7 listeleri gibi yap\u0131land\u0131r\u0131lm\u0131\u015f veriler i\u00e7in JSON veya YAML format\u0131, Python taraf\u0131nda parse edilmesini (ayr\u0131\u015ft\u0131r\u0131lmas\u0131n\u0131) kolayla\u015ft\u0131rd\u0131\u011f\u0131 i\u00e7in daha avantajl\u0131d\u0131r.<\/p>\n
    3. Bu y\u00f6ntem g\u00fcvenlik a\u00e7\u0131\u011f\u0131 olu\u015fturur mu?<\/strong>
    \nHay\u0131r, tam aksine g\u00fcvenli\u011fi art\u0131r\u0131r. Kurallar\u0131n\u0131z kodun i\u00e7inde g\u00f6m\u00fcl\u00fc olmad\u0131\u011f\u0131 i\u00e7in, g\u00fcvenlik denet\u00e7ileri (auditors) sadece bu be\u015f metin dosyas\u0131n\u0131 inceleyerek sistemin KVKK ve di\u011fer reg\u00fclasyonlara uygunlu\u011funu kolayca raporlayabilir.<\/p>\n
    4. B\u00fcy\u00fck projelerde bu sistem yava\u015flamaya neden olur mu?<\/strong>
    \nHay\u0131r. D\u00fcz metin dosyalar\u0131n\u0131 bellekte (RAM) \u00f6nbelle\u011fe (cache) alarak okuma h\u0131z\u0131n\u0131 milisaniyeler seviyesine indirebilirsiniz. Bu sayede sistem son derece performansl\u0131 \u00e7al\u0131\u015f\u0131r.<\/p>\n
    #YapayZeka #AjanY\u00f6netimi #Yaz\u0131l\u0131mGeli\u015ftirme #AI #PromptEngineering<\/p>\n","protected":false},"excerpt":{"rendered":"Karma\u015f\u0131k yapay zeka sistemlerini y\u00f6netmek i\u00e7in binlerce sat\u0131r koda veya pahal\u0131 orkestrasyon ara\u00e7lar\u0131na ihtiyac\u0131n\u0131z oldu\u011funu mu d\u00fc\u015f\u00fcn\u00fcyorsunuz?","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"csco_page_header_type":"","csco_page_load_nextpost":"","csco_page_subscribe_form":"","csco_page_contact_form":"","footnotes":""},"categories":[1],"tags":[],"class_list":{"0":"post-42879","1":"post","2":"type-post","3":"status-publish","4":"format-standard","6":"category-genel","7":"cs-entry","8":"cs-video-wrap"},"yoast_head":"\nBe\u015f D\u00fcz Metin Dosyas\u0131 ile \u00dc\u00e7 Yapay Zeka Ajan\u0131n\u0131 Y\u00f6netmek - Kodlar\u0131n Gizemli D\u00fcnyas\u0131<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/\" \/>\n<meta property=\"og:locale\" content=\"tr_TR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Be\u015f D\u00fcz Metin Dosyas\u0131 ile \u00dc\u00e7 Yapay Zeka Ajan\u0131n\u0131 Y\u00f6netmek\" \/>\n<meta property=\"og:description\" content=\"Karma\u015f\u0131k yapay zeka sistemlerini y\u00f6netmek i\u00e7in binlerce sat\u0131r koda veya pahal\u0131 orkestrasyon ara\u00e7lar\u0131na ihtiyac\u0131n\u0131z oldu\u011funu mu d\u00fc\u015f\u00fcn\u00fcyorsunuz?\" \/>\n<meta property=\"og:url\" content=\"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/\" \/>\n<meta property=\"og:site_name\" content=\"Kodlar\u0131n Gizemli D\u00fcnyas\u0131\" \/>\n<meta property=\"article:published_time\" content=\"2026-06-27T06:02:04+00:00\" \/>\n<meta name=\"author\" content=\"Fatih Soysal\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Yazan:\" \/>\n\t<meta name=\"twitter:data1\" content=\"Fatih Soysal\" \/>\n\t<meta name=\"twitter:label2\" content=\"Tahmini okuma s\u00fcresi\" \/>\n\t<meta name=\"twitter:data2\" content=\"12 dakika\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/\"},\"author\":{\"name\":\"Fatih Soysal\",\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1\"},\"headline\":\"Be\u015f D\u00fcz Metin Dosyas\u0131 ile \u00dc\u00e7 Yapay Zeka Ajan\u0131n\u0131 Y\u00f6netmek\",\"datePublished\":\"2026-06-27T06:02:04+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/\"},\"wordCount\":2006,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1\"},\"inLanguage\":\"tr\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/#respond\"]}],\"copyrightYear\":\"2026\",\"copyrightHolder\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/\",\"url\":\"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/\",\"name\":\"Be\u015f D\u00fcz Metin Dosyas\u0131 ile \u00dc\u00e7 Yapay Zeka Ajan\u0131n\u0131 Y\u00f6netmek - Kodlar\u0131n Gizemli D\u00fcnyas\u0131\",\"isPartOf\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#website\"},\"datePublished\":\"2026-06-27T06:02:04+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/#breadcrumb\"},\"inLanguage\":\"tr\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Anasayfa\",\"item\":\"https:\/\/fatihsoysal.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Be\u015f D\u00fcz Metin Dosyas\u0131 ile \u00dc\u00e7 Yapay Zeka Ajan\u0131n\u0131 Y\u00f6netmek\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#website\",\"url\":\"https:\/\/fatihsoysal.com\/blog\/\",\"name\":\"Fatihsoysal.com\",\"description\":\"Blog - Yaz\u0131l\u0131m D\u00fcnyas\u0131 Tecr\u00fcbelerim\",\"publisher\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/fatihsoysal.com\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"tr\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1\",\"name\":\"Fatih Soysal\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"tr\",\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/fatihsoysal.com\/blog\/wp-content\/uploads\/2024\/04\/cropped-replicate-prediction-3kgg1hgjn5rgp0cf0p5tr0jw7w-1.png\",\"contentUrl\":\"https:\/\/fatihsoysal.com\/blog\/wp-content\/uploads\/2024\/04\/cropped-replicate-prediction-3kgg1hgjn5rgp0cf0p5tr0jw7w-1.png\",\"width\":512,\"height\":512,\"caption\":\"Fatih Soysal\"},\"logo\":{\"@id\":\"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/image\/\"},\"description\":\"Kullan\u0131m ve kodlama m\u00fckemmeliyetini odak alan uygulamalar olu\u015fturma deneyimine sahip, profesyonel olarak 15+ y\u0131l \u00fczeri deneyime sahip bir yaz\u0131l\u0131m m\u00fchendisi.\",\"url\":\"https:\/\/fatihsoysal.com\/blog\/author\/fatihsoysal\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Be\u015f D\u00fcz Metin Dosyas\u0131 ile \u00dc\u00e7 Yapay Zeka Ajan\u0131n\u0131 Y\u00f6netmek - Kodlar\u0131n Gizemli D\u00fcnyas\u0131","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/","og_locale":"tr_TR","og_type":"article","og_title":"Be\u015f D\u00fcz Metin Dosyas\u0131 ile \u00dc\u00e7 Yapay Zeka Ajan\u0131n\u0131 Y\u00f6netmek","og_description":"Karma\u015f\u0131k yapay zeka sistemlerini y\u00f6netmek i\u00e7in binlerce sat\u0131r koda veya pahal\u0131 orkestrasyon ara\u00e7lar\u0131na ihtiyac\u0131n\u0131z oldu\u011funu mu d\u00fc\u015f\u00fcn\u00fcyorsunuz?","og_url":"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/","og_site_name":"Kodlar\u0131n Gizemli D\u00fcnyas\u0131","article_published_time":"2026-06-27T06:02:04+00:00","author":"Fatih Soysal","twitter_card":"summary_large_image","twitter_misc":{"Yazan:":"Fatih Soysal","Tahmini okuma s\u00fcresi":"12 dakika"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/#article","isPartOf":{"@id":"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/"},"author":{"name":"Fatih Soysal","@id":"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1"},"headline":"Be\u015f D\u00fcz Metin Dosyas\u0131 ile \u00dc\u00e7 Yapay Zeka Ajan\u0131n\u0131 Y\u00f6netmek","datePublished":"2026-06-27T06:02:04+00:00","mainEntityOfPage":{"@id":"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/"},"wordCount":2006,"commentCount":0,"publisher":{"@id":"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1"},"inLanguage":"tr","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/#respond"]}],"copyrightYear":"2026","copyrightHolder":{"@id":"https:\/\/fatihsoysal.com\/blog\/#organization"}},{"@type":"WebPage","@id":"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/","url":"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/","name":"Be\u015f D\u00fcz Metin Dosyas\u0131 ile \u00dc\u00e7 Yapay Zeka Ajan\u0131n\u0131 Y\u00f6netmek - Kodlar\u0131n Gizemli D\u00fcnyas\u0131","isPartOf":{"@id":"https:\/\/fatihsoysal.com\/blog\/#website"},"datePublished":"2026-06-27T06:02:04+00:00","breadcrumb":{"@id":"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/#breadcrumb"},"inLanguage":"tr","potentialAction":[{"@type":"ReadAction","target":["https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/fatihsoysal.com\/blog\/bes-duz-metin-dosyasi-ile-uc-yapay-zeka-ajanini-yonetmek\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Anasayfa","item":"https:\/\/fatihsoysal.com\/blog\/"},{"@type":"ListItem","position":2,"name":"Be\u015f D\u00fcz Metin Dosyas\u0131 ile \u00dc\u00e7 Yapay Zeka Ajan\u0131n\u0131 Y\u00f6netmek"}]},{"@type":"WebSite","@id":"https:\/\/fatihsoysal.com\/blog\/#website","url":"https:\/\/fatihsoysal.com\/blog\/","name":"Fatihsoysal.com","description":"Blog - Yaz\u0131l\u0131m D\u00fcnyas\u0131 Tecr\u00fcbelerim","publisher":{"@id":"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/fatihsoysal.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"tr"},{"@type":["Person","Organization"],"@id":"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/002a254750921dcfd568a99e48240dd1","name":"Fatih Soysal","image":{"@type":"ImageObject","inLanguage":"tr","@id":"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/image\/","url":"https:\/\/fatihsoysal.com\/blog\/wp-content\/uploads\/2024\/04\/cropped-replicate-prediction-3kgg1hgjn5rgp0cf0p5tr0jw7w-1.png","contentUrl":"https:\/\/fatihsoysal.com\/blog\/wp-content\/uploads\/2024\/04\/cropped-replicate-prediction-3kgg1hgjn5rgp0cf0p5tr0jw7w-1.png","width":512,"height":512,"caption":"Fatih Soysal"},"logo":{"@id":"https:\/\/fatihsoysal.com\/blog\/#\/schema\/person\/image\/"},"description":"Kullan\u0131m ve kodlama m\u00fckemmeliyetini odak alan uygulamalar olu\u015fturma deneyimine sahip, profesyonel olarak 15+ y\u0131l \u00fczeri deneyime sahip bir yaz\u0131l\u0131m m\u00fchendisi.","url":"https:\/\/fatihsoysal.com\/blog\/author\/fatihsoysal\/"}]}},"yoast_meta":{"yoast_wpseo_title":"","yoast_wpseo_metadesc":"","yoast_wpseo_canonical":""},"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/posts\/42879","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/comments?post=42879"}],"version-history":[{"count":0,"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/posts\/42879\/revisions"}],"wp:attachment":[{"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/media?parent=42879"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/categories?post=42879"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fatihsoysal.com\/blog\/wp-json\/wp\/v2\/tags?post=42879"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}