Как настроить подключение к Гигачат в AppsMax

После того как вы получили данные у Sber, следующий шаг — правильно настроить вкладку «Подключение» в AppsMax. Эта вкладка отвечает не за стиль ответов и не за базу знаний, а за сам факт связи между AppsMax и Гигачат. Если здесь ошибка, остальные вкладки уже не дадут нормального результата. Ниже разобрана вся вкладка целиком, без сокращений и без предположения, что “это и так понятно”.

Что нужно подготовить заранее

• Выбранный бот в шапке AppsMax.
• Подготовленный ключ авторизации Гигачат.
• Понимание, какой у вас scope.

Если в шапке не выбран бот, часть действий на этой вкладке будет бессмысленной: система не поймёт, к какому рабочему контуру вы хотите привязать Гигачат.

Что вы получите в итоге

После правильной настройки AppsMax сможет:

• проверить авторизацию в Гигачат;
• показывать статус подключения;
• использовать Гигачат во вкладках Функции, База знаний и Тест.

Как устроена вкладка «Подключение»

Экран состоит из двух смысловых частей:

1. Левая часть — это поля ввода и кнопки управления.
2. Правая часть — это блок статуса, где видно, что происходит с подключением сейчас.

Ниже на этой же вкладке расположен большой блок общих параметров ответов и лимитов. Он не отвечает за саму авторизацию, но задаёт общие правила работы Гигачат для выбранного бота.

Поле «Организация»

Это не редактируемое поле, а информационный блок. Оно показывает, для какой организации сейчас настраивается подключение. Значение подтягивается по выбранному в шапке боту. Зачем это важно: если в системе несколько организаций, вы сразу видите, что не редактируете чужое или соседнее подключение.

Поле «Название подключения»

Это внутреннее имя, удобное для вас и команды. Оно помогает быстро понять, что именно подключено. Примеры хороших названий:

• Гигачат для консультаций;
• Гигачат для AppsMax;
• Основное подключение Гигачат.

Плохой вариант — случайный текст без смысла, например test1 или новое подключение. Через пару недель никто уже не поймёт, зачем оно было создано.

Поле «Режим доступа»

Это поле связано со значением scope из Гигачат API. Обычно здесь используется один из вариантов:

• Гигачат_API_PERS — если доступ оформлен как у физлица;
• Гигачат_API_B2B — для части корпоративных сценариев;
• Гигачат_API_CORP — для другого корпоративного режима.

Если вы не уверены, не меняйте значение “на глаз”. Самая частая безопасная ситуация — оставить то значение, которое у вас указано по умолчанию и которое соответствует вашему проекту Гигачат.

Поле «Ключ авторизации»

Это главное поле вкладки. Сюда вставляется ключ авторизации, полученный в кабинете Гигачат API. Не временный access token, не Client ID и не Client Secret. Проверочный принцип очень простой:

• если значение было получено через кнопку «Получить ключ» в проекте Гигачат API и называется Ключ авторизации, вы на правильном пути;
• если вы копировали временный токен из запроса OAuth, это уже не то значение.

Кнопка «Сохранить»

Эта кнопка сохраняет введённые данные в AppsMax. Что важно понимать:

• Сохранить — это не то же самое, что проверить;
• после сохранения данные уже записаны, но это ещё не означает, что авторизация прошла успешно.

Правильный порядок действий такой:

1. заполнить поля;
2. нажать Сохранить;
3. после этого нажать Проверить.

Кнопка «Проверить»

Эта кнопка делает практическую проверку: может ли AppsMax использовать ваши данные для работы с Гигачат. Именно после неё начинает иметь смысл блок статуса справа. Если проверка проходит, это означает, что:

• ключ задан корректно;
• режим доступа не противоречит проекту;
• AppsMax смог связаться с Гигачат.

Правый блок «Статус»

Это ваш быстрый ориентир. Он помогает понять не только “работает или нет”, но и какая сейчас стадия.

Статус

• Подключено — соединение прошло проверку и работает.
• Настроено — данные сохранены, но успешная рабочая проверка ещё не подтверждена.
• Ошибка — проверка не прошла или при последнем обращении возникла проблема.
• Не настроено — подключение ещё не собрано.

Последняя проверка

Показывает, когда система в последний раз успешно или неуспешно проверяла подключение. Это особенно полезно, если несколько человек в команде меняют настройки по очереди.

Ключ задан

Это простая, но важная индикация. Она отвечает только на вопрос: сохранено ли какое-то значение ключа. Это не равняется успешной авторизации. То есть статус может показывать, что ключ задан, но при этом само подключение всё равно окажется с ошибкой.

Текст ошибки

Если последняя проверка завершилась неудачно, справа показывается сообщение об ошибке. Его нужно читать буквально, а не пропускать. Обычно именно оно подсказывает, что исправить: ключ, режим доступа или внешний доступ к API.

Блок «Параметры ответов и лимитов»

Этот блок влияет уже не на сам факт подключения, а на то, как Гигачат будет отвечать. Важно: параметры применяются ко всем режимам выбранного бота — личным сообщениям, группам и каналам. Если вы пока только подключаете Гигачат первый раз, можно оставить большинство значений по умолчанию. Но важно понимать, что означает каждое поле.

Температура

Влияет на свободу формулировок. Чем ниже значение, тем более предсказуемыми и однообразными будут ответы. Чем выше — тем свободнее и разнообразнее ответы. Для поддержки и FAQ обычно лучше умеренное значение. Для очень творческих ответов — выше, но с осторожностью.

Широта выбора ответа

Это дополнительная настройка вариативности. В интерфейсе она названа понятнее, чем технический термин top-p. Если вы не уверены, лучше не экспериментировать и оставить рекомендованное значение.

Максимальная длина ответа

Ограничивает размер ответа. Полезно, если вы не хотите, чтобы бот писал слишком длинные простыни.

Длина ответа

Это более понятный пользовательский режим: коротко, сбалансированно или подробно. Для большинства бизнес-сценариев подходит сбалансированно.

Язык ответа

Позволяет зафиксировать язык или оставить автоматический режим.

Тон ответа

Определяет характер общения: нейтральный, дружелюбный или официальный.

Обращение

Позволяет выбрать режим общения: автоматически, на ты или на вы.

Сообщений контекста

Определяет, сколько предыдущих сообщений система учитывает при ответе. Чем больше значение, тем лучше удерживается контекст диалога, но тем выше расход ресурсов.

Лимит расхода в сутки и на диалог

Это защитные ограничения. Они помогают не уйти в неконтролируемое потребление токенов.

Текст при достижении лимита

Это сообщение, которое увидит пользователь, если лимит будет исчерпан. Здесь лучше писать спокойно и понятно, без технических терминов.

Рекомендуемый порядок первой настройки

1. Выберите правильного бота в шапке.
2. Проверьте организацию на экране.
3. Заполните название подключения.
4. Укажите корректный режим доступа.
5. Вставьте ключ авторизации.
6. Нажмите Сохранить.
7. Нажмите Проверить.
8. Убедитесь, что справа появился статус Подключено.
9. Только после этого переходите к вкладке Функции.

Частые ошибки

1. Данные сохранены, но проверка не проходит

Проверьте три вещи:

• не перепутан ли ключ авторизации с access token;
• правильно ли выбран scope;
• не осталось ли лишних пробелов при вставке ключа.

2. Пользователь думает, что статус «ключ задан» означает «всё работает»

Нет. Это означает только то, что AppsMax хранит значение ключа. Рабочим считается именно статус после успешной проверки.

3. Команда меняет параметры ответов, не проверив базовое подключение

Это неправильный порядок. Сначала связь, потом стиль ответов, потом база знаний и тесты.

Как понять, что вкладка настроена правильно

Правильный результат выглядит так:

• справа статус Подключено;
• есть дата последней проверки;
• система понимает, что ключ задан;
• нет активного сообщения об ошибке.

После этого можно переходить к следующему шагу — настройке поведения самого бота. Для этого откройте инструкцию «Как настроить функциональную часть бота».