aiq-research

AIQ Research — официальный навык NVIDIA для глубокого исследования через доступный backend NVIDIA AI-Q Blueprint. Он рассчитан на запросы исследовательского типа: deep research, AI-Q research и вопросы, которые нужно передать AI-Q для подготовки отчёта. Навык использует вспомогательный скрипт `scripts/aiq.py` и обращается к уже запущенному локальному или self-hosted серверу; сам навык не устанавливает, не разворачивает, не запускает и не останавливает Blueprint. До отправки исследования требуется проверить health endpoint. По умолчанию используется `http://localhost:8000`, а другой адрес задаётся через `AIQ_SERVER_URL`. Для удалённого или иного нелокального backend адрес должен быть явно доверен пользователем до отправки запроса, поскольку текст вопроса передаётся на этот endpoint. В окружении необходим Python 3.11 или новее, сетевой доступ к backend и настроенные на стороне backend credentials. Публичный helper не собирает и не управляет API-ключами: секреты должны оставаться в окружении развёртывания AI-Q, а не в skill и не в тексте запроса. После успешного health нужно выбрать chat или research flow. `chat` может вернуть обычный JSON сразу либо структуру с `status=deep_research_running` и `job_id`. Если возвращён идентификатор задания, исследование продолжается асинхронно на сервере, поэтому его нужно опрашивать через `research_poll`; автоматический повтор после failed job не предусмотрен. Для восстановления после прерывания доступны `status`, `report` и повторное `research_poll`, а если отчёт уже готов, его можно получить напрямую. Результат следует показывать с сохранёнными цитатами и URL источников. Отчёты могут ссылаться на артефакты с URI `artifact://`; их можно материализовать в локальную папку через `artifacts`, либо экспортировать самодостаточный `report.md` с локальными ссылками через `report --out-dir`. Навык поддерживает продолжение работы: вопрос, который уже покрыт готовым отчётом, следует отвечать без нового обращения к backend; для новой проверки отправляется новый запрос с контекстом предыдущей темы. Редактирование отчёта допускается только как косметическое преобразование доступных исходных данных через `report_edit`, а redo создаёт новое исследовательское задание с уточнённым scope и выбранным типом агента. При проблемах совместимости сначала можно посмотреть доступные async agents. Skill версии 2.1.0 рассчитан на AI-Q Blueprint с совпадающей major-версией и minor-версией не ниже 2.1; версия 3.x несовместима по заявленному правилу. Если backend не отвечает, нужно запросить доверенный адрес или передать задачу AIQ Deploy, а не выдумывать результат. При HTTP 401/403 публичный helper останавливается, потому что не управляет аутентификацией. Если health проходит, но chat, async route или polling недоступны, это нужно сообщить как проблему конфигурации или совместимости. Ограничения особенно важны для конфиденциальных запросов: remote endpoint может журналировать prompts, responses и metadata, поэтому перед отправкой надо подтвердить границу доверия. Карточка предназначена для запуска и сопровождения AI-Q research jobs, сохранения их источников и артефактов; она не является инструкцией по деплою Blueprint, настройке auth или замене официального backend.