Guide

Input in Streaming

Comprensione delle due modalità di input per Claude Agent SDK e quando utilizzare ciascuna

Panoramica

Claude Agent SDK supporta due modalità di input distinte per interagire con gli agenti:

Modalità Input in Streaming (Predefinita e Consigliata) - Una sessione persistente e interattiva
Input Singolo Messaggio - Query una tantum che utilizzano lo stato della sessione e la ripresa

Questa guida spiega le differenze, i vantaggi e i casi d'uso per ogni modalità per aiutarti a scegliere l'approccio giusto per la tua applicazione.

Modalità Input in Streaming (Consigliata)

La modalità input in streaming è il modo preferito per utilizzare Claude Agent SDK. Fornisce accesso completo alle capacità dell'agente e consente esperienze ricche e interattive.

Consente all'agente di operare come un processo di lunga durata che accetta input dell'utente, gestisce interruzioni, visualizza richieste di autorizzazione e gestisce la gestione della sessione.

Come Funziona

Vantaggi

Caricamenti di Immagini

Allega immagini direttamente ai messaggi per l'analisi visiva e la comprensione

Messaggi in Coda

Invia più messaggi che vengono elaborati sequenzialmente, con la possibilità di interrompere

Integrazione Strumenti

Accesso completo a tutti gli strumenti e ai server MCP personalizzati durante la sessione

Supporto Hook

Utilizza hook del ciclo di vita per personalizzare il comportamento in vari punti

Feedback in Tempo Reale

Visualizza le risposte mentre vengono generate, non solo i risultati finali

Persistenza del Contesto

Mantieni il contesto della conversazione su più turni naturalmente

Esempio di Implementazione

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);
  }
}

Input Singolo Messaggio

L'input singolo messaggio è più semplice ma più limitato.

Quando Utilizzare Input Singolo Messaggio

Utilizza input singolo messaggio quando:

Hai bisogno di una risposta una tantum
Non hai bisogno di allegati di immagini, hook, ecc.
Hai bisogno di operare in un ambiente senza stato, come una funzione lambda

Limitazioni

La modalità input singolo messaggio non supporta:

Allegati di immagini diretti nei messaggi
Accodamento dinamico dei messaggi
Interruzione in tempo reale
Integrazione hook
Conversazioni multi-turno naturali

Esempio di Implementazione

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);
  }
}

Was this page helpful?

Guide

Input in Streaming

Comprensione delle due modalità di input per Claude Agent SDK e quando utilizzare ciascuna

Panoramica

Claude Agent SDK supporta due modalità di input distinte per interagire con gli agenti:

Modalità Input in Streaming (Predefinita e Consigliata) - Una sessione persistente e interattiva
Input Singolo Messaggio - Query una tantum che utilizzano lo stato della sessione e la ripresa

Questa guida spiega le differenze, i vantaggi e i casi d'uso per ogni modalità per aiutarti a scegliere l'approccio giusto per la tua applicazione.

Modalità Input in Streaming (Consigliata)

La modalità input in streaming è il modo preferito per utilizzare Claude Agent SDK. Fornisce accesso completo alle capacità dell'agente e consente esperienze ricche e interattive.

Consente all'agente di operare come un processo di lunga durata che accetta input dell'utente, gestisce interruzioni, visualizza richieste di autorizzazione e gestisce la gestione della sessione.

Come Funziona

Vantaggi

Caricamenti di Immagini

Allega immagini direttamente ai messaggi per l'analisi visiva e la comprensione

Messaggi in Coda

Invia più messaggi che vengono elaborati sequenzialmente, con la possibilità di interrompere

Integrazione Strumenti

Accesso completo a tutti gli strumenti e ai server MCP personalizzati durante la sessione

Supporto Hook

Utilizza hook del ciclo di vita per personalizzare il comportamento in vari punti

Feedback in Tempo Reale

Visualizza le risposte mentre vengono generate, non solo i risultati finali

Persistenza del Contesto

Mantieni il contesto della conversazione su più turni naturalmente

Esempio di Implementazione

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);
  }
}

Input Singolo Messaggio

L'input singolo messaggio è più semplice ma più limitato.

Quando Utilizzare Input Singolo Messaggio

Utilizza input singolo messaggio quando:

Hai bisogno di una risposta una tantum
Non hai bisogno di allegati di immagini, hook, ecc.
Hai bisogno di operare in un ambiente senza stato, come una funzione lambda

Limitazioni

La modalità input singolo messaggio non supporta:

Allegati di immagini diretti nei messaggi
Accodamento dinamico dei messaggi
Interruzione in tempo reale
Integrazione hook
Conversazioni multi-turno naturali

Esempio di Implementazione

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);
  }
}

Was this page helpful?