# Инструмент Text Summarizer
## Описание
Инструмент `text_summarizer` — это gRPC-сервис на Python, который создает краткое, абстрактное резюме длинного текста. Он использует предварительно обученную модель T5 (Text-to-Text Transfer Transformer) для генерации резюме, которое отражает основные идеи исходного текста.
> **Примечание:** Этот инструмент загружает большую модель машинного обучения в память, что делает его ресурсоемким. Модель лениво загружается при первом вызове инструмента. Он считается модулем **R&D (Исследования и Разработка)** и по умолчанию отключен в основной конфигурации сервера для обеспечения стабильной и быстро запускающейся среды.
## Параметры
Инструмент принимает следующие аргументы в виде JSON-объекта:
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|--------------|----------|--------------|--------------|--------------------------------------------------------------|
| `text` | `string` | **Да** | | Текст для суммирования. |
| `max_length` | `number` | Нет | `150` | Максимальная длина (в токенах) сгенерированного резюме. |
| `min_length` | `number` | Нет | `20` | Минимальная длина (в токенах) сгенерированного резюме. |
## Ответ
* **Успешное суммирование:** Возвращает строку, содержащую сгенерированное резюме.
* **Ошибка:** Если параметр `text` отсутствует или возникает ошибка во время работы модели, инструмент возвращает сообщение об ошибке.
## Пример использования
Вот пример использования инструмента `text_summarizer` для суммирования абзаца.
**Запрос:**
```bash
curl -X POST http://localhost:8002/v1/tools:run \
-d '{
"name": "text_summarizer",
"arguments": {
"text": "Космический телескоп «Джеймс Уэбб» (JWST) — это космический телескоп, предназначенный в основном для проведения инфракрасной астрономии. Являясь крупнейшим оптическим телескопом в космосе, его высокое разрешение и чувствительность позволяют ему видеть объекты, слишком старые, далекие или тусклые для космического телескопа «Хаббл». Это позволило провести широкий спектр исследований во многих областях астрономии и космологии, таких как наблюдение первых звезд и формирование первых галактик.",
"max_length": 50
}
}'
```
**Успешный ответ:**
```json
{
"result": {
"stringValue": "Космический телескоп «Джеймс Уэбб» (JWST) — крупнейший оптический телескоп в космосе. Он предназначен для проведения инфракрасной астрономии и наблюдения за объектами, слишком старыми, далекими или тусклыми для телескопа «Хаббл»."
}
}
```
## Конфигурация
Конфигурация инструмента управляется через файл `config.json`.
**Пример `config.json`:**
```json
{
"port": 50075,
"command": ["python", "server.py"]
}
```
## Проверки состояния и логирование
* **Проверки состояния:** Реализует стандартный протокол gRPC Health Checking Protocol.
* **Логирование:** Использует стандартный модуль `logging` в Python.
