Интеграция Gemini Enterprise Agents с Google Workspace

1. Прежде чем начать

Что такое Gemini Enterprise?

Gemini Enterprise — это передовая платформа для работы с агентами, которая предоставляет лучшие возможности искусственного интеллекта Google каждому сотруднику и для любого рабочего процесса. Она позволяет командам находить, создавать, совместно использовать и запускать агентов ИИ в единой безопасной среде.

• Получите доступ к передовым моделям: пользователи получают мгновенный доступ к самым мощным многомодальным моделям искусственного интеллекта Google, включая Gemini, для решения сложных бизнес-задач.
• Используйте специализированных агентов: в пакет входят готовые к использованию агенты Google для исследований, программирования и ведения заметок, обеспечивающие немедленную пользу.
• Расширьте возможности каждого сотрудника: варианты без программирования и с возможностью написания кода позволяют сотрудникам всех отделов создавать и управлять собственными пользовательскими агентами для автоматизации рабочих процессов.
• Внедрение агентов в данные: Агенты могут быть безопасно подключены к внутренним данным компании и сторонним приложениям, чтобы обеспечить контекстную точность их ответов.
• Централизованное управление: администраторы могут визуализировать и проверять всю активность агентов, чтобы гарантировать соответствие организации строгим стандартам безопасности и соответствия требованиям.
• Расширяйте возможности экосистемы: платформа интегрируется с широкой сетью партнерских приложений и поставщиков услуг, что позволяет распространить автоматизацию на различные системы.

Что такое Google Workspace?

Google Workspace — это набор облачных решений для повышения производительности и совместной работы, разработанных для частных лиц, учебных заведений и предприятий.

• Коммуникация: Профессиональные почтовые сервисы (Gmail), видеоконференции (Meet) и командный мессенджер (Chat).
• Создание контента: Инструменты для написания документов (Docs), создания электронных таблиц (Sheets) и разработки презентаций (Slides).
• Организация: общие календари (Календари) и цифровые заметки (Keeping).
• Хранение данных: Централизованное облачное пространство для безопасного сохранения и обмена файлами (Drive).
• Управление: Административные средства управления пользователями и параметрами безопасности (Консоль администратора рабочей области).

Какие именно пользовательские интеграции?

Google Workspace и Gemini Enterprise создают мощную петлю обратной связи, где Workspace предоставляет данные в реальном времени и контекст для совместной работы, а Gemini Enterprise предлагает модели, агентное мышление и оркестровку, необходимые для автоматизации интеллектуальных рабочих процессов.

• Интеллектуальное подключение: управляемые Google хранилища данных, API и серверы MCP (управляемые Google и собственные) позволяют агентам безопасно и беспрепятственно получать доступ к данным Workspace и выполнять действия от имени пользователей.
• Пользовательские агенты: Используя конструкторы без кода или профессиональные фреймворки для программирования, команды могут создавать специализированные агенты, основанные на данных и действиях рабочего пространства, управляемых администратором.
• Встроенная интеграция: дополнения Workspace устраняют разрыв между системами искусственного интеллекта и такими приложениями, как Chat и Gmail, будь то с помощью специальных компонентов пользовательского интерфейса или фоновых процессов. Это позволяет агентам оказывать пользователям мгновенную помощь с учетом контекста именно там, где они находятся.

Сочетая мощную экосистему повышения производительности Google Workspace с передовыми возможностями агентского управления Gemini Enterprise, организации могут трансформировать свою деятельность с помощью настраиваемых, основанных на данных агентов искусственного интеллекта, которые автоматизируют сложные рабочие процессы непосредственно в инструментах, которые их команды уже используют каждый день.

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

Если вы хотите выполнить все шаги в своей собственной среде, вам потребуется:

• Базовые знания Google Cloud и Python .
• Проект Google Cloud, владельцем которого вы являетесь, с включенной оплатой. Чтобы проверить, включена ли оплата в существующем проекте, см. раздел «Проверка статуса оплаты ваших проектов ». Чтобы создать проект и настроить оплату, см. раздел «Создание проекта Google Cloud» . Чтобы изменить владельца проекта, см. раздел «Управление участниками проекта или изменение владельца проекта» .
• Доступны версии Gemini Enterprise Standard / Plus. Для сравнения версий Gemini Enterprise см. раздел «Сравнение версий Gemini Enterprise» . Если у вас нет лицензии на Gemini Enterprise, на следующем шаге у вас будет возможность создать пробную лицензию.
• Корпоративный аккаунт Google Workspace ( для бизнеса) с включенным доступом к Google Chat и интеллектуальным функциям.
• Для вашего проекта Google Cloud установлен и инициализирован интерфейс командной строки Google Cloud.
• Для корректной работы требуется установленный Python 3.11+. Инструкции см. на официальном сайте Python .

Что вы построите

В этом практическом занятии мы создадим три решения с использованием агентов Gemini Enterprise AI, тесно интегрированных с Google Workspace. Они продемонстрируют архитектурные шаблоны, которые можно использовать для взаимодействия с данными, действиями и пользовательскими интерфейсами.

Пользовательский агент без кода

Этот агент позволяет пользователям искать данные и выполнять действия в Workspace на их естественном языке. Он основан на следующих элементах:

• Модель: Близнецы.
• Данные и действия: хранилища данных Gemini Enterprise для Google Workspace (Календарь, Gmail, Диск, NotebookLM), Google Поиск .
• Инструменты для создания агентов: Gemini Enterprise Agent Designer.
• Агент-хост: Gemini Enterprise.
• Пользовательский интерфейс: Веб-приложение Gemini Enterprise.

Пользовательский агент с промокодом

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

• Модель: Близнецы.
• Данные и действия: хранилища данных Gemini Enterprise для Google Workspace (Календарь, Gmail, Диск, NotebookLM), Google Поиск , сервер протокола контекста модели (MCP) управляемого Google Agent Search, пользовательская функция инструмента для отправки сообщений Google Chat (через Google Chat API).
• Инструменты для создания агентов: Комплект для разработки агентов (ADK).
• Хост агента: Среда выполнения агента.
• Пользовательский интерфейс: Веб-приложение Gemini Enterprise.

Агентом по умолчанию является надстройка Google Workspace.

Этот агент позволяет пользователям искать данные для Workspace на своем естественном языке в контексте пользовательского интерфейса приложения Workspace. Он основан на следующих элементах:

• Модель: Близнецы.
• Данные: хранилища данных Gemini Enterprise для Google Workspace (Календарь, Gmail, Диск, NotebookLM), Google Поиск .
• Агент-хост: Gemini Enterprise.
• Пользовательский интерфейс: Дополнение Google Workspace для чата и Gmail (легко расширяется для календаря, диска, документов, таблиц и презентаций).
• Дополнение Google Workspace: Apps Script, API Gemini Enterprise, контекстное (метаданные пользователя, выбранное сообщение Gmail).

Что вы узнаете

• Точки интеграции между Gemini Enterprise и Google Workspace, обеспечивающие доступ к данным и выполнение действий.
• Варианты создания пользовательских агентов без программирования и с использованием профессионального программирования, размещенных в Gemini Enterprise.
• Способы доступа пользователей к агентам через веб-приложение Gemini Enterprise и приложения Google Workspace.

Удобный доступ к этому практическому занятию.

2. Настройка

Обзор концепций

Приложение Gemini Enterprise

Приложение Gemini Enterprise предоставляет конечным пользователям результаты поиска, действия и агентов. Термин «приложение» можно использовать взаимозаменяемо с термином «движок» в контексте API. Приложение должно быть подключено к хранилищу данных, чтобы использовать данные из него для предоставления результатов поиска, ответов или действий.

Веб-приложение Gemini Enterprise

Веб-приложение Gemini Enterprise связано с приложением Gemini Enterprise. Оно функционирует как централизованная база для ИИ, где сотрудники используют единый чат-интерфейс для поиска по разрозненным данным компании, запуска специализированных агентов ИИ для сложных рабочих процессов и создания контента профессионального уровня с соблюдением конфиденциальности корпоративного уровня.

Инициализация и доступ к ресурсам.

В этом разделе вы можете получить доступ к следующим ресурсам и настроить их с помощью предпочитаемого вами веб-браузера.

Приложение Gemini Enterprise

Откройте консоль Google Cloud в новой вкладке, затем выполните следующие действия:

1. Выберите свой проект.
2. В поле поиска Google Cloud найдите и выберите Gemini Enterprise , затем нажмите + Создать приложение . Если у вас нет лицензии на Gemini Enterprise, вам будет предложено активировать 30-дневную бесплатную пробную лицензию.

Перейдите в Gemini Enterprise, чтобы создать приложение.

3. Задайте название приложения как codelab .
4. Идентификатор генерируется на основе имени и отображается под полем, скопируйте его.
5. Установите для параметра «Многорегиона» значение global (Global) .
6. Нажмите «Создать» .

7. Приложение создано, и вы автоматически перенаправляетесь на страницу Gemini Enterprise > Обзор .
8. В разделе «Полный доступ» нажмите «Настроить учетную запись» .
9. На новом экране выберите «Использовать учетную запись Google» и нажмите «Подтвердить учетные данные сотрудников» .

10. Настройки сохраняются, и вы автоматически перенаправляетесь на страницу Gemini Enterprise > Обзор .
11. Перейдите в раздел «Настройки» .
12. На вкладке «Управление функциями» включите параметр «Включить конструктор агентов» и нажмите «Сохранить» .

Веб-приложение Gemini Enterprise

Откройте Gemini Enterprise в новой вкладке консоли Cloud, затем выполните следующие действия:

1. Нажмите на приложение под названием codelab .
2. Скопируйте появившийся URL-адрес, поскольку мы будем использовать его для перехода к веб-приложению Gemini Enterprise на следующих шагах.

3. Пользовательский агент без написания кода

Этот агент позволяет пользователям искать данные и выполнять действия в Workspace на их естественном языке. Он основан на следующих элементах:

• Модель: Близнецы.
• Данные и действия: хранилища данных Gemini Enterprise для Google Workspace (Календарь, Gmail, Диск, NotebookLM), Google Поиск .
• Инструменты для создания агентов: Gemini Enterprise Agent Designer.
• Агент-хост: Gemini Enterprise.
• Пользовательский интерфейс: Веб-приложение Gemini Enterprise.

Обзор концепций

Близнецы

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

Хранилище данных Gemini Enterprise

Хранилище данных Gemini Enterprise — это сущность, содержащая данные, поступающие из собственных источников данных, таких как Google Workspace, или сторонних приложений, таких как Jira или Salesforce. Хранилища данных, содержащие данные из сторонних приложений, также называются коннекторами данных.

Gemini Enterprise Agent Designer

Gemini Enterprise Agent Designer — это интерактивная платформа без или с минимальным использованием кода для создания, управления и запуска одно- и многошаговых агентов в Gemini Enterprise.

Обзор архитектуры решения

Включить API

Для работы хранилищ данных Gemini Enterprise Workspace требуется активация API:

1. В консоли Google Cloud включите API для календаря, Gmail и пользователей:

Включите API календаря, Gmail и «Контакты».

2. Нажмите Меню ☰ > API и сервисы > Включенные API и сервисы , а затем убедитесь, что Google Calendar API , Gmail API и People API присутствуют в списке.

Перейдите в раздел API и сервисы > Включенные API и сервисы

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

Для использования функций календаря Gemini Enterprise Workspace и Gmail требуется настройка экрана согласия:

1. В консоли Google Cloud перейдите в меню ☰ > Платформа аутентификации Google > Брендинг .

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

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

12. Настройки сохраняются, и вы автоматически перенаправляетесь на страницу Google Auth Platform > Overview .
13. Перейдите в раздел «Доступ к данным» .
14. Нажмите «Добавить или удалить области действия» .
15. Скопируйте следующие области действия и вставьте их в поле «Добавить области действия вручную» .

https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.calendars
https://www.googleapis.com/auth/gmail.send
https://www.googleapis.com/auth/gmail.readonly

16. Нажмите «Добавить в таблицу» , затем «Обновить» , затем «Сохранить» .

Для получения более подробной информации ознакомьтесь с полным руководством по настройке согласия OAuth .

Создание учетных данных клиента OAuth

Создайте новый OAuth-клиент для Gemini Enterprise для аутентификации пользователей:

1. В консоли Google Cloud перейдите в меню ☰ > Платформа аутентификации Google > Клиенты .

Перейти к клиентам

2. Нажмите + Создать клиента .
3. В поле «Тип приложения» выберите «Веб-приложение» .
4. Задайте имя codelab .
5. Пропустить авторизованные источники JavaScript .
6. В разделе «Авторизованные URI перенаправления» нажмите «Добавить URI» и введите https://vertexaisearch.cloud.google.com/oauth-redirect .
7. Нажмите «Создать» .
8. Появится диалоговое окно с созданным вами идентификатором клиента OAuth и секретным ключом. Сохраните эту информацию в надежном месте.

Создание хранилищ данных

Для подключения Gemini Enterprise к данным вашей рабочей области необходимо создать хранилища данных.

Откройте Gemini Enterprise в новой вкладке консоли Cloud, затем выполните следующие действия:

1. Нажмите на приложение под названием codelab .
2. В навигационном меню нажмите «Подключенные хранилища данных» .
3. Нажмите + Создать хранилище данных .
4. В разделе «Источник» найдите Google Календарь и нажмите «Выбрать» .
5. В разделе «Действия» введите идентификатор клиента (Client ID) и секретный ключ клиента (Client Secret), сохраненные на предыдущих шагах, затем нажмите «Проверить аутентификацию» (Verify Auth) и следуйте инструкциям для аутентификации и авторизации клиента OAuth.
6. Включите действия «Создать событие календаря» и «Обновить событие календаря» .
7. Нажмите «Продолжить» .

8. В разделе «Конфигурация» укажите имя соединителя данных как calendar .
9. Нажмите «Создать» .
10. Вы будете автоматически перенаправлены на страницу подключенных хранилищ данных , где сможете увидеть недавно добавленное хранилище данных.

Создайте хранилище данных Google Gmail:

1. Нажмите + Создать хранилище данных .
2. В поле «Источник» найдите Google Gmail и нажмите «Выбрать» .
3. В разделе «Действия» введите идентификатор клиента (Client ID ) и секретный ключ клиента (Client Secret), сохраненные на предыдущих шагах, а затем нажмите «Проверить аутентификацию» (Verify Auth) .
4. Включите действие «Отправить электронное письмо» .
5. Нажмите «Продолжить» .
6. В разделе «Конфигурация» укажите имя коннектора данных как gmail .
7. Нажмите «Создать» .
8. Вы будете автоматически перенаправлены на страницу подключенных хранилищ данных , где сможете увидеть недавно добавленное хранилище данных.

Создайте хранилище данных Google Drive:

1. Нажмите + Создать хранилище данных .
2. В поле «Источник» найдите Google Drive и нажмите «Выбрать» .
3. В разделе «Данные» выберите «Все» , затем нажмите «Продолжить» .
4. В разделе «Конфигурация» укажите имя соединителя данных как drive .
5. Нажмите «Создать» .
6. Вы будете автоматически перенаправлены на страницу подключенных хранилищ данных , где сможете увидеть недавно добавленное хранилище данных.

Создайте хранилище данных NotebookLM:

1. Нажмите + Создать хранилище данных .
2. В поле «Источник» найдите NotebookLM и нажмите «Выбрать» .
3. В разделе «Конфигурация» укажите имя коннектора данных как notebooklm .
4. Нажмите «Создать» .
5. Вы будете автоматически перенаправлены на страницу подключенных хранилищ данных , где сможете увидеть недавно добавленное хранилище данных.

Через несколько минут статус всех подключенных хранилищ данных (кроме NotebookLM) изменится на «Активный» . Если вы обнаружите какие-либо ошибки, вы можете щелкнуть по источнику данных, чтобы просмотреть подробности ошибки.

хранилища тестовых данных

Убедитесь, что ваши хранилища данных корректно загружают данные, выполнив несколько тестовых запросов.

Откройте URL-адрес веб-приложения Gemini Enterprise, который мы скопировали ранее:

2. Нажмите Меню ☰ > Новый чат .
3. В нижней части поля для нового сообщения чата нажмите значок « Коннекторы» и включите все коннекторы.
4. Теперь вы можете поэкспериментировать с подсказками, связанными с коннекторами. Например, в чате введите Do I have any meetings today? и нажмите enter .
5. Далее попробуйте набрать How many emails did I receive today? и нажмите enter .
6. Наконец, Give me the title of the last Drive file I created и нажмите enter .