LangChain Tools-API


@tool-Dekorator

ParameterTypeStandardwertBeschreibung
args_schemaBaseModel oder NoneKeineParametervalidierungsmodell. Wenn nicht angegeben, wird es automatisch aus der Funktionssignatur generiert.
return_directboolFalseOb direkt zurückgegeben werden soll (Modell-Neudenken überspringen)
namestr or NoneFunktionsnameTool-Name
descriptionstr or NoneFunktions-DocstringTool-Beschreibung

Wichtige Attribute und Methoden von BaseTool

Attribut/MethodeBeschreibung
nameTool-Name (string)
descriptionTool-Beschreibung (string)
args_schemaPydantic-Modell für Parameter
return_directOb direkt zurückgegeben werden soll (bool)
invoke(input)Tool aufrufen; input ist das Parameter-Dictionary
ainvoke(input)Tool asynchron aufrufen

Dependency-Injection-Marker

MarkerZweckNutzung
InjectedStateAgent-Status injizierenAnnotated[dict, InjectedState]
InjectedStoreCross-Session-Store injizierenAnnotated[BaseStore, InjectedStore()]
InjectedToolCallIdTool-Aufruf-ID injizierenAnnotated[str, InjectedToolCallId]
InjectedToolArgGenerischer InjektionsmarkerAnnotated[T, InjectedToolArg]

Häufige Anwendungsbeispiele

Beispiele

from langchain.tools import tool, InjectedState, InjectedStore, ToolException
from typing import Annotated
from langgraph.store.base import BaseStore

# Einfaches Tool
@tool
def my_tool(param: str) -> str:
    """Tool-Beschreibung"""
    return f"Ergebnis: {param}"

# Mit Parametervalidierung
from pydantic import BaseModel, Field

class MyInput(BaseModel):
    param: str = Field(description="Parameterbeschreibung", min_length=1)

@tool(args_schema=MyInput)
def validated_tool(param: str) -> str:
    return param

# Direkte Rückgabe
@tool(return_direct=True)
def query_tool(query: str) -> str:
    return f"Ergebnis: {query}"

# Zustand injizieren
@tool
def stateful_tool(
    param: str,
    state: Annotated[dict, InjectedState],
) -> str:
    return f"Nachrichtenanzahl: {len(state.get('messages', []))}"

# Store injizieren
@tool
def store_tool(
    key: str,
    store: Annotated[BaseStore, InjectedStore()],
) -> str:
    item = store.get(("ns",), key)
    return str(item.value if item else "None")

# Ausnahmebehandlung
@tool
def safe_tool(param: int) -> str:
    if param < 0:
        raise ToolException(f"Parameter muss eine positive Zahl sein: {param}")
    return f"OK: {param}"
Andere Erweiterungen