ym88659208ym87991671
Настройка ключа GigaChat в сценарии чат-бота | Документация для разработчиков

Настройка ключа GigaChat в сценарии чат-бота

Обновлено 6 августа 2025

Ключ GigaChat или персональный ключ авторизации — это ключ, нужный для создания блоков Генерация ответа и AI-ответ из базы знаний. Его пользователь получает и добавляет в проект чат-бота для дальнейшего использования.

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

Получение и добавление ключа

Вы можете продолжать использовать GigaChat Lite при работе с блоками Генерация ответа и AI-ответ из базы знаний на бесплатной основе.
Также в проекте SaluteBot появилась возможность получить и добавить свои персональные ключи GigaChat.

Если вы используете персональные ключи авторизации GigaChat, то для работы с RAG обязательно подключите модель векторного представления текста Embeddings. Без подключенной модели база знаний работать не будет.

Важно: в базе знаний на платформе SaluteBot используется только модель Embeddings. Для работы с RAG обязательно выберите глобальный ключ.

Ключ авторизации — это набор данных аутентификации и авторизации для доступа к проекту GigaChat, который используется для получения токенов и идентификации данных.

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

Для получения ключа авторизации GigaChat:

  1. Создайте проект GigaChat по инструкции, выбрав доступ для физического или юридического лица.

  2. На левой панели выберите раздел Настройки API.

  3. Нажмите кнопку Получить ключ.

Получение ключа
  1. Скопируйте имя скоупа Scope и ключ авторизации Authorization key.

Scope бывает нескольких видов:

  • GIGACHAT_API_PERS — доступ для физических лиц;
  • GIGACHAT_API_B2B — доступ для ИП и юридических лиц по платным пакетам;
  • GIGACHAT_API_CORP — доступ для ИП и юридических лиц по схеме pay-as-you-go.
  1. Зайдите в проект SaluteBot, в разделе Токены и доступы перейдите во вкладку Ключи GigaChat и добавьте полученный в Authorization key ключ.
Токены и доступы

После этого ключ можно использовать в работе.

Полученный в проекте ключ авторизации рекомендуется сделать ключом по умолчанию в проекте SaluteBot. Для этого следует установить отметку Использовать ключ по умолчанию. Если эта отметка установлена, ключ будет использоваться при работе всех блоков сценария GigaChat и работе агента.

Добавление глобального ключа

Глобальный ключ действует на все сценарии проекта.

Для добавления глобального ключа:

  1. Откройте проект сценария.

  2. Перейдите в раздел Токены и доступы на вкладке Ключи GigaChat. По умолчанию список ключей пустой.

  3. Добавьте имеющийся ключ GigaChat. После добавления ключа автоматически становится активен переключатель Сделать глобальным ключом по умолчанию.

  4. Сохраните ключ.

В результате ключ будет отображен в списке с меткой Глобальный ключ по умолчанию.

Тестовый доступ

До добавления в проект персонального ключа вам будет доступен тестовый доступ. Выбор модели ограничен только моделью GigaChat Lite. Для использования всех моделей семейства GigaChat воспользуйтесь инструкцией выше.

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.