🏗️ QA Bot'tan Görev Ajanına: Bir Mimari Rehberi

TL;DR: Sadece soruları yanıtlayan sohbet botları inşa etmeyi bırakın. Gerçekten iş yapan görev ajanları inşa etmeye başlayın.

Bu rehber, monolitik QA botlarından Görev Ajanlarına geçişi, Statik Kurallar, Dinamik Beceriler ve Deterministik Kancalar kullanarak açıklamaktadır—somut kod örnekleri ve açık kaynak referansları ile.

Farklı bileşenler arasındaki etkileşimi gösteren bir görev ajanı sistem mimarisinin illüstrasyonu

1. Temel Değişim: QA Bot → Görev Ajanı

Günümüzdeki çoğu AI sistemi hala bağlamla doldurulmuş QA botlarıdır:

• Soruları iyi yanıtlarlar

• Baskı altında hayal görürler

• Uygulama, güvenlik ve tutarlılık konusunda garanti vermezler

💡 Ana fikir: 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
•Hayal görmeleri ve stil kaymasını önler
•Küçük, kararlı, insan tarafından düzenlenebilir

🛠️ 2. Dinamik Bağlam — Beceriler (İhtiyaç Duyulduğunda)

•Zihinsel model: Alet kutusu
•Sadece gerektiğinde yüklenir
•Her beceri, kendine yeterli bir yetenektir
•Bağlam penceresini temiz tutar

⚓ 3. Deterministik Kancalar — Güvenlik Şeritleri

•Zihinsel model: Güvenlik + Uyum katmanı
•Olasılıksal değil
•LLM akıl yürütmesinden önce / sonra çalışır
•Asla başarısız olmaması gereken kuralları zorlar

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 kalitesindeki sistemlere odaklanmış Kıdemli Python Mühendisisiniz.

# KURALLAR
- Hata ayıklama için ASLA print() kullanmayın
- HER ZAMAN fonksiyonları tip ipucu ile yazın
- 3'ten fazla dosya ile çalışıyorsanız bir plan önerin

# DAVRANIŞ
- Kısa ve öz olun
- Gerekirse açıklayıcı sorular sorun

Referans: https://github.com/PatrickJS/awesome-cursorrules

5. Dinamik Yetenek Ö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"Oluşturulan bilet {ticket_id} öncelik={priority} ile"

if __name__ == "__main__":
    mcp.run()

Referans: https://github.com/modelcontextprotocol/python-sdk

6. Deterministik Kanca Örneği

def compliance_check_hook(state):
    user_input = state["messages"][-1].content.lower()
    if "password" 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/

Eğer ajansınız sadece soruları yanıtlıyorsa, bu bir sohbet botudur. Eğer güvenilir bir şekilde iş yapıyorsa, bu bir Görev Ajansı'dır.