На этой странице представлен обзор того, как создать интерактивное приложение Google Chat. Интерактивные приложения для Chat создаются как дополнения Google Workspace, расширяющие возможности Google Chat.
Интерактивные приложения Chat позволяют пользователям:
- Добавлять приложения Chat в чат-группы или прямые переписки.
- Отправлять и получать сообщения от приложений Chat, содержащие текст, карточки и интерактивные элементы интерфейса.
- Просматривать карточку Главная страница приложения и взаимодействовать с ней на вкладке Главная в прямых переписках 1:1 с приложением Chat.
- Отправлять запросы приложениям Chat с помощью слеш-команд, быстрых команд или действий с сообщениями.
- Просматривайте ссылки из сообщений Chat и выполняйте действия, не покидая чат.
- Отправлять информацию в приложения Chat, например вводить текст в диалоговое окно или карточку.
- Автоматизируйте или выполняйте задачи в приложениях Google Workspace и подключайтесь к внешним инструментам или сервисам.
Как пользователи находят и используют интерактивные приложения Chat
В Chat дополнения, расширяющие возможности Chat, показываются пользователям как приложения Google Chat. Пользователи могут находить и использовать приложения Chat, опубликованные в каталоге Marketplace, разными способами, в том числе:
- Находите и устанавливайте приложения Chat из Google Chat или Marketplace.
- Взаимодействовать с приложением Chat, добавленным в чат-группу Chat.
- Найти приложение Chat на панели прямых переписок после того, как администратор Google Workspace установит его от имени пользователя.
Чтобы начать использовать приложение Chat, пользователи Google Chat могут отправить ему прямое сообщение или добавить его в чат-группу. Пользователи также могут добавить приложение Chat, упомянув его через символ @. Подробнее о том, как использовать приложения Chat…
В следующем примере показано, как пользователь упоминает приложение Chat, чтобы добавить его в чат-группу:
Начать
Чтобы начать создавать интерактивное приложение Chat, ознакомьтесь со следующей документацией:
- Настройте Google Chat API и включите интерактивные функции для приложения Chat.
- Узнайте, как получать и обрабатывать взаимодействия с пользователем с помощью триггеров, объектов событий и действий.
- Попробуйте создать простое приложение Chat, используя архитектуру приложения Google Chat.
Как настроить и создать базовое приложение Chat
В таблице ниже приведена документация по настройке Chat API и созданию базового интерактивного приложения Chat для каждой архитектуры приложения Google Chat:
| Архитектура или задача | Руководство |
|---|---|
| Как настроить Chat API | Как настроить Google Chat API |
| Краткие руководства | |
| Apps Script | Как создать приложение Chat с помощью Apps Script |
| HTTP-сервис (функции Cloud Run) | Как создать приложение Chat на основе HTTP |
| издатель-подписчик | Как создать приложение Chat с помощью Pub/Sub |
| Dialogflow CX | Как создать приложение Chat с помощью Dialogflow CX |
| Dialogflow ES | Как создать приложение Chat с помощью Dialogflow ES |
| ИИ-агент Agent Development Kit (ADK) | Как создать приложение Chat для ИИ-агента ADK |
| ИИ-агент Agent2Agent (A2A) | Как создать приложение Chat для ИИ-агента A2A |
| ИИ-агент A2UI | Как создать приложение Chat с ИИ-агентом для A2UI |
| ИИ-агент Gemini Enterprise | Как создать приложение Chat с ИИ-агентом Gemini Enterprise |
Как создавать интерактивные функции
В таблице ниже приведена документация по созданию интерактивных функций приложений Chat.
| Функция | Руководство |
|---|---|
| Получение и обработка действий пользователей | Как получать и обрабатывать действия пользователей |
| Отправлять сообщения (отвечать на запросы или отправлять сообщения по собственной инициативе). | Ответить на сообщение или отправить сообщение с помощью Chat API. |
| Отвечать на слеш-команды, быстрые команды и действия с сообщениями | Как отвечать на команды |
| Создавайте интерактивные диалоговые окна | Как открыть интерактивные диалоговые окна |
| Собирать и обрабатывать информацию из карточек и диалоговых окон. | Как читать данные, введенные пользователями в формы на карточках |
| Предпросмотр ссылок в сообщениях Chat | Ссылки для предпросмотра |
| Как создать главную страницу приложения в прямой переписке 1:1 | Как создать главную страницу для приложения Chat |
| Подключение к внешним системам и инструментам | Как подключить приложение Chat к другим сервисам и инструментам |
Ограничения и рекомендации для дополнений Google Workspace
Поскольку приложения Chat создаются как дополнения Google Workspace, расширяющие возможности Chat, учитывайте следующие ограничения:
- AppSheet Архитектура приложения Chat недоступна при создании дополнения Google Workspace. Вместо этого создайте приложение Chat, используя сервис HTTP, Apps Script, Dialogflow ES, Dialogflow CX или Pub/Sub.
- В Chat не поддерживаются специальные карты авторизации. Чтобы аутентифицировать сервис и предоставить ему доступ из Chat, приложение Chat должно вернуть основную карту авторизации.
- Главные страницы дополнений на боковой панели Chat не поддерживаются. Если вы настроили триггер главной страницы в манифесте (
addons.common.homepageTrigger), главная страница будет показываться только на боковой панели других приложений Google Workspace, которые поддерживает ваше дополнение. Вместо этого вы можете создать главную страницу для приложения Chat, которая будет показываться на вкладке Главная в прямой переписке с приложением Chat.
Если вы расширяете существующее дополнение Google Workspace, чтобы оно работало в Chat, учитывайте следующие требования к конфигурации приложений Chat:
- Настройки установки приложений из Google Workspace Marketplace должны разрешать установку дополнения как отдельным пользователям, так и администраторам Google Workspace.
- Любые общие настройки конфигурации в манифесте дополнения (
addons.common) игнорируются в Chat. Чтобы настроить работу дополнения в Chat, необходимо включить и настроить Chat API. Инструкции приведены в статье Как настроить Google Chat API. - Чтобы развернуть и протестировать дополнение в Chat, необходимо использовать параметр Видимость API Chat. Все настройки видимости и тестирования, заданные в Google Workspace Marketplace SDK, игнорируются. Чтобы развернуть тестовую версию дополнения в Chat, ознакомьтесь со статьей Как тестировать интерактивные функции приложений Google Chat.
- Если ваше дополнение опубликовано в каталоге Google Workspace Marketplace, вы не сможете сохранить черновик изменений в настройках конфигурации API Google Chat. После того как вы измените настройки конфигурации Chat API, обновленное приложение Chat сразу станет доступно всем существующим пользователям. Чтобы изменить страницу приложения в каталоге, вы можете создать черновик, прежде чем отправлять изменения.
Статьи по теме
- Обзор документации по Google Chat API
- Как получать и обрабатывать действия пользователей
- Как выбрать архитектуру приложения Google Chat
- Пример:
- Как запланировать встречу в Google Chat
- Интеграция основных концепций ИИ в приложения Chat
- Планируйте поездки с помощью ИИ-агента, доступного в Google Workspace
- Создавайте агентов Gemini Enterprise, тесно интегрированных с хранилищами данных Workspace, API и приложениями Chat
- Создание ИИ-агентов Vertex AI, тесно интегрированных с хранилищами данных Workspace, API и приложениями Chat
Приложения Chat, которые не являются дополнениями: создание интерактивного приложения Google Chat
Приложения Chat, которые не являются дополнениями Google Workspace, создаются как приложения только для Chat, которые получают события взаимодействия Chat API (Event) вместо объектов событий дополнения Google Workspace (EventObject) и действий.
Если вы поддерживаете приложение Chat, которое не является дополнением, вы можете:
- Преобразуйте приложение Chat, которое не является дополнением, в дополнение Google Workspace, расширяющее возможности Google Chat. Подробнее о том, как преобразовать приложение Google Chat в дополнение Google Workspace…
- Форматы запросов и ответов можно найти в раскрывающихся разделах Приложения для Chat, которые не являются дополнениями внизу каждого руководства по интерактивным функциям в этом наборе документации.