Guides

Entrée en continu

Comprendre les deux modes d'entrée du SDK Claude Agent et quand utiliser chacun

Aperçu

Le SDK Claude Agent prend en charge deux modes d'entrée distincts pour interagir avec les agents :

Mode d'entrée en continu (Par défaut et recommandé) - Une session persistante et interactive
Entrée de message unique - Des requêtes ponctuelles qui utilisent l'état de la session et la reprise

Ce guide explique les différences, les avantages et les cas d'utilisation de chaque mode pour vous aider à choisir la bonne approche pour votre application.

Mode d'entrée en continu (Recommandé)

Le mode d'entrée en continu est la façon préférée d'utiliser le SDK Claude Agent. Il fournit un accès complet aux capacités de l'agent et permet des expériences riches et interactives.

Il permet à l'agent de fonctionner comme un processus de longue durée qui accepte l'entrée de l'utilisateur, gère les interruptions, affiche les demandes de permission et gère la gestion de session.

Comment cela fonctionne

Avantages

Téléchargements d'images

Joignez des images directement aux messages pour l'analyse et la compréhension visuelles

Messages en file d'attente

Envoyez plusieurs messages qui se traitent séquentiellement, avec la possibilité d'interrompre

Intégration d'outils

Accès complet à tous les outils et serveurs MCP personnalisés pendant la session

Support des hooks

Utilisez les hooks de cycle de vie pour personnaliser le comportement à différents points

Retours en temps réel

Voyez les réponses au fur et à mesure qu'elles sont générées, pas seulement les résultats finaux

Persistance du contexte

Maintenez le contexte de la conversation sur plusieurs tours naturellement

Exemple d'implémentation

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

Entrée de message unique

L'entrée de message unique est plus simple mais plus limitée.

Quand utiliser l'entrée de message unique

Utilisez l'entrée de message unique quand :

Vous avez besoin d'une réponse ponctuelle
Vous n'avez pas besoin de pièces jointes d'images, de hooks, etc.
Vous devez fonctionner dans un environnement sans état, comme une fonction lambda

Limitations

Le mode d'entrée de message unique ne prend pas en charge :

Les pièces jointes d'images directes dans les messages
La mise en file d'attente dynamique des messages
L'interruption en temps réel
L'intégration des hooks
Les conversations naturelles multi-tours

Exemple d'implémentation

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

Guides

Entrée en continu

Comprendre les deux modes d'entrée du SDK Claude Agent et quand utiliser chacun

Aperçu

Le SDK Claude Agent prend en charge deux modes d'entrée distincts pour interagir avec les agents :

Mode d'entrée en continu (Par défaut et recommandé) - Une session persistante et interactive
Entrée de message unique - Des requêtes ponctuelles qui utilisent l'état de la session et la reprise

Ce guide explique les différences, les avantages et les cas d'utilisation de chaque mode pour vous aider à choisir la bonne approche pour votre application.

Mode d'entrée en continu (Recommandé)

Le mode d'entrée en continu est la façon préférée d'utiliser le SDK Claude Agent. Il fournit un accès complet aux capacités de l'agent et permet des expériences riches et interactives.

Comment cela fonctionne

Avantages

Téléchargements d'images

Joignez des images directement aux messages pour l'analyse et la compréhension visuelles

Messages en file d'attente

Envoyez plusieurs messages qui se traitent séquentiellement, avec la possibilité d'interrompre

Intégration d'outils

Accès complet à tous les outils et serveurs MCP personnalisés pendant la session

Support des hooks

Utilisez les hooks de cycle de vie pour personnaliser le comportement à différents points

Retours en temps réel

Voyez les réponses au fur et à mesure qu'elles sont générées, pas seulement les résultats finaux

Persistance du contexte

Maintenez le contexte de la conversation sur plusieurs tours naturellement

Exemple d'implémentation

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

Entrée de message unique

L'entrée de message unique est plus simple mais plus limitée.

Quand utiliser l'entrée de message unique

Utilisez l'entrée de message unique quand :

Vous avez besoin d'une réponse ponctuelle
Vous n'avez pas besoin de pièces jointes d'images, de hooks, etc.
Vous devez fonctionner dans un environnement sans état, comme une fonction lambda

Limitations

Le mode d'entrée de message unique ne prend pas en charge :

Les pièces jointes d'images directes dans les messages
La mise en file d'attente dynamique des messages
L'interruption en temps réel
L'intégration des hooks
Les conversations naturelles multi-tours

Exemple d'implémentation

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