Depuração de SSE

Server-Sent Events (SSE) é uma tecnologia de comunicação em tempo real baseada no protocolo HTTP, que permite aos servidores enviar atualizações para os clientes através de uma ligação persistente e unidirecional. SSE é frequentemente utilizado para transmitir respostas de modelos de IA, notificações em direto e feeds de dados em tempo real.

Com SSE, os utilizadores podem ver instantaneamente o processo de pensamento dos modelos de raciocínio e o conteúdo gerado à medida que este é transmitido pelo servidor.

Pré-requisitos

Apidog versão 2.3.10 ou posterior

Um endpoint HTTP que devolva Content-Type: text/event-stream

Iniciar uma ligação SSE

Criar um novo endpoint

No Apidog, crie um novo projeto HTTP, adicione um novo endpoint e introduza o URL do endpoint do modelo de IA ou do servidor SSE.

Enviar o pedido

Ao enviar o pedido, se o cabeçalho da resposta Content-Type incluir text/event-stream, o Apidog analisa automaticamente os dados devolvidos como eventos SSE.

Ver respostas em tempo real

Veja as mensagens em tempo real na vista Timeline do painel de resposta, onde o conteúdo é apresentado em formato de linguagem natural.

Fusão automática de mensagens

Requisito de versão

É necessária a versão 2.7.14 ou posterior do Apidog para a funcionalidade de fusão automática.

O Apidog inclui suporte integrado para modelos de IA populares e reconhece e combina automaticamente respostas em streaming nos seguintes formatos:

Formato	Descrição
Compatível com a API OpenAI	Utilizado pela grande maioria dos fornecedores de modelos de IA
Compatível com a API Gemini	Formato do modelo Gemini da Google
Compatível com a API Claude	Formato do modelo Claude da Anthropic
Compatível com a API Ollama	Formato JSON Streaming (NDJSON) para modelos de IA implementados localmente

Quando a resposta do modelo de IA corresponde a qualquer um destes formatos, o Apidog combina automaticamente fragmentos de mensagens numa resposta completa, com pré-visualização do conteúdo em formato Markdown.

Suporte para modelos de raciocínio

Para determinados modelos, como DeepSeek R1, o Apidog apresenta o processo de pensamento do modelo na timeline, proporcionando uma visualização mais clara e intuitiva do raciocínio da IA.

Personalizar regras de fusão

Se a funcionalidade Fusão automática não funcionar corretamente, pode configurar regras de extração personalizadas com base no seu caso de utilização específico.

Configurar regras de extração JSONPath

Quando o SSE devolve conteúdo JSON que não está em conformidade com as regras de reconhecimento integradas (OpenAI, Gemini, Claude, etc.), configure manualmente o JSONPath para extrair o conteúdo necessário.

Exemplo de resposta 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"}]}

Configuração JSONPath:

Para extrair o campo content, utilize:

$.choices[0].message.content

Análise do JSONPath:

Componente	Descrição
`$`	Raiz do objeto JSON
`choices[0]`	Primeiro elemento do array `choices`
`message.content`	Atributo `content` no objeto `message`

Resultado extraído:

Hi

Utilizar scripts de pós-processamento

Para mensagens SSE não JSON, pode:

Utilizar scripts de pós-processamento para tratar os dados manualmente

Contactar o suporte técnico para fornecer feedback sobre o formato do modelo que está a utilizar, para possível suporte integrado

FAQ

O que fazer se a timeline SSE não apresentar mensagens?

Este problema ocorre normalmente quando a resposta do servidor não segue as diretrizes de formato SSE. O formato padrão de mensagem SSE requer:

O conteúdo da mensagem deve vir depois de data:

Cada mensagem deve ser separada por dois caracteres de nova linha (uma linha em branco entre mensagens)

Para obter mais detalhes sobre o formato de mensagem SSE, consulte a documentação da MDN - Utilizar Server-Sent Events.

Saiba mais

Como utilizar a API Deepseek (R1 e V3)?

Um guia completo para obter a chave da API DeepSeek e depurar a API.

Pré-requisitos#

Iniciar uma ligação SSE#

Fusão automática de mensagens#

Suporte para modelos de raciocínio#

Personalizar regras de fusão#

Configurar regras de extração JSONPath#

Utilizar scripts de pós-processamento#

FAQ#

Saiba mais#

Pré-requisitos

Iniciar uma ligação SSE

Fusão automática de mensagens

Suporte para modelos de raciocínio

Personalizar regras de fusão

Configurar regras de extração JSONPath

Utilizar scripts de pós-processamento

FAQ

Saiba mais