← Blog'a Dön
Yeni Başlayanlar İçin AI Ajanı Oluşturma Rehberi: İlk Ajanınızı Adım Adım Kurun
Yapay Zeka 32 dk okuma Yayın: Güncelleme:

Yeni Başlayanlar İçin AI Ajanı Oluşturma Rehberi: İlk Ajanınızı Adım Adım Kurun

Sıfırdan AI ajanı oluşturma rehberi: temel kavramlar sözlüğü, ilk ajanınız için doğru görev seçimi, kodsuz kurulum adımları, prompt yazma, test etme, sık yapılan hatalar ve 8 haftalık öğrenme yol haritası.

Yapay zeka ajanları hakkında okuduğunuz her yazı, siz daha ne olduğunu anlamadan “ReAct döngüsü”, “tool calling” ve “vektör veritabanı” demeye başlıyor. Bu rehber öyle değil.

Burada hiçbir teknik geçmişi olmadığı varsayılan bir okuyucu için, ilk AI ajanınızı gerçekten çalışır hâle getirene kadar izlemeniz gereken yolu anlatıyorum: kavramların gündelik dilde karşılığı, ilk ajan için doğru görevi seçme yöntemi, kod yazmadan kurulum, ajanın nasıl test edileceği ve yeni başlayanların en sık düştüğü tuzaklar.

Bu yazı başlangıç seviyesi için yazıldı. Mimari kararlar, kod tabanlı kurulum, MCP ve maliyet optimizasyonu gibi ileri konular için AI agent kurulumu rehberine bakabilirsiniz.


Önce Şunu Netleştirelim: AI Ajanı Nedir?

En yalın tanımı şu: AI ajanı, kendisine verilen bir hedefe ulaşmak için kendi başına adım atabilen bir yapay zeka sistemidir.

Farkı bir örnekle görelim. Diyelim ki elinizde bir e-posta kutusu var ve gelen taleplerin ilgili departmana yönlendirilmesi gerekiyor.

ChatGPT’ye sorarsanız: E-postayı kopyalayıp yapıştırırsınız, “bu hangi departmana gitmeli?” dersiniz, o söyler, siz de gidip elle yönlendirirsiniz. Düşünme işini o yapar, iş yapmayı siz.

Bir ajan kurarsanız: E-posta geldiğinde ajan onu kendisi okur, içeriğine bakar, gerekiyorsa CRM’den müşteri kaydını çeker, doğru departmana atar ve size “şunu şuraya yönlendirdim” der. Hem düşünme hem iş yapma onda.

Aradaki tek fark aslında şu: ajanın araçları vardır. Bir yapay zeka modeli, kendisine “e-posta okuma” ve “kayıt atama” gibi araçlar verildiğinde ve bunları ne zaman kullanacağına kendisi karar edebildiğinde ajana dönüşür.

Ajan mı, chatbot mu, otomasyon mu?

Bu üç kelime sürekli birbirinin yerine kullanılıyor ama üçü farklı şeyler:

Ne yaparÖrnekNe zaman doğru seçim
ChatbotSoruya cevap verir”Kargom nerede?” → bilgi metni dönerBilgi verme, sık sorulan sorular
OtomasyonSabit adımları tekrarlarForm dolduruldu → CRM’e kaydet → bildirim gönderAdımları önceden bilinen işler
AI AjanıHedefe göre kendi adımlarını seçer”Bu talebi çöz” → gereken neyse onu yaparAdımları girdiye göre değişen işler

Yeni başlayanlar için en önemli cümle bu: Yapacağınız işi bir akış şeması olarak çizebiliyorsanız, ajana ihtiyacınız yok — sıradan bir otomasyon daha ucuz, daha hızlı ve daha güvenilir olur. Ajan, akış şemasını çizemediğiniz yerde işe yarar.


Temel Kavramlar Sözlüğü

Ajan dünyasında sürekli karşınıza çıkacak on kavramın gündelik dildeki karşılığı:

KavramNe demek
Model (LLM)Ajanın “beyni”. Metni anlayan ve üreten yapay zeka. Claude, GPT gibi.
PromptModele verdiğiniz talimat. Ajanlarda buna “sistem talimatı” denir.
Sistem talimatıAjanın kim olduğunu, ne yapacağını ve neyi yapmayacağını anlatan kalıcı metin.
Araç (tool)Ajanın dış dünyaya dokunma biçimi. E-posta gönderme, veri çekme, kayıt açma.
Araç çağrısı (tool call)Ajanın bir aracı kullanmaya karar verip çalıştırması.
TokenMetnin faturalandırma birimi. Kabaca 4 karakter ≈ 1 token. Maliyet buradan hesaplanır.
Bağlam penceresi (context)Ajanın aynı anda “aklında tutabildiği” metin miktarı.
Hafıza (memory)Ajanın oturumlar arası hatırladığı bilgiler.
RAG / bilgi tabanıAjanın soru geldiğinde içinden arama yaptığı doküman havuzu.
Otonomi seviyesiAjanın insana sormadan ne kadar iş yapabildiği.

Bu on kelimeyi anladıysanız, ajan yazılarının %80’ini rahatça okuyabilirsiniz.


İlk Ajanınız İçin Doğru Görevi Seçmek

Yeni başlayanların yaptığı bir numaralı hata, ilk ajanı en heyecan verici işte kurmaya çalışmak: müşteriyle konuşan bir asistan. Bu, yüzme öğrenmeye açık denizde başlamaya benzer. Hata yaparsınız — ki yapacaksınız — ve hatayı müşteri görür.

Doğru ilk görev üç ölçütü birden karşılar:

Ölçüt 1: Sık tekrarlanıyor

Haftada en az birkaç kez yapılan bir iş olmalı. Ayda iki kez yapılan on dakikalık bir işi otomatikleştirmek, kurulum ve bakım süresini asla çıkarmaz.

Ölçüt 2: Hata maliyeti düşük

Ajan yanlış yaparsa ne olur? Cevap “birisi düzeltir, 5 dakika kaybederiz” ise iyi. Cevap “müşteriye yanlış fiyat gider” ise ilk proje için uygun değil.

Ölçüt 3: Sonucu ölçülebilir

Ajanın işi doğru yapıp yapmadığına bakarak karar verebilmelisiniz. “Daha iyi hizmet” ölçülemez; “doğru departmana yönlendirme oranı” ölçülebilir.

Yeni başlayanlar için iyi ilk projeler

  • Gelen talepleri kategorilere ayırma ve etiketleme
  • Uzun dokümanlardan belirli bilgileri çıkarıp tabloya yazma
  • Haftalık rapor taslağı hazırlama (veriyi çekip özetleme)
  • Rakip sitelerdeki fiyat/içerik değişikliklerini takip edip özet çıkarma
  • Toplantı kaydından karar maddelerini ve görevleri çıkarma

Yeni başlayanlar için kötü ilk projeler

  • Müşteriye doğrudan cevap yazan destek botu
  • Fiyat veya teklif oluşturan sistem
  • Para transferi, iptal, silme gibi geri alınamaz işlemler yapan ajan
  • Aynı anda beş farklı sisteme bağlanan “her şeyi yapan” asistan

Ajanınızı Kurmadan Önce: Tek Sayfalık Tanım

Araca dokunmadan önce bir sayfalık bir tanım yazın. Bu, kurulum sırasında yaşayacağınız kafa karışıklığının %70’ini önler.

Şu altı başlığı doldurun:

1. AJANIN ADI VE İŞİ
   Talep Sınıflandırıcı — gelen destek e-postalarını okur ve etiketler.

2. TETİKLEYİCİ (ne zaman çalışır?)
   Destek kutusuna yeni e-posta düştüğünde.

3. GİRDİ (eline ne geçer?)
   E-postanın gönderen adresi, konusu ve metni.

4. ARAÇLAR (neye erişebilir?)
   - musteri_ara: E-posta adresiyle CRM'de müşteri kaydı arar (sadece okur)
   - etiket_ekle: Talebe kategori etiketi ekler
   - ekibe_ata: Talebi bir departmana atar

5. ÇIKTI (işi bitince ne olmuş olur?)
   Talep etiketlenmiş ve doğru departmana atanmış olur.

6. YAPMAYACAKLARI
   - Müşteriye cevap yazmaz
   - Talebi kapatmaz veya siler
   - Fiyat/söz vermez

Altıncı madde çoğu kişinin atladığı ama en değerli maddedir. Ajanın yapmayacaklarını yazmak, yapacaklarını yazmak kadar önemlidir.


Adım Adım Kurulum: Kod Yazmadan

İlk ajan için kod yazmanıza gerek yok. n8n, Make veya benzeri görsel araçlarla, tarayıcıdan sürükle-bırak ile çalışan bir ajan kurulabilir. Aşağıda n8n üzerinden anlatıyorum ama mantık her araçta aynı. (n8n’i kendi sunucunuza kurmak isterseniz: n8n kurulumu rehberi.)

Adım 1 — Hesap ve model bağlantısı

Aracınıza bir yapay zeka modeli bağlamanız gerekiyor. Bunun için model sağlayıcısından bir API anahtarı alırsınız ve araca yapıştırırsınız.

Güvenlik notu: API anahtarınız kredi kartı gibidir. Ekran görüntüsünde, e-postada, Slack mesajında paylaşmayın. Bir yere yapıştırdıysanız ve emin değilseniz, sağlayıcı panelinden iptal edip yenisini oluşturun.

Adım 2 — Tetikleyiciyi kurun

Ajanı ne başlatacak? Seçenekler:

  • Zamanlanmış: Her sabah 09:00’da çalış
  • Olay tabanlı: Yeni e-posta geldiğinde, form doldurulduğunda
  • Manuel: Siz butona bastığınızda (ilk testler için en iyisi)

İlk kurulumda manuel tetikleyici ile başlayın. Otomatik tetikleyiciye ancak ajanın davranışına güvendiğinizde geçin.

Adım 3 — AI Agent düğümünü ekleyin

Bu, ajanın kalbi. Üç şey ister: model, sistem talimatı, araçlar.

Adım 4 — Sistem talimatını yazın

Burası kurulumun kalitesini en çok belirleyen yer. Yeni başlayanların en sık hatası, talimatı iki cümlede geçiştirmek. İyi bir talimat dört bölümden oluşur:

ROL
Sen bir destek talebi sınıflandırma asistanısın.

GÖREV
Gelen e-postayı oku. Talebin ne olduğunu belirle, uygun kategori
etiketini ekle ve ilgili departmana ata.

ARAÇ KULLANIMI
- musteri_ara: Her talepte İLK bunu çağır. Gönderen adresiyle
  müşteriyi bul. Kayıt yoksa talebi "yeni müşteri" olarak işaretle.
- etiket_ekle: Kategoriyi belirledikten sonra kullan.
  Kategoriler: fatura, teknik, iade, genel_bilgi
- ekibe_ata: Etiket eklendikten sonra kullan.
  fatura → muhasebe, teknik → destek, iade → operasyon,
  genel_bilgi → destek

SINIRLAR
- Müşteriye asla doğrudan cevap yazma.
- Kategoriden emin değilsen "genel_bilgi" kullan ve
  açıklamana "kategori belirsiz" yaz.
- Talebi kapatma veya silme.

Dikkat edilecek üç nokta:

  1. Araçları ne zaman kullanacağını yazın, sadece ne işe yaradığını değil. “musteri_ara: müşteri arar” yetersizdir; “her talepte ilk bunu çağır” yeterlidir.
  2. Belirsizlik durumunda ne yapacağını söyleyin. Aksi hâlde ajan tahmin eder ve tahmini size söylemez.
  3. Sınırları açıkça yazın. Ajan, yasaklanmamış her şeyi denemeye eğilimlidir.

Adım 5 — Araçları bağlayın

Her araç, aracınızda ayrı bir bağlantıdır: Gmail, Google Sheets, veritabanı veya kendi sisteminize giden bir HTTP isteği.

Her araca açık bir isim ve net bir açıklama verin. Ajan yalnızca bu metni görür — sizin kafanızdaki tanımı değil.

Adım 6 — Hafıza ekleyin (isteğe bağlı)

İlk ajanınız için genelde gerekmez. Ajan her talebi bağımsız işliyorsa hafızaya ihtiyaç yoktur. Ancak ajan bir konuşmayı sürdürüyorsa (birden fazla mesaj), oturum hafızası ekleyin.

Adım 7 — Onay adımı koyun

Ajanın dış dünyaya dokunan her eyleminin önüne bir onay adımı koyun. n8n’de bu, bir Slack mesajı ve iki buton kadar basittir:

Ajan → "Bu talebi muhasebeye atayacağım. Onaylıyor musunuz?"
       [Onayla] [Reddet]

İlk üç–dört hafta bu adım kalsın. Ajanın ne kadar isabetli olduğunu bu sayede öğrenirsiniz.


Ajanınızı Nasıl Test Edersiniz?

Kurulum bitince ilk refleks “hadi canlıya alalım” oluyor. Bir adım geride durun.

1. Test setinizi hazırlayın

Gerçek hayattan 20 örnek toplayın ve her biri için doğru cevabı elle yazın. Bu 20 örnek şunları içermeli:

  • 12 tane sıradan, tipik durum
  • 5 tane sınırda durum (belirsiz kategori, eksik bilgi)
  • 3 tane “kötü” durum (alakasız e-posta, spam, çok uzun metin)

2. Ajanı bu 20 örnekle çalıştırın

Sonuçları bir tabloya yazın: hangi örnekte doğru, hangisinde yanlış yaptı, ne yaptı.

3. Hataları sınıflandırın

Her hatanın nedeni genelde üç kategoriden biridir:

Hata tipiBelirtiÇözüm
Talimat eksikliğiAjan durumu bilmiyorduSistem talimatına kural ekleyin
Araç açıklaması zayıfYanlış aracı seçtiAraç açıklamasına “ne zaman kullanılır” ekleyin
Görev fazla genişBazen doğru, bazen yanlışGörevi ikiye bölün

4. Bir değişiklik yapın, testi tekrar çalıştırın

Aynı anda beş şeyi birden değiştirmeyin. Tek değişiklik → tekrar test → sonucu karşılaştır. Aksi hâlde neyin işe yaradığını asla bilemezsiniz.

En değerli alışkanlık bu: Bu 20 örneklik seti saklayın. Aylar sonra bir şey değiştirdiğinizde tekrar çalıştırın. Ajanı bozmadan geliştirmenin başka yolu yok.


Yeni Başlayanların En Sık Yaptığı 8 Hata

1. Sistem talimatını çok kısa yazmak

”Sen bir destek asistanısın, taleplere yardımcı ol.” Bu bir talimat değil, bir dilek. Ajan boşlukları kendi doldurur ve nasıl doldurduğunu size söylemez.

2. Aynı anda çok fazla araç bağlamak

On beş araçlı bir ajan, dört araçlı olandan daha yetenekli değil daha kararsızdır. Araç sayısı arttıkça doğru olanı seçme oranı düşer. Dörtle başlayın.

3. Ajanın “emin olmadığında” ne yapacağını söylememek

Bir modele belirsizlik durumunda ne yapacağını söylemezseniz, en makul görüneni seçer ve bunu emin bir tonda yapar. Talimata mutlaka bir “emin değilsen” maddesi koyun.

4. İlk günden tam otonom çalıştırmak

Onay adımı olmadan üretime çıkan ilk ajanın ilk hatası, genellikle dışarıya gider. Onay adımı yavaşlatır ama ilk aylarda size gerçek veri kazandırır.

5. Bozuk süreci otomatikleştirmek

Ajan bir süreci hızlandırır, düzeltmez. Elle yaparken de karışık olan bir süreci ajana verirseniz, karışıklık hızlanır. Önce süreç düzelir.

6. Maliyeti hiç ölçmemek

Ajan her çalıştığında token harcar. Bir ajan kötü bir döngüye girip aynı aracı yirmi kez çağırabilir. Kurulumda mutlaka bir tur sınırı koyun (örneğin görev başına en fazla 10 araç çağrısı).

7. Logu unutmak

Ajan yanlış yaptığında soracağınız soru “neden böyle yaptı?” olacak. Cevap verebilmek için hangi araçları hangi sırayla çağırdığını kaydetmeniz gerekir. Sonradan eklemek zordur; baştan koyun.

8. “Yapay zeka halüsinasyon görüyor” deyip pes etmek

Yanlış çıktıların büyük kısmı modelin uydurmasından değil, eksik talimattan veya eksik veriden kaynaklanır. Hatayı önce kendi kurulumunuzda arayın; sekiz hatanın yedisi orada çıkar.


Ne Zaman Koda Geçmelisiniz?

Kodsuz araçlar ilk ajan için mükemmel, ama sınırları var. Şu dört işaretten ikisi görünüyorsa kod tarafına geçme zamanı gelmiştir:

  • Görsel akış okunamaz hâle geldi. Otuz düğümlü bir akışta hata bulmak, koddan daha zor.
  • Aynı mantığı üçüncü kez kopyaladınız. Kodda bu bir fonksiyon olurdu.
  • Test edilebilirliğe ihtiyacınız var. Otomatik testler kodsuz araçlarda pratik değildir.
  • Kendi sisteminizle derin entegrasyon gerekiyor. HTTP isteğiyle çözemediğiniz noktalar birikmeye başladı.

Bu noktaya gelmeden koda geçmek, çözülmemiş bir problemi daha karmaşık bir araçla çözmeye çalışmaktır.


8 Haftalık Öğrenme Yol Haritası

HaftaOdakSomut çıktı
1Kavramları öğrenin, hazır ajan örneklerini inceleyinSözlükteki 10 kavramı kendi cümlelerinizle açıklayabilmek
2Tek sayfalık ajan tanımınızı yazın, 20 örneklik test setini toplayınYazılı tanım + test seti
3Kodsuz araçta ilk ajanı kurun, tek araçla başlayınManuel tetiklenen, tek araçlı çalışan ajan
4Araçları çoğaltın, sistem talimatını iyileştirin3–4 araçlı ajan, test setinde %70+ isabet
5Onay adımı, log ve tur sınırı ekleyinDenetlenebilir ajan
6Sınırlı pilot: gerçek verilerle ama insan onayıyla çalıştırınBir haftalık gerçek kullanım verisi
7Hataları analiz edin, talimatı ve araçları düzeltinTest setinde %85+ isabet
8Otonomi seviyesini kademeli artırın, metrikleri raporlayınKarar verilebilir sonuç raporu

Sekizinci haftanın sonunda elinizde üç sayı olmalı: kaç görev insansız tamamlandı, kaçı insana düştü, çıktıların yüzde kaçı elle düzeltildi. Bu üç sayı olmadan “işe yaradı mı?” sorusu bir kanaat tartışmasına dönüşür.


Hangi Araçla Başlamalısınız? Karşılaştırma

Kodsuz ajan kurulumunda en sık sorulan soru “n8n mi, Make mi, Zapier mi?” olur. Aşağıdaki tablo yeni başlayanlar için pratik bir kıyaslama sunuyor; daha kapsamlı bir karşılaştırma için Make, n8n ve Zapier karşılaştırma yazısına bakabilirsiniz.

Kritern8nMakeZapier
Öğrenme eğrisiOrta (biraz teknik zihniyet ister)Düşük-ortaÇok düşük
Kendi sunucunuzda barındırmaVar (ücretsiz, KVKK açısından avantajlı)YokYok
AI Agent düğümü desteğiGüçlü ve esnekVar, sınırlı esneklikSınırlı
Fiyatlandırma mantığıSabit + iş yüküİşlem bazlıGörev bazlı, hızlı pahalılaşır
Türkçe kaynak / toplulukArtıyorSınırlıSınırlı
Yeni başlayan için önerilir miEvet, orta vadeli öğrenme için idealEvet, hızlı başlangıç içinBasit, tek adımlık işler için

Pratik öneri: Türkiye’de veri saklama ve KVKK hassasiyeti olan bir işletmeyseniz kendi sunucunuzda barındırabildiğiniz n8n avantajlıdır. Hızla bir prototip görüp karar vermek istiyorsanız Make’in görsel arayüzü daha az sürtünme yaratır. Zapier ise tek adımlık, basit bildirim/aktarım işleri için hâlâ en hızlı kuruluma sahiptir ama ajan tabanlı karmaşık işlerde sınırlı kalır.


Vaka Kurgusu: Küçük Bir E-ticaret İşletmesinin İlk Ajanı

Anadolu’da faaliyet gösteren, günde ortalama yetmiş sipariş alan küçük bir e-ticaret işletmesinin sahibi, müşteri hizmetleri e-postalarının önemli kısmının “siparişim nerede” sorusundan oluştuğunu fark ediyor. Bu soruları yanıtlamak günde yaklaşık bir buçuk saat alıyor ve genelde aynı adımları içeriyor: sipariş numarasını bulmak, kargo takip sistemini kontrol etmek, müşteriye durumu yazmak.

Uygulama: İşletme sahibi bu görevi ilk ajan projesi olarak seçiyor çünkü üç ölçütü de karşılıyor — sık tekrarlanıyor, hata maliyeti düşük (yanlış bilgi verilse bile müşteri destek hattından düzeltebiliyor) ve sonucu ölçülebilir (doğru cevap oranı takip edilebiliyor). n8n üzerinde manuel tetikleyiciyle başlayan bir ajan kuruluyor: e-posta konusunu ve içeriğini okuyor, sipariş numarasını metinden çıkarıyor, kargo takip API’sinden durumu sorguluyor ve bir yanıt taslağı hazırlıyor. İlk üç hafta ajan yalnızca taslak hazırlıyor, gönderim işlemini işletme sahibi elle onaylıyor.

Sonuç penceresi (ilk 8 hafta): İlk iki hafta test setiyle çalışılıyor ve sistem talimatı üç kez revize ediliyor; en büyük sorun ajanın bazen sipariş numarasını yanlış biçimde metinden çıkarması oluyor, bu da örnek çeşitliliği artırılarak çözülüyor. Dördüncü haftada onay adımı korunarak gerçek e-postalarla pilot başlıyor. Altıncı haftada doğru cevap oranı test setinde yeterli seviyeye ulaşınca otomatik gönderim (onaysız) devreye alınıyor, ancak “kargo kayboldu” veya “iade” gibi karmaşık talepler otomatik olarak insana yönlendirilmeye devam ediyor. Sekizinci haftanın sonunda işletme sahibi, günlük bir buçuk saatlik zamanının büyük kısmını geri kazanıyor ve bu süreyi ürün ve tedarikçi ilişkilerine ayırabiliyor.

(Vaka temsilidir.)


Türkiye’de AI Ajanı Kurarken Dikkat Edilmesi Gereken Yerel Konular

Yurt dışı kaynaklı rehberlerin çoğu, Türkiye’ye özgü birkaç pratik noktayı atlıyor. Yerel bir işletme için ajan kurarken şu başlıklar ayrıca önem taşıyor.

KVKK ve veri saklama. Ajanınız müşteri e-postası, telefon numarası veya sipariş bilgisi gibi kişisel veri işliyorsa, bu verinin hangi sunucuda ve hangi ülkede saklandığını bilmeniz gerekiyor. Bulut tabanlı bir araç kullanıyorsanız sağlayıcının veri işleme sözleşmesini kontrol edin; hassas veri söz konusuysa kendi sunucunuzda barındırılabilen bir araç (örneğin n8n’in kendi barındırma seçeneği) tercih edilebilir.

Türkçe dil performansı. Büyük dil modellerinin çoğu Türkçe metinleri İngilizce kadar tutarlı işlemeyebiliyor; özellikle yazım hataları, argo ifadeler veya bölgesel kullanımlar içeren müşteri mesajlarında ajan performansı düşebiliyor. Test setinizi oluştururken gerçek Türkçe müşteri mesajlarını, yazım hatalarını ve kısaltmaları içerecek biçimde çeşitlendirin.

Yerel entegrasyon eksiklikleri. Yurt dışı kaynaklı otomasyon platformlarının bazı yerel servislerle (kargo firmaları, yerel ödeme sistemleri, e-fatura sistemleri) hazır bağlantısı olmayabilir. Bu durumda HTTP isteği tabanlı özel bir bağlantı kurmanız gerekebilir; bu, kodsuz kurulumun sınırlarından biridir ve bazen daha erken bir aşamada teknik desteğe ihtiyaç doğurabilir.

Çalışma saatleri ve tatil takvimi. Türkiye’ye özgü resmi tatiller, dini bayramlar ve kampanya dönemleri (11.11, Black Friday gibi) ajanın iş yükünü ve hata toleransını etkileyebilir. Yoğun kampanya dönemlerinde ajanın onay adımını geçici olarak sıkılaştırmak, hata riskini azaltır.


İlk Ajanınızın Sağlık Kontrolü: Yayın Öncesi Kontrol Listesi

Ajanı gerçek kullanıma açmadan önce aşağıdaki maddeleri tek tek işaretleyin. Bu liste, önceki bölümlerde anlatılan adımların sıkıştırılmış bir özeti ve yayın öncesi son kontrolüdür.

  • Tek sayfalık ajan tanımı (ad, tetikleyici, girdi, araçlar, çıktı, yapmayacakları) yazılı ve güncel
  • Sistem talimatı dört bölümü de (rol, görev, araç kullanımı, sınırlar) içeriyor
  • En az 20 örneklik test seti hazır ve üç kategoriye (tipik, sınırda, kötü) ayrılmış
  • Test setinde isabet oranı kabul edilebilir seviyede (yeni başlayanlar için genellikle %80 ve üzeri makul bir eşik)
  • Her araç açık bir isme ve “ne zaman kullanılır” bilgisi içeren bir açıklamaya sahip
  • Görev başına maksimum araç çağrısı (tur) sınırı tanımlı
  • Dış dünyaya dokunan her eylem için onay adımı veya en azından log kaydı var
  • API anahtarları kod veya talimat içine değil, güvenli kimlik bilgisi alanına yazılmış
  • Kişisel veri işleniyorsa KVKK açısından hangi verinin nerede saklandığı netleştirilmiş
  • Ajanın performansını izleyecek en az üç metrik (isabet oranı, insana devredilen oran, ortalama tur sayısı) tanımlı
  • Ajanı durdurma veya devre dışı bırakma yöntemi (acil “kapat” anahtarı) belirlenmiş

Bu listenin tamamını işaretleyemiyorsanız ajan henüz gerçek kullanım için hazır değil demektir; eksik maddeler genellikle ilk haftalarda en çok sorun çıkaran noktalardır. Deneyimli ekiplerin ortak gözlemi şu: kontrol listesindeki her atlanan madde, canlıya geçtikten sonra ortalama birkaç günlük ekstra hata ayıklama süresine dönüşüyor. Listeyi yayın öncesi on dakikada tamamlamak, sonradan harcanacak saatlerden çok daha ucuzdur.


Ajan Kurduktan Sonra: İlk Ay Ne Beklemelisiniz?

Ajan canlıya alındıktan sonra beklentilerin gerçekçi olması, projeyi terk etmemek açısından en az kurulumun kendisi kadar önemli. İlk ayın tipik seyri şöyle işliyor:

İlk hafta: Ajan beklenenden daha fazla “emin değilim” durumuyla karşılaşır. Bu normaldir; test setinizde öngöremediğiniz gerçek dünya çeşitliliği ortaya çıkar. Bu hafta boyunca onay adımını sıkı tutun ve her reddedilen veya düzeltilen kararı not edin.

İkinci hafta: Notlarınızdan bir örüntü çıkmaya başlar — genellikle hataların büyük kısmı birkaç tekrarlayan durumdan kaynaklanır. Bu durumları sistem talimatına açıkça ekleyin.

Üçüncü hafta: İsabet oranı belirgin biçimde artar. Bu noktada onay adımını bazı düşük riskli işlemler için gevşetmeyi (örneğin otomatik gönderim, yalnızca yüksek riskli işlemlerde onay) değerlendirebilirsiniz.

Dördüncü hafta: Ajan artık “yeni” değil, günlük operasyonun bir parçası hâline gelir. Bu aşamada bir sonraki görevi otomatikleştirmeyi düşünmeye başlayabilirsiniz — ama yalnızca ilk ajan istikrarlı çalışıyorsa. İkinci ajana geçmeden önce birinci ajanın en az iki-üç hafta sorunsuz çalıştığından emin olun.

Gerçekçi olmayan beklenti: “Kurdum, artık hiç bakmama gerek yok.” Ajanlar bahçe gibidir; kurulumdan sonra da düzenli bakım ister. Sistem talimatı, iş süreçleriniz değiştikçe veya yeni bir hata örüntüsü fark ettikçe güncellenmeli; bu tek seferlik bir proje değil, sürekli iyileştirilen bir sistemdir.


Sık Sorulan Sorular

AI ajanı oluşturmak için programlama bilmem gerekir mi?
İlk ajanınız için gerekmez. n8n, Make gibi görsel araçlarla sürükle-bırak mantığıyla çalışan bir ajan kurabilirsiniz. Programlama bilgisi, özel entegrasyonlar gerektiğinde, akış çok karmaşıklaştığında veya otomatik test yazmanız gerektiğinde devreye girer. Asıl belirleyici olan yazılım bilgisi değil süreç bilgisidir: otomatikleştirmek istediğiniz işi adım adım anlatamıyorsanız, hangi araçla kurarsanız kurun sonuç aynı olur.
İlk ajanımı kurmak ne kadar sürer?
Basit, tek görevli bir ajanın kodsuz araçlarla ilk çalışan sürümü genellikle 1–2 gündür. Ancak güvenilir hale gelmesi 3–4 hafta sürer ve bu sürenin çoğu kurulumda değil test etme ve talimat iyileştirmede geçer. “Bir öğleden sonrada kurdum” diyen kurulumlar genellikle test edilmemiş kurulumlardır; hata canlıda ortaya çıkar.
AI ajanı ne kadara mal olur?
Küçük ölçekte beklenenden ucuzdur. Maliyet üç kalemden oluşur: model kullanımı (işlenen metin miktarına göre), araç aboneliği (n8n gibi platformların aylık ücreti) ve sizin zamanınız. Günde birkaç yüz basit görev işleyen bir ajanın model maliyeti genelde küçük rakamlardadır. Faturayı büyüten şey görev sayısı değil, bir görevin kaç turda bittiğidir — bu yüzden tur sınırı koymak hem teknik hem finansal bir güvenliktir.
Hangi yapay zeka modelini seçmeliyim?
Başlangıçta bu kararı büyütmeyin. Orta seviye, dengeli bir modelle başlayın; ajanınız çalışmaya başladıktan sonra ihtiyaca göre değiştirirsiniz — model değiştirmek genellikle tek satırlık bir ayardır. Genel kural: karar ve planlama gerektiren işler güçlü modelde, çok sayıda metni okuyup ayıklama gibi hacimli işler ucuz modelde daha verimlidir. İlk ajanınızda bu ayrımı yapmanıza gerek yok.
Ajanım yanlış cevap veriyor, ne yapmalıyım?
Önce hatayı sınıflandırın, çünkü çözümü buna göre değişir. Ajan durumu bilmiyorsa sistem talimatına kural ekleyin. Yanlış aracı seçiyorsa araç açıklamasına “ne zaman kullanılır / ne zaman kullanılmaz” bilgisini ekleyin. Bazen doğru bazen yanlış yapıyorsa görev muhtemelen fazla geniştir, ikiye bölün. Değişiklikleri tek tek yapın ve her seferinde aynı test setiyle ölçün — aynı anda birkaç şey değiştirirseniz neyin işe yaradığını bilemezsiniz.
Ajanıma kaç araç bağlamalıyım?
İlk kurulumda üç ile beş arasında. Araç sayısı arttıkça ajan daha yetenekli değil daha kararsız hale gelir; birbirine benzeyen araçlar arasında yanlış seçim yapmaya başlar. Görevi tamamlamak için kesinlikle gereken araçlarla başlayın, eksik hissettiğiniz yerde ekleyin. Bir aracı eklemeden önce sorun: bu olmadan görev tamamlanamıyor mu, yoksa sadece “olsa iyi olur” mu?
Ajan verilerimi öğrenir veya dışarı sızdırır mı?
Ajan yalnızca verdiğiniz araçların eriştiği veriye erişir — araç listesi aynı zamanda veri sınırıdır. Dikkat edilmesi gerekenler: verinin hangi sağlayıcıya gittiği, ne kadar süre saklandığı ve API anahtarlarının nerede tutulduğu. Anahtarları asla sistem talimatının veya mesajların içine yazmayın; araç platformunun kimlik bilgisi alanında saklayın. Kişisel veri işleyen bir ajan kuruyorsanız KVKK değerlendirmesini uygulama öncesinde yapın.
Ajanı doğrudan otomatik çalıştırabilir miyim?
Teknik olarak evet, ama ilk haftalarda yapmayın. Önerilen sıra şudur: manuel tetikleyici ile test → insan onaylı otomatik çalışma → sonradan denetlenen otonom çalışma. Her aşamada birkaç hafta kalın ve hata oranını ölçün. Geri alınamaz işlemlerde (ödeme, silme, sözleşme) ajan hiçbir zaman tek başına bırakılmamalı; bu tür işlerde ajanın rolü öneri üretmektir.
Chatbot ile ajan arasında pratikte ne fark var?
Chatbot cevap üretir, ajan iş yapar. “Siparişim nerede?” sorusuna chatbot bir metinle karşılık verir; ajan sipariş sistemine bağlanır, kaydı bulur, kargo durumunu sorgular ve gerekirse bir destek kaydı açar. Teknik fark ajanın araç kullanabilmesi ve adımlarını kendi seçebilmesidir. Bu güç aynı zamanda riski de artırır — bu yüzden ajanda onay noktaları ve log gerekir, chatbotta gerekmez.
Öğrenmeye nereden başlamalıyım?
Teoriden değil, tek bir küçük görevden. Kendi işinizde haftada birkaç kez tekrarladığınız, hata maliyeti düşük bir iş seçin ve onu kurun. Kavramların çoğu, karşınıza çıktığında çok daha hızlı öğreniliyor. Kurs izleyerek geçirilen üç hafta ile çalışan tek bir ajan kurarak geçirilen üç gün karşılaştırıldığında, ikincisi neredeyse her zaman daha fazla şey öğretir.

Sonuç

Yeni başlayanlar için AI ajanı kurmanın zorluğu teknoloji değil, ölçek seçimi.

En yaygın hata, ilk ajanı fazla büyük tasarlamak: çok araç, çok görev, hemen tam otonomi. Bu kurulumların ortak sonu, işe yarayıp yaramadığı hiç anlaşılamayan bir sistemdir.

Doğru yol tersi: küçük bir görev, üç dört araç, insan onayı, 20 örneklik bir test seti. Bu dörtlüyle kurulan bir ajan birkaç hafta içinde gerçekten çalışır hâle gelir ve size bir sonraki ajanı kurmak için gereken deneyimi kazandırır.

Bir şeyi unutmayın: ajanın kalitesini belirleyen şey seçtiğiniz model değil, ona verdiğiniz talimatın netliği ve araçlarının doğru tarif edilmiş olmasıdır. Zamanınızın çoğunu buraya ayırın.

İşletmenizde hangi süreçle başlamanın mantıklı olduğunu konuşmak isterseniz AI agent geliştirme sayfasına bakabilir veya iletişime geçebilirsiniz.

Onur Öztürk
// yazar

Onur ÖZTÜRK

SEO Uzmanı & Dijital Pazarlama Danışmanı

15 yılı aşkın deneyimle sağlık turizmi, e-ticaret ve kurumsal markalar için SEO stratejisi geliştiriyorum. Google Partner ve Meta Business Partner olarak 150'den fazla işletmenin organik büyümesine katkı sağladım.

// google arama

Bu içerikleri Google'da daha sık görün

onuroztr.com'u tercih edilen kaynak olarak ekleyin; yazılarımız arama sonuçlarında ve yapay zeka özetlerinde size daha sık gösterilsin.

WhatsApp'tan yazın Genellikle 1 saat içinde dönüyorum
WhatsApp Toplantı Planlayın