Recibe respuestas mediante streaming

Cuándo utilizar streaming

El streaming mejora la percepción de velocidad en chats y asistentes porque entrega fragmentos de texto a medida que se generan. El endpoint es:

POST /v1/agents/{AGENT_ID}/responses/stream
Accept: text/event-stream

Acepta el mismo cuerpo que una respuesta normal, incluido conversation_id para mantener el contexto.

Procesa los eventos

El flujo puede producir:

• response.created: informa del identificador de conversación.
• response.output_text.delta: contiene un fragmento de texto.
• response.completed: entrega el texto completo y las citas públicas.
• error: finaliza el flujo con un código y un mensaje.

Con TypeScript:

import { collectStream } from "@inceptiva/sdk";

const events = client.responses.stream({
  message: "Resume esta oportunidad",
  conversationId,
  signal: controller.signal,
});

for await (const event of events) {
  if (event.type === "response.output_text.delta") {
    process.stdout.write(event.delta);
  }
}

Si solo necesitas el resultado final, collectStream(...) acumula los deltas y devuelve una respuesta normalizada.

Un stream ya iniciado no se reintenta automáticamente porque podría enviar el mismo mensaje dos veces. Si el flujo falla, decide desde tu aplicación si debes crear una nueva petición.