Transmitir eventos de sessão - Qoder CN Series: Central de Documentação do Alibaba Cloud

Assine um stream de eventos de sessão Forward com SSE.

Cabeçalhos de requisição

Cabeçalho	Obrigatório	Descrição
`Authorization`	Sim	`Bearer <PAT>`
`Accept`	Sim	`text/event-stream`
`Last-Event-ID`	Não	Retoma após este ID de evento.

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição
`session_id`	string	Sim	ID da sessão.

Parâmetros de consulta

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
`type`	string	Não	-	Filtra por tipo de evento. Aceita valores separados por vírgula.
`types[]`	string	Não	-	Filtro de tipo de evento no estilo array.
`include_tool_calls`	boolean	Não	`true`	Inclui eventos de chamada de ferramenta.
`include_thinking`	boolean	Não	`true`	Inclui eventos de raciocínio.

Exemplo de requisição

curl -N -X GET 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx/events/stream?include_thinking=false' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Accept: text/event-stream"

Exemplo de resposta

HTTP 200 OK

id: evt_xxx
event: agent.message
data: {"id":"evt_xxx","type":"agent.message","session_id":"sess_xxx","content":[{"type":"text","text":"Here is the analysis result."}],"processed_at":"2026-06-22T11:00:03Z"}

Exemplo de streaming incremental

Quando a sessão é criada com incremental_streaming_enabled=true, o stream pode incluir eventos incrementais antes do agent.message final.

id: evt_start_xxx
event: agent.message_start
data: {"id":"evt_start_xxx","type":"agent.message_start","session_id":"sess_xxx","message_id":"msg_xxx","created_at":"2026-06-22T11:00:01Z"}

id: evt_delta_xxx
event: agent.content_block_delta
data: {"id":"evt_delta_xxx","type":"agent.content_block_delta","session_id":"sess_xxx","message_id":"msg_xxx","index":0,"delta":{"type":"text_delta","text":"Here"},"created_at":"2026-06-22T11:00:01Z"}

Campos de resposta

Campo	Descrição
`id`	ID de evento SSE. Equivale ao ID do evento.
`event`	Tipo de evento.
`data`	JSON do Forward Event filtrado.

Erros

HTTP	Tipo	Código	Gatilho
400	`invalid_request_error`	`invalid_event_cursor`	`Last-Event-ID` não pertence a esta sessão.
401	`authentication_error`	`TOKEN_INVALID`	PAT inválido ou expirado.
404	`not_found_error`	`session_not_found`	A sessão não existe.

Observações

O streaming incremental é controlado pela requisição de criação de sessão e não pode ser ativado neste endpoint.
Tipos de eventos desconhecidos são encaminhados como eventos somente de envelope quando disponíveis.
include_thinking=false filtra eventos de raciocínio e deltas de raciocínio reconhecíveis.
include_tool_calls=false filtra eventos de uso de ferramenta e deltas de entrada/saída de ferramenta reconhecíveis.