Panduan

Input Streaming

Memahami dua mode input untuk Claude Agent SDK dan kapan menggunakan masing-masing

Gambaran Umum

Claude Agent SDK mendukung dua mode input yang berbeda untuk berinteraksi dengan agen:

Mode Input Streaming (Default & Direkomendasikan) - Sesi interaktif yang persisten
Input Pesan Tunggal - Kueri sekali jalan yang menggunakan status sesi dan melanjutkan

Panduan ini menjelaskan perbedaan, manfaat, dan kasus penggunaan untuk setiap mode untuk membantu Anda memilih pendekatan yang tepat untuk aplikasi Anda.

Mode Input Streaming (Direkomendasikan)

Mode input streaming adalah cara pilihan untuk menggunakan Claude Agent SDK. Ini memberikan akses penuh ke kemampuan agen dan memungkinkan pengalaman interaktif yang kaya.

Ini memungkinkan agen beroperasi sebagai proses yang berumur panjang yang menerima input pengguna, menangani gangguan, menampilkan permintaan izin, dan menangani manajemen sesi.

Cara Kerjanya

Manfaat

Unggahan Gambar

Lampirkan gambar langsung ke pesan untuk analisis visual dan pemahaman

Pesan Antrian

Kirim beberapa pesan yang diproses secara berurutan, dengan kemampuan untuk mengganggu

Integrasi Alat

Akses penuh ke semua alat dan server MCP kustom selama sesi

Dukungan Hooks

Gunakan lifecycle hooks untuk menyesuaikan perilaku di berbagai titik

Umpan Balik Real-time

Lihat respons saat dihasilkan, bukan hanya hasil akhir

Persistensi Konteks

Pertahankan konteks percakapan di beberapa giliran secara alami

Contoh Implementasi

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 Pesan Tunggal

Input pesan tunggal lebih sederhana tetapi lebih terbatas.

Kapan Menggunakan Input Pesan Tunggal

Gunakan input pesan tunggal ketika:

Anda membutuhkan respons sekali jalan
Anda tidak memerlukan lampiran gambar, hooks, dll.
Anda perlu beroperasi di lingkungan stateless, seperti fungsi lambda

Keterbatasan

Mode input pesan tunggal tidak mendukung:

Lampiran gambar langsung dalam pesan
Antrian pesan dinamis
Gangguan real-time
Integrasi hook
Percakapan multi-giliran alami

Contoh Implementasi

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?

Panduan

Input Streaming

Memahami dua mode input untuk Claude Agent SDK dan kapan menggunakan masing-masing

Gambaran Umum

Claude Agent SDK mendukung dua mode input yang berbeda untuk berinteraksi dengan agen:

Mode Input Streaming (Default & Direkomendasikan) - Sesi interaktif yang persisten
Input Pesan Tunggal - Kueri sekali jalan yang menggunakan status sesi dan melanjutkan

Panduan ini menjelaskan perbedaan, manfaat, dan kasus penggunaan untuk setiap mode untuk membantu Anda memilih pendekatan yang tepat untuk aplikasi Anda.

Mode Input Streaming (Direkomendasikan)

Mode input streaming adalah cara pilihan untuk menggunakan Claude Agent SDK. Ini memberikan akses penuh ke kemampuan agen dan memungkinkan pengalaman interaktif yang kaya.

Ini memungkinkan agen beroperasi sebagai proses yang berumur panjang yang menerima input pengguna, menangani gangguan, menampilkan permintaan izin, dan menangani manajemen sesi.

Cara Kerjanya

Manfaat

Unggahan Gambar

Lampirkan gambar langsung ke pesan untuk analisis visual dan pemahaman

Pesan Antrian

Kirim beberapa pesan yang diproses secara berurutan, dengan kemampuan untuk mengganggu

Integrasi Alat

Akses penuh ke semua alat dan server MCP kustom selama sesi

Dukungan Hooks

Gunakan lifecycle hooks untuk menyesuaikan perilaku di berbagai titik

Umpan Balik Real-time

Lihat respons saat dihasilkan, bukan hanya hasil akhir

Persistensi Konteks

Pertahankan konteks percakapan di beberapa giliran secara alami

Contoh Implementasi

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 Pesan Tunggal

Input pesan tunggal lebih sederhana tetapi lebih terbatas.

Kapan Menggunakan Input Pesan Tunggal

Gunakan input pesan tunggal ketika:

Anda membutuhkan respons sekali jalan
Anda tidak memerlukan lampiran gambar, hooks, dll.
Anda perlu beroperasi di lingkungan stateless, seperti fungsi lambda

Keterbatasan

Mode input pesan tunggal tidak mendukung:

Lampiran gambar langsung dalam pesan
Antrian pesan dinamis
Gangguan real-time
Integrasi hook
Percakapan multi-giliran alami

Contoh Implementasi

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?