Основные понятия

Knowlume построен вокруг небольшого набора объектов. Если понять их, интерфейс и API становятся намного проще.

Первый практический сценарий описан в Быстрый старт.

Фильтрация знаний

Knowlume построен вокруг фильтрации, а не только вокруг суммаризации.

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

Главный вопрос:

Какие части этого источника стоит сохранить в базе знаний?

Ответ обычно не равен всему источнику. В длинном подкасте или лекции может быть всего несколько фрагментов, которые достаточно воспроизводимы, небанальны или богаты источниками.

Проект

Project — граница рабочего пространства. Он группирует источники, фрагменты, выборки и экспорты.

Используйте проекты для:

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

У каждого пользователя есть проект Inbox для несортированной работы.

Источник

Source — исходный материал, отправленный в Knowlume.

Поддерживаемые типы источников:

  • сайт или статья по URL;
  • YouTube URL;
  • вставленный текст;
  • файловые входы, если включены.

Источники проходят жизненный цикл: queued, processing, waiting, succeeded или failed. Public API использует тот же внешний словарь статусов; см. Интеграции и API.

Обработка

Обработка — это работа, которую Knowlume выполняет после добавления источника или запроса экспорта.

Для источника обработка обычно означает:

  1. получить или принять содержимое;
  2. извлечь читаемый текст или транскрипт;
  3. разбить содержимое на чанки;
  4. оценить и назвать фрагменты;
  5. подготовить фрагменты для просмотра.

Для экспорта обработка превращает выбранный набор фрагментов в Markdown-артефакт.

Фрагмент

Fragment — дистиллированная единица знания. Он ближе к переиспользуемой заметке или micro-memory, чем к обычному абзацу summary.

Хорошие фрагменты:

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

Фрагменты — главный результат продукта. Интерфейс построен вокруг просмотра, фильтрации, выбора и экспорта фрагментов. См. Фрагменты, оценки и экспорт.

Оценки

Knowlume оценивает фрагменты по трем осям от 0 до 10:

Оценка Смысл
Reproducibility Можно ли проверить, повторить или операционализировать утверждение или метод?
Originality Насколько реальное следствие фрагмента не было легко предсказать из причины и контекста?
Sourcesness Есть ли во фрагменте явные упоминания книг, статей, инструментов, сервисов, сайтов, URL или других внешних источников?

Фильтры Public API используют включительные целочисленные диапазоны для этих оценок.

Высокая воспроизводимость и высокая оригинальность вместе обычно дают самый сильный сигнал для личной базы знаний: фрагмент и применим, и стоит сохранения.

Выборка

Selection — набор фрагментов, которые пользователь хочет сохранить для экспорта.

Выбор намеренно остается human-in-the-loop. Knowlume может ранжировать и фильтровать кандидатов, но человек решает, что попадет в итоговый knowledge pack.

При просмотре источника используйте оценки, чтобы быстро найти кандидатов, затем открывайте детали фрагмента перед сохранением чего-то важного.

Экспорт

Export превращает выбранные фрагменты в Markdown.

Экспорты можно скачать как файлы. Их также можно отправлять через Integration Webhook, если пользователь настроил webhook-доставку.

Артефакты экспорта отдаются с:

https://files.knowlu.me/knowlume-artifacts/...

Поверхности интеграции

У Knowlume три основные поверхности:

Поверхность Аудитория База
Web app Пользователи https://app.knowlu.me
Public API Автоматические интеграции https://app.knowlu.me/api/public/v1
MCP Agent-клиенты https://app.knowlu.me/mcp/

Аутентификация, примеры и границы интеграции описаны в Интеграции и API.