Как настроить API-ключи Gemini для Discourse AI
Введение
В этой теме описывается процесс настройки API-ключа Google Gemini с использованием существующего проекта в аккаунте Google Cloud. Gemini — это платный сервис, поэтому вам необходимо убедиться, что в панели администратора Google Cloud настроена оплата.
На странице генерации ключей в разработческом студии Gemini есть важная информация со ссылками:
Хорошо, давайте приступим!
ПРИМЕЧАНИЕ: Требуется доступ уровня администратора к Google Cloud и вашему форуму Discourse.
Шаг 1: Настройка проекта Google Cloud
Правильная настройка API-ключа Gemini требует наличия прав администратора в вашем аккаунте Google Cloud и создания биллингового проекта, который вы сможете использовать для операций с ключом Gemini.
Вы можете создать ключ в Gemini Studio и подключить его к Google Cloud, но проще сделать всё сразу через консоль Google Cloud, чтобы не переключаться между интерфейсами.
Перейдите в панель администратора Google Cloud для API вашей организации и убедитесь, что вы находитесь в родительской организации (это отображается в поле вверху рядом с логотипом Google Cloud).
Если у вас ещё нет подходящего проекта для ключа Gemini, вам нужно его создать (обратите внимание на ссылку для выбора или создания нового проекта в левом верхнем углу страницы).
Для нового проекта заполните страницу создания нового проекта (убедитесь, что ваша организация выбрана в соответствующем выпадающем списке).
Для управления оплатой вашего проекта вам необходимо настроить учётную запись биллинга для проекта в Google Cloud Billing, при условии, что оплата уже настроена для вашей организации. Вы (или менеджер вашей учётной записи биллинга) сможете сделать это позже, после создания ключа. Обратите внимание, что существуют квоты для проектов и биллинговых проектов в зависимости от вашего аккаунта Google Cloud организации. Чтобы включить оплату для вашего проекта, перейдите на вкладку «Оплата» в меню навигации Google Cloud, привяжите учётную запись биллинга (см. ссылку «Управление учётными записями оплаты») и включите оплату для проекта на странице биллинговых проектов.
Шаг 2: Создание API-ключа Gemini
ВАЖНО! Помните о необходимости безопасного хранения ваших API-ключей. Перед продолжением внимательно ознакомьтесь с инструкциями Как сохранить API-ключ в безопасности и Рекомендации по безопасному использованию API-ключей.
Теперь вы готовы создать API-ключ в проекте. Перейдите к учётным данным для этого проекта, нажмите ссылку «+ создать учётные данные» вверху и выберите «API-ключ» из выпадающего списка.
Для вас будет создан новый API-ключ. Скопируйте его и сохраните в надёжном месте, например, в менеджере паролей. Не передавайте ключи третьим лицам. Это тот ключ, который вам нужно будет ввести в настройки Discourse AI.
Ключ должен теперь отображаться в списке ваших API-ключей. Нажмите на него, чтобы отредактировать настройки ключа.
Придайте ключу подходящее имя, затем прокрутите вниз до раздела «Ограничения API», выберите «Ограничить ключ», а затем выберите «Generative Language API».
Сохраните обновлённый ключ. Нажмите ссылку «Показать ключ» для вашего нового ключа и скопируйте его.
Шаг 3: Настройка Gemini в параметрах Discourse AI
Discourse AI теперь использует централизованную систему Учётных данных для управления API-ключами. Вместо того чтобы вставлять ключ напрямую в каждую конфигурацию LLM, сначала создайте учётные данные, а затем выберите их при настройке модели Gemini.
Шаг 3a: Создание учётных данных
Перейдите в Администрирование > Плагины > ИИ > Учётные данные и нажмите Новые учётные данные. Придайте им описательное имя (например, «API-ключ Gemini») и вставьте API-ключ, скопированный из Google Cloud. Сохраните учётные данные.
Совет: Вы также можете создать учётные данные непосредственно в процессе — при добавлении нового LLM на следующем шаге нажмите кнопку + рядом с селектором учётных данных, чтобы создать их на лету.
Шаг 3b: Добавление LLM Gemini
Теперь перейдите в Администрирование > Плагины > ИИ > LLM. Нажмите Добавить и выберите одну из предварительно настроенных моделей Gemini (например, Gemini 3 Flash или Gemini 3 Pro). Название модели, URL-адрес конечной точки и другие настройки будут автоматически заполнены. Используйте выпадающий список Учётные данные, чтобы выбрать учётные данные, созданные на предыдущем шаге, затем сохраните изменения.
Примечание: Одни и те же учётные данные можно использовать в нескольких конфигурациях LLM, поэтому вам нужно ввести API-ключ Gemini только один раз.
Шаг 4: Отслеживание использования API-ключа Gemini
Вы можете отслеживать использование вашего API-ключа Gemini в панели управления Google Cloud в разделе оплаты под пунктом «Управление учётной записью оплаты».
Затем выберите свой конкретный проект из списка биллинговых проектов, и откроется отчёт об оплате, где вы сможете указать проект(ы) и различные другие детали, которые хотите использовать для отслеживания проектов вашего API-ключа (здесь вы также можете отслеживать другие API-ключи Google, привязанные к вашему аккаунту Google Cloud, например, если у вас настроены Google Custom Search API и Programmable Search Engine).
