---
title: "SSE (Server-Sent Events)"
type: entity
tags: [web, real-time, http]
sources: [mcp在cursor中的集成与应用详解, expose-hermes-agent-as-an-openai-compatible-api-for-any-frontend]
last_updated: 2026-05-02
---

## Overview
SSE（Server-Sent Events，服务器推送事件）是一种基于 HTTP 的**服务器向客户端推送实时事件**的技术，允许服务器主动向浏览器或客户端应用发送数据更新。

## Key Characteristics
- **单向通信**：仅服务器向客户端推送，客户端不能反向通信
- **基于 HTTP**：使用标准 HTTP 协议，易于穿过防火墙
- **自动重连**：浏览器端 SSE API 自动处理连接断开重连
- **文本协议**：使用文本格式传输数据（通常为 JSON）

## Usage in Hermes Agent
`/v1/runs` API 通过 SSE 实现长会话实时进度订阅：
- **Token 流**：逐 token 推送响应内容
- **工具进度**：自定义事件推送工具执行状态
- **实时反馈**：用户可看到 Agent 思考和工具调用的全过程

## Comparison

| 特性 | SSE | WebSocket |
|------|-----|-----------|
| 通信方向 | 单向（服务端→客户端） | 双向 |
| 协议 | HTTP | 独立协议 |
| 复杂度 | 简单 | 较复杂 |
| HTTP/2 多路复用 | 支持 | 支持 |
| 防火墙穿透 | 易 | 需特殊配置 |

## Related Pages
- [[expose-hermes-agent-as-an-openai-compatible-api-for-any-frontend]]
- [[ToolStreaming]]
- [[ResponsesAPI]]