Что такое Docmost

Docmost — open-source wiki и база знаний для команд: пространства (spaces), страницы в Markdown/rich text, совместное редактирование, права доступа. Есть Community-сборка и Enterprise-функции (SSO, API keys, AI Chat / Ask AI, audit). Продукт self-hosted: данные остаются у вас.

Сайт: docmost.com
Документация и установка: docmost.com/docs
Исходники: github.com/docmost/docmost

Adminica отдаёт OpenAI-compatible gateway: тот же RAG по библиотеке и вашим документам, что в веб-чате, но из интерфейса Docmost. Ниже — как связать оба продукта.

Что получите после подключения

Ask AI / Generative AI — ответ с опорой на архив Adminica (модель adminica-rag).
AI Chat — диалог с tool calling (модель adminica).
Ключ ak_… из профиля Adminica — без отдельного OpenAI-аккаунта.

AI Search в Docmost пока не подключайте: Adminica не отдаёт /v1/embeddings, а для поиска по эмбеддингам в Docmost нужен ещё pgvector в Postgres.

Предварительные условия

Работающий Docmost (self-hosted) с лицензией, где доступны AI settings (Enterprise / trial).
Аккаунт на adminica.ru и API-ключ: Профиль → Безопасность → API-ключи.
Доступ к docker-compose (или env) сервиса docmost-app.

Переменные окружения Docmost

В compose у приложения укажите драйвер OpenAI-compatible и base URL Adminica:

AI_DRIVER: openai-compatible
OPENAI_API_URL: https://adminica.ru/api/v1
OPENAI_API_KEY: ak_YOUR_KEY
AI_COMPLETION_MODEL: adminica-rag
AI_CHAT_MODEL: adminica

Переменная	Зачем
`OPENAI_API_URL`	База OpenAI SDK: `…/api/v1` (без хвоста `/chat/completions`)
`OPENAI_API_KEY`	Ключ `ak_…` из ЛК Adminica
`AI_COMPLETION_MODEL`	Ask AI → `adminica-rag`
`AI_CHAT_MODEL`	AI Chat (tools) → `adminica`

Пересоздайте контейнер приложения:

docker compose up -d --no-deps docmost-app

Включить AI в UI Docmost

Settings → AI settings.
Включите AI Chat и/или Generative AI (Ask AI).
Проверьте ответ на странице заметки: вопрос должен уходить на Adminica и возвращать текст с опорой на ваш контур (библиотека ∪ документы профиля ∪ org, если вы в организации).

Проверка gateway Adminica

Список моделей и пробный completion (с хоста, где виден API):

curl -sS https://adminica.ru/api/v1/models \
  -H "Authorization: Bearer ak_YOUR_KEY"

curl -sS https://adminica.ru/api/v1/chat/completions \
  -H "Authorization: Bearer ak_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "adminica-rag",
    "messages": [{"role": "user", "content": "Кратко: что такое RAG?"}]
  }'

В каталоге должны быть adminica и adminica-rag. Подробнее — документация API и статья про REST-коннектор.

Практики

Не коммитьте OPENAI_API_KEY в git — только secrets / CI variables.
Для staging укажите свой OPENAI_API_URL (тот же путь /api/v1).
AI Chat требует модель с tool calling — берите adminica, не подставляйте произвольные имена.
Ключ списывает токены владельца; для команды заведите отдельный ключ с понятным именем.

Когда Docmost, а когда чат Adminica

Сценарий	Docmost + Adminica	Веб-чат Adminica
Спросить прямо со страницы wiki	✓	—
Исследование, сценарии, файлы, графики	—	✓
IDE / агенты	—	MCP / REST

Итог: Docmost подключается к Adminica как любой OpenAI-compatible клиент: base URL /api/v1, ключ ak_…, модели adminica-rag и adminica. AI Search пока оставьте выключенным.