Compatibilidad con streaming

Compatibilidad con streaming en UnifAPI para flujos de trabajo de agentes

UnifAPI admite streaming allí donde los agentes necesitan feedback de progreso: MCP con Streamable HTTP para sesiones de herramientas en vivo y Server-Sent Events en el endpoint público de consultas. Las llamadas directas a la API REST mantienen la predecible envoltura JSON de una sola respuesta.

Abrir /ask

MCP Streamable HTTP

Usa el servidor MCP alojado de UnifAPI cuando un agente necesita descubrimiento de herramientas y llamadas de herramientas con seguimiento del progreso. URL del conector: https://mcp.unifapi.com.

Abrir MCP Streamable HTTP

NLWeb ask SSE

Usa Server-Sent Events en /ask para respuestas de descubrimiento ligeras que emiten eventos start, result y complete.

Abrir NLWeb ask SSE

REST JSON directo

Usa rutas directas de la API HTTP para código de producto que quiere una envoltura JSON normalizada por cada llamada de datos públicos.

Abrir REST JSON directo

Inicio rápido con SSE

Transmite respuestas de descubrimiento desde /ask

Envía Accept: text/event-stream o configura prefer.streaming para recibir eventos progresivos. Este endpoint es para respuestas de descubrimiento de UnifAPI; conecta tu agente — un prompt o un conector web para datos en vivo — cuando un agente necesita llamadas de herramientas de datos públicos en vivo.

curl -N https://unifapi.com/ask \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{"query":{"text":"Where is the UnifAPI OpenAPI spec?"},"prefer":{"streaming":true}}'

Contrato de eventos

Eventos que los agentes deben esperar

start

Confirma que el stream se ha abierto e incluye metadatos al estilo NLWeb de UnifAPI.

result

Transporta un resultado de respuesta con título, URL, snippet y metadatos de origen.

complete

Marca el final del stream para que un agente pueda dejar de esperar y elaborar un resumen.

Comportamiento de REST directo

Las operaciones directas de la API REST en https://api.unifapi.com devuelven actualmente una envoltura JSON normalizada por llamada. Para flujos de trabajo REST de larga duración, los agentes deben usar paginación, IDs de solicitud, reintentos y errores documentados. Usa MCP cuando la tarea se beneficie de una sesión mantenida por el agente y de trabajo progresivo con herramientas.