ガイド

ストリーミング入力

Claude Agent SDKの2つの入力モードを理解し、各モードをいつ使用するかを学ぶ

概要

Claude Agent SDKは、エージェントと対話するための2つの異なる入力モードをサポートしています：

ストリーミング入力モード（デフォルト＆推奨）- 永続的でインタラクティブなセッション
シングルメッセージ入力 - セッション状態を使用して再開する1回限りのクエリ

このガイドでは、各モードの違い、利点、ユースケースについて説明し、アプリケーションに適したアプローチを選択するのに役立てます。

ストリーミング入力モード（推奨）

ストリーミング入力モードは、Claude Agent SDKを使用する推奨される方法です。エージェントの機能に完全にアクセスでき、豊かでインタラクティブな体験を実現します。

これにより、エージェントは長期的なプロセスとして動作し、ユーザー入力を受け取り、割り込みを処理し、権限リクエストを表示し、セッション管理を処理できます。

仕組み

利点

画像アップロード

メッセージに画像を直接添付して、ビジュアル分析と理解を実現

キューに入れたメッセージ

複数のメッセージを順序立てて処理し、割り込む機能を備えて送信

ツール統合

セッション中のすべてのツールとカスタムMCPサーバーへの完全なアクセス

フック対応

ライフサイクルフックを使用して、様々なポイントで動作をカスタマイズ

リアルタイムフィードバック

最終結果だけでなく、生成されるレスポンスをリアルタイムで確認

コンテキスト永続性

複数のターンにわたって自然に会話コンテキストを維持

実装例

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

シングルメッセージ入力

シングルメッセージ入力はより単純ですが、より制限されています。

シングルメッセージ入力を使用する場合

シングルメッセージ入力を使用する場合：

1回限りのレスポンスが必要な場合
画像添付、フックなどが不要な場合
ラムダ関数などのステートレス環境で動作する必要がある場合

制限事項

シングルメッセージ入力モードは以下をサポートしていません：

メッセージ内の直接的な画像添付
動的なメッセージキューイング
リアルタイム割り込み
フック統合
自然なマルチターン会話

実装例

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?

ガイド

ストリーミング入力

Claude Agent SDKの2つの入力モードを理解し、各モードをいつ使用するかを学ぶ

概要

Claude Agent SDKは、エージェントと対話するための2つの異なる入力モードをサポートしています：

ストリーミング入力モード（デフォルト＆推奨）- 永続的でインタラクティブなセッション
シングルメッセージ入力 - セッション状態を使用して再開する1回限りのクエリ

このガイドでは、各モードの違い、利点、ユースケースについて説明し、アプリケーションに適したアプローチを選択するのに役立てます。

ストリーミング入力モード（推奨）

仕組み

利点

画像アップロード

メッセージに画像を直接添付して、ビジュアル分析と理解を実現

キューに入れたメッセージ

複数のメッセージを順序立てて処理し、割り込む機能を備えて送信

ツール統合

セッション中のすべてのツールとカスタムMCPサーバーへの完全なアクセス

フック対応

ライフサイクルフックを使用して、様々なポイントで動作をカスタマイズ

リアルタイムフィードバック

最終結果だけでなく、生成されるレスポンスをリアルタイムで確認

コンテキスト永続性

複数のターンにわたって自然に会話コンテキストを維持

実装例

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

シングルメッセージ入力

シングルメッセージ入力はより単純ですが、より制限されています。

シングルメッセージ入力を使用する場合

シングルメッセージ入力を使用する場合：

1回限りのレスポンスが必要な場合
画像添付、フックなどが不要な場合
ラムダ関数などのステートレス環境で動作する必要がある場合

制限事項

シングルメッセージ入力モードは以下をサポートしていません：

メッセージ内の直接的な画像添付
動的なメッセージキューイング
リアルタイム割り込み
フック統合
自然なマルチターン会話

実装例

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?