Ordinare il servizio ed eseguire il provisioning di un'istanza
Per impostare il team con Oracle Digital Assistant, è necessario ordinare il servizio, concedere agli utenti le autorizzazioni appropriate, quindi eseguire il provisioning dell'istanza.
Tipi di prodotto Digital Assistant
Oracle Digital Assistant è disponibile attraverso una vasta gamma di modelli di prezzi e sottoscrizioni. La modalità di impostazione dell'istanza dipende da quale di questi modelli si seleziona al momento dell'ordine del servizio.
I modelli di determinazione prezzi vengono suddivisi nei seguenti tipi generali:
- Servizio individuale. Quando si ordina Digital Assistant come singolo servizio, in genere si esegue il provisioning di tali istanze personalmente. Vedere Impostazione di Digital Assistant come servizio singolo.
- Abbinato alle applicazioni cloud basate su Fusion. Puoi ottenere Digital Assistant in questo modo quando disponi di servizi Oracle Applications Cloud basati su Fusion (ad esempio Sales Cloud o HCM Cloud).
Quando ottieni ODA in questo modulo, il provisioning viene eseguito automaticamente. È possibile concedere ai membri del team l'accesso all'istanza nell'applicazione IDCS per l'istanza. Consulta Oracle Fusion Cloud Applications e Digital Assistant.
Nota
Questo tipo di ordine di Digital Assistant è specificamente progettato per consentire all'utente di estendere tali competenze pronte all'uso per la propria attività. Se desideri anche creare competenze personalizzate o integrarle con backend diversi dal servizio a cui sono legate le competenze pronte all'uso, devi ottenere una sottoscrizione individuale separata a Digital Assistant. Vedere Collegamento delle istanze di Digital Assistant.
Effettua un ordine per Oracle Digital Assistant
È possibile effettuare un ordine per Oracle Digital Assistant in uno dei modi indicati di seguito.
- Passare a https://www.oracle.com/application-development/cloud-services/digital-assistant/ e fare clic su Acquista ora.
- Contattare il funzionario commerciale Oracle.
Dopo aver effettuato un ordine per Oracle Digital Assistant come servizio singolo, si riceve un messaggio di posta elettronica con le istruzioni per accedere all'account cloud con una password temporanea. Una volta eseguito il login con tale password, viene richiesto di immettere una nuova password. Successivamente, puoi procedere e impostare gli utenti ed eseguire il provisioning dell'istanza.
Attiva una sottoscrizione Digital Assistant
Se hai effettuato la sottoscrizione a Oracle Digital Assistant Platform for SaaS, riceverai un messaggio di posta elettronica in cui viene richiesto di attivare la sottoscrizione. Seguendo le istruzioni contenute nel messaggio di posta elettronica, attivare l'account.
-
Se è stata acquistata una sottoscrizione a Oracle Digital Assistant Platform for SaaS da utilizzare con un'istanza di Digital Assistant di cui è stato eseguito il provisioning nell'ambito di una sottoscrizione al servizio Oracle Applications Cloud basata su Fusion, attivare la nuova sottoscrizione a Digital Assistant nello stesso tenant in cui si dispone del servizio Oracle Applications Cloud.
Dopo aver attivato la sottoscrizione nello stesso tenant del servizio Oracle Applications Cloud, si ottengono le abilitazioni per utilizzare la funzionalità completa di Digital Assistant nelle istanze di cui è stato precedentemente eseguito il provisioning. Non è necessario eseguire il provisioning di istanze separate per ottenere queste abilitazioni. Puoi semplicemente utilizzare le istanze di cui è già stato eseguito il provisioning.
-
Se è stata acquistata una sottoscrizione a Oracle Digital Assistant Platform for SaaS ma non verrà collegata a un'altra istanza di Digital Assistant:
- Seguendo le istruzioni contenute nel messaggio di posta elettronica di attivazione, attivare la sottoscrizione.
- Impostare l'istanza o le istanze di Digital Assistant come descritto nei seguenti argomenti.
Se si paga per l'utilizzo di Digital Assistant tramite Universal Credit (invece di acquistare un abbonamento), non esiste alcun passaggio di attivazione.
Impostare Digital Assistant come servizio singolo
Per impostare una singola istanza di Oracle Digital Assistant (in altre parole, un'istanza che non è abbinata a un ordine di Oracle Cloud Applications e quindi non viene fornita automaticamente per l'utente), è necessario accedere alla console di Oracle Cloud Infrastructure ed effettuare le operazioni riportate di seguito.
- Impostare un compartimento per l'assistente digitale nella tenancy.
- Impostare gli utenti e i gruppi per gli utenti.
- Impostare i criteri che regolano le autorizzazioni per i gruppi di utenti.
- Eseguire il provisioning dell'istanza.
Se il compartimento, gli utenti, i gruppi e i criteri non sono stati ancora impostati, vedere Utenti, gruppi e criteri per le informazioni necessarie. Se si desidera rendere rapidamente operativa un'istanza e configurare un set di autorizzazioni utente di base, è possibile seguire questa ricetta per impostazione e provisioning rapidi.
Dopo aver completato questi passi, è possibile procedere con il provisioning dell'istanza, come descritto nell'argomento successivo.
Se è stata effettuata la sottoscrizione a Oracle Digital Assistant Platform for SaaS e tale sottoscrizione è stata collegata a un'istanza di Digital Assistant di cui è stato eseguito il provisioning nell'ambito di una sottoscrizione al servizio Oracle Applications Cloud basata su Fusion, non è necessario eseguire il provisioning dell'istanza di Oracle Digital Assistant Platform for SaaS. In effetti, è più semplice se si esegue il lavoro di sviluppo di Digital Assistant nell'istanza di cui è stato eseguito il provisioning.
Creare un'istanza di Oracle Digital Assistant Service
- Connettersi all'account Oracle Cloud.
- 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).
- Nel pannello Compartimenti selezionare un compartimento.
Se non è stato ancora creato un compartimento, vedere Informazioni sui compartimenti e Gestione dei compartimenti.
- Fare clic su Crea istanza di Digital Assistant.
- 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.
-
Modalità dell'istanza. Selezionare una delle seguenti forme:
- Development. Si tratta di 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 prevede limiti di frequenza più elevati e una maggiore capacità del database, che consente la raccolta di un maggior numero di 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 ruolo è disabilitata se la tenancy corrente non dispone ancora del supporto per i domini di Identity. -
Spazio di nomi tag. (Facoltativo) Per ulteriori informazioni sul funzionamento, vedere Gestione di tag e spazi di nomi tag.
- Fare clic su Crea.
Dopo alcuni minuti, lo stato dell'istanza passerà da Creazione ad Attivo, il che significa che l'istanza è pronta per l'uso.
Se il provisioning dell'istanza non riesce, è possibile che si sia raggiunto il limite del servizio per le istanze di Digital Assistant nell'account. Per una spiegazione dei limiti del servizio e della possibilità di richiedere un limite superiore, vedere Limiti del servizio.
Accedere all'istanza del servizio dalla console dell'infrastruttura
Dopo aver eseguito il provisioning di un'istanza, è possibile accedervi dalla console dell'infrastruttura effettuando le operazioni riportate di seguito.
-
Nella pagina della console per l'istanza, fare clic sul pulsante Service Console.
Verrà visualizzata un'altra pagina di login.
-
Fare clic sul collegamento Modifica tenant.
-
Nel campo Tenant cloud, immettere il valore del campo Account cloud nella sezione Dettagli accesso del messaggio di posta elettronica di benvenuto.
-
Accedere all'istanza.
L'amministratore del tenant può sempre eseguire il login con le credenziali di accesso singolo (a sinistra della pagina). Analogamente, qualsiasi utente federato tramite IDCS può eseguire il login con queste credenziali.
Gli utenti a cui è stato eseguito il provisioning con gli account utente IAM possono eseguire il login sul lato destro.
Una volta effettuato l'accesso, devi essere indirizzato all'istanza del servizio Oracle Digital Assistant.
Nota
Se la nuova password non funziona, è possibile che non sia stata ancora applicata. In questo caso, prova a inserire la password temporanea ricevuta dall'e-mail di benvenuto.
Ottieni URL istanza servizio
È possibile recuperare l'URL per l'istanza del servizio nella pagina della console per l'istanza. A questo punto sarà necessario condividere l'URL con il team, poiché non verrà inviata una notifica in altro modo, anche quando vengono concesse le autorizzazioni per Digital Assistant.
-
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.
-
Incollare l'URL in una posizione comoda.
-
Condividi questo URL con i membri del tuo team.
Opzioni di accesso
Quando si immette l'URL per l'istanza di Oracle Digital Assistant nel browser, vengono visualizzate due opzioni di login:
- Oracle Cloud Infrastructure Direct Sign-In (IAM): IAM è il servizio di identità nativo per Oracle Cloud Infrastructure. Se tutti i tuoi servizi Oracle Cloud rientrano in Oracle Cloud Infrastructure (Gen 2), devi impostare i tuoi account utente in IAM e usarli come opzione di accesso principale.
- Single Sign-On (SSO): questa opzione consente di eseguire il login se si dispone di un account utente con un provider di identità federato con IAM. Ad esempio, Oracle Identity Cloud Service (IDCS) è un servizio utilizzato da molti servizi Oracle Cloud, inclusi quelli che non fanno parte dell'architettura Oracle Cloud Infrastructure (Gen 2). Una volta federato e assegnato un account utente di questo tipo ai gruppi con le autorizzazioni appropriate, tale account utente può essere utilizzato come opzione Single Sign-On per tutti i servizi Oracle Cloud di tale utente.
Nota
L'amministratore dell'account cloud può eseguire il login a Digital Assistant con l'account IDCS, anche se l'account non è stato aggiunto in modo esplicito a un gruppo con le autorizzazioni per l'accesso a Digital Assistant.
Per ulteriori informazioni su queste opzioni, su come si relazionano tra loro e su come appare quando si accede a ciascuna di esse, vedere Introduzione alle opzioni di accesso.
Limiti del servizio
Oracle Digital Assistant prevede limiti per il numero di istanze e servizi di componenti personalizzati incorporati che è possibile creare. Ogni volta che crei una nuova istanza o un servizio di componenti personalizzati incorporato, il sistema garantisce che la tua richiesta rientri nei limiti previsti.
Per le istanze, il limite dipende dal modo in cui è stato ordinato Digital Assistant:
Limite risorse | Nome breve limite | Limitato | descrizione; |
---|---|---|---|
Conteggio istanze di Digital Assistant | instance-count | (vista nella console dell'infrastruttura) | Numero massimo di istanze di Oracle Digital Assistant. |
Conteggio servizi componente personalizzato incorporato | embedded-custom-component-service-count | (vista nella console dell'infrastruttura) | Limita per istanza i servizi container incorporati che puoi creare per ospitare componenti personalizzati. |
Conteggio endpoint privati | endpoint privato-conteggio | (vista nella console dell'infrastruttura) | Limite per account di endpoint privati. |
Visualizzare i limiti del servizio nella console dell'infrastruttura
Per visualizzare i limiti di servizio correnti:
- Nella console dell'infrastruttura, fare clic su
in alto a sinistra per aprire il menu di navigazione, selezionare Governance e amministrazione e selezionare Limiti, quote e uso (che viene visualizzato nella categoria Governance nella pagina).
- Nell'elenco a discesa Servizio, selezionare Assistente digitale.
Se il limite è troppo basso per le tue esigenze, puoi richiedere un aumento. Vedere Come richiedere un aumento del limite del servizio.
Quote del servizio
Puoi utilizzare le quote per stabilire in che modo gli altri utenti assegnano le risorse nei vari compartimenti di Oracle Cloud Infrastructure. Ogni volta che si crea un'istanza di Oracle Digital Assistant o si esegue uno scale up, il sistema garantisce che la richiesta rientri nei limiti della quota previsti per il compartimento specifico.
Per ulteriori informazioni sul funzionamento delle quote, vedere Quota compartimento.
Questa tabella mostra la quota correlata a Digital Assistant che è possibile applicare ai compartimenti
Nome quota | Ambito | descrizione; |
---|---|---|
instance-count | Regionali | Numero massimo di istanze di Oracle Digital Assistant per il compartimento |
Criteri quota di esempio per Oracle Digital Assistant
Di seguito è riportato un esempio di istruzione quota.
Set digital-assistant quota instance-count to 3 in compartment MyCompartment
In questo esempio, il numero di istanze di Oracle Digital Assistant di cui è possibile eseguire il provisioning nel compartimento MyCompartment
è limitato a 3.
Forme dell'istanza, limiti di frequenza e storage
Il numero di richieste al minuto che è possibile effettuare per l'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 tutte le richieste che si verificano quando viene raggiunto il limite di frequenza, viene restituita una risposta HTTP 429 (Troppe richieste).
Inoltre, la quantità di storage allocata per i dati Insights dipende dalla forma dell'istanza:
- Forma di sviluppo: 40GB
- Forma di produzione: 100GB
Ricetta per impostazione e provisioning rapidi
Quando si imposta l'istanza per gli utenti, è necessario pianificare con attenzione 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 ricetta, 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 sarà possibile adattare la ricetta alle proprie esigenze.
-
Creare un compartimento in cui posizionare l'istanza.
I compartimenti forniscono raggruppamenti logici di istanze di servizio e altre risorse cloud. La creazione di un compartimento per l'istanza in uso consente di concedere agli utenti le autorizzazioni per l'istanza senza concedere tali autorizzazioni per l'intera tenancy.
-
Nella console dell'infrastruttura fare clic su
in alto a sinistra per aprire il menu di navigazione, selezionare Identità e sicurezza e selezionare Compartimenti.
- Fare clic su Crea compartimento.
- Nel campo Nome, immettere
da_development
.Puoi scegliere un altro nome, se lo desideri. In tal caso, ricordarsi di modificare le definizioni dei criteri riportate di seguito.
- Compilare il resto dei valori richiesti e fare clic su Crea compartimento.
-
-
Creare gli account utente IAM per qualsiasi altro membro del team che si desidera abbia accesso all'istanza.
-
Nella sezione Identità della pagina Identità e sicurezza, fare clic su Utenti.
-
Fare clic su Crea utente.
-
Nella finestra di dialogo Crea utente, immettere i dettagli necessari, con particolare attenzione ai seguenti elementi:
- Il valore Nome può essere un indirizzo e-mail o un nome univoco. Questo sarà il nome utilizzato dall'utente per eseguire il login all'istanza.
- Il valore Email, utilizzato per il recupero della password.
-
Fare clic su Crea.
-
Dopo aver creato l'utente, selezionarlo e fare clic su Crea/Reimposta password.
-
Fare clic su Copia.
-
Incollare la password in un luogo sicuro, quindi fornirla all'utente.
L'utente dovrà accedere con la password e modificarla immediatamente.
-
-
Crea un gruppo IAM per gli sviluppatori e uno per gli amministratori.
-
Nella sezione Identità della pagina Identità e sicurezza, fare clic su Gruppi.
-
Fare clic su Crea gruppo.
-
Completare i campi della finestra di dialogo come riportato di seguito.
- Nome:
ServiceDevelopers
- Descrizione:
Developer access to the instance of Digital Assistant in the da_development compartment.
- Nome:
-
Fare clic su Crea gruppo per completare la creazione del gruppo.
-
Fare di nuovo clic sul pulsante Crea gruppo della pagina.
-
Immettere quanto riportato di seguito.
- 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.
- Nome:
-
Fare clic su Crea gruppo.
Nota
Come per il nome del compartimento, è possibile assegnare un nome ai gruppi qualsiasi cosa si desideri. Se si utilizzano nomi diversi, ricordarsi di modificare le definizioni dei criteri riportate di seguito. -
-
Creare criteri per ciascun gruppo che definiscono il livello di accesso che ogni membro ottiene all'istanza di Digital Assistant.
In questi passaggi, creerai criteri per definire l'accesso che avrà ogni gruppo. Per il gruppo di sviluppatori, darai permessi 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, sarà possibile fornire autorizzazioni complete per l'istanza, inclusa la possibilità di abilitare le funzioni e gestire i dati di analitica.
-
Nella sezione Identità della pagina Identità e sicurezza, fare clic su Criteri.
-
Dalla lista di compartimenti a sinistra, selezionare
da_development
. -
Fare clic su Create Policy.
-
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.
- Nome:
-
Per Controllo delle versioni dei criteri, selezionare Conserva criterio corrente.
-
In Rendiconto, immettere le due istruzioni seguenti:
Allow group ServiceDevelopers to use oda-design in compartment da_development
Allow group ServiceDevelopers to use oda-insights in compartment da_development
-
Fare clic su Crea.
-
Fare di nuovo clic su Crea criterio.
-
Immettere quanto riportato di seguito.
- 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: Conserva criterio corrente.
- Dichiarazione:
Allow group ServiceAdministrators to manage oda-family in compartment da_development
- Nome:
-
Fare clic su Crea.
-
-
Aggiungere gli utenti ai gruppi IAM appropriati. Non è necessario aggiungere se stessi, poiché si dispone già dell'accesso all'istanza come amministratore dell'account cloud.
-
Nel menu Identità, selezionare Gruppi.
-
Individuare il gruppo nell'elenco.
-
Fare clic sul gruppo.
-
Fare clic su Add User to Group.
-
Selezionare l'utente dall'elenco a discesa, quindi fare clic su Aggiungi utente.
-
-
Creare l'istanza del servizio Oracle Digital Assistant.
-
Fare clic su
in alto a sinistra per aprire il menu di navigazione, selezionare Analytics e AI e selezionare Assistente digitale.
- Nel pannello Compartimenti selezionare
da_development
. - Fare clic su Crea istanza.
- Nella pagina Crea istanza, specificare i dettagli riportati di seguito.
- Compartimento:
da_development
-
Nome:
da-dev1
(o un altro nome che rifletta l'uso dell'istanza) -
forma dell'istanza:
- Development. Si tratta di 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 un numero maggiore di richieste al minuto e dispone di una maggiore capacità del database, che consente di raccogliere e memorizzare un numero maggiore di dati Insights.
- Compartimento:
- Selezionare la casella di controllo VIEW DIGITAL ASSISTANT INSTANCE DETAILS UPON CREATING.
- Fare clic su Crea.
Dopo alcuni minuti, lo stato dell'istanza passerà da Creazione ad Attivo, il che significa che l'istanza è pronta per l'uso.
-
-
Ottenere l'URL per gli utenti.
-
Nella scheda Informazioni sull'istanza della pagina relativa all'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.
-
Incollare l'URL in una posizione comoda.
-
Condividi questo URL con i membri del tuo team.
Dal momento che sono stati 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 l'account SSO (a meno che l'account utente IAM non sia stato aggiunto al gruppo ServiceDevelopers o ServiceAdministrator).
Nota
L'amministratore degli account cloud dispone sia di account SSO (tramite Oracle Identity Cloud Service) che di account IAM. Inoltre, in qualità di amministratore dell'account cloud, è possibile accedere a Digital Assistant con l'account SSO senza dover prima aggiungere se stessi a un gruppo con autorizzazioni per Digital Assistant.
-
-
(Facoltativo) Accedere all'istanza dalla console dell'infrastruttura.
È inoltre possibile accedere all'istanza del servizio dalla console dell'infrastruttura:
-
Nella pagina della console per l'istanza, fare clic sul pulsante Service Console.
Verrà visualizzata un'altra pagina di login.
-
Nella pagina di login, in cui viene visualizzato il messaggio Accesso al tenant cloud, assicurarsi che il nome del tenant corrisponda al nome nel campo Account cloud nella sezione Dettagli 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.
-
Nella parte sinistra della pagina, in Single Sign-On (SSO), fare clic su Continua.
È necessario essere indirizzati all'istanza del servizio Oracle Digital Assistant.
-
Applicazioni Oracle Fusion Cloud e assistente digitale
Se si dispone di un'istanza di Digital Assistant abbinata a una sottoscrizione a un servizio Oracle Fusion Cloud Applications, ad esempio HCM Cloud o Sales Cloud, i passi di impostazione sono diversi da quelli eseguiti se Digital Assistant è stato ordinato in modo indipendente.
In questo caso, viene fornito Digital Assistant in modo da poter personalizzare le competenze pronte all'uso fornite con il servizio Fusion Applications. Il provisioning di questo assistente digitale viene eseguito automaticamente.
Per i passi di impostazione, vedere Introduzione a Oracle Digital Assistant per Fusion Applications.
Collegamento delle istanze di Digital Assistant
Le istanze di Digital Assistant abbinate alle sottoscrizioni a un servizio Oracle Fusion Applications Cloud sono progettate per utilizzare ed estendere le competenze pronte all'uso 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, ad esempio la creazione e la clonazione di skill e assistenti digitali.
Se si desidera sfruttare la gamma completa di funzioni di Digital Assistant all'interno dell'istanza associata, è possibile collegare l'istanza associata a una sottoscrizione a Digital Assistant come servizio singolo. Se l'istanza associata 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 associata.
Sono disponibili due modi per collegare l'istanza di Digital Assistant associata:
-
Utilizzando lo stesso account Oracle Cloud in cui hai la sottoscrizione a Fusion Applications, acquista una sottoscrizione a Oracle Digital Assistant Platform for SaaS. Dopo aver abilitato l'abilitazione per la sottoscrizione, il collegamento deve avvenire automaticamente.
Il collegamento è stato stabilito correttamente se è possibile eseguire operazioni nell'istanza abbinata, ad esempio creare nuove competenze senza visualizzare un'avvertenza indicante che non si dispone dell'abilitazione necessaria.
Nota
Quando si esegue il collegamento a questo tipo di sottoscrizione, non è necessario eseguire il provisioning di una nuova istanza affinché il collegamento funzioni. Infatti, è meglio continuare a lavorare allo sviluppo nell'istanza abbinata e non eseguire il provisioning di un'istanza per la sottoscrizione 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 Universal Credits, provisioning di un'istanza e collegamento manuale dell'istanza all'istanza associata. Vedere Collegamento manuale delle istanze di Digital Assistant.
Se in precedenza un'istanza è stata collegata manualmente e poi si acquista una sottoscrizione a Oracle Digital Assistant Platform for SaaS, tale sottoscrizione potrebbe essere collegata, il che significa che saranno disponibili due istanze collegate. Per scollegare uno di essi, inoltrare una richiesta di servizio.
Collegamento manuale delle istanze di Digital Assistant
Se è stata acquistata una sottoscrizione a Oracle Digital Assistant Platform for SaaS nello stesso account Oracle Cloud di un'istanza di Digital Assistant abbinata a un servizio Oracle Cloud Applications ed è stata abilitata l'abilitazione per tale sottoscrizione, l'istanza abbinata deve essere collegata automaticamente a tale abilitazione. In questo caso, non è necessario fare altro per poter utilizzare l'intera gamma di funzionalità di Digital Assistant.
Tuttavia, se si desidera collegare l'istanza associata a un'istanza di Digital Assistant di cui è stato eseguito il provisioning tramite il programma Universal Credits, è necessario farlo manualmente. Di seguito è illustrata la procedura.
-
Uso dello stesso account Oracle Cloud in cui si dispone della sottoscrizione a Oracle Applications, eseguire la sottoscrizione a Digital Assistant Cloud Service tramite il programma Universal Credits ed eseguire il provisioning di un'istanza nella stessa area.
Vedere Impostazione di Digital Assistant come servizio singolo.
-
Eseguire il login all'istanza di Digital Assistant associata con privilegi di amministratore.
-
Fare clic su
per aprire il menu laterale e selezionare Impostazioni > Istanza collegata.
-
Fare clic su Imposta istanza collegata.
-
Nella finestra di dialogo, selezionare un'istanza dall'elenco a discesa Istanza servizio e fare clic su Istanza collegamento.
Se nell'elenco a discesa non sono visualizzate istanze, effettuare una delle operazioni riportate di seguito.
- Non esistono istanze nello stesso account Oracle Cloud in cui si trova l'istanza abbinata.
- Non esistono istanze nella stessa regione in cui si trova l'istanza abbinata.
Amministrazione delle istanze collegate
Quando sono presenti istanze di Digital Assistant collegate, sono disponibili alcuni importanti dettagli amministrativi da tenere presenti:
- Nella console dell'infrastruttura non è possibile arrestare o eliminare le istanze a cui è stato collegato.
- Dopo che un'istanza è stata collegata, qualsiasi attività fatturabile correlata alle tue competenze personalizzate e agli assistenti digitali viene fatturata all'istanza collegata, anche se tali bot sono ospitati nell'istanza di cui è stato eseguito il provisioning per le tue competenze Oracle Cloud Applications pronte all'uso.
Migrazione da Gen 1 a Gen 2 Infrastructure
Se si dispone di istanze di Oracle Digital Assistant di cui è stato originariamente eseguito il provisioning nell'infrastruttura cloud Gen 1 di Oracle (nel 2019 e versioni precedenti) e che sono state successivamente migrate in Oracle Cloud Infrastructure (Gen 2), la maggior parte del lavoro con le istanze migrate dovrebbe continuare senza interruzioni. Esistono tuttavia alcune differenze. Ecco cosa devi sapere.
Applicazione IDCS nelle istanze migrate
Ogni istanza di Digital Assistant di cui è stata eseguita la migrazione dall'infrastruttura Gen 1 all'infrastruttura Gen 2 dispone di un'applicazione IDCS per gestire l'autorizzazione utente e l'accesso alle API. Il nome dell'applicazione IDCS deve iniziare con idcs-oda
.
All'interno di tale applicazione IDCS si trova un gruppo denominato OCI_Administrators. L'amministratore dell'account cloud è assegnato a questo gruppo. I membri di questo gruppo possono accedere in un secondo momento alla console dell'infrastruttura Gen 2 per eseguire il provisioning di nuove istanze e gestire gli utenti in IAM.
Differenze nelle istanze migrate
Di seguito sono riportate alcune differenze che è necessario annotare (e su cui eventualmente intervenire) una volta eseguita la migrazione di un'istanza da Gen 1 a Gen 2:
-
Nell'applicazione IDCS dell'istanza (ServiceAdmin e ServiceBusinessUser) sono disponibili due nuovi ruoli applicazione, oltre a ServiceDeveloper, l'unico ruolo disponibile nelle istanze Gen 1.
-
I package di componenti personalizzati caricati in un servizio di componenti personalizzati incorporato devono contenere tutte le dipendenze dei moduli nodo, come descritto in Prepara il package per un servizio Container 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, consulta la sezione relativa alla visualizzazione dei limiti del servizio nella console dell'infrastruttura e alla richiesta di un aumento dei limiti del servizio.
- Se una qualsiasi 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 IDCS 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, consulta l'argomento Invia richieste nella API REST per Oracle Digital Assistant su Oracle Cloud Infrastructure. Per informazioni sull'aggiornamento del servizio di autenticazione, vedere Servizi di autenticazione.
-
L'endpoint API delle sessioni è stato modificato e ora include l'ID utente e l'ID canale oltre all'ID sessione. Per tutti i componenti personalizzati che chiamano questa API per ottenere il log delle conversazioni, è necessario modificare la 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 Sessioni, è necessario apportare le modifiche riportate di seguito.
- Il codice deve chiamare
conversation.channelId()
per ottenere l'ID canale per il percorso della richiesta. - 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, consulta l'argomento Invia richieste nella API REST per Oracle Digital Assistant su Oracle Cloud Infrastructure.
Dopo aver apportato le modifiche, imballare di nuovo i componenti. Quindi, per tutte le competenze con un servizio componente per il package componente, ricaricare il package.
Per ulteriori dettagli sull'API, consulta la sezione relativa all'API REST per Oracle Digital Assistant su Oracle Cloud Infrastructure.
- Il codice deve chiamare
-
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 ciascun tipo di canale). Se si dispone di competenze o assistenti digitali che utilizzano i vecchi tipi di canale, è necessario eseguirne la migrazione per utilizzare i nuovi tipi di canale nativi Oracle.
Vedere Esempi di personalizzazione e programmazione di Oracle Digital Assistant Web SDK nel 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. A differenza della funzionalità di domande e risposte, gli intenti di risposta vengono risolti con l'NLP. Inoltre, non è necessario aggiornare il flusso della finestra di dialogo per gestire gli intenti di risposta nel modo in cui si esegue un modulo di domande e risposte.
-
Nelle istanze Gen 2 di Digital Assistant sono disponibili numerose altre funzioni e miglioramenti non disponibili nelle istanze Gen 1. Per una panoramica di queste funzionalità, consulta Novità di Oracle Digital Assistant.
Gestisce l'accesso degli utenti in un'istanza migrata
Per le istanze di Digital Assistant di cui è stata eseguita la migrazione dall'infrastruttura cloud Gen 1 a Gen 2, utilizzare un'applicazione Oracle Identity Cloud Service (IDCS) per gestire l'accesso a Digital Assistant.
Nelle istanze Gen 2 sono disponibili i ruoli applicazione riportati di seguito.
- ServiceAdministrator, che fornisce autorizzazioni complete per l'istanza. Nelle istanze Gen 1, il ruolo ServiceDeveloper fornisce questo livello di accesso.
- ServiceDeveloper, che fornisce le autorizzazioni rilevanti per gli utenti che sviluppano competenze e assistenti digitali. Mancano alcune autorizzazioni di amministrazione (come la possibilità di rimuovere i dati).
- ServiceBusinessUser, che fornisce un subset delle autorizzazioni ServiceDeveloper e si concentra principalmente sulla possibilità di utilizzare i report 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 loro ruoli in modo da allinearli meglio all'uso dell'istanza.
Per assegnare a un utente uno dei seguenti ruoli:
-
L'amministratore dell'account cloud deve eseguire il login a IDCS.
-
Fare clic sulla casella Oracle Cloud Services.
-
Passare all'applicazione IDCS per l'istanza Digital Assistant migrata.
Questa applicazione deve avere un nome che corrisponda alla prima parte del nome dominio completamente qualificato (FQDN) dell'istanza. Ad esempio, se il nome FQDN dell'istanza è
idcs-oda-abcd1234-p0.digitalassistant.example.com
, l'applicazione IDCS deve avereidcs-oda-abcd1234-p0
all'inizio del nome. -
Nell'applicazione IDCS fare clic sulla scheda Ruoli applicazione.
-
Nella casella relativa al ruolo a cui si desidera aggiungere utenti, fare clic su
) e selezionare Assegna utenti o Assegna gruppo.
-
Selezionare gli utenti o i gruppi a cui si desidera assegnare il ruolo e fare clic su Assegna.
Nota
Se si desidera accedere all'interfaccia utente di Digital Assistant, assicurarsi di assegnare anche il ruolo.
Per rimuovere un'assegnazione di ruolo per un utente, fare clic su ) nella casella relativa al ruolo e selezionare Revoca utenti.
Nell'infrastruttura Gen 1, l'unico ruolo applicazione IDCS disponibile per Digital Assistant è denominato ServiceDeveloper, ma l'equivalente Gen 2 è ServiceAdministrator.
Indirizzi IP per la lista di inclusione
Poiché Oracle Cloud Infrastructure (Gen 2) è un'architettura multi-tenant, le istanze di Digital Assistant di cui viene eseguita la migrazione in Gen 2 non dispongono di un proprio intervallo di indirizzi IP. Al contrario, hai a disposizione un intervallo di indirizzi IP pubblici determinati dall'area in cui risiede la tua istanza. Se in precedenza avevi una lista di inclusione con una gamma di indirizzi IP per la tua istanza quando si trovava sull'infrastruttura Gen 1, dovrai aggiornare tale lista con gli indirizzi IP pubblici forniti nell'infrastruttura Gen 2.
Per determinare la gamma di indirizzi IP per la tua area, consulta la sezione relativa agli indirizzi IP pubblici per VCN e Oracle Services Network.