So implementieren Sie Tool-Calls mit LangSmith (Schritt für Schritt)

📖 5 min read•955 words•Updated Mar 29, 2026

So implementieren Sie Tool-Calls mit LangSmith

Wir bauen eine Tool-Calling-Implementierung, die verschiedene APIs und Dienste verbindet, um Ihre Anwendung effizienter und reaktionsschneller zu machen. Diese Methode ist heute besonders relevant, da Unternehmen mit der Notwendigkeit für schnellere Entwicklungszyklen kämpfen.

Voraussetzungen

JavaScript ES6+
Node.js 14+
LangSmith v1.0.0+

Schritt 1: Richten Sie Ihre Umgebung ein

Als Erstes müssen Sie Ihr Projekt einrichten und die benötigten Abhängigkeiten installieren. Wenn Sie das ignorieren, werden Sie später mit den Konsequenzen kämpfen müssen.


mkdir langsmith-tool-calling
cd langsmith-tool-calling
npm init -y
npm install langsmith

Warum das wichtig ist: Eine ordnungsgemäße Initialisierung Ihrer Umgebung erspart Ihnen später große Schwierigkeiten. Wenn Sie nicht die Node-Version 14 oder höher verwenden, wird Ihre App auf Kompatibilitätsprobleme stoßen. Vertrauen Sie mir, ich habe das schon durchgemacht.

Schritt 2: Erstellen Sie eine grundlegende Tool-Calling-Funktion

Mit allem eingerichtet, ist der nächste Schritt, einen grundlegenden Tool-Call zu implementieren. Dies wird Ihr erster Test sein, um sicherzustellen, dass LangSmith wie erwartet funktioniert.


import { Tool } from 'langsmith';

const fetchDataFromAPI = async (url) => {
 const response = await Tool.call(url);
 return response.data;
};

fetchDataFromAPI('https://api.example.com/data')
 .then(data => console.log(data))
 .catch(err => console.error(err));

Diese Funktion ruft eine API auf und gibt die Daten zurück. Das Wichtigste hier ist, Fehler elegant zu behandeln. Wenn Sie versuchen, eine nicht vorhandene URL aufzurufen, erhalten Sie einen Netzwerkfehler. Fangen Sie diese ab und protokollieren Sie sie, um zu verstehen, was schiefgeht.

Schritt 3: Richten Sie Ihren API-Schlüssel und Umgebungsvariablen ein

Normalerweise würden Sie Ihre API-Schlüssel nicht direkt im Code sichtbar machen. Daher sollten Sie Ihre Anmeldeinformationen über Umgebungsvariablen verwalten.


echo "API_KEY=your_api_key" > .env

Jetzt ändern Sie Ihre Funktion, um dotenv zu verwenden und den API-Schlüssel zu laden.


import dotenv from 'dotenv';
dotenv.config();

const fetchDataFromAPI = async (url) => {
 const apiKey = process.env.API_KEY;
 const response = await Tool.call(url, {headers: { 'Authorization': `Bearer ${apiKey}` }});
 return response.data;
};

Stellen Sie sicher, dass Sie dotenv installieren: npm install dotenv. Wenn Sie das vergessen, erhalten Sie Fehler mit undefiniertem API-Schlüssel und fragen sich, warum Ihre Anfragen fehlschlagen.

Schritt 4: Fügen Sie parallele Anfragen hinzu

Warum nicht die Aufrufe schneller gestalten? Indem Sie Daten parallel abrufen, können Sie wertvolle Sekunden sparen.


const fetchMultipleAPIs = async (urls) => {
 const promises = urls.map(url => fetchDataFromAPI(url));
 return Promise.all(promises);
};

fetchMultipleAPIs(['https://api.one.com', 'https://api.two.com'])
 .then(data => console.log(data))
 .catch(err => console.error(err));

Dieser Schritt beschleunigt alles. Stellen Sie sich vor, Ihre App ruft Daten von fünf Endpunkten anstelle von einem ab; das ist ein Kinderspiel. Vergessen Sie nicht, das Drosseln zu handhaben, und Sie werden die Grenzen der API überschreiten, was zu noch mehr Kopfschmerzen führt.

Schritt 5: Fehlerbehandlung und Protokollierung

Nun, eine App ohne Fehlerbehandlung ist wie ein Schiff ohne Kompass. Sie werden sicher verloren gehen. Lassen Sie uns einige zusätzliche Fehlererfassungsmechanismen hinzufügen.


const fetchDataFromAPI = async (url) => {
 try {
 const apiKey = process.env.API_KEY;
 const response = await Tool.call(url, { headers: { 'Authorization': `Bearer ${apiKey}` } });
 return response.data;
 } catch (error) {
 console.error(`Fehler beim Abrufen von ${url}: ${error.message}`);
 throw error; // Wichtig für die Fehlerbehandlung stromaufwärts.
 }
};

Das Hinzufügen von try/catch-Anweisungen sorgt nicht nur für saubere Protokolle, sondern ermöglicht auch besseres Debugging. Wenn etwas fehlschlägt, wissen Sie genau, wo es passiert ist. Vertrauen Sie mir; ich war schon derjenige, der nach einem stillen Fehler debuggen musste.

Die Fallen

Ratenbegrenzung: Die meisten APIs begrenzen, wie viele Anfragen Sie pro Minute stellen können. Zu viele parallele Anfragen können dazu führen, dass Sie auf die schwarze Liste gesetzt werden.
Datenkonsistenz: Das Aufrufen mehrerer APIs bedeutet, dass sich die Daten zwischen den Aufrufen ändern können. Haben Sie immer eine Strategie, um damit umzugehen.
Netzwerkprobleme: Schauen Sie, Netzwerkprobleme kommen vor. Setzen Sie Zeitlimits für Ihre Anfragen, um solche Szenarien elegant mit Wiederholungen zu behandeln.
Umgebungseinrichtung: Stellen Sie sicher, dass Ihre .env-Datei nicht in der Versionskontrolle ist. Ich habe das auf die harte Tour gelernt.

Vollständiges Codebeispiel


import dotenv from 'dotenv';
import { Tool } from 'langsmith';

dotenv.config();

const fetchDataFromAPI = async (url) => {
 try {
 const apiKey = process.env.API_KEY;
 const response = await Tool.call(url, { headers: { 'Authorization': `Bearer ${apiKey}` } });
 return response.data;
 } catch (error) {
 console.error(`Fehler beim Abrufen von ${url}: ${error.message}`);
 throw error;
 }
};

const fetchMultipleAPIs = async (urls) => {
 const promises = urls.map(url => fetchDataFromAPI(url));
 return Promise.all(promises);
};

fetchMultipleAPIs(['https://api.one.com', 'https://api.two.com'])
 .then(data => console.log(data))
 .catch(err => console.error(err));

Was kommt als Nächstes?

Erwägen Sie, Caching-Mechanismen hinzuzufügen, um wiederholte API-Aufrufe zu optimieren. Durch das Cachen von Antworten können Sie die Leistung erheblich steigern und Kosten senken.

Häufig gestellte Fragen

Kann ich LangSmith mit anderen Programmiersprachen verwenden?
Nein, LangSmith ist derzeit für JavaScript und TypeScript ausgelegt. Für Integrationen mit Python oder Ruby müssen Sie woanders suchen.
Wie kann ich API-Aufrufe überwachen?
Das Hinzufügen von Protokollierung wie gezeigt ermöglicht es Ihnen, die Erfolgs- und Fehlerrate zu überwachen. Für die Produktion sollten Sie in Erwägung ziehen, einen Protokolldienst zu integrieren.
Gibt es Kosten im Zusammenhang mit der Nutzung von LangSmith?
LangSmith hat ein gestaffeltes Preismodell, und Sie sollten deren Webseite für Details überprüfen.

Datenquellen

LangSmith GitHub
Tool Calling – Dokumente von LangChain

Letzte Aktualisierung am 25. März 2026. Daten stammen aus offiziellen Dokumenten und Gemeinschaftsbenchmarks.

So implementieren Sie Tool-Calls mit LangSmith (Schritt für Schritt)