Решение проблем

Начните здесь, если что-то в веб-приложении работает не так, как ожидалось.

Источник не завершается

Для длинных видео, больших страниц или страниц с большим количеством ссылок подождите немного дольше.

Если источник все равно не завершается:

  • проверьте, открывается ли URL в приватном окне браузера;
  • убедитесь, что страница не требует входа;
  • попробуйте канонический URL статьи вместо поисковой выдачи или redirect URL;
  • для YouTube проверьте, есть ли у видео субтитры или транскрипт;
  • если сайт блокирует извлечение, добавьте материал как вставленный текст.

Фрагменты не появились

Сначала сбросьте фильтры. Строгие пороги могут скрыть все фрагменты.

Затем проверьте статус источника:

  • processing означает, что Knowlume еще работает;
  • waiting означает, что обработка поставлена на паузу и должна продолжиться позже;
  • failed означает, что источник не удалось обработать.

Если источник завершился ошибкой, попробуйте более простой или прямой URL.

Источник выглядит слабым

Это может быть корректным результатом, а не ошибкой.

Некоторые видео, подкасты и статьи состоят в основном из вступлений, мнений, историй или общих советов. В таком случае Knowlume может показать очень мало сильных фрагментов.

Попробуйте так:

  • откройте два-три самых сильных фрагмента;
  • ненадолго снизьте пороги, чтобы убедиться, что источник не переотфильтрован;
  • если полезного всё равно нет, пропустите источник вместо принудительного экспорта.

Фрагменты слишком общие

Не экспортируйте все подряд: уменьшите объем выборки.

Проверяйте так:

  • оставляйте фрагменты, которые конкретны, полезны или достаточно контекстны для проверки;
  • пропускайте фрагменты, которые просто пересказывают заголовок;
  • предпочитайте фрагменты с ясным контекстом и доказательством;
  • после первого прохода повышайте пороги originality или sourcesness.

Модель оценок описана в Фрагменты, оценки и экспорт.

Экспорт содержит не то, что ожидалось

Экспорт использует сохраненную выборку.

Перед экспортом:

  1. Выберите нужные фрагменты.
  2. Сохраните выборку.
  3. Проверьте количество выбранных фрагментов.
  4. Экспортируйте Markdown.

Если скачивается старый экспорт, используйте действие последнего экспорта после сохранения текущей выборки.

Доставка через вебхук не пришла

Сначала проверьте, что обычный файловый экспорт работает.

Затем проверьте:

  • webhook URL все еще активен;
  • принимающий сервис принимает входящие запросы;
  • destination не отклонил payload;
  • webhook был настроен до создания экспорта.

Если контент важен, оставьте скачивание файла как резервный вариант.

Запросы к программному интерфейсу не проходят

Сначала проверьте базовые вещи:

  • API-ключ активен;
  • запрос использует Authorization: Bearer ...;
  • при отправке источника передан idempotency key;
  • перед чтением фрагментов или экспортом источник имеет статус succeeded.

Поддерживаемый поток описан в Интеграции и API.

Слайды, формулы и специальные термины

Обработка YouTube сильно зависит от того, что есть в транскрипте. Если формула, диаграмма или слайд видны, но не проговариваются, они могут не попасть в извлеченный текст.

Для специализированного материала:

  • предпочитайте источники с читаемым текстом, captions или транскриптами;
  • добавляйте статьи или документы, если в них есть точная терминология;
  • проверяйте важные фрагменты вручную перед экспортом;
  • ожидайте, что имена, названия и технические термины иногда придется проверять.