Skip to content

Notebooks ​

Сервис notebooks предоставляет личные интерактивные тетради для сбора пользовательского контекста и проведения AI-чата на базе RAG (аналог Google NotebookLM).

Порты и БД ​

  • Порт PM2 / контейнера: 8111
  • Опубликованный Docker-порт: 18111
  • База данных: notebooks (PostgreSQL)

Основные возможности ​

  • Управление тетрадями: создание, чтение, обновление и удаление личных тетрадей.
  • Источники контекста (Sources):
    • Заметки (documents)
    • Задачи (task-tracker)
    • Таблицы данных (data-tables)
    • Внешние URL
    • Файлы: текстовые и бинарные. В RAG уходит content_type, чтобы чанкер не схлопывал структуру.
  • Интеграция с RAG: индексация в область notebook-{uuid} сервиса ai-router.

Загрузка файла (POST …/sources/upload):

Расширениеcontent_type в RAGКак берётся текст
.jsonjsonФайл как есть
.yaml, .ymlyamlФайл как есть
.toml, .ini, .conf, .cfg, .env, .propertiesconfigФайл как есть
.md, .markdownmarkdownФайл как есть
.sh, .bash, .zsh, .py, .go, .ts, .js, .sql, .css, .scss, .less, .xmlcodeФайл как есть
.pdf, .docx, .doc, .xlsx, .xls, .xlsm, .pptx, .ppt, .epub, .rtf, .odt, .ods, .odpmarkdown, если extract вернул meta.format=markdown, иначе textcontent-extract

Пустой результат или ошибка extract для бинарных форматов помечает источник как failed: сырые байты в RAG не попадают. Заметки, задачи, таблицы и URL индексируются как text.

HTTP API ​

МетодПутьОписание
GET/api/v1/notebooksСписок тетрадей пользователя
POST/api/v1/notebooksСоздание новой тетради
GET/api/v1/notebooks/:idИнформация о тетради с источниками
PATCH/api/v1/notebooks/:idРедактирование тетради
DELETE/api/v1/notebooks/:idУдаление тетради и её RAG-области
POST/api/v1/notebooks/:id/sources/from-platformДобавление заметки, задачи или таблицы
POST/api/v1/notebooks/:id/sources/from-urlИзвлечение содержимого веб-страницы
POST/api/v1/notebooks/:id/sources/uploadЗагрузка локального файла
POST/api/v1/notebooks/:id/sources/:sid/refreshОбновление снимка источника
DELETE/api/v1/notebooks/:id/sources/:sidУдаление источника из тетради и RAG