Руководства

Потоковый ввод

Понимание двух режимов ввода для Claude Agent SDK и когда использовать каждый

Обзор

Claude Agent SDK поддерживает два различных режима ввода для взаимодействия с агентами:

Режим потокового ввода (По умолчанию и рекомендуется) - постоянный интерактивный сеанс
Ввод одного сообщения - одноразовые запросы, которые используют состояние сеанса и возобновление

Это руководство объясняет различия, преимущества и варианты использования каждого режима, чтобы помочь вам выбрать правильный подход для вашего приложения.

Режим потокового ввода (рекомендуется)

Режим потокового ввода - это предпочтительный способ использования 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);
  }
}

Ввод одного сообщения

Ввод одного сообщения проще, но более ограничен.

Когда использовать ввод одного сообщения

Используйте ввод одного сообщения, когда:

Вам нужен одноразовый ответ
Вам не нужны вложения изображений, хуки и т. д.
Вам нужно работать в среде без состояния, такой как функция lambda

Ограничения

Режим ввода одного сообщения не поддерживает:

Прямые вложения изображений в сообщениях
Динамическое формирование очереди сообщений
Прерывание в реальном времени
Интеграцию хуков
Естественные многоходовые разговоры

Пример реализации

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

Руководства

Потоковый ввод

Понимание двух режимов ввода для Claude Agent SDK и когда использовать каждый

Обзор

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

Ввод одного сообщения

Ввод одного сообщения проще, но более ограничен.

Когда использовать ввод одного сообщения

Используйте ввод одного сообщения, когда:

Вам нужен одноразовый ответ
Вам не нужны вложения изображений, хуки и т. д.
Вам нужно работать в среде без состояния, такой как функция lambda

Ограничения

Режим ввода одного сообщения не поддерживает:

Прямые вложения изображений в сообщениях
Динамическое формирование очереди сообщений
Прерывание в реальном времени
Интеграцию хуков
Естественные многоходовые разговоры

Пример реализации

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