Yapay Zeka Ajanları: Nedir ve Adım Adım Kendi Ajanınızı Nasıl Oluşturursunuz?

Herkes AI ajanlarından bahsediyor. Ama çoğu kişiye bir ajanın aslında ne olduğunu sorarsanız, "otonom olarak işler yapan AI" gibi muğlak bir cevap alırsınız.

Gerçek tablo bundan çok daha kullanışlı. Ajanlar bir kategori değil, bir spektrumdur.

Bu rehber, farklı AI araçlarının bu spektrumda nerede durduğunu, temel bir LLM etkileşimini gerçek bir ajan iş akışından neyin ayırdığını ve Claude Code ile kendi ajanınızı nasıl oluşturup kod yazmadan Telegram'a bağlayacağınızı açıklıyor.

Detaylara girmeden önce, beni X'te takip edin.

X -

https://x.com/ai_rohitt

Bir Şeyi Ajan Yapan Nedir?

Claude'a "bugün ne paylaşmalıyım?" diye sormak bir ajan değildir. Bu bir sohbettir.

Claude'a "şu anda AI'da trend olan üç konuyu bul, en fazla etkileşim potansiyeli olanı seç, benim tarzımda bir gönderi taslağı hazırla ve bir dosyaya kaydet" deyip, siz hiçbir şeye dokunmadan tüm bunları yapmasını sağlamak - işte bu bir ajandır.

Fark modelde değil, etrafındaki yapıdadır.

Bir ajan, normal bir sohbette olmayan üç şeye sahiptir. Kendi başına çağırabileceği araçlar: arama, dosya sistemleri, kod çalıştırma, harici API'ler. Tek bir oturumla sınırlı olmayan, görevler arasında devam eden bellek. Ve tek bir yanıt üretmek yerine görev tamamlanana kadar çalışan bir döngü.

Bu üç şeyden ne kadar çok eklerseniz, sizin dahil olmanız o kadar azalır. İşte fikir bu.

Spektrum: Sohbetten Ajana

Bir uçta temel bir sohbet vardır. Siz sorarsınız, Claude cevaplar, oturum biter. Araç yok, devam eden hedef yok, dünyada hareket etme yeteneği yok.

Bir adım yukarı: Araçlar etkinleştirilmiş Claude. Claude cevaplamadan önce internette arama yaptığında, ekli bir dosyayı okuduğunda veya bir görsel oluşturduğunda, zaten biraz ajan benzeridir. Siz ona bunları adım adım yapmasını söylemediniz; kendi başına ihtiyacı olduğuna karar verdi.

Daha da yukarı: Çok adımlı iş akışları. Bir hedef verirsiniz, Claude bunu adımlara böler, her birini yürütür, sonucu kontrol eder ve bitmiş bir çıktı sunar. Siz adımlar arasında dahil olmazsınız.

En üstte: Tamamen otonom ajanlar. Ajan bir programa göre çalışır, girdileri izler, harici hizmetleri çağırır ve döngüde bir insan olmadan karmaşık görevleri tamamlar. Hedefi bir kez belirlersiniz ve çıktıyı kontrol edersiniz.

Alt ve üst arasındaki fark farklı bir model değildir. Modeli çevreleyen şeydir: çağırabileceği araçlar, bağlam taşıyan bellek ve görev tamamlanana kadar çalışmaya devam eden bir döngü.

Bugün Oluşturabileceğiniz Ajan Türleri

Ajanların bugün aslında nasıl görünebileceğine dair bir fikir vermek için aşağıya birkaç örnek derledim. Bunlar sınırlar değil; kendi durumunuza uygun olan her şeyi oluşturabilirsiniz.

Araştırma ajanı: Bir konu hakkında bilgi toplar, birden çok kaynağı okur, önemli olanı çıkarır ve yapılandırılmış bir özet sunar. Ona bir soru verirsiniz. Size manuel olarak saatler sürecek bir cevap verir.

Yazma ajanı: Tanımladığınız bir sisteme göre içerik yazar. Tonunuzu, formatınızı, kitlenizi ve konunuzu verin. Her cümleyi siz yönetmeden taslakları, yeniden yazmaları ve düzenlemeleri halleder.

Kod ajanı: Kod yazar, çalıştırır, hataları okur, düzeltir ve devam eder. Kodun ne yapması gerektiğini tarif edersiniz. Ajan uygulama ve hata ayıklama döngüsünü halleder.

İş ajanı: Tekrarlayan iş görevlerini halleder: e-posta taslakları hazırlama, müşteri taleplerini işleme, potansiyel müşterileri nitelendirme, raporlar oluşturma. Kuralları tanımladıktan sonra otomatik pilotta çalışır.

Kişisel ajan: Programınızı yönetir, görevleri organize eder, brifingler hazırlar ve her gün manuel olarak yaptığınız planlama işini halleder.

İlk Ajanınızı Oluşturma - Buradan Başlayın

Uzak bir sunucuda çalışan ve beyni olarak Claude'u kullanan bir Telegram botu oluşturmak için Claude Code'u kullanacaksınız. Claude Code sizin için tüm kodu yazar; siz sadece ne istediğinizi düz İngilizce ile tarif edersiniz. Kurulduktan sonra, botla tüm iletişim doğrudan Telegram üzerinden gerçekleşir.

Tüm kurulum yaklaşık 10-20 dakika sürer. Kod yazmayı bilmenize gerek yok.

Sistem İstemi Şablonları - İstem 2'ye Yapıştırın

Aşağıdaki kurulumdan İstem 2'yi çalıştırdığınızda, ne tür bir ajan istediğinizi tanımlamanız gerekir. Bunlar hazır şablonlardır; size uyanı kopyalayın, "Ajan şöyle olmalı:" yazan yere İstem 2'ye yapıştırın ve Claude Code o belirli ajanı oluşturacaktır. Durumunuza uyacak şekilde ayrıntıları ayarlayın.

Araştırma Ajanı

1Sen bir araştırma ajanısın. İşin, sana verdiğim herhangi bir konu hakkında bilgi toplamak, analiz etmek ve sentezlemek.
2
3Bir araştırma görevi verildiğinde:
41. Cevaplanması gereken en önemli 3-5 alt soruyu belirle
52. Her biri için bilgi ara
63. Her kaynağın kalitesini ve alaka düzeyini değerlendir
74. Yalnızca soruyu doğrudan cevaplayan şeyi çıkar
85. Şunları içeren yapılandırılmış bir özet sun: temel bulgular, destekleyici kanıtlar ve dolduramadığın boşluklar
9
10Biçim: Başlıklar, madde işaretleri ve net bölümler kullan.
11Bir şeyden emin değilsen, bunu açıkça belirt.
12Dolgu maddesi ekleme. Her cümle bilgi içermelidir.

Yazma Ajanı

1Sen bir yazma ajanısın. İçeriği benim sesimde ve tarzımda yazıyorsun.
2
3Benim tarzım:
4- Sohbet havasında, doğrudan, kurumsal dil yok
5- Kısa cümleler ve paragraflar
6- Belirsiz iddialar yerine belirli sayılar ve örnekler
7- Her zaman okuyucunun yapması veya düşünmesi gereken bir şeyle bitir
8
9Bir yazma görevi verildiğinde:
101. Verilmemişse konuyu, kitleyi ve istenen uzunluğu sor
112. İlk taslağı yaz
123. Stil kurallarıma göre gözden geçir
134. Yayına hazır son sürümü teslim et
14
15Gereksiz girişler ekleme. En önemli noktayla başla.

Kod Ajanı

1Sen bir kod ajanısın. İşin kod yazmak, hata ayıklamak ve iyileştirmek.
2
3Bir kodlama görevi verildiğinde:
41. Kodun ne yapması gerektiğine dair anlayışını onayla
52. Net yorumlarla çözümü yaz
63. Herhangi bir uç durumu veya olası hatayı belirle
74. Hatalar varsa, yardım istemeden önce sistematik olarak hata ayıkla
8
9Kurallar:
10- Anlamlı değişken adlarıyla temiz, okunabilir kod yaz
11- Her zaman hata yönetimini dahil et
12- Her ana bölümün ne yaptığını sade bir dille açıkla
13- Gereksinimlerden emin değilsen, devam etmeden önce bir açıklayıcı soru sor

İş E-posta Ajanı

1Sen bir iş e-posta ajanısın. Benim adıma profesyonel e-postalar yazıyorsun.
2
3Benim iletişim tarzım:
4- Doğrudan ve saygılı
5- Gereksiz formaliteler yok
6- İlk cümlede konuya gir
7- Net bir sonraki adımla kapat
8
9Bir e-posta görevi verildiğinde:
101. E-postanın amacını belirle (bilgilendirme, talep, takip, onay)
112. E-postanın amacını yansıtan bir konu satırı yaz
123. E-postayı en fazla 3-5 kısa paragraf halinde taslakla
134. Net bir eylem maddesi veya sonraki adımla bitir
14
15Her zaman gönderilmeye hazır e-postalar yaz, doldurulacak boşlukları olan şablonlar değil.

Kişisel Planlama Ajanı

1Sen benim kişisel planlama ajanımsın. İşimi organize etmeme, görevleri önceliklendirmeme ve haftamı planlamama yardım ediyorsun.
2
3Görevlerimi veya hedeflerimi paylaştığımda:
41. Acil olanı önemli olandan ayırt et
52. Bağımlılıklara dayalı gerçekçi bir sıra öner
63. Her görev için gereken süreyi tahmin et
74. Devredilebilecek veya ortadan kaldırılabilecek her şeyi işaretle
8
9Bir projeyi tarif ettiğimde:
10- Somut sonraki eylemlere ayır
11- İlk yapılacak en önemli tek şeyi belirle
12- Takip edebileceğim basit bir kontrol listesi oluştur
13
14Her şeyi pratik tut. Motivasyon dolduruşu yok. Sadece plan.

Başlamadan Önce İhtiyacınız Olanlar

1 - console.anthropic.com adresinden bir Claude API anahtarı. Bu bir geliştirici anahtarıdır; sabit bir aylık ücret yerine kullanım başına ödeme yaparsınız. Günde 50 mesaj gönderen kişisel bir bot için, seçtiğiniz modele bağlı olarak maliyet ayda 1-5 dolar arasındadır.

2 - BotFather'dan bir Telegram bot token'ı.

3 - Linux çalıştıran bir VPS. Kişisel bir Telegram botu için güçlü bir şeye ihtiyacınız yok - 1 CPU, 1 GB RAM ve 20 GB depolama fazlasıyla yeterlidir. DigitalOcean, Hetzner veya Vultr'daki herhangi bir temel plan işinizi görecektir ve aylık yaklaşık 4 ila 6 dolar arasındadır. Sunucuya sahip olduğunuzda, terminalinizde npm i -g @anthropic-ai/claude-code komutunu çalıştırarak Claude Code'u kurun.

Botunuz için hangi Claude modelini kullanmalı ve gerçek maliyeti nedir:

Çoğu kişisel bot için Sonnet 4.6 doğru seçimdir, herhangi bir görev için yeterince güçlü ve günlük kullanım için uygun fiyatlıdır. Maliyeti en aza indirmek istiyorsanız Haiku 4.5'i kullanın. Opus 4.8, yalnızca cevap kalitesinin kritik olduğu karmaşık bir analitik ajan için anlamlıdır.

İlk Ajanınızı Oluşturma - Adım 1

VPS terminalinizi açın ve Claude Code'u başlatın. Bu istemi yapıştırın ve her şeyi oluşturmasına izin verin.

Ajana bir kişilik verin

1Bana beyni olarak Claude API'sini kullanan bir Telegram botu oluştur.
2
3Gereksinimler:
4- Dil: Python
5- Telegram için kütüphane: python-telegram-bot
6- Claude modeli: claude-sonnet-4-6
7- Bot bir mesaj alır, Claude API'sine gönderir ve Claude'un yanıtını Telegram'a döndürür
8- Kullanıcı başına sohbet geçmişini koru — her kullanıcının oturum içinde kendi bağlamı vardır
9- Botu tanıtan bir /start komutu ekle
10- O kullanıcı için sohbet geçmişini sıfırlayan bir /clear komutu ekle
11
12Gerekli tüm dosyaları oluştur: ana bot dosyası, requirements.txt ve API anahtarları için bir .env dosyası şablonu.
13Hiçbir API anahtarını sabit kodlama — bunları ortam değişkenlerinden oku.

Arka plan hizmeti olarak dağıtın

1Bu botun Linux VPS'imde otomatik olarak çalışması ve çökerse yeniden başlaması için bir systemd hizmet dosyası oluştur.
2
3Hizmet şunları yapmalı:
4- Sunucu başladığında otomatik olarak başla
5- Çökerse otomatik olarak yeniden başla
6- Proje klasöründeki .env dosyasından ortam değişkenlerini yükle
7- Daha sonra kontrol edebileceğim bir dosyaya günlükleri kaydet
8
9Ayrıca bana hizmeti kurmak, başlatmak, çalışıp çalışmadığını kontrol etmek ve günlükleri görüntülemek için tam terminal komutlarını yaz.

Oturumlar arasında kalıcı bellek ekleyin

1Bot yeniden başladığında sohbet geçmişini kaybediyor. Bunu düzelt.
2
3Her mesajdan sonra her kullanıcının sohbet geçmişini diske bir JSON dosyasına kaydet. Bot başladığında otomatik olarak geri yükle.
4
5Maksimum bir geçmiş uzunluğu ekle — bağlam penceresinin asla çok uzun olmaması için kullanıcı başına yalnızca son 20 mesajı tut.

Claude Code Botunuza Yetenekler Ekleme

Yetenekler, zamanla botunuza eklediğiniz özelliklerdir. Her biri Claude Code'a verdiğiniz yeni bir istemdir ve o da çalışmasını sağlayacak kodu yazar. İşte en kullanışlı olanları.

**Yetenek: Web araması

**Ajanınız yalnızca hafızadan cevap vermek yerine gerçek zamanlı bilgi arayabilir.

1Tavily API'sini kullanarak bota web arama yeteneği ekle.
2
3Kullanıcı haberler, fiyatlar, güncel olaylar gibi güncel bilgi gerektiren bir şey sorduğunda, bot otomatik olarak web'de arama yapar ve sonuçları yanıtına dahil eder.
4
5Bot ne zaman arama yapacağına ve ne zaman hafızadan cevap vereceğine kendi başına karar vermeli. .env dosyası şablonuna TAVILY_API_KEY ekle.
6
7Bunu temiz bir şekilde uygulamak için Claude'un araç kullanma özelliğini kullan.

**Yetenek: Notları kaydetme

**Ajanınız, ona söylediğiniz her şeyi bir dosyaya kaydedebilir - fikirler, görevler, araştırma bulguları - ve daha sonra bunları alabilir.

1Bota not kaydetme özelliği ekle.
2
3Kullanıcı "bunu kaydet", "bunu hatırla" veya "not:" dediğinde, bot içeriği bir zaman damgasıyla notes.txt dosyasına kaydeder.
4
5Son 10 kaydedilmiş notu döndüren bir /notes komutu ekle.
6Tüm kaydedilmiş notları silen bir /clearnotes komutu ekle.

**Yetenek: Yalnızca hesabınızla sınırlayın

**Varsayılan olarak, botunuzu bulan herkes onu kullanabilir ve API kredilerinizi tüketebilir. Bu, botu yalnızca size kilitler.

1Bota, yalnızca benim kullanabilmem için bir kullanıcı kısıtlaması ekle.
2
3Telegram kullanıcı ID'mi .env dosyasına ALLOWED_USER_ID olarak ekle.
4Başka biri bota mesaj atarsa, bot "Bu bot özeldir." yanıtını verir ve o kullanıcıdan gelen diğer tüm mesajları yok sayar.
5
6Ayrıca kendi Telegram kullanıcı ID'mi nasıl bulacağımı da ekle - botun kendisi aracılığıyla veya başka bir yöntemle.

**Yetenek: API maliyetlerini takip edin

**Claude API, token başına ücret alır. Bu, ne harcadığınızı her zaman bilmeniz için basit bir maliyet takipçisi ekler.

1Bota temel maliyet takibi ekle.
2
3Her Claude API yanıtından sonra, kullanılan girdi token'larının ve çıktı token'larının sayısını günlüğe kaydet.
4Bir costs.json dosyasında sürekli bir toplam tut.
5
6Şunları gösteren bir /costs komutu ekle: bugün kullanılan toplam token, tüm zamanlar boyunca kullanılan toplam token ve claude-sonnet-4-6 fiyatlandırmasına dayalı tahmini USD maliyeti.

**Yetenek: Planlanmış günlük brifing

**Ajan, siz sormadan her sabah size bir mesaj gönderir.

1Bota planlanmış bir günlük brifing ekle.
2
3Her gün saat 8:00'de, bot bana şu mesajı gönderir:
41. Motivasyon verici bir satırlık söz (kısa, ucuz değil)
52. Gün için en önemli önceliğimi kontrol etmem için bir hatırlatma
63. Üretkenlik veya AI hakkında rastgele kullanışlı bir gerçek
7
8Bunu .env dosyasındaki Telegram kullanıcı ID'me gönder.
9Bunu uygulamak için schedule veya APScheduler kütüphanesini kullan.

Kurulumdan Sonra Bilinmesi Gereken Faydalı Şeyler

Ajanınızın kişiliğini nasıl güncellersiniz. Ana bot dosyasını açın, üstteki sistem istemi değişkenini bulun, değiştirin, dosyayı kaydedin ve sudo systemctl restart bot-adiniz komutuyla hizmeti yeniden başlatın. Yeni kişilik anında etkin olur.

Botun çalışıp çalışmadığını nasıl kontrol edersiniz. Terminalinizde sudo systemctl status bot-adiniz komutunu çalıştırın. "active (running)" yazıyorsa çalışıyordur. "failed" yazıyorsa, günlükleri kontrol edin.

Günlükler nasıl okunur. Son 50 satırı görmek için journalctl -u bot-adiniz -n 50 komutunu çalıştırın. Bir şey bozulursa hata mesajlarını burada bulursunuz.

Yeni bir yetenek nasıl eklenir. Proje klasörünüzde Claude Code'u açın ve ne istediğinizi tarif edin: "Bota X özelliğini ekle." Claude Code mevcut kodunuzu okur, yeni özelliği temiz bir şekilde ekler ve yeniden başlatma gerekip gerekmediğini size söyler.

Her Ajanın Sahip Olduğu Bellek Sorunu

Bu, insanların karşılaştığı en yaygın sorundur. Ajan, oturumlar arasında, uzun görevler boyunca, çok fazla mesajdan sonra bağlamı kaybeder ve daha önce yaptığı işi tekrarlamaya veya hatalar yapmaya başlar.

Bunun olmasının üç yolu vardır:

Uzun görevler sonunda Claude'un bağlam sınırını aşar ve ajan konuşmanın başlangıcını kaybetmeye başlar: orijinal hedef, daha önce alınan kararlar, belirlediğiniz kısıtlamalar.

Bir oturumu kapatıp yeni bir tane açtığınızda, ajan sıfırdan başlar.

Ajan bir görevin ortasında kesintiye uğrarsa, nerede kaldığını bilmesinin bir yolu yoktur.

Bunu düzeltmek için dört şey yapılabilir:Ajana her büyük adımdan sonra bir ilerleme notu yazmasını söyleyin: ne yapıldı, neye karar verildi, hala ne olması gerekiyor. Tam bağlamı geri yüklemek için bu notu bir sonraki oturumun başında yapıştırın.

Her on ila on beş mesajda bir, ajana nerede olduğunu özetlemesini isteyin. Bu, taşmadan önce bağlamı sıkıştırmaya zorlar.

Konuşma çok uzamadan önce, ajandan her şeyi bir özete sıkıştırmasını ve oradan devam etmesini isteyin. Konu ipliği bozulmadan kalır.

Ajanınızın her zaman ihtiyaç duyduğu temel gerçekleri doğrudan bot kodunuzdaki sistem istemine ekleyin. Claude bunu her konuşmanın başında okur, böylece işler ne kadar uzarsa uzasın bu bilgi her zaman bağlamda olur.

Kontrol Noktası İstemi

1Devam etmeden önce, kısa bir kontrol noktası yaz:
21. Şu ana kadar neyi tamamladın?
32. Bu oturumdaki ana kararlar veya bulgular neler?
43. Hala ne yapılması gerekiyor?
54. Bu göreve yeni bir oturumda devam etmek için hangi bağlama ihtiyacın olur?
6
7200 kelimenin altında tut.

Bellek Dosyası İstemi

1Her büyük adımı tamamladıktan sonra, bu formatta bir bellek notu yaz:
2
3TAMAMLANAN ADIM: [ne yapıldı]
4ANA KARARLAR: [alınan kararlar ve nedenleri]
5MEVCUT DURUM: [görevin şu anki durumu]
6SONRAKİ ADIM: [bundan sonra ne olmalı]
7
8Bu not, bağlamı kaybetmeden göreve yeni bir oturumda devam etmek için kullanılacaktır.

Bağlam Kurtarma İstemi

1Önceki bir oturumdan bir göreve devam ediyoruz. İşte bağlam:
2
3[bellek notunuzu buraya yapıştırın]
4
5Buna dayanarak:
61. Nerede olduğumuza dair anlayışını onayla
72. Sonraki adımı belirle
83. Devam etmek için gereken soruları sor
9
10Daha önce tamamlanmış işi tekrarlama.

Devam Eden Özet İstemi

1Konuşma uzuyor. Önemli olan her şeyi bir özete sıkıştır:
2
31. Orijinal hedef
42. Ne yapıldı ve ne bulundu
53. Alınan ana kararlar
64. Hala ne olması gerekiyor
7
8Özeti yazdıktan sonra, oradan devam et. Bu özeti yeni başlangıç noktası olarak kabul et.

Artık ajanların ne olduğunu, neler yapabileceklerini ve kendinizin nasıl bir tane oluşturacağını biliyorsunuz. Umarım faydalı olmuştur.

AI dünyasında olup biten her şeyden haberdar olmak istiyorsanız, beni X'te takip edin.

X - https://x.com/ai_rohitt