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,41 @@ 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,8 +132,8 @@ SDK маршрутизує кожен запит за його заголовк
!!! check
Зробіть неправильно. `reserve` — той самий інструмент, що щойно обслужив обох клієнтів.
Розгорніть його зі `stateless_http=True`, під'єднайте тих самих двох клієнтів через HTTP
і викличте його з кожного.
Розгорніть його зі `stateless_http=True`, під'єднайте тих самих двох клієнтів і викличте
його з кожного.
Сучасний клієнт, як і раніше, отримує `Reserved 2 of 'Dune'.` Сучасна гілка не змінилася.