1. Connettersi all'account Oracle Cloud.
2. 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).
3. Nel pannello Compartimenti selezionare un compartimento.

   Se non è stato ancora creato un compartimento, vedere Informazioni sui compartimenti e Gestione dei compartimenti.

4. Fare clic su Crea istanza di Digital Assistant.
5. Nella pagina Crea istanza di Digital Assistant, immettere i dettagli riportati di seguito.
   • Compartimento.

   • Nome. Immettere un nome che rifletta l'uso dell'istanza. Ad esempio, per un ambiente di sviluppo, è possibile utilizzare oda-dev1.

   • Forma dell'istanza. Selezionare una delle seguenti forme:

     • Development. Questa è un'opzione leggera orientata al lavoro di sviluppo.
     • Produzione. Questa opzione deve essere selezionata per le istanze di produzione di Digital Assistant. Rispetto alla forma Sviluppo, questa opzione ha limiti di frequenza più elevati e una maggiore capacità del database, che consente di raccogliere più dati Insights.

     Per informazioni sui limiti di frequenza, vedere Forme dell'istanza e limiti di frequenza e storage.

   • Se si desidera abilitare l'accesso basato su ruoli all'istanza (anziché l'accesso basato su criteri predefinito di IAM), fare clic su Mostra opzioni avanzate, selezionare Abilita accesso basato su ruoli e selezionare un dominio di Identity.

     Per informazioni sull'impostazione di utenti e gruppi e sull'assegnazione dei ruoli, vedere Accesso basato sui ruoli e domini di Identity.

     Nota
     
     L'opzione Abilita accesso basato su ruoli è disabilitata se la tenancy corrente non dispone ancora del supporto per i domini di Identity.

   • Spazio di nomi tag. (Facoltativo) Per informazioni sul funzionamento, vedere Gestione degli spazi di nomi tag e tag.

6. Fare clic su Crea.

   Dopo alcuni minuti, l'istanza passerà dallo stato Creazione a Attiva, il che significa che l'istanza è pronta per l'uso.

Una volta eseguito il provisioning di un'istanza, puoi accedervi dalla console dell'infrastruttura effettuando i passi riportati di seguito.

1. Nella pagina della console dell'istanza fare clic sul pulsante Console servizio.

   Si verrà reindirizzati a un'altra pagina di login.

2. Fare clic sul collegamento Modifica tenant.

3. Nel campo Tenant cloud immettere il valore del campo Account cloud nella sezione Dettagli accesso dell'e-mail di benvenuto.

4. Accedere all'istanza.

   L'amministratore del tenant può sempre eseguire il login con le credenziali di accesso singolo (sul lato sinistro della pagina).

   Tutti gli utenti di cui è stato eseguito il provisioning con gli account utente IAM possono eseguire il login sul lato destro.

   Una volta eseguito l'accesso, è necessario essere indirizzati all'istanza del servizio Oracle Digital Assistant.

   Nota
   
   Se la nuova password non funziona, è possibile che non sia ancora stata applicata. In questo caso, prova a inserire la password temporanea ricevuta dalla tua e-mail di benvenuto.

È possibile recuperare l'URL dell'istanza del servizio nella pagina della console per l'istanza. Dovrai quindi condividere tale URL con il tuo team, in quanto non riceveranno altrimenti una notifica, anche quando gli verranno concesse le autorizzazioni per Digital Assistant.

1. Nella scheda Informazioni istanza, fare clic sul collegamento Copia visualizzato a destra del campo URL Web di base.

   L'URL verrà copiato negli appunti del sistema.

2. Incollare l'URL in una posizione appropriata.

3. Condividi questo URL con i membri del tuo team.

Oracle Digital Assistant prevede limiti per il numero di istanze e i servizi di componenti personalizzati incorporati che è possibile creare. Ogni volta, che si crea una nuova istanza o un servizio di componenti personalizzati incorporato, il sistema garantisce che la richiesta rientri nei limiti previsti.

Per le istanze, il limite dipende dal modo in cui hai ordinato Digital Assistant:

È possibile utilizzare le quote per stabilire in quale modo gli altri utenti allocano le risorse nei vari compartimenti di Oracle Cloud Infrastructure. Ogni volta, che si crea un'istanza di Oracle Digital Assistant o che si esegue un scale up, il sistema garantisce che la richiesta rientRI nei limiti della quota prevista per il compartimento specifico.

Per ulteriori informazioni sul funzionamento delle quote, vedere Quote di compartimento.

Questa tabella mostra la quota relativa a Digital Assistant che è possibile applicare ai compartimenti

Il numero di richieste al minuto che è possibile effettuare all'istanza dipende dalla forma dell'istanza:

• Forma di sviluppo: 50 richieste al minuto
• Forma di produzione: 500 richieste al minuto

Questi limiti riguardano le richieste provenienti dai canali utente (ad esempio Slack, Microsoft Teams, Web, Twilio, Webhook e così via).

Per qualsiasi richiesta che si verifica quando viene raggiunto il limite di frequenza, viene restituita una risposta HTTP 429 (Troppe richieste).

Inoltre, la quantità di storage allocata per i dati di Insights dipende dalla forma dell'istanza:

• Forma di sviluppo: 40GB
• Forma di produzione: 100GB

Quando si imposta l'istanza per gli utenti, è necessario pianificare attentamente la modalità di organizzazione della tenancy e di creazione dei gruppi di utenti e dei criteri. Tuttavia, se desideri impostare rapidamente un'istanza prima di diventare completamente esperto in questi concetti, puoi seguire la "ricetta" di seguito.

In questa recipe, oltre al provisioning dell'istanza, è possibile impostare le autorizzazioni per sviluppatori e amministratori utilizzando il servizio IAM (Identity and Access Management) di Oracle Cloud Infrastructure. In seguito è possibile adattare la ricetta alle proprie esigenze.

1. Creare un compartimento in cui posizionare l'istanza.

   I compartimenti forniscono raggruppamenti logici di istanze di servizio e altre risorse cloud. Creando un compartimento per l'istanza in uso, puoi concedere agli utenti le autorizzazioni per l'istanza senza concedere tali autorizzazioni per l'intera tenancy.

   1. Nella console dell'infrastruttura fare clic su in alto a sinistra per aprire il menu per la navigazione, selezionare Identità e sicurezza, quindi in Compartimenti.

   2. Fare clic su Crea compartimento.
   3. Nel campo Nome, immettere da_development.

      Puoi scegliere un altro nome se lo desideri. In tal caso, ricordarsi di modificare di conseguenza le definizioni dei criteri riportate di seguito.

   4. Compilare gli altri valori richiesti e fare clic su Crea compartimento.

2. Creare account utente IAM per qualsiasi altro membro del team che si desidera avere accesso all'istanza.

   1. Nella sezione Identità della pagina Identità e sicurezza, fare clic su Utenti.

   2. Fare clic su Crea utente.

   3. Nella finestra di dialogo Crea utente, immettere i dettagli necessari, con particolare attenzione agli elementi riportati di seguito.

      • Il valore Nome può essere un indirizzo di posta elettronica o un nome univoco. Sarà il nome utilizzato dall'utente per eseguire il login all'istanza.
      • Il valore Email, utilizzato per il recupero della password.

   4. Fare clic su Crea.

   5. Una volta creato l'utente, selezionarlo e fare clic su Crea/Reimposta password.

   6. Fare clic su Copia.

   7. Incollare la password in un luogo sicuro, quindi fornirla all'utente.

      L'utente dovrà accedere con quella password e poi cambiarla immediatamente.

3. Creare un gruppo IAM per gli sviluppatori e uno per gli amministratori.

   1. Nella sezione Identità della pagina Identità e sicurezza, fare clic su Gruppi.

   2. Fare clic su Crea gruppo.

   3. Completare i campi della finestra di dialogo come indicato di seguito.

      • Nome: ServiceDevelopers
      • Descrizione: Developer access to the instance of Digital Assistant in the da_development compartment.

   4. Fare clic su Crea gruppo per completare la creazione del gruppo.

   5. Di nuovo, fare clic sul pulsante Crea gruppo della pagina.

   6. Inserire quanto segue:

      • Nome: ServiceAdministrators
      • Descrizione: Complete access to the instance of Digital Assistant in the da_development compartment, including the ability to set feature flags and purge data.

   7. Fare clic su Crea gruppo.

   Nota
   
   Come per il nome del compartimento, è possibile assegnare ai gruppi tutti i nomi desiderati. Se si utilizzano nomi diversi, ricordarsi di modificare di conseguenza le definizioni dei criteri riportate di seguito.

4. Creare criteri per ogni gruppo che definisce il livello di accesso che ogni membro ottiene all'istanza di Digital Assistant.

   In questi passi verranno creati criteri per definire l'accesso di cui avrà ciascun gruppo. Per il gruppo di sviluppatori, darai autorizzazioni che consentono lo sviluppo di competenze e assistenti digitali, la creazione di canali e altre funzioni utili per gli sviluppatori. Per il gruppo di amministratori, verranno fornite le autorizzazioni complete per l'istanza, inclusa la possibilità di abilitare le funzioni e gestire i dati di analitica.

   1. Nella sezione Identità della pagina Identità e sicurezza, fare clic su Criteri.

   2. Dalla lista dei compartimenti a sinistra, selezionare da_development.

   3. Fare clic su Crea criterio.

   4. Per Nome e Descrizione, immettere quanto segue:

      • Nome: Policy-for-DA-ServiceDevelopers
      • Descrizione: Policy for developer access to instances of Digital Assistant in the da_development compartment.

   5. Per Controllo delle versioni dei criteri, selezionare Conserva criterio corrente.

   6. In Rendiconto, immettere le due istruzioni riportate di seguito.

      • Allow group ServiceDevelopers to use oda-design in compartment da_development
      • Allow group ServiceDevelopers to use oda-insights in compartment da_development

   7. Fare clic su Crea.

   8. Di nuovo, fare clic su Crea criterio.

   9. Inserire quanto segue:

      • Nome: Policy-for-DA-ServiceAdministrators
      • Descrizione: Policy for complete access to instances of Digital Assistant in the da_development compartment.
      • Controllo delle versioni dei criteri: Mantieni i criteri correnti.
      • Dichiarazione: Allow group ServiceAdministrators to manage oda-family in compartment da_development

   10. Fare clic su Crea.

5. Aggiungere utenti ai gruppi IAM appropriati. Non è necessario aggiungere se stessi perché si dispone già dell'accesso all'istanza come amministratore dell'account cloud.

   1. Nel menu Identità selezionare Gruppi.

   2. Individuare il gruppo nell'elenco.

   3. Fare clic sul gruppo.

   4. Fare clic su Aggiungi utente al gruppo.

   5. Selezionare l'utente dall'elenco a discesa, quindi fare clic su Aggiungi utente.

6. Creare l'istanza del servizio Oracle Digital Assistant.

   1. Fare clic su in alto a sinistra per aprire il menu di navigazione, selezionare Analytics & AI, quindi selezionare Digital Assistant.

   2. Nel pannello Compartimenti selezionare da_development.
   3. Fare clic su Crea istanza.
   4. Nella pagina Crea istanza, immettere i dettagli riportati di seguito.
      • Compartimento: da_development

      • Nome: da-dev1 (o un altro nome che riflette l'uso dell'istanza)

      • Forma dell'istanza:

        • Development. Questa è un'opzione leggera orientata al lavoro di sviluppo.
        • Produzione. Questa opzione deve essere selezionata per le istanze di produzione di Oracle Digital Assistant. Rispetto alla forma Sviluppo, la forma Produzione può accettare più richieste al minuto e ha una maggiore capacità di database, che consente di raccogliere e memorizzare più dati Insights.
   5. Selezionare la casella di controllo VIEW DIGITAL ASSISTANT INSTANCE DETAILS UPON CREATING.
   6. Fare clic su Crea.

      Dopo alcuni minuti, l'istanza passerà dallo stato Creazione a Attiva, il che significa che l'istanza è pronta per l'uso.

7. Recupera l'URL per gli utenti.

   1. Nella scheda Informazioni sull'istanza della pagina per l'istanza nella console dell'infrastruttura, fare clic sul collegamento Copia visualizzato a destra del campo URL Web di base.

      L'URL verrà copiato negli appunti del sistema.

   2. Incollare l'URL in una posizione appropriata.

   3. Condividi questo URL con i membri del tuo team.

      Dopo averli impostati con gli account IAM, indicare loro di accedere sul lato destro della pagina di login (in Oracle Cloud Infrastructure).

      Tuttavia, l'utente dovrà eseguire il login sul lato sinistro della pagina con il proprio account SSO (a meno che non sia stato aggiunto l'account utente IAM al gruppo ServiceDevelopers o ServiceAdministrator).

      Nota
      
      L'amministratore dell'account Cloud dispone sia di account SSO (tramite Oracle Identity Cloud Service) che di account IAM. Inoltre, come amministratore di account cloud, puoi accedere a Digital Assistant con il tuo account SSO senza dover prima aggiungere te stesso a un gruppo con autorizzazioni per Digital Assistant.

8. (Facoltativo) Accedere all'istanza dalla console dell'infrastruttura.

   È inoltre possibile accedere all'istanza del servizio dalla console dell'infrastruttura:

   1. Nella pagina della console dell'istanza fare clic sul pulsante Console servizio.

      Si verrà reindirizzati a un'altra pagina di login.

   2. Nella pagina di login, in cui viene indicato Accesso al tenant cloud, assicurarsi che il nome del tenant corrisponda al nome nel campo Account cloud nella sezione Dettagli di accesso del messaggio di posta elettronica di benvenuto. In caso contrario, fare clic sul collegamento Modifica tenant e immettere il nome dell'account cloud prima di continuare.

   3. Sul lato sinistro della pagina, in Single Sign-On (SSO), fare clic su Continua.

      È necessario essere indirizzati all'istanza del servizio Oracle Digital Assistant.

Le istanze di Digital Assistant abbinate alle sottoscrizioni a un servizio Oracle Fusion Applications Cloud sono progettate per consentire all'utente di utilizzare ed estendere le competenze predefinite esistenti fornite da tale servizio Fusion Applications. Per impostazione predefinita, queste istanze abbinate non consentono di utilizzare l'intera gamma di funzioni di Digital Assistant, come la creazione e la clonazione di competenze e assistenti digitali.

Se si desidera sfruttare l'intera gamma di funzioni di Digital Assistant all'interno dell'istanza abbinata, è possibile collegare l'istanza abbinata a una sottoscrizione a Digital Assistant come singolo servizio. Se l'istanza abbinata non è collegata in questo modo, si riceveranno messaggi di avvertenza durante la creazione di skill o assistenti digitali o l'esecuzione di qualsiasi altro task non coperto dai termini per l'istanza abbinata.

Esistono due modi per collegare l'istanza di Digital Assistant abbinata:

• Utilizzando lo stesso account Oracle Cloud in cui si dispone della sottoscrizione a Fusion Applications, acquistare una sottoscrizione Oracle Digital Assistant Platform for SaaS. Una volta abilitata l'abilitazione per tale sottoscrizione, il collegamento deve avvenire automaticamente.

  Saprai che il collegamento è stato stabilito con successo se puoi fare cose nell'istanza abbinata come creare nuove competenze senza vedere un avviso che non hai il diritto necessario per farlo.

  Nota
  
  Quando si esegue il collegamento a questo tipo di sottoscrizione, non è necessario eseguire effettivamente il provisioning di una nuova istanza per il collegamento al lavoro. Infatti, è meglio continuare a svolgere il proprio lavoro di sviluppo nell'istanza abbinata e non eseguire il provisioning di un'istanza per l'abbonamento a Oracle Digital Assistant Platform for SaaS.

• Uso dello stesso account Oracle Cloud in cui si dispone della sottoscrizione a Oracle Applications, sottoscrizione a Digital Assistant Cloud Service tramite il programma Crediti universali, provisioning di un'istanza, quindi collegamento manuale dell'istanza all'istanza abbinata. Vedere Collegamento manuale delle istanze di Digital Assistant.

Ogni istanza di Digital Assistant di cui è stata eseguita la migrazione dall'infrastruttura Gen 1 all'infrastruttura Gen 2 dispone di un'applicazione del dominio di identità IAM OCI per gestire l'autorizzazione e l'accesso degli utenti alle API.

All'interno di tale applicazione del dominio di Identity è presente un gruppo denominato OCI_Administrators. L'amministratore dell'account cloud è assegnato a questo gruppo. I membri di questo gruppo possono accedere alla console dell'infrastruttura per eseguire il provisioning di nuove istanze e gestire gli utenti.

Di seguito sono riportate alcune differenze che è necessario notare (ed eventualmente intervenire) una volta eseguita la migrazione di un'istanza da Gen 1 a Gen 2:

• Nell'applicazione del dominio di Identity OCI IAM dell'istanza sono disponibili due nuovi ruoli applicazione (ServiceAdmin e ServiceBusinessUser), oltre a ServiceDeveloper, che era l'unico ruolo disponibile nelle istanze Gen 1.

• I package di componenti personalizzati caricati in un servizio componente personalizzato incorporato devono contenere tutte le dipendenze del modulo nodo, come descritto in Preparazione del package per un servizio contenitore incorporato. Se il pacchetto non contiene tutte le relative dipendenze, si riceverà un errore di percorso del componente non valido.

• Nell'infrastruttura Gen 2 sono previsti limiti di servizio per i servizi di componenti personalizzati incorporati.

  Se è necessario aumentare il limite, è possibile richiedere un aumento. Per ulteriori informazioni, vedere Visualizzare i limiti del servizio nella console dell'infrastruttura e Richiedere un aumento del limite del servizio.

• Se una delle tue competenze utilizza il componente OAuth2Client per accedere alle API REST di Oracle Digital Assistant, il servizio di autenticazione su cui si basano deve essere aggiornato per utilizzare la nuova applicazione riservata IAM OCI di cui è stato eseguito il provisioning per l'istanza Gen 2. Sarà necessario aggiornare l'ID client, il segreto client e l'ambito. Per informazioni su come ottenere i nuovi valori, vedere l'argomento Invia richieste in API REST per Oracle Digital Assistant su Oracle Cloud Infrastructure. Per ulteriori informazioni sull'aggiornamento del servizio di autenticazione, vedere Authentication Services.

• L'endpoint API Sessions è stato modificato e ora include l'ID utente e l'ID canale oltre all'ID sessione. Per qualsiasi componente personalizzato che chiama questa API per ottenere il log delle conversazioni, è necessario modificare tale chiamata API. Inoltre, è necessario aggiornare l'ID client, il segreto client e l'ambito utilizzati per ottenere il token di accesso per autorizzare la chiamata REST. Per i componenti personalizzati che accedono all'API delle sessioni, è necessario apportare le modifiche riportate di seguito.

  • Il codice deve chiamare conversation.channelId() per ottenere l'ID canale per il percorso della richiesta.
  • È necessario modificare il percorso della richiesta in /api/v1/bots/sessions/{channelId}/{userId}/{sessionId}/log. Si noti che attualmente l'ID utente ha lo stesso valore dell'ID sessione.
  • Se il componente personalizzato recupera il token di accesso, l'ID client, il segreto client e l'ambito devono essere aggiornati nella chiamata REST all'endpoint del token di accesso. Per informazioni su come ottenere i nuovi valori, vedere l'argomento Invia richieste in API REST per Oracle Digital Assistant su Oracle Cloud Infrastructure.

  Una volta apportate le modifiche, imballare nuovamente i componenti. Quindi, per tutte le competenze che dispongono di un servizio componenti per il pacchetto componenti, ricaricare il pacchetto.

  Per ulteriori dettagli sull'API, consulta l'API REST per Oracle Digital Assistant su Oracle Cloud Infrastructure.

• Per il trasferimento agente (Integrazioni agente), la struttura dell'oggetto customInfo è diversa per i nuovi canali se la destinazione OSvC è 19A o successiva.

• I tipi di canale SDK Web, Android e iOS nelle istanze Gen 1 vengono sostituiti dalle versioni native Oracle di tali tipi di canale in Gen 2 (con nuovi SDK per ogni tipo di canale). Se hai competenze o assistenti digitali che utilizzano i vecchi tipi di canale, dovresti eseguirne la migrazione per utilizzare i nuovi tipi di canale nativi Oracle.

  Consulta gli esempi di personalizzazione e programmazione di Oracle Digital Assistant Web SDK sul blog TechExchange per esempi concreti su come adattare il codice dell'applicazione Web al nuovo Web SDK.

• È ora possibile utilizzare Intenti risposta per aggiungere la funzionalità Domande frequenti a uno skill. Al contrario della funzionalità Q&A, gli intenti delle risposte vengono risolti con l'NLP. Inoltre, non è necessario aggiornare il flusso della finestra di dialogo per gestire gli intenti delle risposte nel modo in cui si esegue un modulo di domande e risposte.

• Sono disponibili diverse altre funzioni e miglioramenti nelle istanze Gen 2 di Digital Assistant non disponibili nelle istanze Gen 1. Per una panoramica di queste funzioni, vedere Novità di Oracle Digital Assistant.

Per le istanze di Digital Assistant di cui è stata eseguita la migrazione dall'infrastruttura cloud Gen 1 a Gen 2, si utilizza un'applicazione del dominio di identità IAM OCI per gestire l'accesso a Digital Assistant.

Nelle istanze di Gen 2 sono disponibili i seguenti ruoli applicazione:

• ServiceAdministrator, che fornisce le autorizzazioni complete per l'istanza. Nelle istanze di Gen 1, il ruolo ServiceDeveloper fornisce questo livello di accesso.
• ServiceDeveloper, che fornisce autorizzazioni pertinenti per gli utenti che sviluppano competenze e assistenti digitali. Mancano alcune autorizzazioni di amministratore (ad esempio la possibilità di rimuovere i dati).
• ServiceBusinessUser, che fornisce un subset delle autorizzazioni ServiceDeveloper e si concentra principalmente sulla capacità di utilizzare i report di Insights.

Per impostazione predefinita, a tutti gli utenti di un'istanza migrata viene assegnato il ruolo ServiceAdministrator. Per gli utenti che non devono disporre delle autorizzazioni ServiceAdministrator complete, è possibile modificare i propri ruoli in modo da allinearli meglio all'uso dell'istanza.

Poiché Oracle Cloud Infrastructure (Gen 2) è un'architettura multi-tenant, le istanze di Digital Assistant di cui è stata eseguita la migrazione a Gen 2 non dispongono di una propria gamma di indirizzi IP. Invece, hai un intervallo di indirizzi IP pubblici determinati dall'area in cui risiede l'istanza. Se in precedenza avevi una lista di inclusione con un intervallo di indirizzi IP per la tua istanza quando era nell'infrastruttura Gen 1, dovrai aggiornare tale lista con gli indirizzi IP pubblici forniti nell'infrastruttura Gen 2.

Per determinare l'intervallo di indirizzi IP della propria area, vedere Indirizzi IP pubblici per le reti VCN e Oracle Services Network.