Claude Platform 101
← Alle Lektionen
Lektion 07Claude Platform 101

Server-Tools: von dir deklariert, von Anthropic ausgeführt

Zusammenfassung (Audio)

Gesprochene Zusammenfassung — drücke auf Play zum Mitlesen: die gesprochene Zeile bleibt oben.

Studiennotizen

Du kannst deine eigenen benutzerdefinierten Tools erstellen, aber einige Funktionen sind so verbreitet, dass Anthropic sie bereits vorgefertigt bereitstellt. Du schreibst den Code nicht. Du hostest die Sandbox nicht. Du deklarierst einfach das Tool, und Anthropic führt es aus.

Server-Tools: von dir deklariert, von Anthropic ausgeführt

Anthropic stellt Server-Tools bereit, die auf ihrer Infrastruktur laufen. Du führst diese nicht aus — Anthropic tut es. Das bedeutet, dass du keine Agent-Schleife für diese Aufrufe benötigst. Claude ruft die Tools von selbst auf, und das Ergebnis kommt in derselben Antwort zurück.

Die wichtigsten sind:

  • Web search — durchsucht das Internet und gibt Ergebnisse mit Zitaten zurück
  • Code execution — schreibt und führt Python in einer Sandbox aus
  • Web fetch — ruft vollständigen Inhalt von URLs ab

Zwei Server-Tools in einer Datei

Schauen wir uns einige der großen in einer Datei an: zwei messages. create Aufrufe, einer mit Web-Suche und einer mit Code-Ausführung.

import anthropic

client = anthropic. Anthropic()

search_response = client. messages. create( model="claude-opus-4-8", max_tokens=1024, tools=[{"type": "web_search_20260209", "name": "web_search"}], messages=[ {"role": "user", "content": "What is Anthropic's latest model release? Answer in one sentence. "} ], )

for block in search_response. content: if block. type == "server_tool_use": print(f"Tool call: {block. name} — {block. input}") elif block. type == "text": print(block. text)

code_response = client. messages. create( model="claude-opus-4-8", max_tokens=1024, tools=[{"type": "code_execution_20260120", "name": "code_execution"}], messages=[ {"role": "user", "content": "Calculate the mean and standard deviation of [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]"} ], )

for block in code_response. content: if block. type == "server_tool_use": print(f"Tool call: {block. name} — {block. input}") elif block. type == "bash_code_execution_tool_result": print(f"stdout: {block. content. stdout}") elif block. type == "text": print(block. text)

Zwei Dinge sind zu beachten:

  • **Es gibt hier keine Agent-Schleife. ** Wir schalten nicht auf stop_reason um. Wir schieben Tool-Ergebnisse nicht zurück. Anthropic führt das Tool serverseitig aus, und die Antwort enthält bereits das Ergebnis.
  • **Die Antwort hat neue Block-Typen. ** Ein server_tool_use Block für den Tool-Aufruf, ein Code-Ausführungs-Tool-Ergebnis-Block für die Ausgabe, plus die regulären text Blöcke.

Ausführung

Bei der Web-Suche siehst du Claudes Tool-Aufruf gedruckt, dann eine einsätzige Antwort über die neueste Modellversion mit den eingefügten Such-Zitaten.

Bei der Code-Ausführung siehst du den tatsächlichen Python-Code, den Claude geschrieben hat, die stdout aus der Sandbox, die ihn ausführt, und eine abschließende Text-Antwort.

Wir mussten keinen Such-Crawler starten. Wir haben keine Python-Sandbox ausgeführt. Wir haben zwei Tools deklariert und beide kostenlos erhalten.

Die andere Kategorie: Client-Tools

Es ist erwähnenswert, dass die andere Kategorie existiert. Client-Tools laufen dort, wo dein Code läuft. Sie werden im Claude SDK bereitgestellt, daher musst du das Schema nicht selbst definieren. Zwei Beispiele:

  • Memory — Claude liest und schreibt Memory über Sessions hinweg
  • Bash — eine persistente Bash-Shell, damit Claude Befehle ausführen kann

Die Anthropic-Dokumentationstabelle der integrierten Tools, mit Memory und Bash als Client-Tools neben Server-Tools wie Web Fetch und Code Execution

Sie haben die gleiche Form wie ein benutzerdefiniertes Tool, aber das SDK gibt dir das Schema und einen sinnvollen Runner.

Warum das in der Produktion wichtig ist

In einer Produktions-App ist dies der kürzeste Weg zu Funktionen, die sonst Wochen dauern würden. Web-Suche kann einen Fact-Check-Endpoint antreiben, der jeden numerischen und regulatorischen Anspruch in einem Entwurf gegen das Live-Web überprüft.

Eine Proposal-Review-App, die Web-Suche verwendet, um die regulatorischen und numerischen Ansprüche in einem Entwurfs-Proposal zu überprüfen

Eine Erinnerung: Nur weil etwas im Internet validiert ist, bedeutet das nicht, dass es wahr ist. Überprüfe Claudes Arbeit immer doppelt.

Zusammenfassung

  • Server-Tools — Web-Suche, Code-Ausführung, Web Fetch — werden in deinem tools Array deklariert. Anthropic führt sie aus.
  • Du erhältst das Ergebnis in derselben Antwort, ohne dass eine Agent-Schleife erforderlich ist. Suche nach server_tool_use und Tool-Ergebnis-Blöcken neben den regulären Text-Blöcken.
  • Client-Tools wie Memory und Bash laufen dort, wo dein Code läuft, aber das SDK stellt dir das Schema und einen Runner zur Verfügung.
  • Die Idee des "von Anthropic gehostet" skaliert bis ganz nach oben: verwaltete Agents wenden sie auf den gesamten Agent an, nicht nur auf ein Tool.
Lernkarten 10 Karten
Frage
zum Aufdecken klicken · ←/→
Antwort
zum Zurückdrehen klicken
Nach Anki exportieren (.tsv) ↓
Wissensüberprüfung 6 Fragen