Подключение моделей
Обновлено
Где настраивать
Откройте MCP → Модели под администратором MCP. Можно создать несколько подключений кнопкой «Новое подключение». В карточке существующего подключения меняются его параметры.
Основные поля
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Название | Имя подключения в интерфейсе | У нового подключения пусто |
| Адрес API | Базовый адрес API провайдера | Пусто; укажите адрес по документации провайдера, с /v1 или без него, как требует сервис |
| Ключ API | Авторизация запросов к провайдеру | Пусто; при редактировании оставьте пустым, чтобы сохранить существующий ключ |
| Разрешённые модели | Определяет модели, доступные для выбора в чате и агенте | У нового подключения ничего не выбрано; список загружается кнопкой «Загрузить список» |
| видит картинки / не видит | Уточняет способность выбранной модели принимать изображения | Исходное значение определяется каталогом моделей; переключается нажатием рядом с моделью |
| Вести журнал | Записывает ошибки ходов, обрывы связи и сведения о вызовах инструментов | Выключено; переключатель находится на странице «Модели» и действует на плагин в целом |
В чате можно выбрать другую разрешённую модель. Это не меняет модель по умолчанию в карточке агента. После удаления подключения использовавшие его агенты переходят на первое доступное; если подключений не осталось, отвечать нечем.
Рисование
В блоке «Рисование» задаётся отдельная модель. Она не выбирается собеседником.
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Модель | Включает генерацию изображений у этого подключения | «— не задана —»; можно выбрать предложенную модель или «Другая — вписать вручную…» |
| Формат запроса | Выбирает протокол генерации | «OpenAI — /images/generations» по умолчанию; также «MiniMax — /image_generation», «Alibaba (Qwen) — родной API DashScope» |
Сохраните подключение. Кнопка «Проверить рисование» создаёт одну картинку через провайдера и расходует его услуги. При пустой модели инструмент agent_generate_image не предлагается агенту.
Зрение
Если разговорная модель не видит картинки, отдельная модель зрения может описать их текстом. Описание сохраняется для повторного использования.
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Модель | Читает изображения за модели подключения без собственного зрения | «— не задана —»; выбор из списка или ручной ввод |
| Формат запроса | Выбирает протокол зрения | «Чат — /chat/completions» по умолчанию; также «MiniMax — /coding_plan/vlm» |
После сохранения нажмите «Проверить зрение». Проверка отправляет модели картинку с кодом; это платный запрос по условиям провайдера. Без настроенного зрения модель, которая не принимает картинки сама, не сможет увидеть их содержимое.
Какие данные уходят провайдеру
В API отправляются системные инструкции агента и проекта, передаваемая история разговора, описания доступных инструментов и результаты их вызовов. Прочитанные справочники, материалы проекта, содержимое текстовых вложений и открытых страниц могут попасть в эти запросы. Закреплённые справочники передаются целиком в каждом запросе, в котором используются.
Изображения передаются разговорной модели со зрением либо настроенной модели зрения. Для рисования отправляется описание изображения. Ключ используется для авторизации API-запросов. При загрузке списка моделей плагин обращается к API подключения.
Если агент вызывает инструмент внешнего MCP-плагина, тот может обращаться к своему сервису по собственным правилам. Вызов agent_fetch_url делает отдельный запрос с сервера сайта к выбранному адресу.
Журнал для диагностики
При сбое включите «Вести журнал», повторите действие и передайте поддержке файл:
wa-log/plugins/mcpagent/agent.logПереключатель предназначен для диагностики; после неё журнал можно выключить. Текст переписки специально в журнал не записывается.