Создайте приложение Google Chat с помощью агента искусственного интеллекта ADK.

На этой странице объясняется, как создать надстройку для Google Workspace, которая будет работать в Google Chat и взаимодействовать с агентом искусственного интеллекта Agent Development Kit (ADK), размещенным в Vertex AI Agent Engine .

Примечание: В Google Chat дополнения отображаются пользователям как приложения Google Chat. Вы также можете создать свое приложение Chat, используя события взаимодействия API Google Chat . Для получения дополнительной информации см. обзор расширения Google Chat .

Агенты ИИ автономно воспринимают окружающую среду, рассуждают и выполняют сложные многоэтапные действия для достижения заданной цели. В этом руководстве вы развернете пример многоагентной системы ADK LLM Auditor , которая анализирует и корректирует факты, используя Gemini и Google Search в качестве основы для своих вычислений.

На следующей диаграмме показана архитектура и схема обмена сообщениями:

На приведенной выше диаграмме показано следующее взаимодействие пользователя с чат-приложением, реализованным с использованием агента ADK AI:

1. Пользователь отправляет сообщение в приложение для чата, либо в личном сообщении, либо в чате.
2. Логика чат-приложения, реализованная либо в Apps Script, либо в виде веб-сервера с HTTP-конечными точками, получает и обрабатывает сообщение.
3. Искусственный интеллект, реализованный с помощью ADK и размещенный на сервере Vertex AI Agent Engine, получает и обрабатывает взаимодействие.
4. При желании приложение для чата или ИИ-агент могут интегрироваться с сервисами Google Workspace, такими как Календарь или Таблицы, или с другими сервисами Google, такими как Google Карты или YouTube.
5. Приложение «Чат» асинхронно отправляет ответы, используя API Google Chat, для отслеживания прогресса работы агента искусственного интеллекта.
6. Ответы доставляются пользователю.

Цели

• Настройте свою среду.
• Разверните агент ADK AI.
• Разверните приложение «Чат».
• Настройте приложение «Чат».
• Протестируйте приложение «Чат».

Предварительные требования

• Корпоративный аккаунт Google Workspace с доступом к Google Chat .
• Проект Google Cloud с включенной оплатой. Чтобы проверить, включена ли оплата в существующем проекте, см. раздел «Проверка статуса оплаты ваших проектов ». Чтобы создать проект и настроить оплату, см. раздел «Создание проекта Google Cloud» .

Настройте свою среду

Включите API Google Cloud.

Перед использованием API Google необходимо включить их в проекте Google Cloud. В одном проекте Google Cloud можно включить один или несколько API.

• В консоли Google Cloud включите API Google Chat, Vertex AI и Cloud Resource Manager.

  Включите API

Настройте экран согласия OAuth.

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

1. В консоли Google Cloud перейдите в >Google Auth platform > Брендинг .

   Перейти к разделу «Брендинг»

2. Если вы уже настроили Google Auth platformВы можете настроить следующие параметры экрана согласия OAuth в разделах «Брендинг» , «Аудитория» и «Доступ к данным» . Если вы видите сообщение, в котором говорится... Google Auth platform Если конфигурация еще не выполнена , нажмите «Начать» :
1. В разделе «Информация о приложении» , в поле «Название приложения» , введите название для приложения.
2. В разделе «Электронная почта службы поддержки пользователей» выберите адрес электронной почты, по которому пользователи смогут связаться с вами, если у них возникнут вопросы относительно их согласия.
3. Нажмите «Далее» .
4. В разделе «Аудитория» выберите «Внутренняя» .
5. Нажмите «Далее» .
6. В поле «Контактная информация» укажите адрес электронной почты , на который вы сможете получать уведомления об изменениях в вашем проекте.
7. Нажмите «Далее» .
8. В разделе «Завершить» ознакомьтесь с Политикой использования пользовательских данных сервисов Google API и, если вы согласны, выберите «Я согласен с Политикой использования пользовательских данных сервисов Google API» .
9. Нажмите «Продолжить» .
10. Нажмите «Создать» .
3. На данный момент добавление областей действия можно пропустить. В будущем, при создании приложения для использования за пределами вашей организации Google Workspace, необходимо изменить тип пользователя на «Внешний» . Затем добавьте необходимые для вашего приложения области авторизации. Для получения дополнительной информации см. полное руководство по настройке согласия OAuth .

Создайте учетную запись службы в консоли Google Cloud.

Создайте новую учетную запись службы с ролью Vertex AI User , выполнив следующие шаги:

Консоль Google Cloud

1. В консоли Google Cloud перейдите в > IAM и администрирование > Учетные записи служб .

   Перейдите в раздел «Учетные записи служб».

2. Нажмите «Создать учетную запись службы» .
3. Заполните данные учетной записи службы, затем нажмите «Создать и продолжить» .
   Примечание: По умолчанию Google создает уникальный идентификатор сервисной учетной записи. Если вы хотите изменить идентификатор, измените его в поле «Идентификатор сервисной учетной записи».
4. Необязательно: назначьте роли вашей учетной записи службы, чтобы предоставить доступ к ресурсам вашего проекта Google Cloud. Для получения более подробной информации см. раздел «Предоставление, изменение и отзыв доступа к ресурсам» .
5. Нажмите «Продолжить» .
6. Необязательно: укажите пользователей или группы, которые могут управлять этой учетной записью службы и выполнять с ней действия. Дополнительные сведения см. в разделе «Управление имитацией учетной записи службы» .
7. Нажмите «Готово» . Запишите адрес электронной почты учетной записи службы.

gcloud CLI

1. Создайте учетную запись службы:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. Необязательно: назначьте роли вашей учетной записи службы, чтобы предоставить доступ к ресурсам вашего проекта Google Cloud. Для получения более подробной информации см. раздел «Предоставление, изменение и отзыв доступа к ресурсам» .

Учетная запись службы отображается на странице учетной записи службы.

Создать закрытый ключ

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

Чтобы узнать больше о безопасной реализации учетных записей служб и передовых методах, см. раздел «Выбор момента использования учетных записей служб» .

Чтобы создать и загрузить закрытый ключ для учетной записи службы, выполните следующие действия:

1. В консоли Google Cloud перейдите в > IAM и администрирование > Учетные записи служб .

   Перейдите в раздел «Учетные записи служб».

2. Выберите свой сервисный аккаунт.
3. Нажмите «Клавиши» > «Добавить клавишу» > «Создать новую клавишу» .
4. Выберите JSON , затем нажмите «Создать» .

   Ваша новая пара открытого/закрытого ключей будет сгенерирована и загружена на ваш компьютер в виде нового файла. Сохраните загруженный JSON-файл как credentials.json в вашей рабочей директории. Этот файл является единственной копией данного ключа. Информацию о том, как безопасно хранить ключ, см. в разделе «Управление ключами учетных записей служб» .

5. Нажмите «Закрыть» .

Для получения дополнительной информации об учетных записях служб см. раздел «Учетные записи служб» в документации Google Cloud IAM .

Разверните агент ADK AI.

1. Откройте пример LLM Auditor в Vertex AI Agent Garden:

   Откройте образец

2. Нажмите «Развернуть» .

3. Если потребуется, выберите свой проект в Google Cloud.

4. Нажмите кнопку «Развернуть» в Cloud Shell .

5. Если потребуется, нажмите «Авторизовать» и пройдите процедуру аутентификации OAuth для Cloud Shell.

6. После полной загрузки Cloud Shell нажмите Enter , чтобы запустить предварительно загруженную командную строку и начать развертывание.

7. Если вас попросят ввести регион, нажмите Enter , чтобы использовать регион по умолчанию.

8. После завершения перейдите к Vertex AI Agent Engine:

   Open Vertex AI Agent Engine

9. Нажмите чтобы скопировать имя ресурса вновь развернутого агента из таблицы.

Создайте и настройте проект приложения «Чат».

1. Нажмите следующую кнопку, чтобы открыть проект ADK AI Agent Quickstart Apps Script.

   Откройте проект

2. Нажмите « Обзор > Сделайте копию .

3. В проекте Apps Script нажмите Настройки проекта > Изменить свойства скрипта > Добавить свойство скрипта , чтобы добавить следующие свойства скрипта:

   1. REASONING_ENGINE_RESOURCE_NAME содержит имя ресурса агента Vertex AI, скопированное на предыдущих шагах.
   2. SERVICE_ACCOUNT_KEY содержит JSON-ключ из учетной записи службы, загруженной на предыдущих шагах, например, { ... } .

4. Нажмите «Сохранить свойства сценария».

5. В консоли Google Cloud перейдите в > IAM и администрирование > Настройки .

   Перейдите в раздел «Настройки IAM и администрирования».

6. В поле «Номер проекта» скопируйте значение.

7. В проекте Apps Script нажмите Настройки проекта .

8. В разделе «Проект Google Cloud Platform (GCP)» нажмите «Изменить проект» .

9. В поле "Номер проекта GCP" вставьте номер проекта Google Cloud, скопированный на предыдущих шагах.

10. Нажмите «Установить проект» . Проект «Облако» и проект «Apps Script» теперь связаны.

Создайте тестовое развертывание.

Для этого проекта Apps Script вам потребуется идентификатор развертывания, чтобы вы могли использовать его на следующем шаге.

Чтобы получить идентификатор головного развертывания, выполните следующие действия:

1. В проекте Apps Script приложения «Чат» нажмите «Развернуть» > «Проверить развертывания» .
2. В разделе «Идентификатор развертывания головного устройства» нажмите Копировать .
3. Нажмите «Готово» .

Настройте приложение «Чат».

Чтобы развернуть приложение Google Chat для тестирования, выполните следующие действия, используя развертывание Apps Script:

1. В консоли найдите Google Chat API и нажмите на него .
2. Нажмите «Управление» .

3. Нажмите «Конфигурация» и настройте приложение «Чат»:

   1. В поле «Название приложения» введите ADK Quickstart .
   2. В поле «URL-адрес аватара» введите https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png .
   3. В поле «Описание» введите ADK Quickstart .
   4. В разделе «Функциональность» выберите «Присоединяйтесь к пространствам и групповым беседам» .
   5. В разделе «Настройки подключения» выберите проект Apps Script .
   6. В поле «Идентификатор развертывания» вставьте ранее скопированный идентификатор развертывания Head.
   7. В разделе «Видимость» выберите «Конкретные люди и группы в вашем домене» и введите свой адрес электронной почты.

4. Нажмите « Сохранить ».

Приложение «Чат» готово отвечать на сообщения.

Протестируйте приложение для чата

Чтобы протестировать приложение «Чат», откройте личное сообщение в приложении «Чат» и отправьте сообщение:

1. Откройте Google Chat, используя учетную запись Google Workspace, которую вы указали при добавлении себя в качестве доверенного тестировщика.

   Перейдите в Google Чат

2. Нажмите новый чат» .
3. В поле «Добавить 1 или более человек» введите название вашего приложения для чата.

4. Выберите ваше приложение для чата из результатов поиска. Откроется личное сообщение.

   Примечание: Если вы не видите свое приложение «Чат» в списке результатов, убедитесь, что вы добавили свою учетную запись Google Workspace в настройки видимости на странице конфигурации API чата в консоли Google Cloud.

5. В новом личном сообщении в приложении напишите « The Eiffel Tower was completed in 1900 и нажмите enter .

   Приложение «Чат» отправляет ответы от суб-агентов «Критик» и «Рецензент» .

Чтобы добавить доверенных тестировщиков и узнать больше о тестировании интерактивных функций, см. раздел «Тестирование интерактивных функций для приложений Google Chat» .

Устранение неполадок

Когда приложение или карточка Google Chat выдает ошибку, интерфейс чата отображает сообщение «Что-то пошло не так» или «Не удалось обработать ваш запрос». Иногда интерфейс чата не отображает никаких сообщений об ошибке, но приложение или карточка чата выдает неожиданный результат; например, сообщение на карточке может не появиться.

Хотя сообщение об ошибке может не отображаться в пользовательском интерфейсе чата, подробные сообщения об ошибках и данные журнала доступны для исправления ошибок, если включено ведение журнала ошибок для приложений чата. Для получения помощи по просмотру, отладке и исправлению ошибок см. раздел «Устранение неполадок и исправление ошибок Google Chat» .

Уборка

Чтобы избежать списания средств с вашего аккаунта Google Cloud за ресурсы, использованные в этом руководстве, мы рекомендуем удалить проект Cloud.

Внимание: удаление проекта влечет за собой следующие последствия:

• Все данные в проекте будут удалены. Если вы использовали существующий проект для этого урока, то при его удалении будет удалена и вся остальная работа, проделанная в этом проекте.
• Пользовательские идентификаторы проектов теряются. При создании этого проекта вы могли создать пользовательский идентификатор проекта, который хотите использовать в будущем. Чтобы сохранить URL-адреса, использующие этот идентификатор проекта, например, URL-адрес на appspot.com, удалите выбранные ресурсы внутри проекта, а не удаляйте весь проект.

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

1. В консоли Google Cloud перейдите на страницу «Управление ресурсами» > IAM и администрирование > Управление ресурсами .

   Перейдите в Диспетчер ресурсов

2. В списке проектов выберите проект, который хотите удалить, и нажмите кнопку «Удалить .
3. В диалоговом окне введите идентификатор проекта, а затем нажмите «Завершить» , чтобы удалить проект.

Связанные темы

• Проверка фактов с помощью агента ADK AI и модели Gemini.
• Планируйте поездки с помощью ИИ-агента, доступного во всем Google Workspace.
• Интегрируйте фундаментальные концепции искусственного интеллекта в чат-приложения.
• Отвечайте на вопросы, основанные на диалогах в чате, с помощью приложения Gemini AI Chat.
• Реагирование на инциденты с помощью Google Chat, Vertex AI, Apps Script и аутентификации пользователей.
• Управляйте проектами с помощью Google Chat, Vertex AI и Firestore.