Na tej stronie znajdziesz omówienie tworzenia interaktywnej aplikacji do Google Chat. Interaktywne aplikacje do czatu są tworzone jako dodatki do Google Workspace, które rozszerzają Google Chat.
Interaktywne aplikacje do Google Chat umożliwiają użytkownikom wykonywanie tych czynności:
- dodawać aplikacje do Google Chat do pokoi lub wiadomości bezpośrednich;
- Wysyłanie i odbieranie wiadomości z aplikacji do obsługi czatu, które zawierają tekst, karty i interaktywne elementy interfejsu.
- Wyświetlanie karty Strona główna aplikacji i wchodzenie z nią w interakcje na karcie Strona główna w wiadomościach prywatnych 1:1 z aplikacją do Google Chat.
- W aplikacjach do obsługi czatu możesz używać poleceń po ukośniku, szybkich poleceń lub działań na wiadomościach.
- wyświetlać podgląd linków z wiadomości na czacie w Google Chat i podejmować działania bez opuszczania rozmowy;
- przesyłać informacje do aplikacji do obsługi czatu, np. wpisywać tekst w oknie dialogowym lub wiadomości na karcie;
- Automatyzuj i wykonuj zadania w aplikacjach Google Workspace oraz łącz się z narzędziami i usługami zewnętrznymi.
Jak użytkownicy odkrywają i używają interaktywnych aplikacji do Google Chat
W Google Chat dodatki rozszerzające Google Chat są widoczne dla użytkowników jako aplikacje Google Chat. Użytkownicy mogą odkrywać i używać aplikacji do Google Chat opublikowanych w Marketplace na wiele sposobów, m.in.:
- Wyszukiwanie i instalowanie aplikacji do obsługi czatu w Google Chat lub Marketplace.
- wchodzić w interakcje z aplikacją do czatu dodaną do pokoju czatu;
- odkrywać aplikację do obsługi czatu w panelu czatu po tym, jak administrator Google Workspace zainstaluje ją w ich imieniu;
Aby zacząć korzystać z aplikacji Google Chat, użytkownicy Google Chat mogą rozpocząć czat z aplikacją lub dodać ją do pokoju. Użytkownicy mogą też dodać aplikację Chat, @wspominając ją. Więcej informacji znajdziesz w artykule Korzystanie z aplikacji Google Chat.
Poniższy przykład pokazuje, jak użytkownik @wzmiankuje aplikację do czatu, aby dodać ją do pokoju:
Rozpocznij
Aby rozpocząć tworzenie interaktywnej aplikacji do obsługi czatu, zapoznaj się z tą dokumentacją:
- Skonfiguruj interfejs Google Chat API i włącz funkcje interaktywne aplikacji do obsługi czatu.
- Dowiedz się, jak otrzymywać reakcje użytkowników i na nie odpowiadać za pomocą wyzwalaczy, obiektów zdarzeń i działań.
- Wypróbuj szybki start, aby utworzyć podstawową aplikację do Google Chat dla wybranej architektury aplikacji Google Chat.
Konfigurowanie i tworzenie podstawowej aplikacji do obsługi czatu
W tej tabeli znajdziesz dokumentację dotyczącą konfigurowania interfejsu Chat API i tworzenia podstawowej interaktywnej aplikacji do obsługi czatu dla każdej architektury aplikacji Google Chat:
| Architektura lub zadanie | Przewodnik |
|---|---|
| Konfigurowanie interfejsu Chat API | Konfigurowanie interfejsu Google Chat API |
| Krótkie wprowadzenia | |
| Google Apps Script | Tworzenie aplikacji Google Chat za pomocą Apps Script |
| Usługa HTTP (funkcje Cloud Run) | Tworzenie aplikacji do obsługi czatu HTTP |
| Pub/Sub | Tworzenie aplikacji Google Chat za pomocą Pub/Sub |
| Dialogflow CX | Tworzenie aplikacji do obsługi czatu w Dialogflow CX |
| Dialogflow ES | Tworzenie aplikacji do obsługi czatu w Dialogflow ES |
| Agent AI w pakiecie Agent Development Kit (ADK) | Tworzenie aplikacji do obsługi czatu z agentem AI ADK |
| Agent AI Agent2Agent (A2A) | Tworzenie aplikacji do Google Chat z agentem AI A2A |
| Agent AI A2UI | Tworzenie aplikacji Google Chat z agentem AI A2UI |
| Agent AI Gemini Enterprise | Tworzenie aplikacji Google Chat z agentem AI Gemini Enterprise |
Tworzenie funkcji interaktywnych
W tabeli poniżej znajdziesz dokumentację dotyczącą tworzenia interaktywnych funkcji aplikacji do obsługi czatu:
| Funkcja | Przewodnik |
|---|---|
| Otrzymywanie odpowiedzi na interakcje użytkowników | Otrzymywanie odpowiedzi na interakcje użytkowników |
| Wysyłanie wiadomości (odpowiadanie na interakcje lub wysyłanie wiadomości z własnej inicjatywy) | Odpowiedz wiadomością lub wyślij wiadomość za pomocą interfejsu Chat API. |
| Odpowiadanie na polecenia po ukośniku, szybkie polecenia i działania na wiadomościach | Odpowiadanie na polecenia |
| Tworzenie interaktywnych okien | Otwieranie interaktywnych okien |
| Zbieranie i przetwarzanie informacji z kart i okien dialogowych | Odczytywanie danych z formularza wprowadzonych przez użytkowników na kartach |
| Wyświetlanie podglądu linków w wiadomościach na Google Chat | Podgląd linków |
| Tworzenie strony głównej (strony aplikacji) na czatach 1:1 | Tworzenie strony głównej aplikacji Google Chat |
| Łączenie z systemami i narzędziami zewnętrznymi | Łączenie aplikacji Google Chat z innymi usługami i narzędziami |
Ograniczenia i kwestie do rozważenia dotyczące dodatków do Google Workspace
Aplikacje do Google Chat są tworzone jako dodatki do Google Workspace, które rozszerzają funkcje Google Chat. Pamiętaj o tych ograniczeniach:
- AppSheet Architektura aplikacji Google Chat jest niedostępna podczas tworzenia jako dodatek do Google Workspace. Zamiast tego utwórz aplikację do Google Chat za pomocą usługi HTTP, Apps Script, Dialogflow ES, Dialogflow CX lub Pub/Sub.
- Niestandardowe karty autoryzacji nie są obsługiwane w Google Chat. Aby uwierzytelnić usługę i przyznać jej autoryzację z poziomu Google Chat, aplikacja do Google Chat musi zwrócić podstawową kartę autoryzacji.
- Strony główne dodatków na pasku bocznym Google Chat nie są obsługiwane. Jeśli w pliku manifestu (
addons.common.homepageTrigger) skonfigurujesz wyzwalacz strony głównej, strona główna będzie się wyświetlać tylko na pasku bocznym innych aplikacji Google Workspace, które rozszerza Twój dodatek. Zamiast tego możesz utworzyć stronę główną aplikacji do Google Chat, która będzie wyświetlana na karcie Strona główna w wiadomościach prywatnych z aplikacją do Google Chat.
Jeśli rozszerzasz istniejący dodatek do Google Workspace, aby działał w Google Chat, weź pod uwagę te wymagania konfiguracyjne dotyczące aplikacji w Google Chat:
- Ustawienia instalacji Google Workspace Marketplace muszą zezwalać zarówno osobom, jak i administratorom Google Workspace na instalowanie dodatku.
- W Chat ignorowane są wszystkie ustawienia wspólnej konfiguracji w manifeście dodatku (
addons.common). Aby skonfigurować dodatek do pracy w Google Chat, musisz włączyć i skonfigurować interfejs Chat API. Instrukcje znajdziesz w artykule Konfigurowanie interfejsu Google Chat API. - Aby wdrożyć i przetestować dodatek w Google Chat, musisz użyć ustawienia Widoczność interfejsu Chat API. Wszelkie ustawienia widoczności lub testowania skonfigurowane w pakiecie SDK Google Workspace Marketplace są ignorowane. Aby wdrożyć testową wersję dodatku w Google Chat, zapoznaj się z artykułem Testowanie funkcji interaktywnych aplikacji Google Chat.
- Jeśli dodatek jest opublikowany w Google Workspace Marketplace, nie możesz zapisać wersji roboczej żadnych zmian w ustawieniach konfiguracji interfejsu Google Chat API. Gdy zaktualizujesz ustawienia konfiguracji interfejsu Chat API, zaktualizowana aplikacja w Google Chat będzie natychmiast dostępna dla wszystkich dotychczasowych użytkowników. Aby zaktualizować informacje o usłudze na platformie, możesz utworzyć wersję roboczą przed przesłaniem zmian.
Powiązane artykuły
- Omówienie dokumentacji interfejsu Google Chat API
- Otrzymywanie odpowiedzi na interakcje użytkowników
- Wybieranie architektury aplikacji Google Chat
- Wypróbuj przykład:
- Planowanie spotkań w Google Chat
- Integracja podstawowych koncepcji AI z aplikacjami Google Chat
- Planowanie podróży z pomocą agenta AI dostępnego w różnych usługach Google Workspace
- Tworzenie agentów Gemini Enterprise, którzy są ściśle zintegrowani z magazynami danych, interfejsami API i aplikacjami Google Chat
- Tworzenie agentów Vertex AI ściśle zintegrowanych z magazynami danych, interfejsami API i aplikacjami do obsługi czatu w Workspace
Aplikacje do obsługi czatu, które nie są dodatkami: tworzenie interaktywnej aplikacji Google Chat
Aplikacje do czatu, które nie są dodatkami do Google Workspace, są tworzone jako aplikacje tylko do czatu, które otrzymują zdarzenia interakcji interfejsu Chat API (Event) zamiast obiektów zdarzeń dodatku do Google Workspace (EventObject) i działań.
Jeśli utrzymujesz aplikację Google Chat, która nie jest dodatkiem, możesz:
- Przekonwertuj aplikację do czatu, która nie jest dodatkiem, na dodatek do Google Workspace rozszerzający Google Chat. Zobacz Przekształcanie aplikacji do Google Chat w dodatek do Google Workspace.
- Formaty żądań i odpowiedzi znajdziesz w rozwijanych sekcjach Aplikacje do czatowania, które nie są dodatkami u dołu każdego przewodnika po funkcjach interaktywnych w tym zestawie dokumentacji.