🏗️ QA Botundan Görev Ajanına: Bir Mimari Rehberi
Özet: Sadece soruları yanıtlayan sohbet robotları oluşturmayı bırakın. Gerçekten iş yapan Görev Ajanları oluşturmaya başlayın.
Bu rehber, Statik Kurallar, Dinamik Beceriler ve Deterministik Kancalar kullanarak monolitik QA botlarından Görev Ajanlarına mimari geçişi somut kod örnekleri ve açık kaynak referanslarıyla açıklamaktadır.
1. Temel Değişim: QA Botu → Görev Ajanı
Bugün çoğu yapay zeka sistemi hala bağlam dolu QA botlarıdır:
• Soruları iyi yanıtlarlar
• Baskı altında halüsinasyon görürler
• Yürütme, güvenlik ve tutarlılık konusunda garantilerden yoksundurlar
💡 Temel içgörü: Bağlamı ölçeklendirmeyin. Yapılandırın.
2. Üç Katmanlı Mimari
🧱 1. Statik Bağlam — Kurallar (Her Zaman Açık)
- •Zihinsel model: Çalışan el kitabı
- •Her zaman yüklü
- •Kimliği, kodlama standartlarını, davranışsal kısıtlamaları tanımlar
- •Halüsinasyonları ve stil kaymasını önler
- •Küçük, kararlı, insan tarafından düzenlenebilir
🛠️ 2. Dinamik Bağlam — Beceriler (İsteğe Bağlı)
- •Zihinsel model: Alet çantası
- •Sadece gerektiğinde yüklenir
- •Her beceri kendi kendine yeten bir yetenektir
- •Bağlam penceresini temiz tutar
⚓ 3. Deterministik Kancalar — Korkuluklar
- •Zihinsel model: Güvenlik + Uyumluluk katmanı
- •Olasılıksal değil
- •LLM akıl yürütmesinden önce / sonra çalışır
- •Asla başarısız olmaması gereken kuralları uygular
3. Önerilen Proje Yapısı
my-task-agent/ ├── .cursorrules ├── main.py ├── tools/ │ └── linear_mcp.py └── README.md
4. Statik Bağlam Örneği: .cursorrules
# ROL Üretim sınıfı sistemlere odaklanmış Kıdemli bir Python Mühendisisiniz. # KURALLAR - Hata ayıklama için ASLA print() kullanmayın - Fonksiyonlara HER ZAMAN tür ipucu ekleyin - >3 dosyaya dokunacaksanız bir plan önerin # DAVRANIŞ - Özlü olun - Gerekirse açıklayıcı sorular sorun Referans: https://github.com/PatrickJS/awesome-cursorrules
5. Dinamik Beceri Örneği (MCP)
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("DevTools")
@mcp.tool()
def create_linear_ticket(title: str, priority: str = "low") -> str:
ticket_id = f"LIN-{hash(title) % 10000}"
return f"Öncelik={priority} ile {ticket_id} bileti oluşturuldu"
if __name__ == "__main__":
mcp.run()
Referans: https://github.com/modelcontextprotocol/python-sdk6. Deterministik Kanca Örneği
def compliance_check_hook(state):
user_input = state["messages"][-1].content.lower()
if "şifre" in user_input or "api_key" in user_input:
return {"error": "Güvenlik ihlali tespit edildi"}
return agent_node(state)
Referans: https://langchain-ai.github.io/langgraph/Ajanınız sadece soruları yanıtlıyorsa, o bir sohbet robotudur. Eğer güvenilir bir şekilde iş yapıyorsa, o bir Görev Ajanıdır.
