İlk AI ajanınızı 1 saatten kısa sürede nasıl oluşturacağınızı bu başlangıç dostu Claude Code rehberiyle öğrenin. Tam talimatları, adım adım iş akışını, yaygın hataları ve araçları, becerileri ve döngüleri anlamanın en kolay yolunu içerir.
Kimse bana ilk AI ajanımın bu kadar sıradan olacağını söylememişti ve tam da bu yüzden işe yaradı.
Bence birçok başlangıç seviyesindeki kişi ilk ajanlarının, uçak bileti ayırtan, kod yazan, web'de araştırma yapan ve bir şekilde öğle yemeğinden önce hayatlarını değiştiren otonom bir dijital çalışan gibi görünmesi gerektiğini hayal ediyor. hahaha.
İşte çoğu insan tam da bu fantezide takılıp kalıyor.
Günlerce terminoloji öğreniyor, framework'leri karşılaştırıyor ve zaten başlangıç seviyesinin çok ötesinde olan kişilerin demolarını izliyorlar. Oysa ihtiyaçları olan tek şey küçük, çalışan bir döngüydü.
İşte Claude Code'un benim için oturmasını sağlayan zihniyet değişimi tam olarak buydu.
İlk ajanınızın etkileyici olması gerekmez; bir hedef alması, biraz bağlam kullanması, bir eylem gerçekleştirmesi, sonucu kontrol etmesi ve devam etmesi ya da durması yeterlidir. Bunu bir kez inşa ettiğinizde, ajanlar etrafındaki tüm o korkutucu dil normal boyutuna küçülmeye başlar.
İşte bu, başladığımda sahip olmayı dilediğim rehber. Aşırı karmaşık teori yok, sadece Claude Code ile ilk kullanılabilir AI ajanınızı bir saatten kısa sürede oluşturmanın başlangıç dostu bir yolu.
Öncelikle, bir ajanın aslında ne olduğunu anlayın
"Ajan" kelimesi bunu olduğundan daha karmaşık gösteriyor.
Başlangıç seviyesinde, bir ajan sadece tek seferlik cevap vermekten fazlasını yapabilen bir AI sistemidir. Bir görevi üstlenebilir, bağlamı inceleyebilir, araçları kullanabilir, adım adım ilerleme kaydedebilir ve bir sonraki adımda ne yapacağına karar verebilir.
İşte bu kadar.
Başlamadan önce gelişmiş mimari diyagramlarını anlamanız gerekmez, sadece döngüyü anlamanız yeterlidir.
Döngü tüm fikirdir:
ajan bir hedef alır, duruma bakar, bir eylemde bulunur, bu eylemin yardımcı olup olmadığını kontrol eder ve ardından devam eder veya durur.
Claude Code bunu öğrenmek için harika bir yerdir çünkü zaten bu şekilde davranır. Sadece kod tükürüp kaybolmaz. Dosyaları inceleyebilir, düzenleyebilir, kontroller çalıştırabilir ve bir görev üzerinde çalışmaya devam edebilir. Bu, başlangıç seviyesindekilerin talimatlarla düşünmeyi bırakıp iş akışlarıyla düşünmeye başlamaları için en kolay yerdir.
İlk saatinizde ne inşa ediyorsunuz
"Her şey için bir araştırma asistanı" VEYA "tamamen otonom bir kodlama çalışanı" inşa etmeyin. Küçük bir şey inşa edin.
En iyi ilk ajan, dar bir işi net bir şekilde yapandır. Örneğin:
bir klasörü oku, dosyaları özetle, eylem maddelerini belirle ve sonucu temiz bir şekilde biçimlendir.
Bu kulağa sıkıcı gelebilir, ama sıkıcı iyidir. Sıkıcı, anlaşılabilir demektir. Ve anlaşılabilir olmak, sistemi daha sonra geliştirmenizi sağlar.
İlk saatteki hedef büyülü bir şey inşa etmek değil, kendinize Claude Code içinde gerçek iş yapan, gerçek yapıya sahip çalışan bir döngü oluşturabileceğinizi kanıtlamaktır.
En kolay ilk ajan iş akışı
En basit hali şöyle görünür:
Claude Code'a şöyle bir görev verirsiniz:
"Bu klasördeki notları gözden geçir, ana temaları özetle, açık soruları listele ve tek bir temiz özet dosyası oluştur."
Bu tek görev zaten bir ajanın temel yapısını taşır:
- bir hedefi var,
- bağlamı var,
- eylemleri var,
- ve doğrulamak için bir çıktısı var.
Onu ajan benzeri yapan şey sadece ifade şekli değildir. Claude Code'un görevi tek seferlik bir cevap gibi değil de adım adım ilerleyebilmesidir.
İşte önerdiğim başlangıç kalıbı:
tek bir klasör, tek bir görev, tek bir çıktı dosyası, tek bir inceleme adımıyla başlayın.
Bu yeterlidir.
Adım adım:
Claude Code'u açın ve çalışmak için küçük bir klasör oluşturun veya seçin.
Bu, birkaç not, bazı markdown dosyaları, küçük bir proje veya sırf pratik için kendinizin oluşturduğu birkaç metin dosyası olabilir.
Ajanın ne yaptığını anlayabileceğiniz kadar küçük tutun.
Ardından şöyle doğrudan bir talimat verin:
1Bu klasördeki tüm dosyaları incele.2İçerikteki ana temaları belirle.3Cevaplanmamış soruları veya gevşek uçları listele.4SUMMARY.md adlı yeni bir markdown dosyasında temiz bir özet oluştur.5Bitirmeden önce, tüm dosyaların incelemeye dahil edildiğini kontrol et.
Bu, başlangıç seviyesindekiler için harika çalışır çünkü sessizce önemli olan hemen her şeyi öğretir.
Ajan şunlara sahiptir:
- bir kapsam: bu klasördeki tüm dosyalar,
- bir hedef: temaları ve açık soruları özetlemek,
- bir eylem: okumak ve sentezlemek,
- bir teslimat: SUMMARY.md,
- bir doğrulama adımı: her dosyanın dahil edildiğinden emin olmak.
Bu, basit olsa bile gerçek bir döngüdür.
Bunun Claude Code'da neden bu kadar iyi çalıştığı
Claude Code başlangıç seviyesindekiler için iyidir çünkü ortam, görev tabanlı düşünmeyi teşvik eder.
Birçok AI eğitimi ajanları soyut bir şekilde öğretir.
Henüz kullanışlı bir sonuç görmeden araçlar, hafıza, orkestrasyon ve otonomiden bahsederler.
Claude Code bunu tersine çevirir.
Somut bir görevle başlamanızı sağlar ve ardından neredeyse tesadüfen, ajanın bir döngü izlediğini fark edersiniz:
incele, eyleme geç, doğrula, devam et.
Bu önemlidir çünkü çoğu başlangıç seviyesindeki kişinin daha fazla teoriye ihtiyacı yoktur. Tek bir başarılı deneyime ihtiyaçları vardır ve bir ajanın gelecekten gelen bir yaratık olmadığını görmeleri gerekir.
Sadece işi ilerletmek için AI kullanan yapılandırılmış bir iş akışıdır.
Claude Code ayrıca becerileri ve araçları daha az korkutucu hissettirir çünkü pratik bir bağlamın içinde yer alırlar. "Teoride araç destekli ajan nedir?" diye sormak yerine daha iyi sorular sormaya başlarsınız:
"Hangi araç bu göreve yardımcı olur?"
"Ajan durmadan önce neyi kontrol etmeli?"
"Çıktı eksik olursa ne olur?"
Bunlar doğru başlangıç sorularıdır.
Araçlar ve beceriler ekleme
Temel ajan çalıştıktan sonraki adım, onu her yerde daha akıllı yapmak değil, ona kullanışlı bir uzantı vermektir.
Örneğin, ajanınız şunları yapabilir:
- notları okuyup bir özet çıkarmak,
- ardından eylem maddelerini çıkarmak,
- sonra bu eylem maddelerini bir kontrol listesine dönüştürmek,
- ve bunları başka bir dosyaya kaydetmek.
Veya şunları yapabilir:
- bir proje klasörünü taramak,
- eksik belgeleri belirlemek,
- ve kısa README dosyalarının nerede gerektiğini önermek.
İşte araçlar ve beceriler bu noktada kullanışlı olmaya başlar. Bir araç, ajanın somut bir şey yapmasına yardımcı olur. Bir beceri, ona bir iş kategorisini ele almak için tekrarlanabilir bir kalıp kazandırır.
Başlangıç seviyesindekiler için bunu düşünmenin en kolay yolu basittir:
araç, ajanın kullanabileceği şeydir;
beceri ise ajanın onu iyi kullanmayı öğrenme şeklidir.
İlk projenizi aşırı yüklemeyin. İlk döngü çalıştıktan sonra yalnızca bir kullanışlı uzantı ekleyin.
İyi çalışan tam talimat
Bu, Claude Code'u ilk ajanı için kullanan bir başlangıç seviyesindeki kişiye vereceğim türden bir talimattır:
1Küçük bir dosya tarama ajanı oluşturmama yardım ediyorsun.23Görev:41. Bu klasördeki tüm dosyaları oku.52. Bunlar arasındaki ana konuları özetle.63. Cevaplanmamış soruları, eksik parçaları veya eylem maddelerini belirle.74. Aşağıdakileri içeren SUMMARY.md adlı bir markdown dosyası oluştur:8 - Ana temalar9 - Açık sorular10 - Önerilen sonraki adımlar115. Bitirmeden önce, klasördeki her dosyanın incelendiğini doğrula.1213Çıktıyı aşırı karmaşık hale getirme.14Özeti pratik ve kolayca göz atılabilir tut.
Bu talimatta sevdiğim şey, gelişmiş görünmeye çalışmaması. Net, dar ve işlevsel. Başlangıç seviyesindekilerin tam olarak ihtiyacı olan şey bu.
Biraz daha ajan benzeri bir versiyon isterseniz, bunu kullanın:
1Bu klasördeki dosyaları bir AI ajanı olarak incele.2Adım adım çalış.3Önce mevcut dosyaları incele.4Ardından ana temaları ve eylem maddelerini çıkar.5Sonra SUMMARY.md'yi oluştur.6Son olarak, durmadan önce hiçbir dosyanın atlanmadığını doğrula.
Bu versiyon döngüyü daha da belirgin hale getirir.
Nasıl doğru şekilde test edilir
Çoğu başlangıç seviyesindeki kişi bir ajanı, bir şey üretip üretmediğine bakarak "test eder". Bu çok zayıf bir testtir.
Gerçek test, gerçek görevi doğru şekilde tamamlayıp tamamlamadığıdır.
Bu ilk ajan için test basittir:
- Tüm dosyaları inceledi mi?
- Özet gerçek içeriği yansıttı mı?
- Bariz bir şeyi kaçırdı mı?
- Doğru çıktı dosyasını oluşturdu mu?
- Nihai sonuç sadece makul değil, aynı zamanda kullanışlı mı hissettirdi?
Son nokta çok önemlidir. AI çıktısı, sığ olsa bile genellikle cilalı gelir. Bu nedenle sadece biçimlendirmenin güzel görünüp görünmediğini kontrol etmeyin. İçeriğin gerçekten doğru olup olmadığını kontrol edin.
Claude Code'un yine yardımcı olduğu yer burasıdır. Görev ortamı içinde çalıştığı için dosyaları inceleyebilir, sonucu karşılaştırabilir ve bir şeyler saparsa talimatı sıkılaştırabilirsiniz.
Başlangıçta ajan oluşturmak gerçekten böyle görünür: küçük döngü, test et, ayarla, tekrar çalıştır.
Başlangıç seviyesindekilerin yaptığı yaygın hatalar
En büyük hata, çok erken çok hırslı bir şey inşa etmeye çalışmaktır.
İlk ajanınızın on araç, hafıza, zamanlama ve karmaşık bir alt ajan zincirine ihtiyacı olmamalıdır.
Bu "başlangıç dostu" değildir. Bu, havalı bir ceket giymiş kafa karışıklığıdır.
İkinci hata, belirsiz hedefler kullanmaktır.
"Bu klasörü iyileştir" derseniz, ajanın başarıya dair güçlü bir tanımı olmaz.
"Tüm dosyaları incele, temaları özetle, açık soruları belirle ve SUMMARY.md oluştur" derseniz, artık bir yönü vardır.
Üçüncü hata, doğrulamayı atlamaktır.
Kontrol etmeden hareket eden bir sistem güçlü bir ajan değildir. Sadece hızlı tahmin yapmaktır.
Dördüncü hata, terminolojiye takılıp kalmaktır. Bir tane inşa etmeden önce her AI ajanı moda sözcüğünde ustalaşmanız gerekmez. Önce inşa edin. Kelime dağarcığı sonra yetişebilir.
Sırada ne inşa edilmeli
Bu ilk ajan çalıştıktan sonra, çok doğal bir şekilde seviye atlayabilirsiniz.
Sonraki kullanışlı başlangıç projeleri genellikle şunlar gibidir:
- notları okuyup brifingler hazırlayan bir araştırma ajanı,
- eksik belgeleri veya TODO'ları bulan bir kod tabanı ajanı,
- kaba notları yapılandırılmış taslaklara dönüştüren bir içerik ajanı,
- dosyaları tarayıp bir güncelleme günlüğü üreten günlük bir inceleme ajanı.
Kalıba dikkat edin: hepsi hala döngülerdir. Sadece bağlam açısından biraz daha zenginleşirler ve doğrulama açısından biraz daha katılaşırlar.
Claude Code ile gerçek başlangıç yolu budur. Talimat hileleri değil. Gösterişli karmaşıklık değil. Sadece döngüyü her seferinde daha net tanımlamayı öğrenmek.
Asıl çıkarılacak ders
İlk AI ajanınız neredeyse hayal kırıklığı yaratacak kadar küçük hissetmeli.
Bu iyi bir işarettir. Anlayabileceğiniz, test edebileceğiniz ve geliştirebileceğiniz kadar gerçek bir şey inşa ettiğiniz anlamına gelir. Claude Code, bu öğrenme tarzını pratik hale getirdiği için harika bir başlangıç aracıdır. Size bir ajanın sihir olmadığını gösterir. Hedef, bağlam, eylem, doğrulama ve durmadan oluşan yapılandırılmış bir döngüdür.
Çalışan küçük bir ajan inşa edin.
Sonra onu biraz daha iyi hale getirin.
Sonra bir araç ekleyin.
Sonra tekrar test edin.
"AI ajanının ne olduğu hakkında hiçbir fikrim yok"tan "bir saatten kısa sürede bir tane inşa ettim"e giden yol budur.
Umarım makaleyi beğenmişsinizdir.
Sizin gibi yaratıcılar için daha iyi AI iş akışları oluşturuyorum.
❣️Ben Kanika (@KanikaBK) — daha pratik testler ve kurulumlar için beni takip edin.
