Claude Academy
Wird geladen

Eine Anfrage stellen

Lektion 310 Min.

Jetzt ist es Zeit, praktisch mit dem Anthropic Python SDK zu arbeiten und deine erste Anfrage an Claude über Vertex AI zu stellen. Wir gehen drei wesentliche Schritte durch: das SDK installieren, einen Client erstellen und deinen ersten API-Aufruf durchführen.

Installation des Anthropic Python SDK

Zuerst musst du das Anthropic SDK mit Vertex AI-Unterstützung installieren. Führe in deinem Jupyter-Notebook diesen Magic Command aus:

bash
%pip install "anthropic[vertex]<1"

Der Teil [vertex] stellt sicher, dass du die spezifischen Komponenten erhältst, die für die Verbindung zur Vertex AI-Plattform von Google Cloud benötigt werden.

Erstellen eines API-Clients

Importiere als Nächstes eine Client-Instanz, die speziell für Vertex AI entwickelt wurde, und erstelle sie:

python
from anthropic import AnthropicVertex

client = AnthropicVertex(region="global", project_id="your-project-id")
model = "claude-haiku-4-5@20251001"

Du musst "your-project-id" durch deine tatsächliche Google Cloud-Projekt-ID ersetzen, die du im Projektselektor der Google Cloud Console findest. Wenn du das Modell als Variable festlegst, erspart dir das, es im gesamten Notebook wiederholt einzutippen.

Die Create-Funktion verstehen

Der Kern des Stellens von Anfragen an Claude ist die create-Funktion, die drei wichtige Parameter benötigt:

Kommentierter client.messages.create-Aufruf mit „model", „max_tokens" auf 1000 gesetzt und „messages"-Parametern, wie unten beschrieben.

  • model - Der Name des Claude-Modells, das du verwenden möchtest
  • max_tokens - Ein Sicherheitslimit für die Antwortlänge (Claude wird nicht versuchen, dieses Ziel zu erreichen, es wird es nur nicht überschreiten)
  • messages - Der Gesprächsverlauf, den du an Claude sendest

Betrachte max_tokens eher als ein Budget denn als ein Ziel. Wenn du es auf 1000 setzt, schreibt Claude die Antwort, die es für angemessen hält, stoppt aber, wenn diese 1000 Tokens überschreiten würde.

Nachrichten verstehen

Nachrichten stellen das Hin und Her des Gesprächs zwischen dir und Claude dar, genau wie in einer Chat-Anwendung:

Chatfenster, in dem die Benutzernachricht fragt „Was ist Quantencomputing?" und die Assistentennachricht die KI-Antwort ist, die es definiert.

Es gibt zwei Arten von Nachrichten:

  • Benutzernachrichten - Von Menschen geschriebene Inhalte, die du in Claude einspeisen möchtest
  • Assistentennachrichten - Inhalte, die Claude generiert und an dich zurückgesendet hat

Deine erste Anfrage stellen

So strukturierst du eine grundlegende Anfrage:

python
message = client.messages.create(
    model=model,
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What is quantum computing? Answer in one sentence"
        }
    ]
)

Jede Nachricht ist ein Dictionary mit einer role (entweder „user" oder „assistant") und content (dem eigentlichen Text).

Die Antwort extrahieren

Wenn du die Anfrage ausführst, erhältst du ein komplexes Antwortobjekt mit vielen Metadaten zurück. Um nur den von Claude generierten Text zu erhalten, verwende:

python
message.content[0].text

Das liefert dir eine übersichtliche, lesbare Ausgabe anstelle des vollständigen Antwortobjekts mit all seinen technischen Details. Du wirst dieses Muster häufig verwenden, wenn du mit Claudes Antworten arbeitest.