Шаг 2 из 5

Профиль подключения

Профиль хранит адрес AI-модели (любой OpenAI-совместимый endpoint) и список её моделей. Агент работает с OpenAI, Ollama, vLLM, LM Studio и шлюзами — через единый протокол /v1/chat/completions.

Где создавать

Профиль создаётся в справочнике «Профили подключений» (СИ_ПрофилиПодключений) — из формы «Настройки» обработки «Чат агента» или напрямую из списка справочников.

Параметры подключения

Поле	Как заполнить
Базовый URL	Адрес endpoint с версией API: `https://api.openai.com/v1`, для локальной Ollama — `http://localhost:11434/v1`
Ключ API	Ключ доступа; для локальных endpoint'ов без авторизации не нужен
Тип авторизации	Как передаётся ключ — см. таблицу ниже
Таймаут	Ожидание ответа модели
Прокси, проверка SSL	При необходимости — настройки прокси и отключение проверки SSL

Типы авторизации

Тип	Как передаётся ключ
Bearer	Заголовок `Authorization: Bearer <ключ>` — по умолчанию
Ключ в заголовке	Ключ в произвольном заголовке — имя задаётся в настройках
Ключ в URL	Ключ как query-параметр URL
Нет	Без авторизации — для локальных endpoint'ов (Ollama)

Модели

В табличную часть «Модели» внесите перечень моделей endpoint:

Имя — как модель называется у провайдера (для Ollama — как в выводе ollama list, например qwen2.5:14b);
Контекстное окно и максимум токенов ответа;
флажки «Использовать по умолчанию» и «Поддержка изображений» — вторая нужна для распознавания картинок и PDF (vision): добавьте мультимодальную модель (llava, qwen2-vl, gpt-4o и т.п.) и отметьте её.

// Пример профиля для локальной Ollama
Базовый URL:   http://localhost:11434/v1
Авторизация:   Нет
Модели:        qwen2.5:14b (по умолчанию)
               llava (Поддержка изображений)

Лимиты

MaxIterations — максимум итераций агентского цикла;
сжатие истории: процент окна под историю, сводка, число свежих сообщений;
лимиты длины сообщений и tool-результатов;
число повторов при транспортных ошибках;
РазрешитьРассуждения — для reasoning-моделей.

Распознавание PDF

Если планируете распознавать PDF, в профиле задаётся движок конвертации (pdftoppm, ghostscript или imagemagick), путь к утилите, максимум страниц и DPI. Подробности — в статье «Распознавание изображений и PDF».

Профилей может быть несколько. Типичный сценарий: облачная модель для чата и локальная Ollama для распознавания картинок — vision направляется на отдельный профиль.

Проверьте подключение действием «проверить подключение» в форме настроек — агент запросит список моделей у endpoint.