Основные понятия
Knowlume построен вокруг небольшого набора объектов. Если понять их, интерфейс и публичный API становятся намного проще.
Первый практический сценарий описан в Быстрый старт.
Фильтрация знаний
Knowlume построен вокруг фильтрации, а не только вокруг суммаризации.
Поиск полезен, когда вы уже знаете, что ищете. Краткое резюме полезно, когда нужен короткий обзор всего источника. Knowlume полезен, когда вы еще не знаете, какие части источника ценны, и хотите просмотреть материал по сигналам качества.
Главный вопрос:
Какие части этого источника стоит сохранить в базе знаний?
Ответ обычно не равен всему источнику. В длинном подкасте или лекции может быть всего несколько фрагментов, которые достаточно воспроизводимы, небанальны или богаты источниками.
Проект
Проект — граница рабочего пространства. Он группирует источники, фрагменты, выборки и экспорты.
Используйте проекты для:
- исследовательской темы;
- заказчика или клиента;
- продуктовой области;
- курса или учебного плана;
- временного расследования.
У каждого пользователя есть проект Inbox для несортированной работы.
Источник
Источник — исходный материал, отправленный в Knowlume.
Поддерживаемые типы источников:
- сайт или статья по URL;
- YouTube URL;
- вставленный текст;
- файловые входы, если включены.
Источники проходят жизненный цикл со статусами queued, processing, waiting, succeeded или failed. Публичный API использует тот же словарь статусов; см. Интеграции и автоматизация.
Обработка
Обработка — это работа, которую Knowlume выполняет после добавления источника или запроса экспорта.
Для источника обработка обычно означает:
- получить или принять содержимое;
- извлечь читаемый текст или транскрипт;
- разбить содержимое на чанки;
- оценить и назвать фрагменты;
- подготовить фрагменты для просмотра.
Для экспорта обработка превращает выбранный набор фрагментов в Markdown-артефакт.
Фрагмент
Фрагмент — дистиллированная единица знания. Он ближе к короткой переиспользуемой заметке, чем к обычному абзацу краткого резюме.
Хорошие фрагменты:
- достаточно короткие для быстрого просмотра;
- достаточно полные, чтобы сохранить контекст;
- связаны с источником;
- написаны как переиспользуемый Markdown;
- имеют оценки для фильтрации.
Фрагменты — главный результат продукта. Интерфейс построен вокруг просмотра, фильтрации, выбора и экспорта фрагментов. См. Фрагменты, оценки и экспорт.
Оценки
Knowlume оценивает фрагменты по трем осям от 0 до 10:
| Оценка | Смысл |
|---|---|
| Воспроизводимость | Можно ли проверить, повторить или операционализировать утверждение или метод? |
| Оригинальность | Насколько реальное следствие фрагмента не было легко предсказать из причины и контекста? |
| Источниковость | Есть ли во фрагменте явные упоминания книг, статей, инструментов, сервисов, сайтов, URL или других внешних источников? |
Фильтры публичного API используют включительные целочисленные диапазоны для этих оценок.
Высокая воспроизводимость и высокая оригинальность вместе обычно дают самый сильный сигнал для личной базы знаний: фрагмент и применим, и стоит сохранения.
Выборка
Выборка — набор фрагментов, которые пользователь хочет сохранить для экспорта.
Выбор намеренно остается за человеком. Knowlume может ранжировать и фильтровать кандидатов, но человек решает, что попадет в итоговую подборку знания.
При просмотре источника используйте оценки, чтобы быстро найти кандидатов, затем открывайте детали фрагмента перед сохранением чего-то важного.
Экспорт
Экспорт превращает выбранные фрагменты в Markdown.
Экспорты можно скачать как файлы. Их также можно отправлять через интеграционный вебхук, если пользователь настроил доставку через вебхук.
Артефакты экспорта отдаются с:
https://files.knowlu.me/knowlume-artifacts/...
Поверхности интеграции
У Knowlume три основные поверхности:
| Поверхность | Аудитория | База |
|---|---|---|
| Веб-приложение | Пользователи | https://app.knowlu.me |
| Публичный API | Автоматические интеграции | https://app.knowlu.me/api/public/v1 |
| MCP | Клиенты с агентами | https://app.knowlu.me/mcp/ |
Аутентификация, примеры и границы интеграции описаны в Интеграции и автоматизация.