Özel Araçlarla Bir Ajan Oluşturma

Hugging Face smolagents ile AI Agent'ları

Adel Nehme

VP of AI Curriculum, DataCamp

Özel Araçların Faydaları

Güvenilirlik: Ajanın tahminine güvenmek yerine mantığı açıkça yazın ve test edin
Yeniden Kullanılabilirlik: Araçları projeler ve ajanlar arasında kullanın
Tutarlılık: Çalışmalar arasında öngörülebilir davranış elde edin (hata ayıklama için harika)
Kontrollü erişim: Sadece istediğiniz şeyleri açığa çıkarın (dosyalar, API'ler, veritabanları vb.)

Senaryo: Bir Perakende Mağazası İşletiyorsunuz

Envanter verileri bir CSV dosyasında saklanır (boyut, renk, miktar ve fiyat)
Kod ajanları CSV'leri okumak için kod yazabilir
Ancak varsayılan olarak dosyalara erişimleri yoktur
Dosya erişimini özel bir araçla sarmanız gerekir

Özel Bir Aracın Anatomisi

from smolagents import tool
import pandas as pd

@tool
def check_inventory(product_name: str) -> int:
    """
    Envanter CSV'sinde bir ürünün mevcut miktarını kontrol edin.

    Args:
        product_name (str): Aranacak ürünün adı.

    Returns:
        int: Stoktaki miktar. Ürün bulunamazsa 0 döner.
    """
    df = pd.read_csv("store_inventory.csv")
    match = df[df["product_name"] == product_name]
    stock_quantity = int(match.iloc[0]["quantity"]) if not match.empty else 0
    return stock_quantity

Özel Araçlar için En İyi Uygulamalar

Stokta tişört var mı?

Ajanınıza Özel Bir Araç Kaydetme

from smolagents import CodeAgent

agent = CodeAgent(
    tools=[check_inventory], # Özel araç ekle
    model=InferenceClientModel(),
    additional_authorized_imports=["pandas"]  # Harici paket izni ver
)

agent.run("Stokta büyük tişört var mı?")

Evet, stokta 8 büyük tişört var.

Üretim Projelerinde Özel Araçlar

Hadi pratik yapalım!

Hugging Face smolagents ile AI Agent'ları