Profile photo
Smirnoff

2 min read

Краткая справка: Подключение внешнего провайдера эмбеддингов (используется вместе с плагином Copilot) позволяет использовать более мощные или дешевые модели для семантического поиска по вашей базе заметок.

1. Подготовка

Перед настройкой убедитесь, что у вас есть:

  1. API Key от вашего провайдера (например, от polza.ai).
  2. Точный Base URL провайдера (без лишних хвостов вроде /embeddings).
  3. Название модели, которую провайдер поддерживает (например, text-embedding-3-small).

2. Пошаговая настройка в Obsidian

Шаг 1: Откройте настройки плагина

  1. Перейдите в Settings → Community Plugins → Copilot.
  2. В верхнем меню настроек выберите вкладку Model.

Шаг 2: Выбор провайдера Embedding-модели

  1. Прокрутите вниз до секции Embedding Model.
  2. В выпадающем списке выберите OpenAI Format (это универсальный драйвер для всех совместимых API).

Шаг 3: Заполнение параметров (Смотри скриншот [2])

Нажмите на кнопку настройки (шестеренку или поле ввода) и заполните данные:

ПараметрЗначениеВажное примечание
Model Nametext-embedding-3-smallДолжно точно совпадать с тем, что дает провайдер.
ProviderOpenAI FormatНе меняйте, если используете кастомный API.
Base URLhttps://api.polza.ai/api/v1КРИТИЧНО: Не добавляйте в конце /embeddings! Плагин сам подставит нужный путь.
API Keysk-.......Ваш ключ доступа.

Лайфхак: Если вы видите галочку CORS Bypass или Proxy Mode в расширенных настройках — попробуйте включить её, если возникают сетевые ошибки Network Error или CORS blocked.

Шаг 4: Активация семантического поиска (Смотри скриншот [1])

  1. Перейдите во вкладку QA (Questions & Answers).
  2. Найдите переключатель Enable Semantic Search.
  3. Переведите его в положение ВКЛ (ON).

3. Запуск индексации

После сохранения настроек база сама не обновится мгновенно.

  1. Нажмите Ctrl/Cmd + P (Command Palette).
  2. Введите: Copilot: Force Reindex Vault (или Refresh Vault Index).
  3. Нажмите Enter.

Следите за уведомлениями справа вверху. Если появится Index successfully updated — всё работает.

4. Решение частых проблем (Troubleshooting)

Ошибка: 404 Not Found или Cannot POST /.../embeddings/embeddings

Причина: Вы указали лишний путь в Base URL. Решение: Уберите /embeddings из конца строки URL. Оставьте только .../v1.

Ошибка: Connection error или CORS policy blocked

Причина: API провайдера не разрешает запросы напрямую из браузера (Obsidian). Решение:

  1. Попробуйте включить локальную модель (Local) вместо внешней.
  2. Или используйте локальный прокси (например, LM Studio / Ollama), который пробрасывает запросы.

Ошибка: Semantic index database not found

Причина: Индекс поврежден из-за прерванной загрузки или проблемы с доступом. Решение:

  1. Перезапустите Obsidian.
  2. Запустите команду Force Reindex Vault.

Graph View

Backlinks