Di seguito è riportato un esempio di come utilizzare la funzione di ricerca per visualizzare tutte le operazioni di eliminazione.

1. Fare clic su + Criteri.
2. Nel campo Filtro selezionare Operazione.
3. Nel campo Operatore selezionare Inizia con.
4. Nel campo del valore immettere Delete.
5. Fare clic su Cerca.

Nei risultati di tale ricerca verranno visualizzate le voci relative a qualsiasi operazione con nomi che iniziano con Delete, ad esempio DeleteSkill o DeleteSkillIntent.

Di seguito sono riportati i tipi di evento emessi dalle istanze del servizio Oracle Digital Assistant.

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

Si tratta di un evento di riferimento per le istanze del servizio Oracle Digital Assistant.

{
  "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"
}

Le metriche di Oracle Digital Assistant vengono emesse con lo spazio di nomi delle metriche oci_digitalassistant.

Di seguito sono riportate le metriche disponibili per le istanze di Oracle Digital Assistant.

È possibile visualizzare le metriche in base a una singola istanza del servizio o in formato aggregato per tutte le istanze.

Per visualizzare le metriche per una singola istanza di servizio, effettuare le operazioni riportate di seguito.

1. Nella console dell'infrastruttura fare clic su in alto a sinistra per aprire il menu di navigazione e selezionare Analytics & AI, quindi fare clic su Digital Assistant.
2. Selezionare il compartimento dell'istanza.
3. Selezionare l'istanza.
4. Scorrere fino alla sezione Metriche della pagina per visualizzare le metriche.

Per visualizzare le metriche aggregate per tutte le istanze del servizio:

1. Nella console dell'infrastruttura fare clic su in alto a sinistra per aprire il menu di navigazione e selezionare Observability & Management, quindi fare clic su Metriche servizio.
2. Nell'elenco a discesa Compartimenti selezionare il compartimento per il quale si desidera visualizzare le metriche.
3. Nel campo Spazio di nomi metrica selezionare oci_digitalassistant.

Nella console dell'infrastruttura sono disponibili vari strumenti di fatturazione e pagamento che consentono di monitorare facilmente la fatturazione, i costi del servizio e l'uso di Oracle Digital Assistant.

Per visualizzare la fatturazione e l'uso, effettuare le operazioni riportate di seguito.

1. Accedere a Oracle Cloud come amministratore dell'account cloud. È possibile reperire il proprio nome account e le informazioni di login nel messaggio di benvenuto ricevuto tramite posta elettronica.
2. Nella console dell'infrastruttura, fare clic su in alto a sinistra per aprire il menu di navigazione, selezionare Governance e amministrazione, quindi selezionare una delle seguenti opzioni:

   • Analisi costi: offre strumenti di visualizzazione facili da usare e utili per registrare e ottimizzare le spese.

   • Report costi e uso: consente di visualizzare file CSV (Comma-separated Value) da utilizzare per ottenere analisi dettagliate delle risorse ai fini dell'audit o della riconciliazione delle fatture.

     Nota
     
     

     Quando si accede ai report sull'uso per la prima volta, è necessario creare un criterio nel compartimento radice. Seguire le istruzioni riportate nella pagina Report uso per creare il criterio, copiando le istruzioni come indicato.

   • Budget: consente di impostare le soglie di spesa. È possibile impostare gli avvisi sul budget in modo da conoscere il momento in cui il budget potrebbe essere superato e visualizzare tutti i budget e le spese da un'unica posizione.

   • Le fatture: consente di visualizzare e scaricare le fatture relative all'uso.

Per ulteriori informazioni sugli strumenti di fatturazione e pagamento, vedere Panoramica sugli strumenti di fatturazione e pagamento.

Se l'utente invia una richiesta di servizio (RS) e il Supporto Oracle determina che è necessario accedere ad alcuni dati per eseguire il debug, è possibile accettare di concedere loro l'accesso temporaneo ai dati dell'istanza del servizio. Ecco il flusso generale del processo:

1. È possibile sottomettere una RS.
2. Se il Supporto Oracle determina di aver bisogno dell'accesso a uno qualsiasi dei tuoi dati per il debug, contatterà l'amministratore via e-mail per l'approvazione per condurre una sessione di Break Glass. L'e-mail contiene un collegamento alla pagina Approvazione accesso temporaneo dell'assistente digitale, in cui l'amministratore può fare clic su Approva o Rifiuta.
3. Se l'amministratore approva la richiesta, viene generata una password temporanea per consentire al Supporto Oracle di avviare una sessione di Break Glass in cui possano accedere ai dati richiesti.
4. Una volta che il supporto Oracle ha completato il proprio lavoro nella sessione Break Glass, interrompono la sessione. Se non interrompono esplicitamente la sessione, essa scade automaticamente entro il periodo di tempo concordato.

Per impostazione predefinita, Oracle fornisce e gestisce le chiavi TDE per la cifratura dei dati nell'istanza di Digital Assistant.

Se l'istanza è abilitata per Break Glass, puoi anche sostituire la chiave privata fornita da Oracle con una propria, che consente anche di ruotare le chiavi secondo le esigenze.

Oracle Digital Assistant è progettato per l'alta disponibilità (HA). Tuttavia, se devi assicurarti che la tua istanza possa ancora funzionare se si verifica una calamità nell'area della tua istanza, puoi richiedere l'impostazione del failover tra più aree.

Quando si imposta il failover tra più aree e l'istanza primaria diventa inattiva:

• Tutte le richieste runtime all'istanza primaria vengono reindirizzate all'istanza di backup.
• Nell'interfaccia utente di Digital Assistant viene visualizzato un banner che indica che l'istanza di backup è in uso.
• Non è consigliabile eseguire operazioni su skill, assistenti digitali, canali, approfondimenti o altri artifact (attraverso l'interfaccia utente o le API REST) nell'istanza di backup. Le modifiche apportate nell'istanza di backup non verranno conservate quando l'istanza primaria viene ripristinata.

Al termine dell'interruzione:

• Il servizio per l'istanza primaria viene ripristinato.
• Tutti i dati Insights accumulati nell'istanza di backup vengono conservati e combinati con i dati Insights esistenti associati all'istanza primaria.
• Artifact come skill e assistenti digitali vengono ripristinati allo stato in cui si trovavano quando l'istanza primaria è diventata inattiva. In pratica, ciò significa semplicemente che le modifiche apportate a questi artifact nell'istanza di backup non verranno conservate.

Per impostare il failover tra più aree, effettuare le operazioni riportate di seguito.

1. Archiviare una richiesta di servizio per il failover tra più aree e, nella richiesta, menzionare l'URL dell'istanza dell'istanza primaria di Digital Assistant.
2. Una volta che il team di supporto ha risposto con informazioni sulle aree di backup disponibili, eseguire la sottoscrizione a un'area di backup in OCI Console.

   Il team di supporto creerà quindi l'istanza di backup.

Durante l'impostazione del failover, nell'istanza specificata ed esposta tramite un canale Web (denominato heartbeat) in tale istanza viene impostata una competenza a livello di sistema (denominata Echo). Dall'area di backup, l'istanza primaria viene quindi sottoposta a polling periodico per il relativo stato di integrità tramite questa abilità.

Per impostare un endpoint privato per Digital Assistant, attenersi alla procedura generale riportata di seguito.

1. Assicurarsi di disporre delle autorizzazioni necessarie per configurare gli endpoint privati e collegarli alle istanze di Digital Assistant.
2. Se non sono già disponibili, nella console OCI creare una rete cloud virtuale (VCN) e le risorse associate, tra cui:
   • Almeno una sottorete.
   • Tabelle di instradamento per instradare il traffico attraverso la subnet alle relative destinazioni.
   • Liste di sicurezza o gruppi di sicurezza di rete per stabilire un set di regole di sicurezza in entrata e in uscita da utilizzare per l'endpoint privato.
   • Facoltativamente, un gateway Internet per concedere l'accesso a Internet alla VCN.
   • Facoltativamente, un gateway NAT (Network Address Translation) che consente alle risorse che non dispongono di indirizzi IP pubblici di accedere a Internet senza esporle alle connessioni Internet in entrata.

   Consultare la documentazione OCI per VCN e subnet.

3. Creare l'endpoint privato e associarlo all'istanza di Digital Assistant.
4. In Digital Assistant configurare un servizio dati o un servizio REST che punta all'endpoint.

Per impostare gli endpoint privati, è necessario disporre delle autorizzazioni appropriate nella console dell'infrastruttura.

Esistono due tipi di risorsa per gli endpoint privati che includono le autorizzazioni richieste riportate di seguito.

• oda-private-endpoints: consente di configurare gli endpoint privati e i proxy SCAN.
• oda-private-endpoint-attachments: consente di collegare un endpoint privato a un'istanza di Digital Assistant.

Le autorizzazioni per tali tipi di risorsa fanno parte anche del tipo di risorsa oda-family. Pertanto, se un'istruzione dei criteri ti consente di gestire i tipi di risorsa oda-family nel compartimento in cui si trova l'endpoint privato, non è necessario creare criteri separati per gli endpoint privati.

Di seguito sono riportati alcuni esempi di criteri generali che consentono la creazione e la configurazione di endpoint privati e li collegano alle istanze di Digital Assistant.

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>

Per ulteriori dettagli sul funzionamento dei criteri, vedere Policy di Digital Assistant.

1. Nella console dell'infrastruttura, fare clic su in alto a sinistra per aprire il menu di navigazione, selezionare Analytics & AI e selezionare Digital Assistant (che viene visualizzato nella categoria Servizi AI nella pagina).
2. Nella navigazione a sinistra della pagina Servizi AI visualizzata, fare clic su Endpoint privati.
3. Se non lo hai già fatto, crea il compartimento in cui desideri conservare l'endpoint privato e, facoltativamente, aggiungi la VCN e la subnet che utilizzerai a tale compartimento.

   Vedere Informazioni sui compartimenti e Gestione dei compartimenti.

4. Fare clic su Crea endpoint privato e compilare i campi obbligatori, inclusi la VCN e la subnet privata.
5. Dopo aver creato l'endpoint, fare clic su Associa istanza ODA, selezionare il compartimento contenente l'istanza di Digital Assistant che si desidera sia in grado di utilizzare l'endpoint privato, quindi selezionare l'istanza specifica.

Dopo aver creato un endpoint privato, è necessario aggiungere un servizio per tale endpoint privato per utilizzarlo in Digital Assistant.

• Per aggiungere un servizio dati per l'endpoint privato, vedere Connettersi al servizio dati.
• Per aggiungere un servizio REST per l'endpoint privato, vedere Aggiungere un servizio REST per un endpoint.

Se si utilizza l'endpoint privato per un database abilitato per RAC, è necessario configurare anche un proxy SCAN per l'endpoint privato.

Per impostare un proxy SCAN:

1. Recupera il nome DNS SCAN e il numero di porta per il database.
   • Se il database è in locale, ottenerlo dall'amministratore del database.
   • Se il database si trova su OCI, effettuare le operazioni riportate di seguito nella console dell'infrastruttura.
     1. Passare alla pagina Dettagli sistema DB per il database e selezionare la scheda Informazioni sul sistema DB.
     2. Nella sezione Rete della pagina copiare il nome DNS SCAN e incollarlo in un'area appropriata.
     3. Prendere nota del numero di porta.
2. Nella console dell'infrastruttura, fare clic su in alto a sinistra per aprire il menu di navigazione, selezionare Analytics e AI e selezionare Endpoint privati (che viene visualizzato nella categoria Servizi AI nella pagina).
3. Selezionare l'endpoint privato.
4. Nella sezione Risorse della pagina, selezionare proxy SCAN.
5. Fare clic su Aggiungi proxy SCAN.
6. Nella finestra di dialogo Aggiungi proxy SCAN, selezionare il tipo (FQDN (per il nome di dominio completamente qualificato) o indirizzo IP), quindi compilare gli altri campi obbligatori.
   • Se come tipo di proxy è stato selezionato FQDN, utilizzare il nome DNS SCAN del database per il nome host e il numero di porta del database come Porta.
   • Se come tipo di proxy è stato selezionato Indirizzo IP, fare clic su Aggiungi listener SCAN per aggiungere indirizzi IP e numeri di porta per uno o più listener SCAN nel database.

In generale, il processo di importazione dei package mediante l'API (direttamente o tramite l'interfaccia CLI o uno degli SDK) è il seguente:

1. Se non esiste ancora, creare l'istanza di Oracle Digital Assistant in cui si desidera importare il package.
   1. Chiamare CreateOdaInstance per creare l'istanza.
   2. Dalla risposta alla chiamata CreateOdaInstance, prendere il valore dell'intestazione di risposta opc-work-request-id e usarlo per chiamare GetWorkRequest per monitorare lo stato di avanzamento dell'operazione di creazione dell'istanza.
   3. Una volta completata la creazione dell'istanza, utilizzare il valore dell'attributo odaInstanceId restituito nel corpo della risposta per chiamare GetOdaInstance.
2. Chiamare ListPackages per visualizzare i pacchetti disponibili per l'istanza o le istanze specificate.
3. Per qualsiasi pacchetto disponibile da importare, chiamare GetPackage per ottenere il contratto di importazione del pacchetto.

   Il contratto di importazione specifica le condizioni che devono essere soddisfatte prima di poter importare il package. Ciò potrebbe includere elementi quali la specifica di un provider di autenticazione e la compilazione di valori per i parametri personalizzati.

4. Soddisfare il contratto di importazione.

   A tale scopo, creare un payload che fornisca i valori per tutti i parametri richiesti nel contratto di importazione. Il payload potrebbe avere un aspetto simile al seguente:

   {
       "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",
       }
   }

   Per semplificare questo task, la risposta GetPackage contiene una sezione denominata defaultParameterValues che è possibile utilizzare per assemblare la parte del valore del parametro del payload.

5. Importare il package nelle istanze.
   1. Chiamare CreateImportedPackage utilizzando il payload appena assemblato.
   2. Dalla risposta alla chiamata CreateImportedPackage, prendere il valore dell'intestazione di risposta opc-work-request-id e usarlo per chiamare GetWorkRequest per monitorare lo stato di avanzamento dell'operazione di importazione del package.
   3. Una volta completata l'importazione del package, utilizzare il valore dell'attributo odaInstanceId restituito nel corpo della risposta per chiamare GetImportedPackage per visualizzare i dettagli del package.

Se è disponibile un aggiornamento per un package, è possibile aggiungerlo all'istanza mediante l'operazione UpdateImportedPackage.