In dieser Anleitung erfahren Sie, wie Sie eine Google Chat-App erstellen, die in Echtzeit auf Vorfälle reagieren. Wenn die App auf einen Vorfall reagiert, erstellt und füllt einen Chatbereich, erleichtert Vorfälle. mit Meldungen, Slash-Befehlen und Dialogfeldern und nutzt KI für Zusammenfassungen die Reaktion auf Vorfälle in einem Google Docs-Dokument.
Ein Vorfall ist ein Ereignis, das die sofortige Aufmerksamkeit eines Teams erfordert. zu klären. Beispiele für Vorfälle:
- In einem CRM-System (Customer-Relationship-Management) wird eine zeitkritische Anfrage erstellt. Plattform, bei der ein Serviceteam zusammen an einer Lösung arbeiten muss.
- Ein System geht offline und eine Gruppe von Site Reliability Engineers (SREs) wird benachrichtigt damit sie es gemeinsam wieder online bringen können.
- Ein schweres Erdbeben ereignet sich und Rettungskräfte benötigen um die Reaktion zu koordinieren.
Im Rahmen dieser Anleitung wird die Vorfallbenachrichtigung gestartet, meldet den Vorfall mit einem Klick auf eine Schaltfläche auf einer Webseite. Die Webseite simuliert indem Sie die Nutzer auffordern, grundlegende Informationen zum Vorfall einzugeben: Titel, eine Beschreibung und die E-Mail-Adressen der Teilnehmer.
Sehen Sie sich die Chat-App für das Vorfallmanagement in Aktion an:
- <ph type="x-smartling-placeholder">
-
Abbildung 2: Benachrichtigung, dass der für den Vorfall vorbereitete Chatbereich erstellt wird. -
Abbildung 3: Der Chatbereich für die Reaktion auf Vorfälle. -
Abbildung 4: Vorfall mit einem Slash-Befehl beheben. -
Abbildung 5: Dialogfeld zur Behebung von Vorfällen. -
Abbildung 6: Google Docs-Dokument zur Behebung von Vorfällen, das im Gruppenbereich freigegeben ist. -
Abbildung 7: Das Google Docs-Dokument zur Zusammenfassung von KI-Vorfällen.
Vorbereitung
Wenn eine dieser Voraussetzungen für Ihre Organisation aktiviert sein muss, fragen Sie nach Ihren Google Workspace-Administrator, um sie zu aktivieren:
- Unternehmen Google Workspace-Konto mit Zugriff auf Google Chat:
- Muss Verzeichnis (Kontaktfreigabe) für Google Workspace aktiviert. Die Vorfall-App verwendet das Verzeichnis, um die Incident-Response-Experten nachzuschlagen, Kontaktdaten wie Name und E-Mail-Adresse. Die Incident-Response-Teams müssen Nutzer mit einem Google Chat-Konto sein in Ihrer Google Workspace-Organisation.
Zielsetzungen
- Chat-App erstellen, die auf Vorfälle reagiert
- So helfen Sie Nutzern, auf Vorfälle zu reagieren:
<ph type="x-smartling-placeholder">
- </ph>
- Erstellen von Antwortbereichen für Vorfälle
- Nachrichten mit einer Zusammenfassung der Vorfälle und Antworten posten
- Förderung der Zusammenarbeit durch interaktive Funktionen der Chat-App.
- Unterhaltungen und Lösungen mit Vertex AI zusammenfassen.
Architektur
Das folgende Diagramm zeigt die Architektur von Google Workspace und Von der Vorfallreaktion verwendete Google Cloud-Ressourcen Google Chat App.
Die Architektur zeigt, wie die Vorfallreaktion Die Google Chat App verarbeitet einen Vorfall und eine Lösung.
Ein Nutzer startet einen Vorfall über eine externe Website, die auf Apps Script.
Die Website sendet eine asynchrone HTTP-Anfrage an den Google Chat App, die auch in Apps Script gehostet wird.
Die Google Chat App verarbeitet die Anfrage:
Mit dem Apps Script Admin SDK-Dienst können Teammitglieder wie Nutzer-ID und E-Mail-Adresse.
Bei einer Reihe von HTTP-Anfragen an die Chat API über die „Apps Script Advanced Chat“, Incident Response Die Google Chat App erstellt einen Vorfall in Chat Gruppenbereich, füllt ihn mit Teammitgliedern und sendet eine Nachricht an den Gruppenbereich.
Teammitglieder besprechen den Vorfall im Chatbereich.
Ein Teammitglied ruft einen Slash-Befehl auf, um dem Vorfall.
HTTP-Aufruf an die Chat API mit dem Apps Script Der erweiterte Chat-Dienst listet alle Nachrichten des Gruppenbereichs.
Vertex AI empfängt die aufgeführten Nachrichten und generiert eine Zusammenfassung.
Der Apps Script-Dienst
DocumentApp
erstellt ein Docs-Dokument und fügt die Zusammenfassung von Vertex AI zum Dokument.Die Google Chat App-Aufrufe als Reaktion auf Vorfälle Chat API, um eine Nachricht mit einem Link zur Zusammenfassung zu senden Docs-Dokument.
Umgebung vorbereiten
In diesem Abschnitt erfahren Sie, wie Sie ein Google Cloud-Projekt für die Chat-App.
Google Cloud-Projekt erstellen
Google Cloud Console
- Öffnen Sie in der Google Cloud Console das Menü > IAM und Verwaltung > Projekt erstellen. .
-
Geben Sie im Feld Projektname einen aussagekräftigen Namen für Ihr Projekt ein.
Optional: Klicken Sie zum Bearbeiten der Projekt-ID auf Bearbeiten. Die Projekt-ID kann nicht geändert werden nachdem das Projekt erstellt wurde, wählen Sie also eine ID, die Ihren Anforderungen für die gesamte Lebensdauer des Projekt arbeiten.
- Klicken Sie im Feld Standort auf Durchsuchen, um die potenziellen Standorte für Ihr Projekt arbeiten. Klicken Sie danach auf Auswählen. <ph type="x-smartling-placeholder">
- Klicken Sie auf Erstellen. In der Google Cloud Console wird die Dashboard-Seite aufgerufen und Ihr Projekt wurde erstellt. innerhalb weniger Minuten.
gcloud-CLI
Greifen Sie in einer der folgenden Entwicklungsumgebungen auf die Google Cloud Befehlszeile („gcloud“):
-
Cloud Shell: Onlineterminal mit der gcloud CLI verwenden
aktivieren Sie Cloud Shell.
Cloud Shell aktivieren -
Lokale Shell: So verwenden Sie eine lokale Entwicklungsumgebung:
install und
Initialisieren
über die gcloud CLI.
Verwenden Sie den Befehl „gcloud projects create“, um ein Cloud-Projekt zu erstellen:gcloud projects create PROJECT_ID
Abrechnung für das Cloud-Projekt aktivieren
<ph type="x-smartling-placeholder">Google Cloud Console
- Gehen Sie in der Google Cloud Console zu Abrechnung. Klicken Sie auf Menü > Abrechnung > Meine Projekte.
- Wählen Sie unter Organisation auswählen die Organisation aus, die mit Ihr Google Cloud-Projekt.
- Öffnen Sie in der Projektzeile das Menü Aktionen. ( ), klicken Sie auf Abrechnung ändern und wählen Sie Cloud-Rechnungskonto.
- Klicken Sie auf Konto festlegen.
gcloud-CLI
- Führen Sie folgenden Befehl aus, um verfügbare Rechnungskonten aufzulisten:
gcloud billing accounts list
- Verknüpfen Sie ein Rechnungskonto mit einem Google Cloud-Projekt:
gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
Ersetzen Sie Folgendes:
PROJECT_ID
ist die Projekt-ID für das Cloud-Projekt, für das Sie die Abrechnung aktivieren möchten.BILLING_ACCOUNT_ID
ist die ID des Rechnungskontos, mit dem eine Verknüpfung hergestellt werden soll. des Google Cloud-Projekts.
APIs aktivieren
Google Cloud Console
Aktivieren Sie in der Google Cloud Console die Google Chat API, die Google Docs API, die Admin SDK API und die Vertex AI API.
Aktivieren Sie die APIs in den richtigen Cloud-Projekt ein und klicken Sie auf Weiter.
Aktivieren Sie die richtigen APIs und klicken Sie dann auf Aktivieren.
gcloud-CLI
Legen Sie bei Bedarf das aktuelle Cloud-Projekt auf das von Ihnen erstellte fest. mit dem Befehl
gcloud config set project
:gcloud config set project PROJECT_ID
Ersetzen Sie PROJECT_ID durch die Projekt-ID des Cloud-Projekt, das Sie erstellt haben.
Google Chat API, Google Docs API, Admin SDK API und Vertex AI API aktivieren mit dem Befehl
gcloud services enable
:gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com
Authentifizierung und Autorisierung einrichten
Durch Authentifizierung und Autorisierung kann das Zugriff auf Ressourcen der Chat-App in Google Workspace und Google Cloud, um eine Reaktion auf Vorfälle zu verarbeiten.
In dieser Anleitung veröffentlichen Sie die App intern, sodass Sie Platzhalter Informationen. Ersetzen Sie den Platzhalter, bevor Sie die App extern veröffentlichen. mit echten Informationen für den Zustimmungsbildschirm.
Gehen Sie in der Google Cloud Console zu Menü > APIs und Dienste > OAuth-Zustimmungsbildschirm.
Wählen Sie unter Nutzertyp die Option Intern aus und klicken Sie dann auf Erstellen.
Geben Sie unter App-Name
Incident Management
ein.Wählen Sie unter Nutzer-Support-E-Mail Ihre E-Mail-Adresse oder eine geeignete Google-Gruppe.
Geben Sie unter Kontaktdaten des Entwicklers Ihre E-Mail-Adresse ein.
Klicken Sie auf Speichern und fortfahren.
Klicken Sie auf Bereiche hinzufügen oder entfernen. Ein Steuerfeld mit einer Liste der Bereiche wird angezeigt für jede API, die Sie in Ihrem Cloud-Projekt aktiviert haben.
Fügen Sie unter Bereiche manuell hinzufügen die folgenden Bereiche ein:
https://www.googleapis.com/auth/chat.spaces.create
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/script.external_request
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/cloud-platform
Klicken Sie auf Zu Tabelle hinzufügen.
Klicken Sie auf Aktualisieren.
Klicken Sie auf Speichern und fortfahren.
Sehen Sie sich die Zusammenfassung der App-Registrierung an und klicken Sie dann auf Zurück zum Dashboard.
Chat-App erstellen und bereitstellen
Im folgenden Abschnitt kopieren und aktualisieren Sie Apps Script-Projekt, das alle erforderlichen Anwendungen enthält Code für Ihre Chat-App ändern. Sie müssen den Code also nicht fügen Sie jede Datei ein.
Einige Funktionen stehen mit Unterstrichen am Ende des Namens, z. B.:
processSlashCommand_()
von ChatApp.gs
. Mit dem Unterstrich wird die Funktion
von der Webseite zur Initialisierung des Vorfalls ein, wenn diese in einem Browser geöffnet ist. Weitere Informationen
finden Sie unter
Private Funktionen:
Apps Script unterstützt zwei Dateitypen: .gs
-Scripts und .html
-Dateien. Zur Erfüllung dieser Unterstützung ist das clientseitige JavaScript der App enthalten
innerhalb von <script />
-Tags und der zugehörige CSS-Code innerhalb von <style />
-Tags innerhalb
eine HTML-Datei.
Optional können Sie das gesamte Projekt auf GitHub ansehen.
Hier ein Überblick über die einzelnen Dateien:
Consts.gs
Definiert Konstanten, auf die von anderen Codedateien verwiesen wird, einschließlich der Cloud-Projekt-ID, der Vertex AI-Standort-ID und der Slash-Befehls-ID zum Schließen eines Vorfalls.
Consts.gs
-Code ansehenChatApp.gs
Verarbeitet Chat-Interaktionsereignisse, darunter: Nachrichten, Klicks auf Karten, Slash-Befehle und Dialogfelder. Reagiert auf den Slash-Befehl
/closeIncident
durch Öffnen eines Dialogfelds zum Erfassen des Vorfalls Details zur Lösung des Problems. Nachrichten im Gruppenbereich durch Aufrufen derspaces.messages.list
-Methode in der Chat API. Ruft Nutzer-IDs über den Admin SDK Directory-Dienst in Apps Script.ChatApp.gs
-Code ansehenChatSpaceCreator.gs
Erhält Formulardaten, die Nutzer bei dem Vorfall eingeben Initialisierungswebseite zum Einrichten einer Chat-Nachricht indem Sie ihn erstellen und ausfüllen, und anschließend eine Nachricht zur Vorfall.
ChatSpaceCreator.gs
-Code ansehenDocsApi.gs
Ruft das Google Docs-API auf, um ein Google Docs-Dokument in einem eine Zusammenfassung der Informationen zum Vorfall erstellt, in
VertexAiApi.gs
erstellt, in das Dokument.DocsApi.gs
-Code ansehenVertexAiApi.gs
Fasst die Unterhaltung im Chat zusammen mit Vertex AI. Diese Zusammenfassung wird in einem eigens erstellten Dokument in
DocsAPI.gs
.VertexAiApi.gs
-Code ansehenWebController.gs
Bedient die Website zur Initialisierung der Vorfälle.
WebController.gs
-Code ansehenIndex.html
Der HTML-Code, in dem die Website zur Initialisierung des Vorfalls verwendet wird
Index.html
-Code ansehenJavaScript.html
Verarbeitet Formularverhalten, einschließlich Senden, Fehler und Löschungen für die Website zur Initialisierung des Vorfalls. Inbegriffen durch die benutzerdefinierte
include
-Funktion inWebController.gs
inIndex.html
.JavaScript.html
-Code ansehenStylesheet.html
Das CSS für die Website zur Initialisierung des Vorfalls. Es ist durch die benutzerdefinierte Funktion
include
inIndex.html
aufgenommenWebController.gs
Stylesheet.html
-Code ansehen
Nummer und ID Ihres Cloud-Projekts ermitteln
Rufen Sie in der Google Cloud Console Ihr Cloud-Projekt auf.
Klicke auf Einstellungen und Dienstprogramme. > Projekteinstellungen.
Notieren Sie sich die Werte in den Feldern Projektnummer und Projekt-ID. Ich in den folgenden Abschnitten.
Apps Script-Projekt erstellen
Um ein Apps Script-Projekt zu erstellen und mit Ihrem Cloud-Projekt:
- Klicken Sie auf die folgende Schaltfläche, um das Apps Script-Projekt Mit Google Chat auf Vorfälle reagieren zu öffnen.
Projekt öffnen - Klicken Sie auf Übersicht.
- Klicken Sie auf der Übersichtsseite auf Kopie erstellen.
Benennen Sie Ihre Kopie des Apps Script-Projekts:
Klicken Sie auf Kopie von „Mit Google Chat auf Vorfälle reagieren“.
Geben Sie unter Projekttitel
Incident Management Chat app
ein.Klicken Sie auf Umbenennen.
Gehen Sie in Ihrer Kopie des Apps Script-Projekts zum
Consts.gs
und ersetzen SieYOUR_PROJECT_ID
durch die ID Ihres Cloud-Projekt
Cloud-Projekt des Apps Script-Projekts festlegen
- In Ihrem Apps Script-Projekt Klicken Sie auf Projekteinstellungen.
- Klicken Sie unter Google Cloud Platform-Projekt (GCP-Projekt) auf Projekt ändern.
- Fügen Sie unter GCP-Projektnummer die Projektnummer Ihres Cloud-Projekts ein.
- Klicken Sie auf Projekt festlegen. Cloud-Projekt und Apps Script sind jetzt verbunden.
Apps Script-Bereitstellung erstellen
Jetzt, wo der gesamte Code vorhanden ist, können Sie das Apps Script bereitstellen. Projekt arbeiten. Mit der Bereitstellungs-ID konfigurieren Sie die Chat-App in Google Cloud
Öffnen Sie in Apps Script das Projekt der App zur Reaktion auf Vorfälle.
Klicken Sie auf Bereitstellen > Neue Bereitstellung.
Wenn Add-on und Web-App noch nicht ausgewählt sind, klicken Sie neben Wählen Sie den Typ aus, klicken Sie auf die Bereitstellungstypen und wählen Sie dann Add-on und Web-App aus.
Geben Sie unter Beschreibung eine Beschreibung für die Version ein, z. B.
Complete version of incident management app
Wählen Sie unter Ausführen als die Option Nutzer, der auf die Web-App zugreift aus.
Wählen Sie unter Wer hat Zugriff? die Option Jeder in meiner Workspace-Organisation aus. Dabei gilt: „Meine Workspace-Organisation“ ist der Name Ihres Google Workspace-Organisation.
Klicken Sie auf Bereitstellen. Apps Script-Berichte erfolgreich Bereitstellung und stellt eine Bereitstellungs-ID und eine URL für den Vorfall bereit Initialisierungswebseite.
Notieren Sie sich die URL der Web-App. Diese rufen Sie später auf, wenn Sie einen Vorfall starten. Kopieren Sie die Bereitstellungs-ID. Sie verwenden diese ID bei der Konfiguration des Chat-App in der Google Cloud Console
Klicken Sie auf Fertig.
Chat-App in der Google Cloud Console konfigurieren
In diesem Abschnitt erfahren Sie, wie Sie die Google Chat API in der Google Cloud Console konfigurieren mit Informationen zu Ihrer Chat-App, einschließlich der ID der Bereitstellung, die Sie gerade aus Ihrem Apps Script erstellt haben Projekt arbeiten.
Klicken Sie in der Google Cloud Console auf das Dreistrich-Menü. > Weitere Produkte > Google Workspace > Produktbibliothek > Google Chat API > Verwalten > Konfiguration.
Geben Sie unter App-Name
Incident Management
ein.Geben Sie unter Avatar-URL
https://developers.google.com/chat/images/quickstart-app-avatar.png
ein.Geben Sie unter Beschreibung
Responds to incidents.
ein.Stellen Sie die Ein/Aus-Schaltfläche Interaktive Funktionen aktivieren auf „Ein“.
Wählen Sie unter Funktionen die Option 1:1-Nachrichten empfangen und Gruppenbereichen und Gruppenunterhaltungen beitreten aus.
Wählen Sie unter Verbindungseinstellungen die Option Apps Script-Projekt aus.
Fügen Sie unter Deployment ID (Bereitstellungs-ID) die Deployment-ID für Apps Script ein. die Sie zuvor aus dem Apps Script-Projekt kopiert haben, Bereitstellung.
Registrieren Sie einen Slash-Befehl, die vollständig implementierte Chat-App nutzt:
Klicken Sie unter Slash-Befehle auf Slash-Befehl hinzufügen.
Geben Sie unter Name den Wert
/closeIncident
ein.Geben Sie unter Befehls-ID
1
ein.Geben Sie unter Beschreibung
Closes the incident being discussed in the space.
Wählen Sie Öffnet ein Dialogfeld aus.
Klicken Sie auf Fertig. Der Slash-Befehl wird registriert und aufgeführt.
Wähle unter Sichtbarkeit die Option Diese Chat-App für bestimmte Personen und Gruppen in Ihrem Workspace Domain und geben Sie Ihre E-Mail-Adresse ein.
Wählen Sie unter Logs die Option Fehler in Logging protokollieren aus.
Klicken Sie auf Speichern. Eine Meldung, dass die Konfiguration gespeichert ist, wird angezeigt, was bedeutet, dass die App testen können.
Chat App testen
Um die Chat-App für das Vorfallmanagement zu testen, initiieren Sie eine den Vorfall über die Webseite und vergewissern Sie sich, dass die Chat-App wie erwartet funktioniert:
Rufen Sie die Webanwendungs-URL für die Apps Script-Bereitstellung auf.
Wenn Apps Script Sie um Zugriff auf Ihre Daten bittet, Klicken Sie auf Berechtigungen prüfen und melden Sie sich mit einem geeigneten Google-Konto an. in Ihrer Google Workspace-Domain auf und klicken Sie auf Zulassen.
Die Webseite zur Initialisierung des Vorfalls wird geöffnet. Testinformationen eingeben:
- Geben Sie unter Titel des Vorfalls
The First Incident
ein. - Optional: Geben Sie unter Incident Responseers (Incident-Response-Teams) die E-Mail-Adressen der folgenden Personen ein: anderen Incident-Response-Teams nachzuvollziehen. Sie müssen Nutzer mit einer Google Chat-Konto in Ihrer Google Workspace-Organisation oder Fehler beim Erstellen des Gruppenbereichs. Geben Sie nicht Ihre eigene E-Mail-Adresse ein, automatisch eingeschlossen.
- Geben Sie unter Erste Nachricht
Testing the incident management Chat app.
ein.
- Geben Sie unter Titel des Vorfalls
Klicken Sie auf Chatbereich erstellen. Die Meldung „
creating space
“ wird angezeigt.Nachdem der Gruppenbereich erstellt wurde, wird die Meldung
Space created!
angezeigt. Klicken Sie auf Gruppenbereich öffnen: Der Gruppenbereich wird in Google Chat in einem neuen Tab geöffnet.Optional können Sie und die anderen Incident-Response-Teams Nachrichten im Leerzeichen. Die Anwendung fasst diese Nachrichten mit Vertex AI zusammen und gibt Retrospektive dokumentieren können.
Um die Reaktion auf Vorfälle zu beenden und den Lösungsprozess zu starten, klicken Sie in der Chatbereich, geben Sie „
/closeIncident
“ ein. Vorfallmanagement wird geöffnet.Geben Sie unter Vorfall schließen eine Beschreibung für die Lösung des Vorfalls ein. wie
Test complete
.Klicken Sie auf Vorfall schließen.
Die App „Vorfallmanagement“ listet die Nachrichten im Gruppenbereich auf und fasst sie zusammen mit Vertex AI, fügt die Zusammenfassung in ein Google Docs-Dokument ein und gibt im Projektbereich.
Bereinigen
Um zu vermeiden, dass Ihrem Google Cloud-Konto Gebühren für Ressourcen, die in dieser Anleitung verwendet werden, empfehlen wir, dass Sie den Cloud-Projekt
-
Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten. Klicken Sie auf
Menü > IAM und Verwaltung
> Ressourcen verwalten.
<ph type="x-smartling-placeholder"></ph> Zu Resource Manager
- Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie auf löschen.
- Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie zum Löschen auf Beenden. für das Projekt.
Weitere Informationen
- Mit der Gemini AI Chat App Fragen zu Chat-Unterhaltungen beantworten
- Projekte mit Google Chat, Vertex AI und Firestore verwalten
- Die Anwendung für die Vorfallreaktion authentifiziert sich mit Nutzeranmeldedaten, um APIs aufzurufen.
und Google Cloud-Dienste wie Chat API und Vertex AI API aufrufen.
Das bedeutet, dass der Nutzer, der einen Vorfall initialisiert,
Dienstleistungen. Rufen Sie die Vertex AI API auf, um die Anwendung robuster zu machen
als Dienstkonto anstelle der Nutzeranmeldedaten des Nutzers, der
den Slash-Befehl
/closeIncident
. Hilfe beim Konfigurieren eines Dienstkontos für die Vertex AI API finden Sie unter Benutzerdefiniertes Dienstkonto verwenden