Streaming-Unterstützung

UnifAPI Streaming-Unterstützung für Agent-Workflows

UnifAPI unterstützt Streaming dort, wo Agents Fortschritts-Feedback benötigen: Streamable HTTP MCP für Live-Tool-Sitzungen und Server-Sent Events am öffentlichen Ask-Endpunkt. Direkte REST-API-Aufrufe behalten das vorhersehbare JSON-Antwortformat mit genau einer Antwort bei.

/ask öffnen

MCP Streamable HTTP

Verwenden Sie den gehosteten UnifAPI-MCP-Server, wenn ein Agent fortschrittsbewusste Tool-Discovery und Tool-Aufrufe benötigt. Connector-URL: https://mcp.unifapi.com.

MCP Streamable HTTP öffnen

NLWeb ask SSE

Verwenden Sie Server-Sent Events auf /ask für schlanke Discovery-Antworten, die start-, result- und complete-Events ausgeben.

NLWeb ask SSE öffnen

Direktes REST-JSON

Verwenden Sie direkte HTTP-API-Routen für Produktcode, der pro Abruf öffentlicher Daten ein normalisiertes JSON-Antwortformat erwartet.

Direktes REST-JSON öffnen

SSE-Schnellstart

Discovery-Antworten von /ask streamen

Senden Sie Accept: text/event-stream oder setzen Sie prefer.streaming, um schrittweise Events zu erhalten. Dieser Endpunkt ist für UnifAPI-Discovery-Antworten gedacht; verbinden Sie Ihren Agent — ein Prompt oder ein Web-Connector für Live-Daten —, wenn ein Agent Live-Tool-Aufrufe für öffentliche Daten benötigt.

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}}'

Event-Vertrag

Events, die Agents erwarten sollten

start

Bestätigt, dass der Stream geöffnet wurde, und enthält Metadaten im UnifAPI-NLWeb-Stil.

result

Überträgt ein Antwortergebnis mit Titel, URL, Snippet und Quellen-Metadaten.

complete

Markiert das Ende des Streams, damit ein Agent das Warten beenden und zusammenfassen kann.

Direktes REST-Verhalten

Direkte REST-API-Operationen unter https://api.unifapi.com geben derzeit pro Aufruf ein normalisiertes JSON-Antwortformat zurück. Für langlaufende REST-Workflows sollten Agents Pagination, Request-IDs, Retries und dokumentierte Fehler nutzen. Verwenden Sie MCP, wenn die Aufgabe von einer vom Agent gehaltenen Sitzung und schrittweiser Tool-Arbeit profitiert.