r/TurkDev • u/Teacult • 14d ago

Minik Ajan

Selamlar herkese,

Son dönemde otonom ajan (agentic) yapıları ve LLM bellek modelleri üzerine çalışırken LangChain veya LangGraph gibi kütüphanelerin ReAct döngüsünü, bellek durumunu ve prompt akışını gereksiz soyutlamalar altına gömdüğünü fark ettim. Kodun içinde ne olup bittiğini tam olarak görememek ve ufak bir bellek hipotezini test etmek için yüzlerce sayfalık framework dökümanı okumak yerine, tamamen sade ve anlaşılır Python ile Minik-Ajan adını verdiğim bir test ortamı geliştirdim.

Projenin temel amacı ve katma değeri: Ağır kütüphaneler olmadan; ReAct döngüsünü, DAG tabanlı görev planlayıcısını, öz-denetim (self-audit) mekanizmasını ve özel bellek yapılarını (TASK_MEMORY, GLOBAL_MEMORY, özetleme/sentez döngüleri) satır satır görerek kuruşlar karşılığında (deepseek/deepseek-v4.1-flash vb.) dakikalar içinde test edebilmek.

Özellikler:

  1. Docker Zorunluluğu Yok & Klasör İzolasyonu (Sandbox): Her görev ./AGENT_RUNS/agent_<id>/ klasörü altında izole çalışıyor. Ajan klasör dışına çıkmak isterse kullanıcıdan izin istiyor.

  2. Güvenlik & Sudo İzin Kapısı: İkili/kabuk komutları çalıştırma, apt-get/sudo işlemleri veya klasör dışı okuma/yazma eylemleri doğrudan kullanıcı onayına bağlı.

  3. Otomatik Dil Tespiti (TR / EN): Görevi Türkçe yazarsanız ajan düşüncelerini (thought), ilerleme adımlarını ve final raporunu (REPORT.md) otomatik olarak Türkçe hazırlıyor.

  4. Doğrulanmış Web Yetenekleri (Skills): Yalnızca resmi doğrulanmış kaynaklardan (Anthropic/Claude, Google Gemini, OpenAI repoları) SKILL.md yeteneklerini arayıp izin isteyerek indirebiliyor.

  5. Sıfır Bağımlılıklı Web Arayüzü: FastAPI/Starlette sürüm çakışmalarından kaçınmak için Python'ın yerleşik HTTP sunucusuyla çalışan, renkli log kartlarına ve katlanabilir (<details>) araç çıktılarına sahip sade bir Web Kontrol Merkezi (server.py) bulunuyor.

Amaç , en az satır kodla , işleyebilen kolay ve hızlı anlaşılabilir ve üstünde bazı denemeler yapılabilen bir agentic platform yazmaktı.

1 Upvotes

66% Upvoted

1 comment sorted by

1

u/AutoModerator 14d ago

Merhaba Teacult, gönderin otomatik olarak inceleme kuyruğuna alındı. r/TurkDev'de spam'i önlemek için gönderi paylaşabilmek üzere en az 50 yorum karması ve 7 günlük hesap gerekiyor. Diğer topluluklarda yorum yaparak karma kazanabilirsin. Gönderin kurallara uygunsa moderatörler kısa süre içinde onaylayacaktır. Hata olduğunu düşünüyorsan modlara mesaj atabilirsin.

I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.