docs: refresh translations, and translate pages in parallel (#3458)
This commit is contained in:
parent
08a3bc8eaf
commit
fd66270926
1 changed files with 4821 additions and 2277 deletions
|
|
@ -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'.` Современная ветка не изменилась.
|
||||
|
|
|
|||
Loading…
Reference in a new issue