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,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'.` Сучасна гілка не змінилася.
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue