Leitfäden

Streaming-Eingabe

Verständnis der zwei Eingabemodi für Claude Agent SDK und wann man jeden verwendet

Übersicht

Das Claude Agent SDK unterstützt zwei unterschiedliche Eingabemodi für die Interaktion mit Agenten:

Streaming-Eingabemodus (Standard & Empfohlen) - Eine persistente, interaktive Sitzung
Einzelne Nachricht-Eingabe - One-Shot-Abfragen, die Sitzungszustand verwenden und fortgesetzt werden

Dieser Leitfaden erklärt die Unterschiede, Vorteile und Anwendungsfälle für jeden Modus, um Ihnen bei der Wahl des richtigen Ansatzes für Ihre Anwendung zu helfen.

Streaming-Eingabemodus (Empfohlen)

Der Streaming-Eingabemodus ist die bevorzugte Methode zur Verwendung des Claude Agent SDK. Er bietet vollständigen Zugriff auf die Fähigkeiten des Agenten und ermöglicht umfangreiche, interaktive Erfahrungen.

Er ermöglicht es dem Agenten, als langlebiger Prozess zu fungieren, der Benutzereingaben entgegennimmt, Unterbrechungen handhabt, Berechtigungsanfragen anzeigt und die Sitzungsverwaltung handhabt.

Funktionsweise

Vorteile

Bild-Uploads

Bilder direkt an Nachrichten anhängen für visuelle Analyse und Verständnis

Warteschlangen-Nachrichten

Mehrere Nachrichten senden, die sequenziell verarbeitet werden, mit der Möglichkeit zu unterbrechen

Tool-Integration

Vollständiger Zugriff auf alle Tools und benutzerdefinierten MCP-Server während der Sitzung

Hooks-Unterstützung

Verwenden Sie Lifecycle-Hooks, um das Verhalten an verschiedenen Punkten anzupassen

Echtzeit-Feedback

Sehen Sie Antworten, während sie generiert werden, nicht nur die endgültigen Ergebnisse

Kontext-Persistenz

Behalten Sie den Gesprächskontext über mehrere Umdrehungen natürlich bei

Implementierungsbeispiel

import { query } from "@anthropic-ai/claude-agent-sdk";
import { readFileSync } from "fs";

async function* generateMessages() {
  // First message
  yield {
    type: "user" as const,
    message: {
      role: "user" as const,
      content: "Analyze this codebase for security issues"
    }
  };
  
  // Wait for conditions or user input
  await new Promise(resolve => setTimeout(resolve, 2000));
  
  // Follow-up with image
  yield {
    type: "user" as const,
    message: {
      role: "user" as const,
      content: [
        {
          type: "text",
          text: "Review this architecture diagram"
        },
        {
          type: "image",
          source: {
            type: "base64",
            media_type: "image/png",
            data: readFileSync("diagram.png", "base64")
          }
        }
      ]
    }
  };
}

// Process streaming responses
for await (const message of query({
  prompt: generateMessages(),
  options: {
    maxTurns: 10,
    allowedTools: ["Read", "Grep"]
  }
})) {
  if (message.type === "result") {
    console.log(message.result);
  }
}

Einzelne Nachricht-Eingabe

Die Eingabe einer einzelnen Nachricht ist einfacher, aber begrenzter.

Wann man Einzelne Nachricht-Eingabe verwendet

Verwenden Sie die Eingabe einer einzelnen Nachricht, wenn:

Sie eine One-Shot-Antwort benötigen
Sie keine Bild-Anhänge, Hooks usw. benötigen
Sie in einer zustandslosen Umgebung arbeiten müssen, z. B. in einer Lambda-Funktion

Einschränkungen

Der Modus für Einzelne Nachricht-Eingabe unterstützt nicht:

Direkte Bild-Anhänge in Nachrichten
Dynamische Nachrichtenwarteschlangen
Echtzeit-Unterbrechung
Hook-Integration
Natürliche Multi-Turn-Gespräche

Implementierungsbeispiel

import { query } from "@anthropic-ai/claude-agent-sdk";

// Simple one-shot query
for await (const message of query({
  prompt: "Explain the authentication flow",
  options: {
    maxTurns: 1,
    allowedTools: ["Read", "Grep"]
  }
})) {
  if (message.type === "result") {
    console.log(message.result);
  }
}

// Continue conversation with session management
for await (const message of query({
  prompt: "Now explain the authorization process",
  options: {
    continue: true,
    maxTurns: 1
  }
})) {
  if (message.type === "result") {
    console.log(message.result);
  }
}

Leitfäden

Streaming-Eingabe

Verständnis der zwei Eingabemodi für Claude Agent SDK und wann man jeden verwendet

Übersicht

Das Claude Agent SDK unterstützt zwei unterschiedliche Eingabemodi für die Interaktion mit Agenten:

Streaming-Eingabemodus (Standard & Empfohlen) - Eine persistente, interaktive Sitzung
Einzelne Nachricht-Eingabe - One-Shot-Abfragen, die Sitzungszustand verwenden und fortgesetzt werden

Dieser Leitfaden erklärt die Unterschiede, Vorteile und Anwendungsfälle für jeden Modus, um Ihnen bei der Wahl des richtigen Ansatzes für Ihre Anwendung zu helfen.

Streaming-Eingabemodus (Empfohlen)

Er ermöglicht es dem Agenten, als langlebiger Prozess zu fungieren, der Benutzereingaben entgegennimmt, Unterbrechungen handhabt, Berechtigungsanfragen anzeigt und die Sitzungsverwaltung handhabt.

Funktionsweise

Vorteile

Bild-Uploads

Bilder direkt an Nachrichten anhängen für visuelle Analyse und Verständnis

Warteschlangen-Nachrichten

Mehrere Nachrichten senden, die sequenziell verarbeitet werden, mit der Möglichkeit zu unterbrechen

Tool-Integration

Vollständiger Zugriff auf alle Tools und benutzerdefinierten MCP-Server während der Sitzung

Hooks-Unterstützung

Verwenden Sie Lifecycle-Hooks, um das Verhalten an verschiedenen Punkten anzupassen

Echtzeit-Feedback

Sehen Sie Antworten, während sie generiert werden, nicht nur die endgültigen Ergebnisse

Kontext-Persistenz

Behalten Sie den Gesprächskontext über mehrere Umdrehungen natürlich bei

Implementierungsbeispiel

import { query } from "@anthropic-ai/claude-agent-sdk";
import { readFileSync } from "fs";

async function* generateMessages() {
  // First message
  yield {
    type: "user" as const,
    message: {
      role: "user" as const,
      content: "Analyze this codebase for security issues"
    }
  };
  
  // Wait for conditions or user input
  await new Promise(resolve => setTimeout(resolve, 2000));
  
  // Follow-up with image
  yield {
    type: "user" as const,
    message: {
      role: "user" as const,
      content: [
        {
          type: "text",
          text: "Review this architecture diagram"
        },
        {
          type: "image",
          source: {
            type: "base64",
            media_type: "image/png",
            data: readFileSync("diagram.png", "base64")
          }
        }
      ]
    }
  };
}

// Process streaming responses
for await (const message of query({
  prompt: generateMessages(),
  options: {
    maxTurns: 10,
    allowedTools: ["Read", "Grep"]
  }
})) {
  if (message.type === "result") {
    console.log(message.result);
  }
}

Einzelne Nachricht-Eingabe

Die Eingabe einer einzelnen Nachricht ist einfacher, aber begrenzter.

Wann man Einzelne Nachricht-Eingabe verwendet

Verwenden Sie die Eingabe einer einzelnen Nachricht, wenn:

Sie eine One-Shot-Antwort benötigen
Sie keine Bild-Anhänge, Hooks usw. benötigen
Sie in einer zustandslosen Umgebung arbeiten müssen, z. B. in einer Lambda-Funktion

Einschränkungen

Der Modus für Einzelne Nachricht-Eingabe unterstützt nicht:

Direkte Bild-Anhänge in Nachrichten
Dynamische Nachrichtenwarteschlangen
Echtzeit-Unterbrechung
Hook-Integration
Natürliche Multi-Turn-Gespräche

Implementierungsbeispiel

import { query } from "@anthropic-ai/claude-agent-sdk";

// Simple one-shot query
for await (const message of query({
  prompt: "Explain the authentication flow",
  options: {
    maxTurns: 1,
    allowedTools: ["Read", "Grep"]
  }
})) {
  if (message.type === "result") {
    console.log(message.result);
  }
}

// Continue conversation with session management
for await (const message of query({
  prompt: "Now explain the authorization process",
  options: {
    continue: true,
    maxTurns: 1
  }
})) {
  if (message.type === "result") {
    console.log(message.result);
  }
}