에이전트 워크플로를 위한 UnifAPI 스트리밍 지원
UnifAPI은(는) 에이전트가 진행 상황 피드백을 필요로 하는 곳에서 스트리밍을 지원합니다: 실시간 도구 세션을 위한 Streamable HTTP MCP, 그리고 공개 ask 엔드포인트의 Server-Sent Events. 직접 REST API 호출은 예측 가능한 단일 응답 JSON 형식을 유지합니다.
MCP Streamable HTTP
에이전트가 진행 상황을 인식하는 도구 디스커버리와 도구 호출이 필요할 때 호스팅된 UnifAPI MCP 서버를 사용하세요. 커넥터 URL: https://mcp.unifapi.com.
MCP Streamable HTTP 열기NLWeb ask SSE
start, result, complete 이벤트를 내보내는 가벼운 디스커버리 답변에는 /ask의 Server-Sent Events를 사용하세요.
NLWeb ask SSE 열기/ask에서 디스커버리 답변 스트리밍
요청에 Accept: text/event-stream을 보내거나 prefer.streaming을 설정하면 점진적 이벤트를 받을 수 있습니다. 이 엔드포인트는 UnifAPI 디스커버리 답변용입니다. 에이전트가 실시간 공개 데이터 도구 호출이 필요할 때는 에이전트를 연결하세요 — 실시간 데이터용 프롬프트 하나 또는 웹 커넥터로.
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}}'에이전트가 기대해야 할 이벤트
스트림이 열렸음을 확인하고 UnifAPI NLWeb 스타일 메타데이터를 포함합니다.
제목, URL, 스니펫, 그리고 출처 메타데이터가 포함된 하나의 답변 결과를 전달합니다.
스트림의 끝을 표시하여 에이전트가 대기를 멈추고 요약할 수 있게 합니다.
직접 REST 동작
https://api.unifapi.com의 직접 REST API 작업은 현재 호출당 하나의 정규화된 JSON 형식을 반환합니다. 장시간 실행되는 REST 워크플로의 경우, 에이전트는 페이지네이션, 요청 ID, 재시도, 그리고 문서화된 오류를 사용해야 합니다. 작업이 에이전트가 유지하는 세션과 점진적 도구 작업에서 이점을 얻을 때는 MCP를 사용하세요.