Appearance
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 | Как берётся текст |
|---|---|---|
.json | json | Файл как есть |
.yaml, .yml | yaml | Файл как есть |
.toml, .ini, .conf, .cfg, .env, .properties | config | Файл как есть |
.md, .markdown | markdown | Файл как есть |
.sh, .bash, .zsh, .py, .go, .ts, .js, .sql, .css, .scss, .less, .xml | code | Файл как есть |
.pdf, .docx, .doc, .xlsx, .xls, .xlsm, .pptx, .ppt, .epub, .rtf, .odt, .ods, .odp | markdown, если extract вернул meta.format=markdown, иначе text | content-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 |