Service bestellen und Instanz bereitstellen
Um Oracle Digital Assistant für Ihr Team einzurichten, bestellen Sie den Service, erteilen Sie den Benutzern die entsprechenden Berechtigungen, und stellen Sie die Instanz durch Provisioning bereit.
Produkttypen von Digital Assistant
Oracle Digital Assistant ist über verschiedene Preis- und Abonnementmodelle verfügbar. Wie Sie die Instanz einrichten, hängt davon ab, welches dieser Modelle Sie beim Bestellen des Service auswählen.
Die Preismodelle sind in die folgenden allgemeinen Typen unterteilt:
- Einzelservice. Wenn Sie Digital Assistant als Einzelservice bestellen, führen Sie das Provisioning dieser Instanzen in der Regel selbst durch.
Die Instanz-URLs für diesen Servicetyp beginnen mit
oda-****
. - Gepaart mit Fusion-basierten Cloud-Anwendungen. Sie können Digital Assistant auf diese Weise erhalten, wenn Sie Fusion-basierte Oracle Applications Cloud-Services (wie Sales Cloud oder HCM Cloud) nutzen.
Die Instanz-URLs für diesen Servicetyp beginnen mit
idcs-oda-****
.Wenn Sie ODA auf diese Weise beziehen, wird das Provisioning automatisch für Sie durchgeführt. Sie erteilen Teammitgliedern Zugriff auf die Instanz in der OCI IAM-Identitätsdomainanwendung für die Instanz. Siehe Oracle Fusion Cloud Applications und Digital Assistant.
Diese Art von Digital Assistant-Bestellung wurde speziell dafür entwickelt, dass Sie Out-of-the-box-Skills nutzen können, die von Fusion-basierten Oracle Applications Cloud-Services bereitgestellt werden. Diese Fähigkeiten können wie besehen ohne zusätzliche Lizenzierung verwendet werden.
Wenn Sie diese Out-of-the-box-Skills auch erweitern, benutzerdefinierte Skills erstellen oder mit anderen Backends als dem Service integrieren möchten, an den die Out-of-the-box-Skills gebunden sind, müssen Sie eine separate Berechtigungslizenz erwerben. Folgende Lizenztypen sind verfügbar:
- SaaS: ODAP4SaaS
- B91939 - Gehosteter Mitarbeiter
- B91938 - Gehosteter benannter Benutzer
- B91940 - 1.000 Sessions
Hinweis
Für diese Abonnementtypen muss keine zusätzliche Digital Assistant-Instanz bereitgestellt werden. Die Berechtigung wird aktiviert, wenn das Abonnement im selben Mandanten wie der Fusion-basierte Oracle Applications Cloud-Service aktiviert wird. Die gesamte Entwicklung erfolgt auf der gepaarten ODA-Instanz - PaaS: ODAP4PaaS
- B90260 Oracle Digital Assistant Cloud Service unter UCM (Universal Credit)
Hinweis
Für diesen Berechtigungstyp ist eine Digital Assistant-Instanz erforderlich, die im Mandanten PaaS bereitgestellt ist. Diese Instanz wird dann mit dem Mandanten SaaS "verknüpft". Zur Durchführung der Verknüpfung kann eine Serviceanfrage eingereicht werden. Wenn Sie bereits eine PaaS ODA-Instanz haben, müssen Sie diese SKU nicht erwerben. Sie können diese Instanz einfach für die Berechtigung verknüpfen. Es gibt keinen technischen Unterschied zwischen der ODA-Berechtigung, die für SaaS und PaaS (unter UC) verfügbar ist - sie sind im Wesentlichen derselbe Service. Der Unterschied liegt im Abonnement - Preis und Metriken (z.B. Sessions vs. Anforderung).
- SaaS: ODAP4SaaS
Oracle Digital Assistant bestellen
Sie können den Oracle Digital Assistant über eines der Folgenden Verfahren bestellen:
- Navigieren Sie zu https://www.oracle.com/application-development/cloud-services/digital-assistant/, und klicken Sie auf Jetzt kaufen.
- Wenden Sie sich an Ihren zuständigen Oracle-Vertriebsmitarbeiter.
Nachdem Sie eine Bestellung für Oracle Digital Assistant als Einzelservice aufgegeben haben, erhalten Sie eine E-Mail mit Anweisungen für den Zugriff auf Ihren Cloud-Account mit einem temporären Kennwort. Nachdem Sie sich mit diesem Kennwort angemeldet haben, werden Sie zur Eingabe eines neuen Kennworts aufgefordert. Danach können Sie die Benutzer einrichten und Ihre Instanz durch Provisioning bereitstellen.
Abonnement eines digitalen Assistenten aktivieren
Wenn Sie Oracle Digital Assistant Platform for SaaS abonniert haben, erhalten Sie eine E-Mail, in der Sie zur Aktivierung des Abonnements aufgefordert werden. Aktivieren Sie das Konto gemäß den Anweisungen in der E-Mail.
-
Wenn Sie ein Oracle Digital Assistant Platform for SaaS-Abonnement zur Verwendung mit einer Digital Assistant-Instanz erworben haben, die für Sie als Teil eines Fusion-basierten Oracle Applications Cloud-Serviceabonnements bereitgestellt wurde, aktivieren Sie das neue Digital Assistant-Abonnement in demselben Mandanten, in dem Sie den Oracle Applications Cloud-Service haben.
Nachdem Sie das Abonnement in demselben Mandanten wie Ihr Oracle Applications Cloud-Service aktiviert haben, erhalten Sie die Berechtigungen zur Nutzung der vollständigen Digital Assistant-Funktionalität in Ihren vorab bereitgestellten Instanzen. Sie müssen keine separaten Instanzen bereitstellen, um diese Berechtigungen zu erhalten. Sie können einfach die Instanzen verwenden, die bereits für Sie bereitgestellt wurden.
-
Wenn Sie ein Oracle Digital Assistant Platform for SaaS-Abonnement erworben haben, es aber nicht mit einer anderen Digital Assistant-Instanz verknüpfen:
- Aktivieren Sie das Abonnement gemäß den Anweisungen in der Aktivierungs-E-Mail.
- Richten Sie Ihre Digital Assistant-Instanz (oder -Instanzen) wie in den folgenden Themen beschrieben ein.
Wenn Sie für die Nutzung von Digital Assistant über Universal Credits bezahlen (anstelle eines Abonnements), gibt es keinen Aktivierungsschritt.
Digital Assistant als Einzelservice einrichten
Um eine Einzelinstanz von Oracle Digital Assistant einzurichten (also eine Instanz, die nicht mit einer Bestellung von Oracle Cloud Applications gepaart und daher nicht automatisch für Sie bereitgestellt wird), müssen Sie zur Oracle Cloud Infrastructure-Konsole gehen und folgende Aktionen ausführen:
- Richten Sie ein Compartment für den digitalen Assistenten in Ihrem Mandanten ein.
- Richten Sie Benutzer und Gruppen für die Benutzer ein.
- Richten Sie Policys ein, die die Berechtigungen für die Benutzergruppen bestimmen.
- Stellen Sie die Instanz bereit.
Wenn Sie das Compartment, die Benutzer, die Gruppen und die Policys noch nicht eingerichtet haben, finden Sie die Informationen dazu unter Benutzer, Gruppen und Policys. Wenn Sie eine Instanz schnell hochfahren und ausführen und ein grundlegendes Set von Benutzerberechtigungen konfigurieren möchten, können Sie dieses Rezept für Schnelleinrichtung und Provisioning befolgen.
Nachdem Sie diese Schritte abgeschlossen haben, können Sie mit dem Provisioning der Instanz fortfahren, wie im nächsten Thema beschrieben.
Wenn Sie Oracle Digital Assistant Platform for SaaS abonniert haben und dieses Abonnement mit einer Digital Assistant-Instanz verknüpft wurde, die als Teil eines Fusion-basierten Oracle Applications Cloud-Serviceabonnements für Sie bereitgestellt wurde, müssen Sie die Oracle Digital Assistant Platform for SaaS-Instanz nicht bereitstellen. In der Tat ist es am einfachsten, wenn Sie Ihre Digital Assistant-Entwicklungsarbeit in der Instanz ausführen, die für Sie bereitgestellt wurde.
Oracle Digital Assistant-Serviceinstanz erstellen
- Melden Sie sich bei Ihrem Oracle Cloud-Account an.
- Klicken Sie in der Infrastructure-Konsole oben links auf
, um das Navigationsmenü zu öffnen, und wählen Sie Analysen und KI und dann Digital Assistant aus (wird auf der Seite unter der Kategorie KI-Services angezeigt).
- Wählen Sie im Bereich Compartments ein Compartment aus.
Wenn Sie noch kein Compartment erstellt haben, finden Sie weitere Informationen unter Compartments und Compartments verwalten.
- Klicken Sie auf Digital Assistant-Instanz erstellen.
- Füllen Sie auf der Seite Digital Assistant-Instanz erstellen die folgenden Details aus:
- Compartment.
-
Name. Geben Sie einen Namen ein, der die Verwendung der Instanz widerspiegelt. Beispiel: Für eine Entwicklungsumgebung können Sie oda-dev1 verwenden.
-
Instanzausprägung. Wählen Sie eine der folgenden Ausprägungen aus:
- Entwicklung. Dies ist eine einfach implementierbare Option, die auf Entwicklungsarbeit ausgerichtet ist.
- Produktion. Diese Option sollte für Produktionsinstanzen von Digital Assistant ausgewählt werden. Im Vergleich zur Entwicklungsausprägung verfügt diese Option über höhere Ratenlimits und eine größere Datenbankkapazität, wodurch mehr Insight-Daten erfasst werden können.
Informationen über die Ratenlimits finden Sie unter Instanzausprägungen und Ratenlimits.
- Wenn Sie den rollenbasierten Zugriff auf die Instanz aktivieren möchten (anstelle des standardmäßigen policy-basierten Zugriffs von IAM), klicken Sie auf Erweiterte Optionen anzeigen, wählen Sie Rollenbasierten Zugriff aktivieren aus, und wählen Sie eine Identitätsdomain aus.
Informationen zum Einrichten von Benutzern und Gruppen sowie zum Zuweisen von Rollen finden Sie unter Rollenbasierter Zugriff und Identitätsdomains.
Hinweis
Die Option "Rollenbasierten Zugriff aktivieren" ist deaktiviert, wenn der aktuelle Mandant noch keine Unterstützung für Identitätsdomains aufweist. -
Tag-Namespace. (Optional) Weitere Informationen dazu finden Sie unter Tags und Tag-Namespaces verwalten.
- Klicken Sie auf Erstellen.
Nach einigen Minuten wechselt Ihre Instanz vom Status Wird erstellt in Aktiv. Das bedeutet, dass die Instanz einsatzbereit ist.
Wenn das Provisioning der Instanz nicht erfolgreich verläuft, könnte dies darauf zurückzuführen sein, dass Sie das Servicelimit für Digital Assistant-Instanzen in Ihrem Account erreicht haben. Eine Erläuterung der Servicelimits und der Möglichkeit, ein höheres Limit zu beantragen, finden Sie unter Servicelimits.
Über die Infrastructure-Konsole auf die Serviceinstanz zugreifen
Nachdem Sie eine Instanz bereitgestellt haben, können Sie wie folgt über die Infrastructure-Konsole darauf zugreifen:
-
Klicken Sie auf der Konsolenseite für die Instanz auf die Schaltfläche Servicekonsole.
Sie werden zu einer anderen Anmeldeseite umgeleitet.
-
Klicken Sie auf den Link Mandanten ändern.
-
Geben Sie im Feld Cloud-Mandant den Wert des Feldes Cloud-Account aus dem Abschnitt "Zugriffsdetails" Ihrer Willkommens-E-Mail ein.
-
Melden Sie sich bei der Instanz an.
Als Mandantenadministrator können Sie sich immer mit Ihren Single-Sign-On-Zugangsdaten anmelden (links auf der Seite).
Alle Benutzer, die mit IAM-Benutzeraccounts bereitgestellt wurden, können sich auf der rechten Seite anmelden.
Nachdem Sie sich angemeldet haben, werden Sie zu Ihrer Oracle Digital Assistant-Serviceinstanz weitergeleitet.
Hinweis
Wenn Ihr neues Kennwort nicht funktioniert, ist es möglicherweise noch nicht wirksam. Geben Sie in diesem Fall das temporäre Kennwort ein, das Sie in Ihrer Willkommens-E-Mail erhalten haben.
Serviceinstanz-URL abrufen
Sie können die URL für Ihre Serviceinstanz auf der Konsolenseite für die Instanz abrufen. Dann müssen Sie diese URL an Ihr Team weitergeben, da die Mitglieder ansonsten nicht benachrichtigt werden, selbst wenn ihnen Berechtigungen für Digital Assistant erteilt wurden.
-
Klicken Sie auf der Registerkarte "Instanzinformationen" auf den Link Kopieren rechts neben dem Feld Basisweb-URL.
Dadurch wird die URL in die Zwischenablage des Systems kopiert.
-
Fügen Sie die URL an einer geeigneten Stelle ein.
-
Teilen Sie diese URL mit Mitgliedern Ihres Teams.
Servicelimits
Oracle Digital Assistant verfügt über Limits für die Anzahl der Instanzen und eingebetteten benutzerdefinierten Komponentenservices, die Sie erstellen können. Wenn Sie eine neue Instanz oder einen eingebetteten benutzerdefinierten Komponentenservice erstellen, stellt das System sicher, dass Ihre Anforderung innerhalb des Limits liegt.
Bei Instanzen hängt das Limit davon ab, auf welche Weise Sie Digital Assistant bestellt haben:
Ressourcenlimit | Kurzname für Limit | Limit | Beschreibung |
---|---|---|---|
Anzahl Digital Assistant-Instanzen | instance-count | (In der Infrastructure-Konsole anzeigen) | Maximale Anzahl von Oracle Digital Assistant-Instanzen. |
Anzahl eingebettete benutzerdefinierte Komponentenservices | embedded-custom-component-service-count | (In der Infrastructure-Konsole anzeigen) | Limit pro Instanz auf eingebetteten Containerservices, die Sie für das Hosten benutzerdefinierter Komponenten erstellen können. |
Anzahl private Endpunkte | Private-Endpoint-Anzahl | (In der Infrastructure-Konsole anzeigen) | Limit pro Account privater Endpunkte. |
Servicelimits in der Infrastructure-Konsole anzeigen
So zeigen Sie Ihre aktuellen Servicelimits an:
- Klicken Sie in der Infrastructure-Konsole oben links auf
, um das Navigationsmenü zu öffnen, und wählen Sie Governance und Administration und dann Limits, Quota und Nutzung aus (wird auf der Seite unter der Kategorie Governance angezeigt).
- Wählen Sie in der Dropdown-Liste Service die Option Digital Assistant aus.
Wenn das Limit zu niedrig für Ihren Bedarf ist, können Sie eine Erhöhung beantragen. Siehe Erhöhung des Servicelimits beantragen.
Service-Quota
Mit Quota können Sie bestimmen, wie andere Benutzer Ressourcen über Compartments in Oracle Cloud Infrastructure verteilen. Wenn Sie eine Oracle Digital Assistant-Instanz erstellen oder vertikal skalieren, muss Ihre Anforderung innerhalb der vorgegebenen Quota für das Compartment liegen.
Weitere Informationen zur Funktionsweise von Quota finden Sie unter Compartment Quota.
In dieser Tabelle wird die Digital Assistant-Quota angezeigt, die Sie für Compartments anwenden können
Quota-Name | Geltungsbereich | Beschreibung |
---|---|---|
instance-count | Regional | Maximale Anzahl von Oracle Digital Assistant-Instanzen für das Compartment. |
Beispiel-Quota Policy für Oracle Digital Assistant
Beispiel für eine Quota-Anweisung:
Set digital-assistant quota instance-count to 3 in compartment MyCompartment
In diesem Beispiel ist die Anzahl der Oracle Digital Assistant-Instanzen, die im Compartment MyCompartment
bereitgestellt werden können, auf 3 begrenzt.
Instanzausprägungen und Limits für Rate und Speicher
Die Anzahl der Anforderungen pro Minute, die an Ihre Instanz gesendet werden können, hängt von der Ausprägung der Instanz ab:
- Entwicklungsausprägung: 50 Anforderungen pro Minute
- Produktionsausprägung: 500 Anforderungen pro Minute
Diese Limits gelten für Anforderungen von Benutzerkanälen (wie Slack, Microsoft Teams, Web, Twilio, Webhook usw.).
Bei Anforderungen, die nach Erreichen des Ratenlimits auftreten, wird eine HTTP 429-Antwort (Zu viele Anforderungen) zurückgegeben.
Darüber hinaus hängt die für Insights-Daten zugewiesene Speichermenge von der Instanzausprägung ab:
- Entwicklungsausprägung: 40 GB
- Produktionsform: 100 GB
Rezept für Schnelleinrichtung und Provisioning
Wenn Sie Ihre Instanz für Ihre Benutzer einrichten, sollten Sie sorgfältig planen, wie Sie Ihren Mandanten organisieren und Ihre Benutzergruppen und Policys erstellen. Wenn Sie jedoch schnell eine Instanz einrichten möchten, bevor Sie mit diesen Konzepten vollständig vertraut sind, können Sie das folgende "Rezept" befolgen.
In diesem Rezept richten Sie neben dem Provisioning der Instanz Berechtigungen für Entwickler und Administratoren mit dem Identity and Access Management-(IAM-)Service von Oracle Cloud Infrastructure ein. Sie können das Rezept später an Ihre eigenen Anforderungen anpassen.
-
Erstellen Sie ein Compartment für Ihre Instanz.
Compartments bieten logische Gruppierungen von Serviceinstanzen und anderen Cloud-Ressourcen. Wenn Sie ein Compartment für Ihre Instanz erstellen, können Sie Benutzerberechtigungen für die Instanz erteilen, ohne diese Berechtigungen dem gesamten Mandanten zu erteilen.
-
Klicken Sie in der Infrastructure-Konsole oben links auf
, um das Navigationsmenü zu öffnen, und wählen Sie Identität und Sicherheit und dann Compartments aus.
- Klicken Sie auf Compartment erstellen.
- Geben Sie im Feld Name
da_development
ein.Sie können gegebenenfalls einen anderen Namen auswählen. In dem Fall müssen Sie die unten aufgeführten Policy-Definitionen entsprechend anpassen.
- Füllen Sie die restlichen erforderlichen Werte aus, und klicken Sie auf Compartment erstellen.
-
-
Erstellen Sie IAM-Benutzeraccounts für alle anderen Teammitglieder, die Zugriff auf die Instanz erhalten sollen.
-
Klicken Sie auf der Seite Identität und Sicherheit unter dem Abschnitt Identität auf Benutzer.
-
Klicken Sie auf Benutzer erstellen.
-
Geben Sie im Dialogfeld Benutzer erstellen die erforderlichen Details ein. Achten Sie dabei besonders auf Folgendes:
- Der Wert unter Name kann eine E-Mail-Adresse oder ein eindeutiger Name sein. Mit diesem Namen meldet sich der Benutzer bei der Instanz an.
- Der Wert unter E-Mail, der für die Kennwortwiederherstellung verwendet wird.
-
Klicken Sie auf Erstellen.
-
Nachdem der Benutzer erstellt wurde, wählen Sie den Benutzer aus, und klicken Sie auf Kennwort erstellen/zurücksetzen.
-
Klicken Sie auf Kopieren.
-
Fügen Sie das Kennwort an einer sicheren Stelle ein, und geben Sie es an den Benutzer weiter.
Der Benutzer muss sich mit diesem Kennwort anmelden und es dann sofort ändern.
-
-
Erstellen Sie eine IAM-Gruppe für Ihre Entwickler und eine für Ihre Administratoren.
-
Klicken Sie auf der Seite Identität und Sicherheit unter dem Abschnitt Identität auf Gruppen.
-
Klicken Sie auf Gruppe erstellen.
-
Füllen Sie die Felder im Dialogfeld wie folgt aus:
- Name:
ServiceDevelopers
- Beschreibung:
Developer access to the instance of Digital Assistant in the da_development compartment.
- Name:
-
Klicken Sie auf Gruppe erstellen, um das Erstellen der Gruppe abzuschließen.
-
Klicken Sie auf der Seite erneut auf die Schaltfläche Gruppe erstellen.
-
Geben Sie Folgendes ein:
- Name:
ServiceAdministrators
- Beschreibung:
Complete access to the instance of Digital Assistant in the da_development compartment, including the ability to set feature flags and purge data.
- Name:
-
Klicken Sie auf Gruppe erstellen.
Hinweis
Wie beim Compartment-Namen können Sie die Gruppen beliebig benennen. Wenn Sie andere Namen verwenden, müssen Sie die unten aufgeführten Policy-Definitionen entsprechend anpassen. -
-
Erstellen Sie für jede Gruppe Policys, die die Zugriffsebene definieren, die jedes Mitglied für die Digital Assistant-Instanz erhält.
In diesen Schritten erstellen Sie Policys, um den Zugriff zu definieren, den jede Gruppe erhält. Für die Entwicklergruppe erteilen Sie Berechtigungen für das Entwickeln von Skills und digitalen Assistenten, für das Erstellen von Kanälen sowie für andere Funktionen, die für Entwickler nützlich sind. Für die Administratorgruppe stellen Sie vollständige Berechtigungen für die Instanz bereit, einschließlich der Fähigkeit, Features zu aktivieren und Analysedaten zu verwalten.
-
Klicken Sie auf der Seite Identität und Sicherheit unter dem Abschnitt Identität auf Policys.
-
Wählen Sie in der Liste der Compartments auf der linken Seite
da_development
aus. -
Klicken Sie auf Policy erstellen.
-
Geben Sie unter Name und Beschreibung Folgendes ein:
- Name:
Policy-for-DA-ServiceDevelopers
- Beschreibung:
Policy for developer access to instances of Digital Assistant in the da_development compartment.
- Name:
-
Wählen Sie unter Policy-Versionierung die Option Policy aktuell halten aus.
-
Geben Sie unter Anweisung die folgenden beiden Anweisungen ein:
Allow group ServiceDevelopers to use oda-design in compartment da_development
Allow group ServiceDevelopers to use oda-insights in compartment da_development
-
Klicken Sie auf Erstellen.
-
Klicken Sie erneut auf Policy erstellen.
-
Geben Sie Folgendes ein:
- Name:
Policy-for-DA-ServiceAdministrators
- Beschreibung:
Policy for complete access to instances of Digital Assistant in the da_development compartment.
- Policy-Versionierung: Policy aktuell halten.
- Anweisung:
Allow group ServiceAdministrators to manage oda-family in compartment da_development
- Name:
-
Klicken Sie auf Erstellen.
-
-
Fügen Sie den entsprechenden IAM-Gruppen Benutzer hinzu. (Sie müssen sich nicht selbst hinzufügen, weil Sie bereits als Cloud-Accountadministrator auf die Instanz zugreifen können.)
-
Wählen Sie im Menü Identität die Option Gruppen aus.
-
Suchen Sie die Gruppe in der Liste.
-
Klicken Sie auf die Gruppe.
-
Klicken Sie auf Benutzer zu Gruppe hinzufügen.
-
Wählen Sie den Benutzer in der Dropdown-Liste aus, und klicken Sie auf Benutzer hinzufügen.
-
-
Erstellen Sie die Oracle Digital Assistant-Serviceinstanz.
-
Klicken Sie oben links auf
, um das Navigationsmenü zu öffnen, und wählen Sie Analysen und KI und dann Digital Assistant aus.
- Wählen Sie im Bereich Compartments
da_development
aus. - Klicken Sie auf Instanz erstellen.
- Geben Sie auf der Seite Instanz erstellen die folgenden Details ein:
- Compartment:
da_development
-
Name:
da-dev1
(oder ein anderer Name, der die Verwendung der Instanz wiedergibt) -
Instanzausprägung:
- Entwicklung. Dies ist eine einfach implementierbare Option, die auf Entwicklungsarbeit ausgerichtet ist.
- Produktion. Diese Option muss für Produktionsinstanzen von Oracle Digital Assistant ausgewählt werden. Im Vergleich zur Entwicklungsausprägung kann die Produktionsausprägung mehr Anforderungen pro Minute akzeptieren. Außerdem weist sie eine höhere Datenbankkapazität auf, wodurch mehr Insight-Daten erfasst und gespeichert werden können.
- Compartment:
- Aktivieren Sie das Kontrollkästchen DETAILS DER DIGITAL ASSISTANT-INSTANZ NACH ERSTELLUNG ANZEIGEN.
- Klicken Sie auf Erstellen.
Nach einigen Minuten wechselt Ihre Instanz vom Status Wird erstellt in Aktiv. Das bedeutet, dass die Instanz einsatzbereit ist.
-
-
Rufen Sie die URL für Ihre Benutzer ab.
-
Klicken Sie auf der Registerkarte "Instanzinformationen" der Seite für Ihre Instanz in der Infrastructure-Konsole auf den Link Kopieren rechts neben dem Feld Basisweb-URL.
Dadurch wird die URL in die Zwischenablage des Systems kopiert.
-
Fügen Sie die URL an einer geeigneten Stelle ein.
-
Teilen Sie diese URL mit Mitgliedern Ihres Teams.
Da Sie IAM-Accounts für sie eingerichtet haben, weisen Sie sie an, sich im rechten Bereich der Anmeldeseite (unter Oracle Cloud Infrastructure) anzumelden.
Sie hingegen müssen sich im linken Bereich der Seite mit Ihrem SSO-Account anmelden (es sei denn, Sie haben Ihren IAM-Benutzeraccount der ServiceDevelopers- oder ServiceAdministrator-Gruppe hinzugefügt).
Hinweis
Als Cloud-Accountadministrator verfügen Sie über SSO- (über Oracle Identity Cloud Service) und IAM-Accounts. Als Cloud-Accountadministrator können Sie sich außerdem mit Ihrem SSO-Account bei Digital Assistant anmelden, ohne sich zunächst einer Gruppe mit Berechtigungen für Digital Assistant hinzufügen zu müssen.
-
-
(Optional) Greifen Sie über die Infrastructure-Konsole auf die Instanz zu.
Sie können auch über die Infrastructure-Konsole auf die Serviceinstanz zugreifen:
-
Klicken Sie auf der Konsolenseite für die Instanz auf die Schaltfläche Servicekonsole.
Sie werden zu einer anderen Anmeldeseite umgeleitet.
-
Stellen Sie auf der Anmeldeseite sicher, dass unter Anmeldung beim Cloud-Mandanten der Mandantenname mit dem Namen im Feld "Cloud-Account" im Abschnitt "Zugriffsdetails" Ihrer Willkommens-E-Mail übereinstimmt. Klicken Sie andernfalls auf den Link Mandanten ändern, und geben Sie den Namen Ihres Cloud-Accounts ein, bevor Sie fortfahren.
-
Klicken Sie links auf der Seite unter Single Sign-On (SSO) auf Weiter.
Sie werden zu Ihrer Oracle Digital Assistant-Serviceinstanz weitergeleitet.
-
Oracle Fusion Cloud-Anwendungen und digitaler Assistent
Wenn Sie eine Digital Assistant-Instanz verwenden, die mit einem Abonnement für einen Oracle Fusion Cloud Applications-Service wie HCM Cloud oder Sales Cloud gepaart ist, sind die Setupschritte anders als bei der separaten Bestellung des Digital Assistant.
In diesem Fall wird Digital Assistant so bereitgestellt, dass Sie Out-of-the-box-Skills anpassen können, die mit Ihrem Fusion Applications Service geliefert werden. Diese Digital Assistant-Instanz wird automatisch für Sie bereitgestellt.
Die Einrichtungsschritte finden Sie unter Erste Schritte mit Oracle Digital Assistant für Fusion Applications.
Verknüpfen von Digital Assistant-Instanzen
Digital Assistant-Instanzen, die mit Abonnements für einen Oracle Fusion Applications Cloud-Service gepaart sind, sind so konzipiert, dass Sie vorhandene Out-of-the-box-Skills verwenden und erweitern können, welche von diesem Fusion Applications-Service bereitgestellt werden. Standardmäßig können Sie mit diesen gepaarten Instanzen nicht alle Digital Assistant-Features verwenden, wie das Erstellen und Klonen von Skills und digitalen Assistenten.
Wenn Sie alle Features von Digital Assistant in der gepaarten Instanz nutzen möchten, können Sie diese gepaarte Instanz verknüpfen mit einem Abonnement von Digital Assistant als individueller Service. Wenn die gepaarte Instanz nicht auf diese Weise verknüpft ist, erhalten Sie Warnmeldungen beim Erstellen von Skills oder digitalen Assistenten oder beim Ausführen einer anderen Aufgabe, die nicht durch die Bedingungen für die gepaarte Instanz abgedeckt ist.
Sie können Ihre gepaarte Digital Assistant-Instanz auf zwei Arten verknüpfen:
-
Erwerb eines Abonnements für Oracle Digital Assistant Platform for SaaS, in dem Sie Ihr Fusion Applications-Abonnement einrichten, mit demselben Oracle Cloud-Account. Nachdem Sie die Berechtigung für dieses Abonnement aktiviert haben, sollte die Verknüpfung automatisch erfolgen.
Sie wissen, dass der Link erfolgreich hergestellt wurde, wenn Sie Aufgaben wie das Erstellen neuer Skills in der gepaarten Instanz ausführen können, ohne eine Warnung zu sehen, dass Sie nicht über die erforderliche Berechtigung verfügen.
Hinweis
Wenn Sie eine Verknüpfung zu diesem Abonnementtyp erstellen, müssen Sie keine neue Instanz bereitstellen, damit die Verknüpfung funktioniert. Tatsächlich ist es am besten, Ihre Entwicklungsarbeit in der gepaarten Instanz fortzusetzen und keine Instanz für das Oracle Digital Assistant Platform for SaaS-Abonnement bereitzustellen. -
Abonnieren Sie im Oracle Cloud-Account, in dem Sie Ihr Oracle Applications-Abonnement eingerichtet haben, Digital Assistant Cloud Service über das Universal Credits-Programm, stellen Sie eine Instanz bereit, und verknüpfen Sie diese Instanz dann manuell mit Ihrer gepaarten Instanz. Siehe Digital Assistant-Instanzen manuell verknüpfen.
Wenn Sie zuvor eine Instanz manuell verknüpft haben und dann ein Abonnement für Oracle Digital Assistant Platform for SaaS erwerben, wird dieses Abonnement möglicherweise ebenfalls verknüpft. Dann sind eventuell zwei verknüpfte Instanzen vorhanden. Um die Verknüpfung einer Instanz aufzuheben, leiten Sie eine Serviceanfrage weiter.
Digital Assistant-Instanzen manuell verknüpfen
Wenn Sie ein Oracle Digital Assistant Platform for SaaS-Abonnement in demselben Oracle Cloud-Account wie eine Digital Assistant-Instanz erworben haben, die mit einem Oracle Cloud Applications-Service gepaart ist, und Sie die Berechtigung für dieses Abonnement aktiviert haben, sollte die gepaarte Instanz automatisch mit dieser Berechtigung verknüpft werden. In diesem Fall müssen Sie nichts mehr tun, um alle Digital Assistant-Features verwenden zu können.
Wenn Sie die gepaarte Instanz jedoch mit einer Digital Assistant-Instanz verknüpfen möchten, die Sie über das Universal Credits-Programm bereitgestellt haben, müssen Sie das manuell tun. Gehen Sie dazu wie folgt vor:
-
Abonnieren Sie im Oracle Cloud-Account, in dem Sie Ihr Oracle Applications-Abonnement eingerichtet haben, Digital Assistant Cloud Service über das Universal Credits-Programm, und stellen Sie eine Instanz in derselben Region bereit.
-
Melden Sie sich bei der gepaarten Instanz von Digital Assistant mit Administratorberechtigungen an.
-
Klicken Sie auf
, um das Seitenmenü zu öffnen, und wählen Sie Einstellungen > Verknüpfte Instanz aus.
-
Klicken Sie auf Verknüpfte Instanz festlegen.
-
Wählen Sie im Dialogfeld eine Instanz in der Dropdown-Liste Serviceinstanz aus, und klicken Sie auf Instanz verknüpfen.
Wenn in der Dropdown-Liste keine Instanzen angezeigt werden, liegt einer der beiden folgenden Fälle vor:
- Es sind keine Instanzen in dem Oracle Cloud-Account vorhanden, in dem sich Ihre gepaarte Instanz befindet.
- Es sind keine Instanzen in der Region vorhanden, in der sich Ihre gepaarte Instanz befindet.
Verwaltung verknüpfter Instanzen
Wenn Sie Digital Assistant-Instanzen verknüpft haben, sind einige wichtige administrative Details zu beachten:
- In der Infrastructure-Konsole können Sie keine Instanzen stoppen oder löschen, zu denen eine Verknüpfung hergestellt wurde.
- Nachdem eine Instanz verknüpft wurde, wird jede abrechenbare Aktivität im Zusammenhang mit Ihren benutzerdefinierten Skills und digitalen Assistenten der verknüpften Instanz in Rechnung gestellt, auch wenn diese Bots in der Instanz gehostet werden, die für Ihre Out-of-the-box-Skills von Oracle Cloud Applications bereitgestellt wurde.
Infrastrukturmigration von der 1. Generation zur 2. Generation
Wenn Sie Instanzen von Oracle Digital Assistant nutzen, die ursprünglich auf Oracle Cloud Infrastructure der 1. Generation bereitgestellt wurden (2019 oder früher) und seitdem in Oracle Cloud Infrastructure der 2. Generation migriert wurden, sollte der Großteil Ihrer Arbeit mit den migrierten Instanzen ohne Unterbrechung fortgesetzt werden. Es gibt jedoch einige Unterschiede. Folgendes muss beachtet werden.
OCI-IAM-Identitätsdomain in migrierten Instanzen
Jede Instanz von Digital Assistant, die von der Infrastruktur der 1.Gen. zur Infrastruktur der 2.Gen. migriert worden ist, verfügt über eine OCI IAM-Identitätsdomainanwendung zur Bearbeitung der Benutzerautorisierung und dem Zugriff auf APIs.
Innerhalb dieser Identitätsdomainanwendung befindet sich eine Gruppe mit dem Namen OCI_Administrators. Der Cloud-Accountadministrator ist dieser Gruppe zugewiesen. Mitglieder dieser Gruppe können dann auf die Infrastructure-Konsole zugreifen, um neue Instanzen bereitzustellen und Benutzer zu verwalten.
Unterschiede in migrierten Instanzen
Nach der Migration einer Instanz von der 1. in die 2. Generation müssen Sie einige Unterschiede beachten (und möglicherweise Maßnahmen ergreifen):
-
In der OCI IAM-Identitätsdomainanwendung der Instanz stehen zusätzlich zu ServiceDeveloper zwei neue Anwendungsrollen zur Verfügung (ServiceAdmin und ServiceBusinessUser). Diese Rolle war die einzige in Instanzen der 1. Generation verfügbare Rolle.
-
Benutzerdefinierte Komponentenpackages, die Sie in einen eingebetteten benutzerdefinierten Komponentenservice hochladen, müssen alle Knotenmodulabhängigkeiten enthalten, wie unter Package für einen eingebetteten Containerservice vorbereiten beschrieben. Wenn das Package nicht alle Abhängigkeiten enthält, erhalten Sie eine Fehlermeldung, dass der Komponentenpfad ungültig ist.
-
In der Infrastruktur der 2. Generation gibt es Servicelimits für eingebettete benutzerdefinierte Komponentenservices.
Wenn Sie das Limit erhöhen müssen, können Sie eine Erhöhung beantragen. Weitere Informationen finden Sie unter Servicelimits in der Infrastructure-Konsole anzeigen und Erhöhung des Servicelimits beantragen.
- If any of your skills use the OAuth2Client component to access the Oracle Digital Assistant REST APIs, then the authentication service that they rely on must be updated to use the new OCI IAM confidential app that has been provisioned for the Gen 2 instance. Sie müssen Client-ID, Client Secret und Geltungsbereich aktualisieren. Weitere Informationen zum Abrufen der neuen Werte finden Sie im Thema Anforderungen senden unter REST-API für Oracle Digital Assistant in Oracle Cloud Infrastructure. Weitere Informationen zum Aktualisieren des Authentifizierungsservice finden Sie unter Authentifizierungsservices.
-
Der Session-API-Endpunkt wurde geändert und enthält jetzt neben der Session-ID auch die Benutzer- und Kanal-ID. Damit benutzerdefinierte Komponenten, die diese API aufrufen, das Unterhaltungslog abrufen können, müssen Sie diesen API-Aufruf ändern. Darüber hinaus müssen Client-ID, Client Secret und Geltungsbereich, mit denen Sie das Zugriffstoken zum Autorisieren des REST-Aufrufs abrufen, aktualisiert werden. Bei benutzerdefinierten Komponenten, die auf die Session-API zugreifen, müssen Sie die folgenden Änderungen vornehmen:
- Ihr Code muss
conversation.channelId()
aufrufen, um die Kanal-ID für den Anforderungspfad abzurufen. - Sie müssen den Anforderungspfad in
/api/v1/bots/sessions/{channelId}/{userId}/{sessionId}/log
ändern. Beachten Sie, dass die Benutzer-ID derzeit denselben Wert wie die Session-ID aufweist. - Wenn die benutzerdefinierte Komponente das Zugriffstoken abruft, müssen Client-ID, Client Secret und Geltungsbereich im REST-Aufruf in den Zugriffstokenendpunkt aktualisiert werden. Weitere Informationen zum Abrufen der neuen Werte finden Sie im Thema Anforderungen senden unter REST-API für Oracle Digital Assistant in Oracle Cloud Infrastructure.
Nachdem Sie die Änderungen vorgenommen haben, verpacken Sie die Komponenten erneut. Laden Sie dann für alle Skills, die über einen Komponentenservice für das Komponentenpackage verfügen, das Package erneut.
Weitere Einzelheiten zur API finden Sie unter REST-API für Oracle Digital Assistant in Oracle Cloud Infrastructure.
- Ihr Code muss
-
Bei Agent-Übertragungen (Agent-Integrationen) unterscheidet sich die
customInfo
-Objektstruktur für neue Kanäle, wenn die OSvC-Zielversion 19A oder höher ist. - Die Web-, Android- und iOS-SDK-Kanaltypen in Instanzen der 1. Generation werden in der 2. Generation durch native Oracle-Versionen dieser Kanaltypen ersetzt (mit neuen SDKs für jeden Kanaltyp). Wenn Sie über Skills oder digitale Assistenten verfügen, die alte Kanaltypen verwenden, müssen Sie sie migrieren, um die neuen nativen Oracle-Kanaltypen zu verwenden.
Unter Oracle Digital Assistant-Web-SDK-Anpassungs- und Programmierbeispiele im TechExchange-Blog finden Sie konkrete Beispiele für die Anpassung von Webanwendungscode an das neue Web-SDK.
- Sie können einem Skill jetzt mit Antwort-Intents häufig gestellte Fragen hinzufügen. Im Gegensatz zur Funktionalität des Moduls "Fragen und Antworten" werden Antwort-Intents mit NLP aufgelöst. Darüber hinaus müssen Sie im Gegensatz zu einem Frage-und-Antwort-Modul den Dialogablauf nicht aktualisieren, um Antwort-Intents zu verarbeiten.
-
Es gibt eine Vielzahl weiterer Features und Erweiterungen in Digital Assistant-Instanzen der 2. Generation, die in Instanzen der 1. Generation nicht verfügbar sind. Eine Zusammenfassung dieser Features finden Sie unter Neue Features in Oracle Digital Assistant.
Benutzerzugriff in einer migrierten Instanz
Bei Digital Assistant-Instanzen, die von der Cloud-Infrastruktur der 1. Gen zur 2. Gen migriert wurden, verwenden Sie eine OCI IAM-Identitätsdomainanwendung, um den Zugriff auf Digital Assistant zu verwalten.
In den Instanzen der 2. Generation sind die folgenden Anwendungsrollen verfügbar:
- ServiceAdministrator: Stellt vollständige Berechtigungen für die Instanz bereit. Instanzen der 1. Generation stellt die ServiceDeveloper-Rolle diese Zugriffsebene bereit.
- ServiceDeveloper: Stellt Berechtigungen bereit, die für Benutzer relevant sind, die Skills und digitale Assistenten entwickeln. In dieser Rolle fehlen einige Administratorberechtigungen (wie die Fähigkeit, Daten zu löschen).
- ServiceBusinessUser: Stellt eine Untergruppe der ServiceDeveloper-Berechtigungen bereit und konzentriert sich in erster Linie auf die Fähigkeit, mit Insights-Berichten zu arbeiten.
Standardmäßig wird allen Benutzern einer migrierten Instanz die ServiceAdministrator-Rolle zugewiesen. Benutzern, die nicht die vollständigen ServiceAdministrator-Berechtigungen erhalten sollen, können Sie andere Rollen zuweisen, die besser für ihre Verwendung der Instanz geeignet sind.
In der Infrastruktur der 1.Generation ist die einzige verfügbare Anwendungsrolle für Digital Assistant ServiceDeveloper. Das Äquivalent der 2.Generation ist jedoch ServiceAdministrator.
IP-Adressen für die Ausnahmeliste
Da Oracle Cloud Infrastructure (2. Generation) eine mehrmandantenfähige Architektur ist, haben Digital Assistant-Instanzen, die zur 2. Generation migriert werden, keinen eigenen IP-Adressbereich. Stattdessen erhalten Sie einen Bereich öffentlicher IP-Adressen, der von der Region bestimmt wird, in der sich Ihre Instanz befindet. Wenn Sie zuvor in der Infrastruktur der 1. Generation eine Ausnahmeliste mit einem IP-Adressbereich für Ihre Instanz hatten, müssen Sie diese Liste mit öffentlichen IP-Adressen aktualisieren, die in der Infrastruktur der 2. Generation bereitgestellt werden.
Informationen zum Bestimmen des IP-Adressbereichs für Ihre Region finden Sie unter Öffentliche IP-Adressen für VCNs und Oracle Services Network.