Yapay Zeka Temsilcileri: Nedir ve Adım Adım Nasıl Oluşturulur?

Herkes AI ajanları hakkında konuşuyor. 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 resim bundan daha faydalı. Ajanlar bir kategori değildir. Bir spektrumdur.

Bu rehber, farklı AI araçlarının bu spektrumun neresinde olduğ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 Telegram'a bağlayacağınızı, kendiniz kod yazmadan açıklar.

Detaylara girmeden önce, beni X'te takip edin ve yeni oluşturduğum Telegram kanalıma katılın; her gün daha fazla AI içeriği paylaşıyorum. İkisi de ücretsiz.

X - https://x.com/AnatoliKopadze

Telegram - https://t.me/kopadzemp

Bir Şeyi Ajan Yapan Nedir

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

Claude'a "şu anda AI'da trend olan üç konuyu bul, en yüksek etkileşim potansiyeline sahip olanı seç, benim tarzımda bir gönderi taslağı hazırla ve bir dosyaya kaydet" deyip, sen 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 sohbetin sahip olmadığı üç şeye sahiptir. Kendi başına çağırabileceği araçlar: arama, dosya sistemleri, kod çalıştırma, harici API'ler. Görevler arasında devam eden, sadece bir oturumla sınırlı olmayan bellek. Ve tek bir yanıt üretinceye kadar değil, görev tamamlanana kadar çalışmaya devam eden bir döngü.

Bu üç şeyden ne kadar eklersen, o kadar az dahil olursun. İşte fikir bu.

Spektrum: Sohbetten Ajana

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

Bir adım yukarı: Araçlar etkinleştirilmiş Claude. Claude cevap vermeden önce internette arama yaptığında, ekli bir dosyayı okuduğunda veya bir görsel oluşturduğunda, zaten biraz ajanlık yapıyordur. Ona adım adım bunları yapmasını sen söylemedin, ihtiyacı olduğuna kendi karar verdi.

Daha da yukarı: Çok adımlı iş akışları. Bir hedef verirsin, Claude onu adımlara böler, her birini yürütür, sonucu kontrol eder ve bitmiş bir çıktı teslim eder. Adımlar arasında sen dahil değilsindir.

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 belirler ve çıktıyı kontrol edersin.

En alt ve en üst arasındaki fark farklı bir model değil. Modeli çevreleyen şeylerdir: çağırabileceği araçlar, bağlamı taşıyan bellek ve görev bitene kadar çalışmaya devam eden bir döngü.

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

Ajanaların bugün aslında neye benzeyebileceğine dair bir fikir vermek için aşağıya birkaç örnek koydum. Bunlar sınırlar değil, kendi özel durumunuza uygun olan her şeyi oluşturabilirsiniz.

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

Yazma ajanı: Tanımladığın bir sisteme göre içerik yazar. Ona tonunu, formatını, kitleni ve konuyu ver. Her cümleyi yönetmek zorunda kalmadan 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 edersin. Ajan uygulama ve hata ayıklama döngüsünü halleder.

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

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

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

Uzaktaki 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 şu olmalıdır:" yazan yere İstem 2'ye yapıştırın; Claude Code o belirli ajanı oluşturacaktır. Durumunuza uyacak şekilde herhangi bir ayrıntıyı ayarlayın.

Araştırma Ajanı

1Sen bir araştırma ajanısın. Görevin, 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 hakkında bilgi ara
63. Her kaynağın kalitesini ve alaka düzeyini değerlendir
74. Yalnızca soruyu doğrudan cevaplayan şeyleri çıkar
85. Şunlarla 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, açıkça söyle.
12Doldurma ekleme. Her cümle bilgi içermelidir.

Yazma Ajanı

1Sen bir yazma ajanısın. Benim sesim ve tarzımda içerik 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. Sağlanmamışsa konuyu, kitleyi ve istenen uzunluğu sor
112. İlk bir taslak yaz
123. Bunu 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. Görevin kod yazmak, hatalarını ayıklamak ve geliş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 bunları sistematik olarak 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 büyük bölümün ne yaptığını dille açıkla
13- Gereksinimlerden emin değilsen, devam etmeden önce netleştirici bir 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 hedefini belirle (bilgilendirmek, talep etmek, takip etmek, onaylamak)
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 göre gerçekçi bir sıra öner
63. Her görev için gereken süreyi tahmin et
74. Devredilebilecek veya elenebilecek herhangi bir ş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 doldurması yok. Sadece plan.

Başlamadan Önce Neye İhtiyacınız Var

1 - console.anthropic.com adresinden bir Claude API anahtarı. Bu bir geliştirici anahtarıdır, sabit bir aylık ücret değil, 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, 1GB RAM ve 20GB depolama fazlasıyla yeterlidir. DigitalOcean, Hetzner veya Vultr'dan herhangi bir temel plan işinizi görecektir ve ayda yaklaşık 4 ila 6 dolar arasındadır. Sunucuyu aldıktan sonra, 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, her 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 kullanın. Opus 4.8 yalnızca cevap kalitesinin kritik olduğu karmaşık bir analitik ajan için mantıklıdır.

İlk Ajanınızı Oluşturmak - 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'yi 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 konuşma 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- Bu kullanıcı için konuşma 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ıdır:
4- Sunucu başlatıldığında otomatik olarak başla
5- Çökerse otomatik olarak yeniden başla
6- Ortam değişkenlerini proje klasöründeki .env dosyasından 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 konuşma geçmişini kaybediyor. Bunu düzelt.
2
3Her mesajdan sonra her kullanıcının konuşma geçmişini diskteki 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 Beceriler Eklemek

Beceriler, zaman içinde botunuza eklediğiniz yeteneklerdir. Her biri Claude Code'a verdiğiniz yeni bir istemdir ve o da bunu çalıştırmak için kodu yazar. İşte en kullanışlı olanları.

**Beceri: 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 karar vermelidir. .env dosyası şablonuna TAVILY_API_KEY ekle.
6
7Bunu temiz bir şekilde uygulamak için Claude'un araç kullanma özelliğini kullan.

**Beceri: Notları kaydet

**Ajanınız, ona söylediğiniz herhangi bir şeyi - fikirler, görevler, araştırma bulguları - bir dosyaya kaydedebilir ve daha sonra 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 kayıtlı notu döndüren bir /notes komutu ekle.
6Tüm kayıtlı notları silen bir /clearnotes komutu ekle.

Beceri: Sadece 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 kullanıcı kısıtlaması ekle, böylece onu yalnızca ben kullanabilirim.
2
3Telegram kullanıcı ID'mi .env dosyasına ALLOWED_USER_ID olarak ekle.
4Başka biri bota mesaj atarsa, "Bu bot özeldir." yanıtını verir ve bu 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 — bot aracılığıyla veya başka bir yöntemle.

Beceri: 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 kümülatif bir toplam tut.
5
6Şunları gösteren bir /costs komutu ekle: bugün kullanılan toplam token sayısı, tüm zamanlar boyunca kullanılan toplam token sayısı ve claude-sonnet-4-6 fiyatlandırmasına dayalı tahmini USD maliyeti.

**Beceri: Planlı günlük brifing

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

1Bota planlı bir günlük brifing ekle.
2
3Her gün sabah 8:00'de, bot bana şunları içeren bir mesaj gönderir:
41. Motivasyonel bir satırlık (kısa, ucuz değil)
52. Günün 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 Bilmeniz 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 your-bot-name ile 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 your-bot-name 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 your-bot-name -n 50 komutunu çalıştırın. Bir şey bozulduğunda hata mesajlarını burada bulursunuz.

Yeni bir beceri 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 sırasında, çok fazla mesajdan sonra bağlamı kaybeder ve hatalar yapmaya veya daha önce yaptığı işi tekrarlamaya başlar.

**Bunun üç 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, 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 görev sırasında kesintiye uğrarsa, nerede durduğunu bilmesinin bir yolu yoktur.

**Bunu dört şey düzeltebilir:

**

Ajana her büyük adımdan sonra bir ilerleme notu yazmasını söyleyin: ne yapıldı, neye karar verildi, hala ne yapılması gerekiyor. Bu notu bir sonraki oturumun başında tam bağlamı geri yüklemek için yapıştırın.

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

Konuşma çok uzamadan önce, ajandan her şeyi kısa 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ğlam içinde olur.

Kontrol Noktası İstemi

1Devam etmeden önce, kısa bir kontrol noktası yaz:
21. Şu ana kadar neyi tamamladın?
32. Bu oturumdan alınan kilit 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 olurdu?
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ı]
4KİLİT KARARLAR: [alınan kararlar ve nedenleri]
5MEVCUT DURUM: [görevin şu an nerede olduğu]
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 tüm 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 kilit 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 nasıl bir tane oluşturacağınızı biliyorsunuz. Umarım faydalı olmuştur.

AI'da olup biten her şeyden haberdar olmak istiyorsanız, beni X ve Telegram'da takip edin.

X - https://x.com/AnatoliKopadze

Telegram - https://t.me/kopadzemp