Een Agent Maken met Aangepaste Tools

AI-agents met Hugging Face smolagents

Adel Nehme

VP of AI Curriculum, DataCamp

Voordelen van Aangepaste Tools

Betrouwbaarheid: Schrijf en test logica expliciet in plaats van te vertrouwen op de agent
Herbruikbaarheid: Gebruik tools in verschillende projecten en agents
Consistentie: Voorspelbaar gedrag bij elke run (handig voor debugging)
Gereguleerde toegang: Stel alleen bloot wat je wilt (bestanden, API's, databases, etc.)

Scenario: Je Beheert een Winkel

Voorraadgegevens staan in een CSV-bestand (maat, kleur, hoeveelheid en prijs)
Code agents kunnen code schrijven om CSV's te lezen
Maar ze hebben standaard geen toegang tot bestanden
Je moet bestandsaccess in een aangepaste tool verpakken

Anatomie van een Aangepaste Tool

from smolagents import tool
import pandas as pd

@tool
def check_inventory(product_name: str) -> int:
    """
    Controleer de beschikbare hoeveelheid van een product in de voorraad-CSV.

    Args:
        product_name (str): De naam van het product om op te zoeken.

    Returns:
        int: De hoeveelheid op voorraad. Geeft 0 terug als het product niet wordt gevonden.
    """
    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

Best Practices voor Aangepaste Tools

Hebben we t-shirts op voorraad?

Een Aangepaste Tool Registreren bij Jouw Agent

from smolagents import CodeAgent

agent = CodeAgent(
    tools=[check_inventory], # Voeg aangepaste tool toe
    model=InferenceClientModel(),
    additional_authorized_imports=["pandas"]  # Sta extern pakket toe
)

agent.run("Hebben we grote t-shirts op voorraad?")

Ja, we hebben 8 grote t-shirts op voorraad.

Aangepaste Tools in Productieprojecten

Laten we oefenen!

AI-agents met Hugging Face smolagents