Sobes Docs

Заметки

База знаний, на которую Copilot опирается во время встречи

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

Какие заметки видит Copilot

Поиск идёт по всем заметкам, у которых включено «Использовать в RAG». У новых заметок оно включено.

Встрече можно ограничить поиск папками: кнопкой «Заметки для Copilot» (значок папки) при создании встречи или позже на её странице, а в веб-версии встречи — «Папки заметок» в меню «Функции ИИ». Тогда Copilot ищет только в выбранных папках, по-прежнему среди заметок с «Использовать в RAG». Без выбора поиск идёт по всем заметкам. Так удобно разводить материалы, которые не должны смешиваться, например несколько версий резюме с разными кейсами: разложите их по папкам и выберите для встречи нужную.

Во встрече поиск по заметкам выключается пунктом «Использовать заметки» в меню «Функции ИИ» (значок молнии). Для отдельного быстрого действия есть такой же флаг в его настройках.

Панель заметок в оверлее (Ctrl/Cmd + N) показывает все заметки, кроме тестовых проектов, в том числе исключённые из RAG. Это шпаргалка для вас, на то, что видит ассистент, она не влияет.

Как ищутся фрагменты

  • Запрос строится из текущего вопроса: вашего сообщения или последней реплики и одной-двух реплик перед ней. Текст со скриншотов в поиск не попадает. У быстрого действия запросом служит его собственный текст.
  • Поиск идёт и по смыслу, и по словам. Название заметки и заголовки разделов сильно влияют на то, найдётся ли фрагмент.
  • В ответ попадает не больше трёх фрагментов, причём не больше двух из одной заметки. Если поиск не успел, ответ придёт без заметок.
  • Фрагменты, которые получила модель, видны в «Источниках» под ответом. Модель могла ими и не воспользоваться.
  • Чтобы ассистент поискал в заметках что-то конкретное, попросите прямо: «найди в заметках…». Тогда он сделает отдельный поиск.

После правки заметка сразу находится по словам, а по смыслу через несколько секунд, когда закончится индексация. Удаление заметки или исключение из RAG действует сразу.

У заметок с RAG виден статус индексации. Пока заметка не в индексе, по смыслу её не найти. «Ждёт подписку» значит, что индексация продолжится, когда подписка снова станет активной. При «Не проиндексирована» текст не удалось обработать: сократите заметку или разбейте её на части и нажмите «Переиндексировать». Временные сбои сервиса индексации повторяются сами.

«Что найдёт Copilot» показывает, какие фрагменты попадут в подсказку на вопрос, который вы введёте. Так до встречи можно проверить, находится ли нужная заметка. Проверка идёт по всем заметкам с RAG, без учёта папок встречи.

Вопросы и ответы

Формат «Вопросы и ответы» выбирается при создании заметки и дальше не меняется. Такая заметка состоит из карточек «вопрос и ответ».

Во встрече карточка работает как обычный фрагмент: ассистент находит похожий вопрос и опирается на ответ, но не подставляет его дословно. Карточка всегда передаётся целиком. Чтобы её находили по-разному заданным вопросам, заполните «Другие формулировки», кнопка «Сгенерировать» предложит варианты.

Импорт списка

Готовый список вставляется через «Импорт Markdown» в редакторе сборника:

## Что такое индекс?
Ответ в Markdown.

## Что такое транзакция?
Ответ в Markdown.

Каждая строка с ## начинает новую карточку, всё до следующей такой строки становится ответом, включая списки, код и подзаголовки ###. Подойдёт и формат со строками Вопрос: … и Ответ: …. Импортированные карточки добавляются к уже существующим, сохраняются кнопкой «Сохранить». Другие формулировки при импорте не распознаются.

Загрузка файлов

  • Загрузить файлы принимает .md, .mdx, .txt и .pdf. Каждый файл становится отдельной заметкой.
  • Загрузить файл внутри заметки заменяет её текст содержимым файла, а не дописывает его.
  • Скан PDF без текстового слоя распознаётся нейросетью. Если в PDF часть страниц текстом, а часть сканами, сканированные страницы не распознаются.

Не загружайте в заметки пароли, ключи API и код, который нельзя показывать третьим лицам.

Тестовый проект

Через «Загрузить тестовый проект» можно загрузить код пет-проекта, чтобы Copilot отвечал на вопросы о нём. Весь проект хранится одной заметкой: вручную её не отредактировать, обновляется она кнопкой «Перезалить». Из одной заметки в ответ попадает не больше двух фрагментов, поэтому спрашивайте о проекте конкретно, называя модуль, файл или функцию. Файлы .env, node_modules, сборки и .git пропускаются автоматически. Если проект не помещается в лимит, отмечается главное: README и манифесты, точки входа и роуты, а тесты и сгенерированные файлы идут последними.

Файлы, в которых нашлось что-то похожее на ключи и пароли, при загрузке не отмечены. Если всё же загрузить такой файл, эти значения заменятся на [REDACTED]: ни в заметку, ни в ответы Copilot они не попадут.

Выгрузка

Все заметки и контексты можно скачать одним zip-архивом из библиотеки заметок: заметки лежат в нём Markdown-файлами по папкам, контексты — в JSON.

Советы

  • Одна тема на заметку. Из одной заметки в ответ попадает не больше двух фрагментов.
  • Давайте понятные названия заметкам и заголовкам: по ним ищутся фрагменты.
  • Разбивайте длинный текст заголовками, фрагменты режутся по разделам.
  • Перед встречей добавьте специфику компании и исключите из RAG то, что не относится к этой позиции.

Содержание