Auf dieser Seite werden die Schritte beschrieben, die zum Konfigurieren eines Google Cloud Projekts für die Telefonieintegration erforderlich sind.
Projekt auswählen oder erstellen Google Cloud
SIP-Trunks sind nur aus Kommunikationsgründen mit einem Projekt verbunden, ihre Auswirkungen sind jedoch nicht auf ein bestimmtes Projekt beschränkt.
Sie haben beispielsweise drei verschiedene Projekte (Entwicklung, Test, Produktion). Wenn derselbe SIP-Trunk für die gesamte SBC-zu-GTP-Kommunikation verwendet wird, ist nur die erste Anfrage zum Erstellen des SIP-Trunks erfolgreich. Die übrigen Anfragen zum Erstellen des SIP-Trunks in derselben Region/mit demselben Hostnamen schlagen fehl.
Wir empfehlen, ein anderes Projekt ausschließlich für die Verwaltung von SIP-Trunks zu verwenden. So kann ein anderes Team für die Trunks verantwortlich sein und in der Trunk-UI verschiedene Gruppen von SBCs für Entwicklung, Test und Produktion einrichten.
Wenn Sie Dienste von Google Cloudnutzen möchten, müssen Sie ein Projekt erstellen. In Projekten können Sie alle Ihre Google Cloud -Ressourcen organisieren. Ein Projekt umfasst Mitbearbeiter, aktivierte APIs (und andere Ressourcen), Monitoringtools, Zahlungsinformationen sowie Authentifizierungs- und Zugriffssteuerungen. Sie können wahlweise ein Projekt erstellen oder Ihre Google Cloud -Ressourcen durch Erstellen mehrerer Projekte in einer Ressourcenhierarchie organisieren. Notieren Sie sich beim Erstellen eines Projekts die Projekt-ID. Diese ID benötigen Sie für API-Aufrufe. Weitere Informationen zu Projekten finden Sie in der Dokumentation zu Resource Manager.
Wählen Sie in der Google Cloud Console auf der Seite für die Projektauswahl ein Projekt vonaus oder erstellen Sie eines Google Cloud .
Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind
- Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können ein beliebiges Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
-
Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“
(
roles/resourcemanager.projectCreator), die dieresourcemanager.projects.createBerechtigung enthält. Informationen zum Zuweisen von Rollen.
Berechtigungen
- Rufen Sie in der Google Cloud Console IAM & Verwaltung -> IAM auf.
- Wählen Sie entweder ein vorhandenes Dienstkonto aus oder erstellen Sie ein neues und weisen Sie ihm die Rolle
Dialogflow API Adminzu. Diese Rolle ist für die Telefonieintegration erforderlich.
API-Zugriff auf Telefonnummern
Für die Verwendung der API-Methoden für Telefonnummern ist ein spezieller Zugriff erforderlich. Weitere Informationen erhalten Sie von Ihrem Google-Ansprechpartner.
Dialogflow, Unterhaltungsprofil und Telefonnummer konfigurieren
In diesem Abschnitt wird beschrieben, wie Sie ein Unterhaltungsprofil für konversationelle KI mit einer zugehörigen Telefonnummer der Google Telephony Platform (GTP) erstellen.
- Rufen Sie Colab Enterprise auf. Aktivieren Sie bei Aufforderung die APIs Compute Engine, Dataform und Vertex .
- Klicken Sie auf Notebooks importieren und wählen Sie URL als Datenquelle aus. Geben Sie diese GitHub-Repository-URL ein, und klicken Sie auf IMPORT.
- Geben Sie im Feld
PROJECT_IDdie Google Cloud Projekt-ID für das Projekt ein, das Sie mit der Integration verknüpfen möchten. Ihre vorhandenen Projekte können im Drop-down-Menü oben auf der Seite in der Cloud Consolegefunden werden. - Geben Sie die gewünschte Region in das Feld
REGIONein. Alle Dialogflow-Regionen werden unterstützt. - Lassen Sie das Feld
JWTunverändert oder geben Sie hier IhrenJWT-Wert ein. Wenn Sie das Feld leer lassen, wird standardmäßig SSO verwendet. - Klicken Sie oben im Abschnitt Project auf die Schaltfläche „Wiedergabe“, um diesen Codeabschnitt auszuführen. Erlauben Sie bei Aufforderung, dass das Notebook auf Ihre Google-Anmeldedaten zugreift.
- Maximieren Sie den Abschnitt Configuring Conversational AI for SIP/SIPREC (Konversationelle KI für SIP/SIPREC konfigurieren). Klicken Sie unter Create a dummy Dialogflow ES agent... (Dialogflow ES-Dummy-Agent erstellen) auf Code anzeigen und führen Sie den Code ohne Änderungen aus. Dadurch wird ein Dialogflow ES-Dummy-Agent erstellt und seine Stufe auf „Enterprise“ festgelegt. Ein Dialogflow ES-Dummy-Agent ist erforderlich, um auf Dialogflow API-Endpunkte zuzugreifen. Jedes Google Cloud Projekt kann einen einzelnen Dialogflow ES-Agent haben.
- Maximieren Sie den Abschnitt Script to create a
ConversationProfile... (Skript zum Erstellen einesConversationProfile...), um den Code anzuzeigen.CONVERSATION_PROFILE_NAME: Kann eine beliebige String sein. Sie können den Standardwert verwenden oder einen eigenen eingeben.SECURITY_SETTINGS: Kann eine beliebige String sein. Sie können den Standardwert verwenden oder einen eigenen eingeben.PHONE_NUMBER_COUNTRY_CODE: Geben Sie die Ländervorwahl ein, die Sie mit Ihrer GTP-Telefonnummer verknüpfen möchten.CX_AGENT_NAME: Geben Sie den Namen des Dialogflow CX-Agenten ein, mit dem das generierte Unterhaltungsprofil verknüpft werden soll.
- Führen Sie den Code aus. Die Ausgabe enthält den Namen des generierten
ConversationProfile, die Sicherheitseinstellungen und die GTP-Telefonnummer. - Rufen Sie die Dialogflow ES-Konsole
auf, um zu prüfen, ob ein Agent mit dem Namen
Dummy_ES_agenterstellt wurde. Klicken Sie auf Einstellungen , um zu prüfen, ob der Agent mit dem richtigen Google Cloud Projekt verknüpft ist und auf die Essentials -Version aktualisiert wurde. - Öffnen Sie die
Agent Assist Console.
Klicken Sie im Menü auf der linken Seite auf Unterhaltungsprofile , um zu prüfen, ob ein Unterhaltungsprofil mit dem eingegebenen
CONVERSATION_PROFILE_NAMEerstellt wurde. - Rufen Sie die Konversationelle KI Insights-Konsole auf. Prüfen Sie, ob alle Unterhaltungstranskripte, die mit Ihrem Dialogflow CX-Agenten verknüpft sind, importiert wurden.
(Optional) Kontingenterhöhung für die Anruflänge des Dialogflow CX-Telefonie-Gateways beantragen
Dialogflow ES Essentials- und Dialogflow CX-Abos haben standardmäßig verfügbare Kontingente. Wenn Sie Dialogflow überhaupt nicht verwenden, sondern beispielsweise nur Agent Assist, Transkription oder Anrufaufzeichnung, entspricht Ihr Standardkontingent dem Kontingent von Dialogflow ES Essentials.
Sie können bei Bedarf eine Kontingenterhöhung beantragen, die auf Ihrem geschätzten Traffic basiert. In den meisten Anwendungsfällen reicht das Standardkontingent für die Einrichtung und Tests aus, für Laufzeitanwendungen ist jedoch eine Erhöhung erforderlich. Auf der Seite zu den Dialogflow-Kontingenten finden Sie Details zu den Kontingenten und eine Anleitung zum Beantragen einer Erhöhung.
(Optional) Audit-Logging für die Dialogflow API aktivieren
Sie können optional das Audit-Logging für die Dialogflow API (dialogflow.googleapis.com) für die Vorgänge „Admin Read“, „Data Read“ und „Data Write“ aktivieren. So können Sie alle einzelnen Aufrufe der konversationellen KI-API und die für die Autorisierung und Nutzung verwendeten Anmeldedaten sehen. Das kann bei der Fehlerbehebung und beim Debugging hilfreich sein.
Nächste Schritte
Informationen zum Einrichten und Konfigurieren eines SBC