Heptabase: карточки, доски и ИИ для знаний — это визуальная среда для учёбы и исследований. Карточка хранит мысль, доска показывает структуру темы, AI Chat работает с вашим контекстом. Ниже — учебный маршрут из трёх карточек и двух связей.
Три элемента и логика интерфейса
Публичная вики проекта описывает три базовых элемента. Карточка хранит знания и идеи. Доска помогает понять структуру темы. AI Chat и Actions дают возможность работать с моделью на своём контексте. В той же документации основной ориентир дизайна — лучше понимать темы, которые вы выбрали. Оценивайте результат по тому, насколько яснее стала тема и какие связи между записями удалось обосновать.
Интерфейс устроен по логике браузера. Карточки, доски и теги вместе образуют «сеть знаний», а сама программа выступает браузером этой сети. Левая панель работает как вкладки и закладки, правая — как плагины, глобальный инструмент — как поиск. Такая аналогия объясняет, почему здесь нет привычного дерева папок: навигация идёт по связям и поиску.
Документация проекта отдельно оговаривает, что атомарная заметка допускает длинный текст. Условие одно: карточка содержит один концепт, а её содержимое этот концепт поддерживает. Формулировка концепта идёт одной фразой, и эта фраза становится заголовком карточки. Причина практичная — по заголовку вы вспоминаете суть без открытия карточки.
Для учебного маршрута этого достаточно. Дальше собираем доску и три карточки.
Создаём доску и три карточки
Создайте доску с названием «Pilot decision». На ней разместите три карточки с полным текстом.
Карточка K1 «Goal»: «The pilot tests whether onboarding instructions are understandable; success means 8 of 10 testers complete the task without help.»
Карточка K2 «Observed»: «In the first session, 6 of 10 testers completed the task without help.»
Карточка K3 «Unrelated plan»: «A separate marketing pilot targets 20 newsletter signups.»
Это учебный набор, составленный для разбора маршрута. Значения 8 из 10 и 6 из 10 заданы для вымышленного учебного примера. Они не получены измерением редакции или запуском продукта.
Смысл набора в том, что две карточки описывают один пилот, а третья относится к другому проекту. K3 существует здесь как проверка дисциплины: она выглядит похоже по формату и не должна попасть в контекст запроса. Если вы собираете карточки из своих материалов, держите тот же принцип — одна карточка, один концепт, заголовок одной фразой.
Порядок работы на доске:
- Откройте доску и убедитесь, что все три карточки видны.
- Проверьте заголовки: по ним вы будете выбирать карточки в контекст.
- Не объединяйте K3 с K1 и K2 визуально в один блок.
После этого переходите к связям.
Две связи с подписями
Проведите связь K1 → K2 и подпишите её «критерий и наблюдение». Проведите связь K1 → K3 и подпишите «другой проект, не объединять метрики».
Подпись здесь несёт основную работу. Стрелка сама по себе сообщает, что карточки связаны, и ничего не говорит о характере связи. Подпись фиксирует, что K2 — это наблюдение относительно критерия из K1, а K3 — отдельный проект со своей метрикой.
Документация проекта описывает этот этап как постепенное добавление связей между извлечёнными концептами. Там же указано, что близкие по смыслу карточки объединяют, а слишком крупные разбивают на части. Для нашего набора объединение не нужно: карточки уже атомарны.
Отдельно зафиксируйте вывод, который часто теряется. Связь на доске объединяет карточки в структуру чтения. Она не превращает две метрики в один набор данных. Число 8 из 10 задаёт критерий в K1, а 6 из 10 обозначает наблюдение в K2; сохраняйте их разный смысл и источник.
| Связь | Подпись | Что она утверждает |
|---|---|---|
| K1 → K2 | критерий и наблюдение | K2 — наблюдение по критерию из K1 |
| K1 → K3 | другой проект, не объединять метрики | K3 относится к иной задаче |
Таблица нужна как шпаргалка перед следующим шагом: в контекст запроса пойдут только K1 и K2.
Открываем Chat и проверяем AI Chat
Откройте Chat на доске. Перед первым запросом проверьте, что AI Chat доступен и отвечает. Простой способ — задать короткий вопрос по одной карточке и посмотреть, приходит ли ответ.
Документация проекта относит AI Chat и Actions к трём базовым элементам наравне с карточками и досками. Это значит, что работа с моделью встроена в тот же маршрут, что и работа с заметками, и не требует отдельного приложения.
На этом шаге важна настройка контекста. В интерфейсе есть режим чата со всем пространством, и он включён по умолчанию. Для учебного упражнения его отключите: тогда вы сами решаете, какие карточки увидит модель.
Проверка перед запросом:
- Убедитесь, что чат открыт именно на нужной доске.
- Посмотрите, какие карточки уже попали в контекст.
- Если в контексте оказалось лишнее, уберите это до отправки запроса.
Отключение режима работы со всем пространством не гарантирует очистку истории переписки. Состав контекста и историю разговора проверяют отдельно. Если ответ пришёл из предыдущего обсуждения, разговор начинают заново и заново проверяют контекст.
Добавляем только K1 и K2 и отправляем запрос
Отключите режим работы со всем пространством и добавьте в контекст через + или @ только карточки K1 и K2. K3 в контекст не добавляйте.
Проверьте состав контекста перед отправкой. В списке должны быть ровно две карточки: Goal и Observed. Это тот шаг, где чаще всего происходит незаметная ошибка: карточка добавляется «на всякий случай», а затем её содержимое попадает в ответ и меняет вывод.
Полный запрос:
Use only Goal and Observed. Was the success criterion met in the first session? Return criterion, observation, comparison and one limitation. Name the source card for each fact. Do not use the marketing pilot or invent follow-up sessions.
В запросе четыре требования к форме ответа: критерий, наблюдение, сравнение и одно ограничение. Плюс два запрета: не использовать маркетинговый пилот и не придумывать последующие сессии. Требование называть исходную карточку для каждого факта даёт вам возможность проверить ответ по источникам.
Запрос можно переписать под свою задачу, сохранив структуру: перечислите, какие карточки разрешены, что вернуть по пунктам, какие данные запрещены и как помечать источник факта. Эта структура переносится на любую тему.
Сверяем сравнение и ограничение
Ручной эталон для этого запроса выглядит так. Критерий: 8 из 10 из карточки K1. Наблюдение: 6 из 10 из карточки K2. Сравнение: 6 меньше 8, порог в этой сессии не достигнут. Ограничение: описана одна сессия, дальнейшие результаты неизвестны.
Сверьте ответ модели с этим эталоном по каждому пункту.
| Пункт ответа | Ожидаемое содержание | Источник |
|---|---|---|
| Критерий | 8 из 10 | K1 «Goal» |
| Наблюдение | 6 из 10 | K2 «Observed» |
| Сравнение | 6 < 8, порог не достигнут | вывод по K1 и K2 |
| Ограничение | описана одна сессия | K2 |
Типичные ошибки на этом шаге. Модель может назвать сравнение выполненным, если перепутает направление знака. Может добавить вывод о будущих сессиях, которых в карточках нет. Может сослаться на маркетинговый пилот, если K3 всё-таки попала в контекст. Может не указать источник для отдельного факта.
Каждую из этих ошибок видно при построчной сверке. Если ответ не проходит сверку, исправьте контекст и отправьте запрос заново. Правка самого ответа вручную допустима, но тогда вывод перестаёт быть ответом модели, и это стоит отметить.
Отрицательная проба на одном K1
Начните новый чат. Режим работы со всем пространством оставьте отключённым, в контекст добавьте только карточку K1. Запрос: «How many testers actually succeeded?»
Ожидаемый эталон: наблюдение в текущем контексте не представлено. Карточка K1 содержит критерий успеха, и в ней нет числа выполнивших задание. Правильный ответ сообщает, что данных для ответа нет.
Если модель отвечает «6 из 10», проверьте происхождение этого числа. Ответ мог прийти из предыдущего разговора. В таком случае пробу нельзя считать чистой: начните новый разговор и заново проверьте состав контекста. Отключение режима работы со всем пространством само по себе историю не стирает.
Эта проба проверяет выбранный контекст и ответ модели при нехватке данных. Любое неподтверждённое число отклоняйте, затем проверьте историю и состав источников. Причину ошибки устанавливайте отдельно: число в ответе само по себе не доказывает доступ к лишним карточкам.
Переносим проверенный вывод в новую карточку
Создайте новую карточку и перенесите в неё только тот вывод, который прошёл сверку. В нашем случае это сравнение 6 меньше 8 и ограничение про одну сессию.
Пометьте карточку как свой проверенный вывод. Формулировка заголовка одной фразой здесь работает так же, как и в остальных карточках: по заголовку вы вспомните суть без открытия. Например: В первой сессии порог 8 из 10 не достигнут, описан один замер.
Документация проекта описывает похожий приём: после сборки доски ссылки на концепт-карточки возвращают в исходную карточку источника, и каждая ссылка показывает заголовок. Так вы видите структуру темы, не открывая каждую карточку.
Что переносить не нужно: черновые ответы модели, не прошедшие сверку, и любые числа, источника которых вы не нашли. Карточка с непроверенным выводом со временем начинает выглядеть как факт.
Порядок переноса:
- Откройте проверенный ответ.
- Создайте новую карточку на доске.
- Вставьте только сверенные пункты.
- Добавьте пометку об авторстве вывода.
- Проведите связь от новой карточки к K1 и K2.
Частые вопросы
Чем карточка отличается от обычной заметки?
Карточка хранит один концепт, а её содержимое этот концепт поддерживает. Заголовок формулируется одной фразой, по которой вы вспоминаете суть. Документация проекта допускает длинный текст внутри карточки при выполнении этого условия.
Зачем нужны связи на доске, если есть теги?
Связь фиксирует характер отношения между двумя конкретными карточками, и подпись это отношение называет. Тег собирает карточки по общему признаку. Для вывода по метрикам важна именно подпись связи, потому что она удерживает критерий и наблюдение вместе.
Почему в контекст не попала третья карточка?
Третья карточка описывает другой проект с другой метрикой. Её попадание в контекст даёт модели повод смешать два набора данных. В учебном маршруте она остаётся на доске как проверка дисциплины отбора.
Что делать, если модель ответила числом, которого нет в контексте?
Проверьте историю разговора и состав контекста. Ответ мог прийти из предыдущего обсуждения. Начните новый чат, заново отключите режим работы со всем пространством и добавьте нужные карточки.
Можно ли править ответ модели вручную?
Да, но тогда вывод перестаёт быть ответом модели. Отметьте это в карточке, чтобы позже не принять свою правку за результат запроса. Проверенный вывод переносится с пометкой об авторстве.