Reputation.ru: поиск судебной практики
Интеграция с Reputation.ru помогает искать российские судебные дела, читать найденные судебные акты и заказывать глубокий анализ практики прямо из чата Искры.
Способ подключения
У навыка два способа подключения с одинаковыми возможностями. Выбор — на странице навыка: «Настройки» → «Способ подключения».
| Способ | Откуда берётся ключ | Кто оплачивает запросы Reputation.ru |
|---|---|---|
| Через Искру (по умолчанию) | Корпоративный ключ настраивает администратор платформы | Искра переводит стоимость внешнего запроса в МТ и списывает её с профиля |
| Свой ключ | Вы вводите свой API-ключ в поле «Ваш ключ Reputation.ru» | Стоимость списывает Reputation.ru с вашего аккаунта; Искра не добавляет стоимость провайдера в МТ |
Обычный расход МТ на сам диалог с Искрой действует при обоих способах. При «Своём ключе» не списывается только дополнительная стоимость запроса к Reputation.ru.
«Через Искру» работает, когда администратор включил навык и настроил корпоративный ключ. Если ключ Искры не задан, навык ответит об этом и предложит обратиться к администратору или выбрать «Свой ключ».
Чтобы платить своим ключом, выберите «Свой ключ» и задайте личный API-ключ в защищённой форме навыка. Не отправляйте ключ сообщением в чат. Если ключ ещё не задан, при первом запросе Искра откроет защищённую форму и остановит выполнение до настройки; внешний запрос в этот момент не отправляется. Если личный ключ отсутствует или перестал работать, Искра не переключится молча на корпоративный доступ. Если форма не появилась, откройте Навыки → Reputation.ru → Настройки → Способ подключения.
Владелец или администратор организации может выбрать «Свой ключ» для всей организации. Даже тогда каждый участник задаёт свой личный ключ: общего ключа организации у этого способа нет. Чтобы вернуться к корпоративному доступу, выберите в настройках «Через Искру». Режим «Выкл / По команде / Авто» способ не меняет. Подробнее — в разделе «Способ подключения».
Отдельного навыка «Reputation.ru — личный ключ» больше нет: тем, кто им пользовался, уже выбран «Свой ключ», а ключ нужно один раз ввести заново.
Восемь инструментов
Начните с вопроса обычными словами. Искра выберет действие; знать техническое имя инструмента для работы в чате не требуется.
| Задача | Что попросить и получить | Имя инструмента для справки |
|---|---|---|
| Найти арбитражную практику | «Найди дела о досрочном расторжении аренды» — список подходящих дел | search_arbitration_cases |
| Найти практику судов общей юрисдикции | Назовите предмет спора — список дел | search_general_court_cases |
| Найти позицию Верховного Суда | «Покажи решения о субсидиарной ответственности» — решения и обзоры | search_supreme_court_cases |
| Заказать глубокий анализ | Назовите вопрос исследования — после подтверждения получите номер запроса | deep_research_request |
| Проверить готовность анализа | Попросите проверить ранее полученный номер | deep_status |
| Забрать анализ | Получите готовый Markdown-отчёт и идентификаторы дел | deep_result |
| Прочитать арбитражный документ | Выберите документ из результатов этого же навыка | get_arbitration_document |
| Прочитать документ суда общей юрисдикции | Выберите документ из результатов этого же навыка | get_general_court_document |
Поиск возвращает не более 10 компактных результатов за один запрос. Пустой результат тоже считается выполненным запросом Reputation.ru и может быть платным. Для чтения документа используйте только идентификатор, который навык ранее показал вам в результате поиска: произвольный или чужой идентификатор будет отклонён до внешнего запроса.
Если после отправки любой платной операции её исход остался неизвестен, навык не повторяет внешний запрос автоматически: повтор мог бы привести к двойной оплате.
При способе «Через Искру» дополнительные МТ списываются только после
подтверждённого успеха Reputation.ru. Ответ провайдера с ошибкой и неопределённый сетевой исход
не тарифицируются в Искре. Если провайдер уже вернул результат, но списание МТ
не подтвердилось, навык сохраняет доступный результат или request_id, помечает
его как неоплаченный и запрещает автоматический повтор.
Глубокий анализ
Глубокий анализ запускается отдельно от обычного поиска и всегда требует подтверждения:
- при способе «Через Искру» показывается цена провайдера в рублях и рассчитанное списание в МТ; показанное значение — верхняя граница списания;
- при «Своём ключе» Искра предупреждает, что платный запрос будет выполнен с вашего аккаунта Reputation.ru, без обещания фиксированной цены.
После подтверждения Искра отправляет запрос один раз и возвращает
request_id. Если, пока вы смотрели на подтверждение, способ подключения
сменился, запрос не отправляется: Искра попросит повторить его, чтобы вы
подтвердили оплату нужным способом. Состояние можно проверять не чаще одного
раза в 10 секунд, а готовый результат получать через deep_result. Проверять
можно только анализ, который ранее запустили вы. Проверка и получение
результата идут тем же способом, которым анализ запущен, даже если вы позже
переключили способ.
Если связь оборвалась после отправки и Искра не может установить исход,
платный запрос не повторяется автоматически. Сначала проверьте состояние
по уже полученному request_id или расходы в аккаунте Reputation.ru; новый
запуск выполняйте только осознанно.
Стоимость при способе «Через Искру»
Перед внешним запросом Искра получает действующий тариф Reputation.ru, проверяет доступный лимит и рассчитывает списание по цене провайдера, коэффициенту платформы и цене МТ вашего тарифа. Если тариф нельзя надёжно проверить или исходная стоимость провайдера выше установленного администратором потолка, запрос не отправляется. Потолок проверяется до применения коэффициента платформы. Проверка статуса и получение результата глубокого анализа выполняются без дополнительной стоимости провайдера, пока действующий тариф Reputation.ru подтверждает нулевую цену этих операций.
При «Своём ключе» Искра не получает тариф вашего аккаунта и не начисляет МТ за запросы к провайдеру. Баланс, квоты и фактическую цену проверяйте в личном кабинете Reputation.ru.
Какие данные уходят во внешний сервис
Текст поискового запроса или запроса на анализ передаётся во внешний сервис Reputation.ru. Не включайте сведения, которые не нужны для поиска. API-ключ берётся из защищённого хранилища и в текст чата не добавляется.
Приватный режим «Антоним» покрывает LLM-запросы Искры, но не обращение навыка к Reputation.ru: текст запроса уходит во внешний сервис и под включённым Антонимом. Поиск при этом работает по реальным ФИО и ИНН — запрос ничем не подменяется.
Навык хранит только ограниченный список идентификаторов, нужных для последующих безопасных вызовов:
- до 100 незавершённых анализов; незавершённая запись истекает через 24 часа;
- до 100 завершённых и истёкших записей — не более 30 дней, с удалением давно не использовавшихся;
- последние 100 идентификаторов арбитражных документов и последние 100 идентификаторов документов судов общей юрисдикции.
Длинный текст документа или отчёта сокращается до 60 000 байт, не разрывая символы. Это ограничение ответа навыка, а не изменение документа у провайдера.
Официальная документация провайдера: