1. Connectez-vous à votre compte Oracle Cloud.
2. Dans la console Oracle Cloud Infrastructure, cliquez sur en haut à gauche pour ouvrir le menu de navigation, sélectionnez Analyse et intelligence artificielle et Digital Assistant (qui apparaît dans la catégorie Services d'intelligence artificielle de la page).
3. Dans le panneau Compartiments, sélectionnez un compartiment.

   Si vous n'avez pas encore créé de compartiment, voir Présentation des compartiments et Gestion des compartiments.

4. Cliquez sur Créer une instance de Digital Assistant.
5. Dans la page Créer une instance Digital Assistant, entrez les détails suivants :
   • Compartiment.

   • Nom. Entrez un nom correspondant à l'utilisation de l'instance. Par exemple, pour un environnement de développement, vous pouvez utiliser oda-de1.

   • Forme d'instance. Sélectionnez l'une des formes suivantes :

     • Développement. C'est une option légère destinée au travail de développement.
     • Production. Cette option devrait être sélectionnée pour les instances de production de Digital Assistant. Comparée à la forme Développement, cette option offre une limite de débit plus élevée et une base de données de capacité plus importante, ce qui permet la collecte d'une plus grande quantité de données clés.

     Voir Formes d'instance et limites de débit et de stockage pour plus d'informations sur les limites de débit.

   • Pour activer l'accès basé sur le rôle à l'instance (au lieu de l'accès par défaut basé sur une politique d'IAM), cliquez sur Afficher les options avancées, sélectionnez Activer l'accès basé sur le rôle et sélectionnez un domaine d'identité.

     Voir Accès basé sur le rôle et domaines d'identité pour plus d'informations sur la configuration d'utilisateurs et de groupes et l'affectation de rôles.

     Note
     
     L'option Activer l'accès basé sur le rôle est désactivée si la location courante ne prend pas encore en charge les domaines d'identité.

   • Espace de noms de marqueur. (Facultatif) Pour plus d'informations, voir Gestion des marqueurs et des espaces de noms de marqueur.

6. Cliquez sur Create (Créer).

   Au bout de quelques minutes, votre instance passe du statut Création au statut Actif, ce qui signifie qu'elle est prête à être utilisée.

Une fois que vous avez provisionné une instance, vous pouvez y accéder à partir de la console Oracle Cloud Infrastructure en procédant comme suit :

1. Dans la page de la console de l'instance, cliquez sur le bouton Console de service.

   Vous êtes redirigé vers une autre page de connexion.

2. Cliquez sur le lien Changer de locataire.

3. Dans le champ Locataire Oracle Cloud, entrez la valeur du champ Compte Oracle Cloud figurant dans la section Détails de l'accès de votre courriel de bienvenue.

4. Connectez-vous à l'instance.

   En tant qu'administrateur de locataire, vous pouvez toujours vous connecter avec vos données d'authentification unique (à gauche de la page).

   Tous les utilisateurs auxquels des comptes d'utilisateur GIA ont été fournis peuvent se connecter à droite de la page.

   Une fois connecté, vous devez être redirigé vers votre instance de service Oracle Digital Assistant.

   Note
   
   Si votre nouveau mot de passe ne fonctionne pas, il est possible qu'il ne soit pas encore entrée en vigueur. Si tel est le cas, essayez d'entrer le mot de passe temporaire que vous avez reçu dans votre courriel de bienvenue.

Vous pouvez extraire l'URL de votre instance de service à partir de la page de la console de l'instance. Vous devrez ensuite partager cette URL avec votre équipe car elle ne recevra pas d'autre avis, même si elle dispose des autorisations requises pour Digital Assistant.

1. Dans l'onglet Informations sur l'instance, cliquez sur le lien Copier figurant à droite du champ URL Web de base.

   L'URL est copiée dans le presse-papiers de votre système.

2. Collez l'URL dans un emplacement pratique.

3. Partagez cette URL avec les membres de votre équipe.

Le nombre d'instances et de services de composants personnalisés intégrés que vous pouvez créer pour Oracle Digital Assistant est limité. Lorsque vous créez une instance ou un service de composants personnalisés intégrés, le système vérifie que votre demande respecte la limite définie.

Pour les instances, la limite dépend de la façon dont vous avez commandé Digital Assistant :

Vous pouvez utiliser des quotas pour déterminer comment les autres utilisateurs affectent des ressources entre les compartiments dans Oracle Cloud Infrastructure. Lorsque vous créez une instance Oracle Digital Assistant ou effectuez un redimensionnement, le système vérifie que votre demande respecte le quota défini pour le compartiment.

Pour en savoir plus sur le fonctionnement des quotas, voir Quotas de compartiment.

Ce tableau présente le quota lié à Digital Assistant que vous pouvez appliquer aux compartiments

Le nombre de demandes par minute qui peuvent être adressées à votre instance dépend de la forme de votre instance :

• Forme Développement : 50 demandes par minute
• Forme Production : 500 demandes par minute

Ces limites couvrent les demandes provenant de canaux utilisateur (tels que Slack, Microsoft Teams, Web, Twilio, Webhook, etc.).

Pour toutes les demandes qui se produisent lorsque la limite de débit a été atteinte, une réponse HTTP 429 (Trop de demandes) est retournée.

En outre, la quantité de stockage affectée aux données clés dépend de la forme de l'instance :

• Forme de développement : 40 Go
• Forme de production : 100 Go

Lorsque vous configurez l'instance pour vos utilisateurs, vous devez planifier soigneusement l'organisation de votre location et construire vos groupes d'utilisateurs et vos politiques. Cependant, si vous souhaitez configurer rapidement une instance avant de maîtriser complètement ces concepts, vous pouvez suivre la "recette" ci-dessous.

Dans cette recette, outre le provisionnement de l'instance, vous configurez des autorisations pour les développeurs et les administrateurs à l'aide du service Gestion des identités et des accès (GIA) d'Oracle Cloud Infrastructure. Par la suite, vous pourrez adapter la recette à vos propres besoins.

1. Créez un compartiment pour y placer votre instance.

   Les compartiments permettent de regrouper des instances de service et d'autres ressources en nuage de manière logique. En créant un compartiment pour votre instance, vous pouvez accorder des autorisations aux utilisateurs pour elle, sans étendre celles-ci à l'ensemble de votre location.

   1. Dans la console Oracle Cloud Infrastructure, cliquez sur dans la partie supérieure gauche pour ouvrir le menu de navigation, sélectionnez Identité et sécurité, puis Compartiments.

   2. Cliquez sur Créer un compartiment.
   3. Dans le champ Nom, entrez da_development.

      Vous pouvez choisir un autre nom si vous le souhaitez. Dans ce cas, n'oubliez pas de modifier les définitions de politique ci-dessous en conséquence.

   4. Indiquez les valeurs obligatoires restantes et cliquez sur Créer un compartiment.

2. Créez des comptes d'utilisateur GIA pour tous les autres membres de l'équipe qui doivent avoir accès à l'instance.

   1. Dans la section Identité de la page Identité et sécurité, cliquez sur Utilisateurs.

   2. Cliquez sur Créer un utilisateur.

   3. Dans la boîte de dialogue Créer un utilisateur, indiquez les détails nécessaires, en tenant compte des points suivants :

      • La valeur de Nom peut être une adresse de courriel ou un nom unique. Il s'agit du nom que l'utilisateur utilisera pour se connecter à l'instance.
      • La valeur de Courriel est utilisée pour la récupération du mot de passe.

   4. Cliquez sur Create (Créer).

   5. Une fois l'utilisateur créé, sélectionnez-le et cliquez sur Créer/Réinitialiser le mot de passe.

   6. Cliquez sur Copier.

   7. Collez le mot de passe dans un emplacement sécurisé, puis communiquez-le à l'utilisateur.

      L'utilisateur doit se connecter à l'aide de ce mot de passe, puis le modifier immédiatement.

3. Créez un groupe GIA pour vos développeurs et un pour vos administrateurs.

   1. Dans la section Identité de la page Identité et sécurité, cliquez sur Groupes.

   2. Cliquez sur Créer un groupe.

   3. Remplissez comme suit les champs de la boîte de dialogue :

      • Nom : ServiceDevelopers
      • Description : Developer access to the instance of Digital Assistant in the da_development compartment.

   4. Cliquez sur Créer un groupe pour terminer l'opération.

   5. Cliquez à nouveau sur le bouton Créer un groupe de la page.

   6. Entrez les informations suivantes :

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

   7. Cliquez sur Créer un groupe.

   Note
   
   Comme pour le compartiment, vous pouvez donner aux groupes le nom que vous souhaitez. Si vous utilisez d'autres noms, n'oubliez pas de modifier les définitions de politique ci-dessous en conséquence.

4. Créez des politiques pour chaque groupe qui définissent le niveau d'accès de chaque membre à l'instance de Digital Assistant.

   Au cours de cette procédure, vous allez créer des politiques définissant l'accès accordé à chaque groupe. Au groupe de développeurs, vous accorderez des autorisations permettant l'élaboration de compétences et d'assistants numériques, la création de canaux et l'accès à d'autres fonctions utiles. Au groupe d'administrateurs, vous accorderez des autorisations complètes sur l'instance, y compris la possibilité d'activer des fonctions et de gérer des données analytiques.

   1. Dans la section Identité de la page Identité et sécurité, cliquez sur Politiques.

   2. Dans la liste de compartiments de gauche, sélectionnez da_development.

   3. Cliquez sur Créer une politique.

   4. Dans les champs Nom et Description, entrez ce qui suit :

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

   5. Dans le champ Contrôle des versions de la politique, sélectionnez Tenir la politique à jour.

   6. Dans le champ Énoncé, entrez les deux énoncés suivants :

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

   7. Cliquez sur Create (Créer).

   8. Cliquez à nouveau sur Créer une politique.

   9. Entrez les informations suivantes :

      • Nom : Policy-for-DA-ServiceAdministrators
      • Description : Policy for complete access to instances of Digital Assistant in the da_development compartment.
      • Contrôle des versions de la politique : Tenir la politique à jour.
      • Énoncé : Allow group ServiceAdministrators to manage oda-family in compartment da_development

   10. Cliquez sur Create (Créer).

5. Ajoutez des utilisateurs aux groupes GIA appropriés.

   1. Dans le menu Identité, sélectionnez Groupes.

   2. Localisez le groupe dans la liste.

   3. Cliquez sur le groupe.

   4. Cliquez sur Ajouter un utilisateur au groupe.

   5. Sélectionnez l'utilisateur dans la liste déroulante, puis cliquez sur Ajouter un utilisateur.

6. Créez l'instance du service d'Oracle Digital Assistant.

   1. Cliquez sur en haut à gauche pour ouvrir le menu de navigation, sélectionnez Analyse et intelligence artificielle, puis Digital Assistant.

   2. Dans le panneau Compartiments, sélectionnez da_development.
   3. Cliquez sur Créer une instance.
   4. Dans la page Créer une instance, entrez les détails suivants :
      • Compartiment : da_development

      • Nom : da-dev1 (ou un autre nom reflétant l'utilisation de l'instance)

      • Forme d'instance :

        • Développement. C'est une option légère destinée au travail de développement.
        • Production. Cette option devrait être sélectionnée pour les instances de production de Digital Assistant. Par rapport à la forme Développement, la forme Production peut accepter plus de demandes par minute et dispose d'une plus grande capacité de base de données, ce qui permet de collecter et de stocker plus de données Insights.
   5. Cochez la case Voir les détails de l'instance Digital Assistant lors de la création.
   6. Cliquez sur Create (Créer).

      Au bout de quelques minutes, votre instance passe du statut Création au statut Actif, ce qui signifie qu'elle est prête à être utilisée.

7. Obtenez l'URL pour vos utilisateurs.

   1. Dans l'onglet Informations sur l'instance de la page de votre instance dans la console Oracle Cloud Infrastructure, cliquez sur le lien Copier qui apparaît à droite du champ URL Web de base.

      L'URL est copiée dans le presse-papiers de votre système.

   2. Collez l'URL dans un emplacement pratique.

   3. Partagez cette URL avec les membres de votre équipe.

8. (Facultatif) Accédez à l'instance depuis la console Oracle Cloud Infrastructure.

   Vous pouvez également accéder à l'instance du service depuis la console Oracle Cloud Infrastructure :

   1. Dans la page de la console de l'instance, cliquez sur le bouton Console de service.

      Vous êtes redirigé vers une autre page de connexion.

   2. Sur la page de connexion, où il est indiqué Signing in to cloud tenant (Connexion au locataire Cloud), assurez-vous que le nom du locataire est celui figurant dans le champ Compte Cloud de la section Détails de l'accès de votre courriel de bienvenue. Sinon, cliquez sur le lien Change tenant (Modifier le locataire) et entrez le nom de votre compte Cloud avant de continuer.

   3. Sur le côté gauche de la page, sous Single Sign-On (SSO) (Authentification unique), cliquez sur Continuer.

      Vous devriez être redirigé vers votre instance de service Oracle Digital Assistant.

Les instances de Digital Assistant associées à des abonnements à un service Oracle Fusion Applications Cloud sont conçues pour vous permettre d'utiliser et d'étendre les compétences prêtes à l'emploi existantes fournies par ce service Fusion Applications. Par défaut, ces instances associées ne vous permettent pas d'utiliser toute la gamme des fonctionnalités Digital Assistant, telles que la création et le clonage de compétences et d'assistants numériques.

Si vous souhaitez tirer parti de la gamme complète de fonctionnalités de Digital Assistant au sein de l'instance associée, vous pouvez lier cette dernière à un abonnement à Digital Assistant en tant que service individuel. Si votre instance associée n'est pas liée de cette façon, vous recevrez des messages d'avertissement lors de la création de compétences ou d'assistants numériques, ou de l'exécution de toute autre tâche qui n'est pas couverte par les termes de l'instance associée.

Il existe deux façons de relier votre instance Digital Assistant associée :

• En utilisant le même compte Oracle Cloud dans lequel vous avez votre abonnement à Fusion Applications, achetez un abonnement à Oracle Digital Assistant Platform for SaaS. Une fois que vous avez activé le droit à cet abonnement, la liaison doit se produire automatiquement.

  Vous saurez que le lien a été établi avec succès si vous pouvez effectuer des opérations dans l'instance associée comme créer de nouvelles compétences sans voir d'avertissement que vous n'avez pas le droit nécessaire de le faire.

  Note
  
  Lors de la liaison à ce type d'abonnement, vous n'avez pas besoin de provisionner réellement une nouvelle instance pour que cette liaison fonctionne. En fait, il est préférable de continuer à effectuer votre travail de développement dans l'instance appariée et de ne pas provisionner d'instance pour l'abonnement à Oracle Digital Assistant Platform for SaaS.

• En utilisant le même compte Oracle Cloud dans lequel vous avez votre abonnement à Oracle Applications, abonnez-vous au service en nuage Digital Assistant par l'intermédiaire du programme de crédits universels, provisionnez une instance, puis reliez-la manuellement à votre instance associée. Voir Lier manuellement des instances de Digital Assistant.

Chaque instance de Digital Assistant qui a été migrée de l'infrastructure 1re génération vers l'infrastructure 2e génération a une application de domaine d'identité OCI IAM pour gérer l'autorisation des utilisateurs et l'accès aux API.

Au sein de cette application de domaine d'identité se trouve un groupe nommé OCI_Administrators. Les membres de ce groupe peuvent accéder à la console d'infrastructure pour provisionner de nouvelles instances et gérer les utilisateurs.

Voici quelques différences dont vous devez tenir compte (et sur lesquelles éventuellement agir) une fois qu'une instance a été migrée de la 1e à la 2e génération :

• Deux nouveaux rôles sont disponibles dans l'application de domaine d'identité OCI IAM de l'instance (ServiceAdmin et ServiceBusinessUser), en plus de ServiceDeveloper, seul rôle disponible dans les instances de 1re génération.

• Les ensembles que vous chargez dans un service de composants personnalisés intégrés doivent contenir toutes les dépendances de modules de noeud décrites dans Préparer l'ensemble pour un service de conteneur intégré. Si l'ensemble ne contient pas toutes ses dépendances, vous recevrez une erreur de chemin de composant non valide.

• Dans l'infrastructure de 2e génération, il existe des limites pour les services de composants personnalisés intégrés.

  Si la limite est insuffisante, vous pouvez demander une augmentation. Pour plus d'informations, voir Voir les limites de service dans la console d'infrastructure et Demande d'une augmentation de limite de service.

• Si vos compétences utilisent le composant OAuth2Client pour accéder aux API REST d'Oracle Digital Assistant, le service d'authentification dont elles dépendent doit être mis à jour afin d'utiliser la nouvelle application confidentielle OCI IAM provisionnée pour l'instance de 2e génération. Vous devrez mettre à jour l'ID client, la clé secrète client et l'étendue. Pour savoir comment obtenir les nouvelles valeurs, voir la rubrique Envoyer les demandes dans API REST pour Oracle Digital Assistant sur Oracle Cloud Infrastructure. Pour voir comment mettre à jour le service d'authentification, voir Services d'authentification.

• Le point d'extrémité de l'API Sessions a changé et comprend maintenant les ID utilisateur et canal en plus de l'ID session. Pour les composants personnalisés qui appellent cette API afin d'obtenir le journal de conversation, vous devez modifier cet appel d'API. En outre, l'ID client, la clé secrète client et l'étendue que vous utilisez pour que le jeton d'accès autorise l'appel REST doivent être mis à jour. Pour les composants personnalisés qui accèdent à l'API Sessions, vous pouvez effectuer les modifications suivantes :

  • Votre code doit appeler conversation.channelId() pour obtenir l'ID canal du chemin d'accès à la demande.
  • Vous devez remplacer le chemin d'accès à la demande par /api/v1/bots/sessions/{channelId}/{userId}/{sessionId}/log. Notez qu'actuellement, l'ID utilisateur et l'ID session sont identiques.
  • Si le composant personnalisé extrait le jeton d'accès, l'ID client, la clé secrète client et l'étendue doivent être mis à jour dans l'appel REST au point d'extrémité du jeton d'accès. Pour savoir comment obtenir les nouvelles valeurs, voir la rubrique Envoyer les demandes dans API REST pour Oracle Digital Assistant sur Oracle Cloud Infrastructure.

  Après avoir apporté les modifications, réassemblez les composants. Ensuite, pour toutes les compétences ayant un service de composant pour l'ensemble de composants, rechargez l'ensemble.

  Pour plus de détails sur l'API, voir API REST pour Oracle Digital Assistant sur Oracle Cloud Infrastructure.

• Pour le transfert d'agent (Intégrations d'agent), la structure d'objet customInfo est différente pour les nouveaux canaux si la version d'OSvC cible est 19A ou ultérieure.

• Les types de canaux Web, Android et iOS de la trousse SDK dans les instances de 1re génération sont remplacés par des versions natives d'Oracle de ces types de canaux dans la 2e génération (avec de nouvelles trousses SDK pour chaque type de canal). Si des compétences ou des assistants numériques utilisent les anciens types de canaux, vous devriez les migrer pour utiliser les nouveaux types natifs Oracle.

  Voir Oracle Digital Assistant Web SDK customization and programming examples dans le blogue TechExchange pour consulter des exemples concrets d'adaptation du code d'application Web à la nouvelle trousse SDK Web.

• Vous pouvez maintenant utiliser Intentions de réponse pour ajouter une fonctionnalité FAQ à une compétence. Contrairement à la fonctionnalité de FAQ, les intentions de réponse sont résolues grâce au traitement du langage naturel. En outre, vous n'avez pas besoin de mettre à jour le flux de dialogue pour traiter les intentions de réponse, comme vous devez le faire pour un module de FAQ.

• Diverses autres fonctionnalités et améliorations sont disponibles dans les instances de 2e génération de Digital Assistant et n'existent pas dans les instances de 1re génération. Pour une description de ces fonctions, voir What's New in Oracle Digital Assistant (Nouveautés d'Oracle Digital Assistant).

Pour les instances de Digital Assistant qui ont été migrées de l'infrastructure en nuage de 1re génération à la 2e génération, vous utilisez une application de domaine d'identité OCI IAM pour gérer l'accès à Digital Assistant.

Dans les instances de 2e génération, les rôles d'application suivants sont disponibles :

• ServiceAdministrator, qui fournit des autorisations complètes sur l'instance. Dans les instances de 1re génération, le rôle ServiceDeveloper offre ce niveau d'accès.
• ServiceDeveloper, qui fournit les autorisations pertinentes aux utilisateurs qui développent des compétences et des assistants numériques. Il lui manque certaines autorisations administratives (par exemple, la capacité d'épurer des données).
• ServiceBusinessUser, qui fournit un sous-ensemble des autorisations ServiceDeveloper et est principalement axé sur la capacité de travailler sur les rapports de données clés.

Par défaut, tous les utilisateurs d'une instance migrée se voient attribuer le rôle ServiceAdministrator. Pour les utilisateurs qui ne devraient pas disposer des autorisations ServiceAdministrator complètes, vous pouvez remplacer leur rôle par un correspondant mieux à leur utilisation de l'instance.

Oracle Cloud Infrastructure (2e génération) étant doté d'une architecture multi-locataire, les instances de Digital Assistant migrées à la 2e génération ne disposent pas de leur propre intervalle d'adresses IP. Au lieu de cela, il existe un intervalle d'adresses IP publiques déterminées par la région où réside votre instance. Si vous aviez déjà une liste d'autorisation comportant un intervalle d'adresses IP pour votre instance sur l'infrastructure de 1re génération, vous devrez mettre à jour cette liste avec les adresses IP publiques fournies dans l'infrastructure de 2e génération.

Pour déterminer l'intervalle d'adresses IP pour votre région, voir Adresses IP publiques pour les réseaux en nuage virtuels et Oracle Services Network.