docs: refresh translations, and translate pages in parallel (#3458)

This commit is contained in:
Max 2026-09-07 13:35:53 +01:00 • committed by GitHub
commit fd66270926
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -1,6 +1,6 @@
---
translation:
sections: [3d1663c18edc824c, d4fd37009a13f03d, af9f398a5a8b679a, 470c2dd144294d69, 8e45827e6d24e8c8, 91dfd0ce98ebb03c]
sections: [3d1663c18edc824c, 90956965ae6a1ca1, af9f398a5a8b679a, 5ce83b1f9d88da62, 0d9b5d13fffc94e5, 8e45827e6d24e8c8, 91dfd0ce98ebb03c]
tool: 1
---
# Обслуживание клиентов старого поколения {#serving-legacy-clients}
@ -21,15 +21,25 @@ SDK маршрутизирует каждый запрос по его заго
## Один обработчик, оба поколения {#one-handler-both-eras}
Вот инструмент, которому нужно кое-что спросить у пользователя, и клиенты обоих поколений, которые его вызывают:
Вот инструмент, которому нужно кое-что спросить у пользователя:
```python title="server.py" hl_lines="24 37-38"
```python title="server.py" hl_lines="21"
--8<-- "docs_src/legacy_clients/tutorial001.py"
```
Инструменту `reserve` нужно одно, чего модель не сообщила: сколько экземпляров. `Annotated[..., Resolve(ask_quantity)]` — так инструмент это объявляет (подробнее — на странице **[Зависимости](../handlers/dependencies.md)**). Ничто в `reserve` не называет версию, не проверяет возможность и не ветвится.
Оба клиента открыты **одновременно**, на одном и том же объекте `mcp`. `mode="legacy"` выполняет рукопожатие `initialize` — ровно такое подключение открывает клиент до 2026 года. Второй клиент берёт значение по умолчанию и оказывается на `2026-07-28`.
Запустите его по HTTP — и вот клиенты обоих поколений, которые его вызывают:
```console
uv run mcp run server.py --transport streamable-http
```
```python title="client.py" hl_lines="14-15"
--8<-- "docs_src/legacy_clients/tutorial001_client.py"
```
Оба клиента открыты **одновременно**, к одному и тому же работающему серверу. `mode="legacy"` выполняет рукопожатие `initialize` — ровно такое подключение открывает клиент до 2026 года. Второй клиент берёт значение по умолчанию и оказывается на `2026-07-28`. Запустите `python client.py` во втором терминале:
```text
2025-11-25 {'result': "Reserved 2 of 'Dune'."}
@ -62,6 +72,40 @@ SDK маршрутизирует каждый запрос по его заго
отправка пропущенных SSE-событий клиенту, который переподключается к *той же* сессии), а не
хранилище сессий. Сессию доступной из другого процесса он не делает никогда.
## Время жизни и лимиты сессий {#session-lifetime-and-limits}
Сессия старого поколения не живёт вечно, и один процесс не держит их неограниченное количество.
За это отвечают две настройки. Обе — именованные аргументы `run()`, `streamable_http_app()`
и `Server.streamable_http_app()`. У современных подключений (`2026-07-28`) и при `stateless_http=True`
сессий нет, так что ни одна из настроек к ним не относится.
| Настройка | По умолчанию | Что делает | Что видит клиент | Как отключить |
|---|---|---|---|---|
| `session_idle_timeout` | `1800` (30 мин) | Закрывает сессию, в которой столько времени ничего не было в работе. | `404 Session not found`. Придётся заново выполнить `initialize`. | `None` |
| `max_sessions` | `10_000` | Отказывается открывать сессии сверх этого числа. Существующие сессии не трогает и ничего не вытесняет. | `503 Too many open sessions` с кодом JSON-RPC `-32603`. | `None` |
Что считается «в работе»:
* Открытый `GET`-поток. Клиенты SDK держат такой поток открытым, поэтому сессия подключённого
клиента никогда не истекает.
* Запрос, на который ещё готовится ответ. Вызов инструмента, работающий дольше тайм-аута,
не прерывается, а обратный отсчёт начинается только после его завершения.
* Больше ничего. Между запросами часы идут. Любой запрос в сессии запускает их заново,
включая `ping`. Истёкшую сессию уже ничто не оживит.
Клиент, завершающий сессию запросом `DELETE`, освобождает её сразу. То же происходит
с клиентом, чей открывающий запрос был отклонён.
```python
mcp.run(transport="streamable-http", session_idle_timeout=None, max_sessions=50_000)
```
Оба события попадают в лог сервера. Истечение — `Session <id> idle timeout` на уровне `INFO`.
Отказ в открытии — `Refusing to open a new session: <n> sessions are already open` на уровне `WARNING`.
Лимиты действуют на процесс. При четырёх рабочих процессах потолок — четыре раза по `max_sessions`,
и каждый рабочий процесс сам отсчитывает время жизни своих сессий.
## Единственный переключатель: `stateless_http` {#the-one-knob-stateless_http}
Если привязка — цена, которую вы платить не готовы, изменить можно ровно одно.
@ -87,7 +131,7 @@ SDK маршрутизирует каждый запрос по его заго
!!! check
Сделайте заведомо неправильно. `reserve` — тот самый инструмент, который только что обслужил
оба клиента. Разверните его с `stateless_http=True`, подключите те же два клиента по HTTP и
оба клиента. Разверните его с `stateless_http=True`, подключите те же два клиента и
вызовите его из каждого.
Современный клиент по-прежнему получает `Reserved 2 of 'Dune'.` Современная ветка не изменилась.