Beispiel für die Verwendung der Suchfunktion, um alle Löschvorgänge anzuzeigen:

1. Klicken Sie auf + Kriterien.
2. Wählen Sie im Feld Filter die Option Vorgang aus.
3. Wählen Sie im Feld Operator die Option Beginnt mit aus.
4. Geben Sie im Wertfeld Delete ein.
5. Klicken Sie auf Suchen.

In den Ergebnissen für diese Suche werden Einträge für alle Vorgänge angezeigt, deren Namen mit Delete beginnen, wie DeleteSkill oder DeleteSkillIntent.

Diese Ereignistypen werden von Oracle Digital Assistant-Serviceinstanzen ausgegeben:

com.oraclecloud.digitalassistant.changeodacompartment.begin

com.oraclecloud.digitalassistant.changeodacompartment.end

com.oraclecloud.digitalassistant.createodainstance.begin

com.oraclecloud.digitalassistant.createodainstance.end

com.oraclecloud.digitalassistant.deleteodainstance.begin

com.oraclecloud.digitalassistant.deleteodainstance.end

com.oraclecloud.digitalassistant.updateodainstance

Dies ist ein Referenzereignis für Oracle Digital Assistant-Serviceinstanzen.

{
  "id": "ocid1.eventschema.oc1.phx.abyhqljrfajridyag4epdbthdjuhwgkwxxog32ed4e36yx2zotmphyxe3z5q",
  "exampleEvent": {
    "eventID": "unique_id",
    "eventTime": "2019-10-09T13:58:03.575Z",
    "contentType": "application/json",
    "eventType": "com.oraclecloud.digitalassistant.createodainstance.end",
    "cloudEventsVersion": "0.1",
    "source": "DigitalAssistant",
    "extensions": {
      "compartmentId": "ocid1.compartment.oc1..unique_ID"
    },
    "eventTypeVersion": "2.0",
    "data": {
      "resourceName": "example_name",
      "compartmentId": "ocid1.compartment.oc1..unique_ID",
      "availabilityDomain": "all",
      "compartmentName": "example_name",
      "resourceId": "ocid1.odainstance.oc1.phx.unique_ID"
    }
  },
  "serviceName": "Digital Assistant",
  "displayName": "ODA Instance - Create End",
  "eventType": "com.oraclecloud.digitalassistant.createodainstance.end",
  "additionalDetails": [],
  "timeCreated": "2019-10-09T13:58:03.575Z"
}

Oracle Digital Assistant-Metriken werden mit dem Metrik-Namespace oci_digitalassistant ausgegeben.

Das sind die verfügbaren Metriken für Oracle Digital Assistant-Instanzen.

Sie können Metriken nach einzelnen Serviceinstanzen oder in aggregierter Form für alle Instanzen anzeigen.

So zeigen Sie Metriken für eine einzelne Serviceinstanz an:

1. Klicken Sie in der Infrastructure-Konsole oben links auf , um das Navigationsmenü zu öffnen, wählen Sie Analysen und KI aus, und klicken Sie auf Digital Assistant.
2. Wählen Sie das Compartment der Instanz aus.
3. Wählen Sie die Instanz aus.
4. Scrollen Sie zum Abschnitt "Metriken" der Seite, um die Metriken anzuzeigen.

So zeigen Sie aggregierte Metriken für alle Serviceinstanzen an:

1. Klicken Sie in der Infrastructure-Konsole oben links auf , um das Navigationsmenü zu öffnen, wählen Sie Observability and Management aus, und klicken Sie auf Servicemetriken.
2. Wählen Sie im Dropdown-Menü Compartments das Compartment aus, für das Sie Metriken anzeigen möchten.
3. Wählen Sie im Metrik-Namespace die Option oci_digitalassistant aus.

Die Infrastructure-Konsole stellt verschiedene Abrechnungs- und Zahlungstools bereit, mit denen Sie die Abrechnung, die Servicekosten und die Nutzung von Oracle Digital Assistant ganz leicht überwachen können.

Um Ihre Abrechnungs- und Nutzungsmetriken anzuzeigen, führen Sie die folgenden Schritte aus:

1. Melden Sie sich bei Oracle Cloud an. Sie finden Ihren Accountnamen und die Anmeldeinformationen in der Willkommens-E-Mail.
2. Klicken Sie in der Infrastructure-Konsole oben links auf , um das Navigationsmenü zu öffnen, und wählen Sie Governance und Administration und dann eine der folgenden Optionen aus:

   • Kostenanalyse: Bietet benutzerfreundliche Visualisierungstools, mit denen Sie Ihre Ausgaben verfolgen und optimieren können.

   • Kosten- und Nutzungsbericht: Zeigen Sie CSV-Dateien an, mit denen Sie detaillierte Aufschlüsselungen von Ressourcen für Auditzwecke oder zur Rechnungsabstimmung erhalten.

     Hinweis
     
     

     Beim ersten Zugriff auf Nutzungsberichte müssen Sie eine Policy in Ihrem Root-Compartment erstellen. Befolgen Sie die Anweisungen auf der Seite "Nutzungsbericht", um die Policy zu erstellen, und kopieren Sie dabei die Anweisungen wie angegeben.

   • Budgets: Legen Sie Schwellenwerte für Ihre Ausgaben fest. Sie können Alerts für Ihr Budget festlegen und benachrichtigt werden, wenn Sie Gefahr laufen, das Budget zu überschreiten. Außerdem können Sie alle Ihre Budgets und Ausgaben an einer zentralen Stelle anzeigen.

   • Rechnungen: Hier können Sie Rechnungen für Ihre Nutzung anzeigen und herunterladen.

Weitere Informationen zu Abrechnungs- und Zahlungstools finden Sie unter Abrechnungs- und Zahlungstools - Überblick.

Wenn Sie eine Serviceanfrage weiterleiten und Oracle Support bestimmt, dass zu Debuggingzwecken Zugriff auf einige Ihrer Daten benötigt wird, können Sie temporären Zugriff auf Ihre Serviceinstanzdaten gewähren. Allgemeiner Ablauf des Prozesses:

1. Sie leiten eine Serviceanfrage weiter.
2. Wenn Oracle Support bestimmt, dass zu Debuggingzwecken Zugriff auf Ihre Daten benötigt wird, wendet sich das Supportteam per E-Mail an den Administrator, um die Genehmigung für eine Break Glass-Session einzuholen. (Die E-Mail enthält einen Link zur Seite "Temporäre Zugriffsgenehmigung" von Digital Assistant. Dort kann der Administrator auf Genehmigen oder Ablehnen klicken.)
3. Wenn der Administrator die Anforderung genehmigt, wird ein temporäres Kennwort generiert, mit dem Oracle Support eine Break Glass-Session starten kann, um auf die erforderlichen Daten zuzugreifen.
4. Nachdem Oracle Support die Arbeit in der Break Glass-Session abgeschlossen hat, wird die Session beendet. Wenn die Session nicht explizit beendet wird, läuft sie automatisch nach dem vereinbarten Zeitrahmen ab.

Standardmäßig stellt Oracle die TDE-Schlüssel zur Verschlüsselung der Daten in Ihrer Digital Assistant-Instanz bereit und verwaltet diese.

Wenn für Ihre Instanz Break Glass aktiviert ist, können Sie den von Oracle bereitgestellten Private Key auch durch Ihren eigenen Schlüssel ersetzen. Dadurch können Sie die Schlüssel auch nach Bedarf rotieren.

Oracle Digital Assistant ist für High Availability (HA) konzipiert. Wenn Sie jedoch sicherstellen müssen, dass Ihre Instanz auch dann funktionieren kann, wenn eine Katastrophe in der Region Ihrer Instanz auftritt, können Sie einen regionsübergreifenden Failover einrichten.

Wenn der regionsübergreifende Failover eingerichtet ist und die primäre Instanz ausfällt, geschieht Folgendes:

• Alle Laufzeitanforderungen an die primäre Instanz werden an die Backupinstanz umgeleitet.
• In der Digital Assistant-UI wird ein Banner angezeigt, das angibt, dass die Backupinstanz verwendet wird.
• Arbeiten Sie in der Backupinstanz nicht an Skills, digitalen Assistenten, Kanälen, Insights oder anderen Artefakten (weder über die UI noch über REST-APIs). Alle Änderungen, die Sie in der Backupinstanz vornehmen, werden nicht beibehalten, wenn die primäre Instanz wiederhergestellt wird.

Beim Ende des Ausfalls geschieht Folgendes:

• Der Service für die primäre Instanz wird wiederhergestellt.
• Alle Insight-Daten, die auf der Backupinstanz gesammelt wurden, werden beibehalten und mit vorhandenen Insight-Daten kombiniert, die mit der primären Instanz verknüpft sind.
• Artefakte wie Skills und digitale Assistenten werden in dem Zustand wiederhergestellt, in dem sie sich befanden, als die primäre Instanz ausfiel. (Das bedeutet einfach gesagt, dass alle Änderungen, die Sie an diesen Artefakten in der Backupinstanz vornehmen, nicht beibehalten werden.)

So richten Sie einen regionsübergreifenden Failover ein:

1. Erstellen Sie eine Serviceanfrage für regionsübergreifendes Failover, und geben Sie in der Anforderung die Instanz-URL der primären Digital Assistant-Instanz an.
2. Nachdem das Supportteam mit Informationen darüber geantwortet hat, welche Backupregionen verfügbar sind, abonnieren Sie eine Backupregion in der OCI-Konsole.

   Das Supportteam erstellt dann die Backupinstanz.

Während des Failover-Setups wird ein Skill auf Systemebene (benannt Echo) in der Instanz eingerichtet, die Sie über einen Webkanal (benannt heartbeat) in dieser Instanz angegeben und angegeben haben. Über die Backupregion wird die primäre Instanz dann regelmäßig über diesen Skill nach ihrem Zustand abgefragt.

So richten Sie einen privaten Endpunkt für Digital Assistant ein:

1. Stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen zum Konfigurieren privater Endpunkte verfügen und diese an Digital Assistant-Instanzen anhängen.
2. Wenn diese noch nicht vorhanden sind, erstellen Sie in der OCI-Konsole ein virtuelles Cloud-Netzwerk (VCN) und die zugehörigen Ressourcen, einschließlich:
   • Mindestens ein Subnetz.
   • Routentabellen, um den Traffic über das Subnetz an seine Ziele weiterzuleiten.
   • Sicherheitslisten oder Netzwerksicherheitsgruppen, um ein Set von Ingress- und Egress-Sicherheitsregeln einzurichten, die Sie für den privaten Endpunkt verwenden.
   • Optional ein Internetgateway, um Internetzugriff auf das VCN zu erteilen.
   • Optional ein NAT-(Network Address Translation-)Gateway, mit dem Ressourcen, die keine öffentlichen IP-Adressen haben, Zugriff auf das Internet erhalten, ohne dass sie für eingehende Internetverbindungen freigegeben werden.

   Siehe die OCI-Dokumentation für VCNs und Subnetze.

3. Erstellen Sie den privaten Endpunkt, und verknüpfen Sie ihn mit der Digital Assistant-Instanz.
4. Konfigurieren Sie in Digital Assistant einen Datenservice oder REST-Service, der auf den Endpunkt verweist.

Um private Endpunkte einzurichten, benötigen Sie die entsprechenden Berechtigungen in der Infrastructure-Konsole.

Es gibt zwei Ressourcentypen für private Endpunkte, die diese erforderlichen Berechtigungen umfassen:

• oda-private-endpoints: Ermöglicht die Konfiguration privater Endpunkte und SCAN-Proxys.
• oda-private-endpoint-attachments: Damit können Sie einen privaten Endpunkt einer Digital Assistant-Instanz zuordnen.

Berechtigungen für diese Ressourcentypen sind ebenfalls Teil des Ressourcentyps oda-family. Wenn Sie also von einer Policy-Anweisung zum Verwalten der Ressourcentypen oda-family in dem Compartment abgedeckt werden, in dem sich Ihr privater Endpunkt befindet, müssen Sie keine separaten Policys für Ihre privaten Endpunkte erstellen.

Im Folgenden finden Sie Beispiele für umfassende Policys, mit denen Sie private Endpunkte erstellen und konfigurieren und an Digital Assistant-Instanzen anhängen können.

allow group <group-name> to manage oda-private-endpoints in compartment <private-endpoint-compartment>
allow group <group-name> to manage oda-private-endpoint-attachments in compartment <private-endpoint-compartment>

Weitere Informationen zur Funktionsweise von Policys finden Sie unter Digital Assistant-Policys.

1. 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).
2. Klicken Sie in der linken Navigation der angezeigten Seite "AI-Services" auf Private Endpunkte.
3. Wenn dies noch nicht geschehen ist, erstellen Sie das Compartment, in dem Sie den privaten Endpunkt beibehalten möchten, und fügen Sie optional das VCN und das Subnetz hinzu, das Sie in diesem Compartment verwenden.

   Siehe Compartments und Compartments verwalten.

4. Klicken Sie auf Privaten Endpunkt erstellen, und füllen Sie die erforderlichen Felder aus, einschließlich des VCN und des privaten Subnetzes.
5. Nachdem der Endpunkt erstellt wurde, klicken Sie auf ODA-Instanz verknüpfen, wählen Sie das Compartment mit der Digital Assistant-Instanz aus, die Sie den privaten Endpunkt verwenden möchten, und wählen Sie diese Instanz aus.

Nachdem Sie einen privaten Endpunkt erstellt haben, müssen Sie einen Service für diesen privaten Endpunkt hinzufügen, um ihn in Digital Assistant zu verwenden.

• Informationen zum Hinzufügen eines Datenservice für den privaten Endpunkt finden Sie unter Verbindung zum Datenservice herstellen.
• Informationen zum Hinzufügen eines REST-Service für den privaten Endpunkt finden Sie unter REST-Service für einen Endpunkt hinzufügen.

Wenn Sie den privaten Endpunkt für eine RAC-fähige Datenbank verwenden, müssen Sie auch einen SCAN-Proxy für den privaten Endpunkt konfigurieren.

So richten Sie einen SCAN-Proxy ein:

1. Rufen Sie den SCAN-DNS-Namen und die Portnummer für die Datenbank ab.
   • Wenn die Datenbank eine On-Premise-Datenbank ist, rufen Sie sie vom Datenbankadministrator ab.
   • Wenn sich die Datenbank auf OCI befindet, gehen Sie in der Infrastructure-Konsole wie folgt vor:
     1. Navigieren Sie zur Seite DB-Systemdetails für die Datenbank, und wählen Sie die Registerkarte DB-Systeminformationen aus.
     2. Kopieren Sie im Abschnitt "Netzwerk" der Seite den SCAN-DNS-Namen, und fügen Sie ihn an einer geeigneten Stelle ein.
     3. Halten Sie die Portnummer fest.
2. Klicken Sie in der Infrastructure-Konsole oben links auf , um das Navigationsmenü zu öffnen, und wählen Sie Analysen und KI und dann Private Endpunkte aus (wird auf der Seite unter der Kategorie KI-Services angezeigt).
3. Wählen Sie Ihren privaten Endpunkt aus.
4. Wählen Sie im Abschnitt "Ressourcen" der Seite die Option SCAN-Proxys aus.
5. Klicken Sie auf SCAN-Proxy hinzufügen.
6. Wählen Sie im Dialogfeld SCAN-Proxy hinzufügen den Typ (FQDN (für vollqualifizierten Domainnamen) oder die IP-Adresse) aus, und füllen Sie dann die restlichen Pflichtfelder aus.
   • Wenn Sie FQDN als Proxytyp ausgewählt haben, verwenden Sie den SCAN-DNS-Namen der Datenbank für den Hostnamen und die Portnummer der Datenbank als Port.
   • Wenn Sie IP-Adresse als Proxytyp ausgewählt haben, klicken Sie auf SCAN-Listener hinzufügen, um IP-Adressen und Portnummern für mindestens einen SCAN-Listener in der Datenbank hinzuzufügen.

Im Allgemeinen ist der Prozess zum Importieren von Packages mit der API (entweder direkt oder über die CLI oder eines der SDKs):

1. Falls noch nicht vorhanden, erstellen Sie die Oracle Digital Assistant-Instanz, in die Sie das Package importieren möchten.
   1. Rufen Sie CreateOdaInstance auf, um die Instanz zu erstellen.
   2. Verwenden Sie in der Antwort auf den Aufruf CreateOdaInstance den Antwortheaderwert opc-work-request-id, und rufen Sie GetWorkRequest auf, um den Fortschritt des Instanzerstellungsvorgangs zu überwachen.
   3. Nachdem die Instanzerstellung abgeschlossen ist, wird der Wert des Attributs odaInstanceId verwendet, das im Antwortbody zurückgegeben wurde, um GetOdaInstance. aufzurufen
2. Rufen Sie ListPackages auf, um zu sehen, welche Packages für die angegebene Instanz (oder Instanz) verfügbar sind.
3. Rufen Sie für alle verfügbaren Pakete, die Sie importieren möchten, GetPackage auf, um den Importvertrag des Pakets abzurufen.

   Der Importvertrag gibt Bedingungen an, die erfüllt werden müssen, bevor Sie das Paket importieren können. Dies kann beispielsweise die Angabe eines Authentifizierungsproviders und das Ausfüllen von Werten für benutzerdefinierte Parameter umfassen.

4. Erfüllen Sie den Importvertrag.

   Dazu erstellen Sie eine Payload, die Werte für alle erforderlichen Parameter im Importvertrag bereitstellt. Die Payload sieht in etwa wie folgt aus:

   {
       "packageId": "<packageId-OCID>",
       "parameterValues": {
           "authProvider.providerX.clientSecret": "some value",
           "authProvider.providerX.authorizationEndpointUrl": "http://host:80/file",
           "authProvider.providerX.revokeEndpointUrl": "http://host:80/file",
           "authProvider.providerX.allowedScopes": "some value",
           "authProvider.providerX.tokenEndpointUrl": "http://host:80/file",
           "authProvider.IDCS_OAuthForIDR.allowedScopes": "some value",
           "authProvider.providerX.clientId": "some value",
           "skillParameter.da.backendRestEndPoint": "http://host:80/file",
       }
   }

   Um diese Aufgabe zu vereinfachen, enthält die Antwort GetPackage einen Abschnitt mit dem Namen defaultParameterValues, mit dem Sie den Parameterwertteil der Payload assemblieren können.

5. Importieren Sie das Package in die Instanz(en).
   1. Rufen Sie CreateImportedPackage mit der gerade assemblierten Payload auf.
   2. Verwenden Sie in der Antwort auf den Aufruf CreateImportedPackage den Antwortheaderwert opc-work-request-id, und rufen Sie GetWorkRequest auf, um den Fortschritt des Packageimportvorgangs zu überwachen.
   3. Nachdem der Packageimport abgeschlossen ist, wird der Wert des Attributs odaInstanceId verwendet, das im Antwortbody zurückgegeben wurde, um GetImportedPackage aufzurufen und die Packagedetails anzuzeigen.

Wenn ein Update für ein Package verfügbar ist, können Sie dieses aktualisierte Package über den Vorgang UpdateImportedPackage zur Instanz hinzufügen.