LangChain-Konfigurations- und Fehlerklassen
RunnableConfig-Konfigurationsoptionen
| Feld | Type | Beschreibung |
|---|---|---|
| configurable | dict | Laufzeitkonfiguration. Am häufigsten verwendet: thread_id für Checkpointer |
| recursion_limit | int | Maximale Rekursionstiefe (Standard 9999) |
| metadata | dict | Zusätzliche Metadaten |
| tags | list[str] | Liste von Tags zum Filtern und Gruppieren von Traces |
| callbacks | list[BaseCallbackHandler] | Callback-Handler |
Beispiel
config = {
"configurable": {"thread_id": "user-001"},
"metadata": {"source": "web"},
"tags": ["production", "chat"],
}
result = agent.invoke(inputs, config=config)
"configurable": {"thread_id": "user-001"},
"metadata": {"source": "web"},
"tags": ["production", "chat"],
}
result = agent.invoke(inputs, config=config)
Checkpointer-Implementierungsklassen
| Klasse | Importpfad | Persistenz |
|---|---|---|
| InMemorySaver | langgraph.checkpoint.memory | nein |
| SqliteSaver | langgraph.checkpoint.sqlite | Ja |
| PostgresSaver | langgraph.checkpoint.postgres | Ja |
Beispiel
# Speicher
from langgraph.checkpoint.memory import InMemorySaver
checkpointer = InMemorySaver()
# SQLite
from langgraph.checkpoint.sqlite import SqliteSaver
checkpointer = SqliteSaver.from_conn_string("checkpoints.db")
# PostgreSQL
# from langgraph.checkpoint.postgres import PostgresSaver
# checkpointer = PostgresSaver.from_conn_string("postgresql://...")
from langgraph.checkpoint.memory import InMemorySaver
checkpointer = InMemorySaver()
# SQLite
from langgraph.checkpoint.sqlite import SqliteSaver
checkpointer = SqliteSaver.from_conn_string("checkpoints.db")
# PostgreSQL
# from langgraph.checkpoint.postgres import PostgresSaver
# checkpointer = PostgresSaver.from_conn_string("postgresql://...")
Store-Implementierungsklassen
| Klasse | Importpfad | Persistenz |
|---|---|---|
| InMemoryStore | langgraph.store.memory | nein |
| PostgresStore | langgraph.store.postgres | Ja |
Beispiel
from langgraph.store.memory import InMemoryStore
store = InMemoryStore()
store.put(("namespace",), "key", {"data": "value"})
item = store.get(("namespace",), "key")
items = store.search(("namespace",))
store.delete(("namespace",), "key")
store = InMemoryStore()
store.put(("namespace",), "key", {"data": "value"})
item = store.get(("namespace",), "key")
items = store.search(("namespace",))
store.delete(("namespace",), "key")
Häufige Ausnahmeklassen
| Ausnahme | Source | Beschreibung |
|---|---|---|
| ToolException | langchain.tools | Ausnahme innerhalb eines Tools. Der Agent kann sie abfangen und neu entscheiden. |
| ImportError | Python-Built-in | Fehlendes Abhängigkeitspaket. Die Fehlermeldung schlägt den Installationsbefehl vor |
| ValueError | Python-Built-in | Fehler bei der Parametervalidierung oder Konfigurationsfehler |
| NotImplementedError | Python-Built-in | Middleware-Methode nicht implementiert (z. B. nur synchron definiert, aber asynchron aufgerufen) |
| StructuredOutputError | langchain.agents.structured_output | Fehler im Zusammenhang mit strukturierter Ausgabe (Formatabweichung, mehrere Ausgaben usw.) |
| StructuredOutputValidationError | langchain.agents.structured_output | Fehlgeschlagene Validierung der strukturierten Ausgabe |
| MultipleStructuredOutputsError | langchain.agents.structured_output | Das Modell hat mehrere strukturierte Ausgaben zurückgegeben |
| TimeoutError | Python-integriert / verschiedene SDKs | Anfrage-Timeout |
LaunchDarkly-Konfigurationscheckliste
| Prüfpunkt | Befehl/Methode |
|---|---|
| Python-Version | python --version (erfordert 3.10+) |
| langchain-Version | python -c "import langchain; print(langchain.__version__)" |
| Installation von Abhängigkeiten | pip list | grep langchain |
| API-Schlüssel-Konfiguration | python -c "import os; from dotenv import load_dotenv; load_dotenv(); print(os.getenv('DEEPSEEK_API_KEY', 'NOT SET')[:10])" |
| Modellkonnektivität | Verwenden Sie init_chat_model(), um eine einfache Anfrage zum Testen zu senden |
Weitere ErweiterungenDie API-Referenz dieses Tutorials basiert auf LangChain v1.3.0. Da sich LangChain noch schnell weiterentwickelt, wird empfohlen, die neueste offizielle Dokumentation für die aktuellsten API-Informationen zu konsultieren.