cuOpt: серверный API (Python)

Что делает навык

Навык описывает развертывание REST-сервера cuOpt и взаимодействие с ним через HTTP-запросы. Он позволяет запускать сервер локально или в Docker, отправлять задачи на решение и опрашивать статус выполнения.

Когда применять

• Развертывание сервера cuOpt для обработки оптимизационных задач.
• Написание клиента на Python или curl для отправки запросов к REST API.
• Отладка ошибок валидации запроса (например, неверные имена полей или структура данных).
• Преобразование данных из формата Python API в формат REST (например, order_locations в task_locations).

Как работает

1. Запустить сервер локально через python -m cuopt_server.cuopt_service или в Docker с поддержкой GPU.
2. Отправить POST-запрос на эндпоинт /cuopt/request с JSON-телом задачи для получения reqId.
3. Опрашивать эндпоинт /cuopt/solution/{reqId} до готовности решения, соблюдая таймауты.
4. Проверить здоровье сервера через GET /cuopt/health и убедиться в доступности порта.
5. Валидировать reqId и использовать правильные имена полей (например, travel_time_matrix_data вместо transit_time_matrix_data).

Примеры запросов агенту

Что понадобится

• NVIDIA GPU с рабочим CUDA драйвером и установленным NVIDIA Container Toolkit (для Docker).
• Установленный пакет cuopt-server или образ nvidia/cuopt.
• Библиотека Python requests для работы с клиентами.

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.