Agentik RAG'a Giriş

Hugging Face smolagents ile AI Agent'ları

Adel Nehme

VP of AI Curriculum, DataCamp

Agentik RAG: Yinelemeli Geri Alma + Akıl Yürütme

smolagents'te Durumsuz vs. Durumlu Araçlar

Fonksiyon Araçları (@tool dekoratörü)

Durumsuz: çağrılar arasında hafıza yok
Çağrılar arasında vektör mağazanızı hatırlayamaz

Sınıf Tabanlı Araçlar (Tool alt sınıfı)

Durumlu: çağrılar arasında referansları saklar
Karmaşık nesneleri depolar

Sınıf Tabanlı Bir Aracın Anatomisi

from smolagents import Tool

class ToolName(Tool):
    name = "tool_name"

    description = "Ajan için net açıklama"

    inputs = {
        "parameter_name": {"type": "parameter_type", "description": "Parametre amacı"}
    }
    output_type = "string"

    def __init__(self, custom_parameters):
        super().__init__()
        self.custom_attribute = custom_parameters

    def forward(self, parameter_name):
        # Ajan bu metodu çağırır
        return "işlenmiş çıktı"

Bir Tarif Arama Aracı Oluşturma

class RecipeSearchTool(Tool):
    name = "recipe_search" 
    description = "Yemek tarifleri, teknikleri ve yemek planlama bilgileri için arama yap"
    inputs = {
        "query": {"type": "string", "description": "Doğal dilde yemek sorgusu"}
    }
    output_type = "string"

    def __init__(self, vectorstore, k=6):
        super().__init__()
        self.vectorstore = vectorstore
        self.k = k

    def forward(self, query):
        docs = self.vectorstore.similarity_search(query, k=self.k)
        return "\n\n".join(doc.page_content for doc in docs) or "Hiçbir şey bulunamadı."

Yemek Asistanı Ajanı: Hepsini Bir Araya Getirme

# Geri alma aracını başlat
recipe_search = RecipeSearchTool(vector_store)

agent = CodeAgent(
    tools=[recipe_search],
    model=model,
    instructions="Tam tarif cevapları sağlamak için kapsamlı arama yap. 
      İlk sonuçlar eksik görünüyorsa, farklı arama terimleri dene.",
    verbosity_level=1,
    max_steps=8
)

Ajan Çalıştırma Örneği

Soru: Profesyonel tekniklerle otlu somon nasıl pişirilir?

[Adım 1] "somon otları pişirme teknikleri" ara...

[Adım 2] "profesyonel somon hazırlama" ara...

[Son Cevap]

"Filetoları kurulayın, otlarla baharatlayın ve:

Tereyağı, sarımsak, kekik ile derisi aşağıda kızartın
Veya 200°C'de limon ve otlu tereyağı ile 10-12 dakika pişirin"

Haydi pratik yapalım!

Hugging Face smolagents ile AI Agent'ları