Depuración de SSE

Server-Sent Events (SSE) es una tecnología de comunicación en tiempo real basada en el protocolo HTTP, que permite a los servidores enviar actualizaciones a los clientes mediante una conexión persistente y unidireccional. SSE se utiliza habitualmente para transmitir respuestas de modelos de IA, notificaciones en vivo y fuentes de datos en tiempo real.

Con SSE, los usuarios pueden ver al instante el proceso de pensamiento de los modelos de razonamiento y el contenido generado a medida que se transmite desde el servidor.

Requisitos previos

Apidog versión 2.3.10 o posterior

Un endpoint HTTP que devuelva Content-Type: text/event-stream

Iniciar una conexión SSE

Crear un nuevo endpoint

En Apidog, cree un nuevo proyecto HTTP, añada un nuevo endpoint e introduzca la URL del endpoint del modelo de IA o del servidor SSE.

Enviar la petición

Al enviar la petición, si el encabezado de respuesta Content-Type incluye text/event-stream, Apidog analiza automáticamente los datos devueltos como eventos SSE.

Ver respuestas en tiempo real

Vea los mensajes en tiempo real en la vista Timeline del panel de respuesta, donde el contenido se muestra en formato de lenguaje natural.

Fusión automática de mensajes

Requisito de versión

Se requiere Apidog versión 2.7.14 o posterior para la funcionalidad de fusión automática.

Apidog incluye compatibilidad integrada con modelos de IA populares y reconoce y fusiona automáticamente respuestas en streaming en los siguientes formatos:

Formato	Descripción
Compatible con OpenAI API	Utilizado por la gran mayoría de proveedores de modelos de IA
Compatible con Gemini API	Formato del modelo Gemini de Google
Compatible con Claude API	Formato del modelo Claude de Anthropic
Compatible con Ollama API	Formato JSON Streaming (NDJSON) para modelos de IA implementados localmente

Cuando la respuesta del modelo de IA coincide con cualquiera de estos formatos, Apidog fusiona automáticamente los fragmentos de mensaje en una respuesta completa, con una vista previa del contenido en formato Markdown.

Compatibilidad con modelos de razonamiento

Para determinados modelos, como DeepSeek R1, Apidog muestra el proceso de pensamiento del modelo en la línea de tiempo, lo que proporciona una vista más clara e intuitiva del razonamiento de la IA.

Personalizar las reglas de fusión

Si la función Auto-Merge no funciona correctamente, puede configurar reglas de extracción personalizadas según su caso de uso específico.

Configurar reglas de extracción JSONPath

Cuando SSE devuelve contenido JSON que no se ajusta a las reglas de reconocimiento integradas (OpenAI, Gemini, Claude, etc.), configure manualmente JSONPath para extraer el contenido requerido.

Ejemplo de respuesta SSE:

data: {"choices":[{"index":0,"message":{"role":"assistant","content":"H"},"logprobs":null,"finish_reason":"stop"}]}

data: {"choices":[{"index":0,"message":{"role":"assistant","content":"i"},"logprobs":null,"finish_reason":"stop"}]}

Configuración de JSONPath:

Para extraer el campo content, use:

$.choices[0].message.content

Desglose de JSONPath:

Componente	Descripción
`$`	Raíz del objeto JSON
`choices[0]`	Primer elemento del arreglo `choices`
`message.content`	Atributo `content` bajo el objeto `message`

Resultado extraído:

Hi

Usar scripts de posprocesamiento

Para mensajes SSE que no sean JSON, puede:

Usar scripts de posprocesamiento para gestionar manualmente los datos

Contactar con soporte técnico para proporcionar comentarios sobre el formato del modelo que está utilizando, con el fin de considerar una posible compatibilidad integrada

Preguntas frecuentes

¿Qué hacer si la línea de tiempo de SSE no muestra mensajes?

Este problema suele producirse cuando la respuesta del servidor no sigue las directrices del formato SSE. El formato estándar de mensajes SSE requiere:

El contenido del mensaje debe venir después de data:

Cada mensaje debe estar separado por dos caracteres de nueva línea, es decir, una línea en blanco entre mensajes

Para obtener más detalles sobre el formato de mensajes SSE, consulte la documentación de MDN - Uso de Server-Sent Events.

Más información

¿Cómo usar la API de Deepseek (R1 y V3)?

Una guía completa para obtener la clave de API de DeepSeek y depurar la API.

Requisitos previos#

Iniciar una conexión SSE#

Fusión automática de mensajes#

Compatibilidad con modelos de razonamiento#

Personalizar las reglas de fusión#

Configurar reglas de extracción JSONPath#

Usar scripts de posprocesamiento#

Preguntas frecuentes#

Más información#

Requisitos previos

Iniciar una conexión SSE

Fusión automática de mensajes

Compatibilidad con modelos de razonamiento

Personalizar las reglas de fusión

Configurar reglas de extracción JSONPath

Usar scripts de posprocesamiento

Preguntas frecuentes

Más información