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

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

4. Cliquez sur Créer une occurrence de Digital Assistant.
5. Sur la page Créer une instance d'assistant numérique, renseignez les détails suivants :
   • Compartiment.

   • Nom. Saisissez le nom qui correspond à l'utilisation de l'instance. Par exemple, dans le cas d'un environnement de développement, vous pouvez utiliser oda-dev1.

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

     • Développement. Il s'agit d'une option légère orientée vers les travaux de développement.
     • Production. Vous devez sélectionner cette option pour les instances de production de Digital Assistant. Par rapport à la forme de développement, cette option applique des limites de débit plus élevées et dispose d'une capacité de base de données supérieure, ce qui permet de collecter davantage de données d'analyse.

     Pour obtenir des informations sur ces limites, reportez-vous à la section Instance Shapes and Rate and Storage Limits.

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

     Pour plus d'informations sur la configuration des utilisateurs et des groupes et l'affectation de rôles, reportez-vous à Accès basé sur les rôles et domaines d'identité.

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

   • Espace de noms de balise. (Facultatif) Pour en savoir plus sur le fonctionnement, reportez-vous à Gestion des balises et des espaces de noms de balise.

6. Cliquez sur Créer.

   Après quelques minutes, l'instance passe du statut Création à 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 Infrastructure en procédant comme suit :

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

   Vous allez être redirigé vers une autre page de connexion.

2. Cliquez sur le lien Modifier le locataire.

3. Dans le champ Locataire cloud, entrez la valeur du champ Compte cloud à partir de la section Détails d'accès du courriel de bienvenue.

4. Connectez-vous à l'instance.

   En tant qu'administrateur de location, vous pouvez toujours vous connecter à l'aide de vos informations d'identification d'accès avec connexion unique (sur le côté gauche de la page).

   Tous les utilisateurs qui ont été provisionnés avec des comptes utilisateur IAM peuvent se connecter sur le côté droit.

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

   Remarque
   
   Si votre nouveau mot de passe ne fonctionne pas, il est possible qu'il n'ait pas encore pris effet. Si c'est le cas, essayez d'entrer le mot de passe temporaire que vous avez reçu dans le courriel de bienvenue.

Vous pouvez extraire l'URL de votre instance de service sur la page de la console de l'instance. Vous devez ensuite partager cette URL avec les membres de votre équipe car ils ne seront pas avertis autrement, même lorsque des droits d'accès leur sont accordés pour Digital Assistant.

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

   Cette opération permet de copier l'URL dans le presse-papiers de votre système.

2. Collez l'URL à un emplacement pratique.

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

Oracle Digital Assistant impose des limites sur le nombre d'instances et de services de composant personnalisés imbriqués que vous pouvez créer. Chaque fois que vous créez une instance ou un service de composant personnalisé imbriqué, le système veille à ce que votre demande reste dans les limites.

Par exemple, la limite dépend de la façon dont vous avez commandé Digital Assistant :

Vous pouvez utiliser des quotas pour déterminer la manière dont les autres utilisateurs allouent les ressources dans les compartiments d'Oracle Cloud Infrastructure. Chaque fois que vous créez une instance Oracle Digital Assistant ou que vous effectuez une augmentation, le système s'assure que votre demande respecte le quota du compartiment concerné.

Pour plus d'informations sur le fonctionnement des quotas, reportez-vous à Quotas de compartiment.

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

Le nombre de demandes par minute pouvant être effectuées sur votre instance dépend de sa forme :

• Forme de développement : 50 demandes par minute
• Forme de 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 générées alors que la limite de débit a été atteinte, une réponse HTTP 429 (trop de demandes) est renvoyée.

En outre, la quantité de stockage allouée pour les données d'analyse dépend de la forme d'instance :

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

Lorsque vous configurez votre instance pour vos utilisateurs, vous devez planifier soigneusement l'organisation de la location et la construction des groupes d'utilisateurs et stratégies. Cependant, si vous voulez configurer rapidement une instance avant de maîtriser complètement ces concepts, vous pouvez suivre la procédure ci-dessous.

Dans cette procédure, en plus de provisionner l'instance, vous configurez des droits d'accès pour les développeurs et les administrateurs à l'aide du service Identity and Access Management (IAM) d'Oracle Cloud Infrastructure. Vous pourrez ensuite adapter la procédure à vos propres besoins.

1. Créez un compartiment dans lequel vous placerez l'instance.

   Les compartiments fournissent des groupes logiques d'instances de service et d'autres ressources cloud. En créant un compartiment pour votre instance, vous pouvez accorder des droits d'accès aux utilisateurs pour l'instance sans accorder ces droits pour l'ensemble de votre location.

   1. Dans la console Infrastructure, cliquez sur , en haut à 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.

      Si vous le souhaitez, vous pouvez choisir un autre nom. Dans ce cas, n'oubliez pas d'ajuster les définitions de stratégie ci-dessous en conséquence.

   4. Remplissez les autres valeurs requises et cliquez sur Créer un compartiment.

2. Créez des comptes utilisateur IAM pour tous les autres membres de l'équipe devant accéder à l'instance.

   1. Sous 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, renseignez les détails nécessaires, avec une attention particulière pour les éléments suivants :

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

   4. Cliquez sur 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 endroit sécurisé, puis fournissez-le à l'utilisateur.

      L'utilisateur devra se connecter avec ce mot de passe et le modifier immédiatement.

3. Créez un groupe IAM pour les développeurs et un autre groupe pour les administrateurs.

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

   2. Cliquez sur Créer un groupe.

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

      • 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 la création du groupe.

   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.

   Remarque
   
   Comme pour le nom du compartiment, vous pouvez attribuer aux groupes le nom de votre choix. Si vous utilisez des noms différents, n'oubliez pas d'ajuster les définitions de stratégie ci-dessous en conséquence.

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

   Avec ces étapes, vous allez créer des stratégies pour définir l'accès accordé à chaque groupe. Pour le groupe de développeurs, vous octroyez des droits d'accès qui permettent le développement de briques et d'assistants numériques, la création de canaux et d'autres fonctions utiles pour les développeurs. Pour le groupe d'administrateurs, vous octroyez des droits d'accès complets sur l'instance, y compris la possibilité d'activer les fonctionnalités et de gérer les données d'analyse.

   1. Sous la section Identité de la page Identité et sécurité, cliquez sur Stratégies.

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

   3. Cliquez sur Créer une stratégie.

   4. Pour Nom et Description, entrez les informations suivantes :

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

   5. Pour Gestion des versions de stratégie, sélectionnez Conserver la stratégie en cours.

   6. Pour Instruction, entrez les deux instructions suivantes :

      • 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 Créer.

   8. Cliquez à nouveau sur Créer une stratégie.

   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.
      • Gestion des versions de stratégie : Conserver la stratégie en cours.
      • Instruction : Allow group ServiceAdministrators to manage oda-family in compartment da_development

   10. Cliquez sur Créer.

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

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

   2. Recherchez le groupe dans la liste.

   3. Cliquez sur le groupe.

   4. Cliquez sur Ajouter un utilisateur à un groupe.

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

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

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

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

      • Nom : da-dev1 (ou un autre nom qui reflète l'utilisation de l'instance)

      • Forme d'instance :

        • Développement. Il s'agit d'une option légère orientée vers les travaux de développement.
        • Production. Vous devez sélectionner cette option pour les instances de production d'Oracle Digital Assistant. Par rapport à la forme de développement, la forme de production peut accepter plus de demandes par minute et dispose d'une capacité de base de données supérieure, ce qui permet de collecter et de stocker davantage de données d'analyse.
   5. Cochez la case Visualiser les détails de l'instance Digital Assistant lors de la création.
   6. Cliquez sur Créer.

      Après quelques minutes, l'instance passe du statut Création à 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 Infrastructure, cliquez sur le lien Copier qui apparaît à droite du champ URL Web de base.

      Cette opération permet de copier l'URL dans le presse-papiers de votre système.

   2. Collez l'URL à un emplacement pratique.

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

8. (Facultatif) Accédez à l'instance à partir de la console Infrastructure.

   Vous pouvez également accéder à l'instance de service à partir de la console Infrastructure :

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

      Vous allez être redirigé vers une autre page de connexion.

   2. Sur la page de connexion, à proximité de Connexion au locataire cloud, assurez-vous que le nom du locataire correspond au nom figurant dans le champ Compte cloud de la section Détails d'accès de votre courriel de bienvenue. Sinon, cliquez sur le lien Modifier le locataire et entrez le nom de votre compte cloud avant de continuer.

   3. Sur le côté gauche de la page, sous Accès avec connexion unique (SSO), cliquez sur Continuer.

      Vous devez être dirigé vers votre instance de service Oracle Digital Assistant.

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

Si vous voulez exploiter la gamme complète des fonctionnalités de Digital Assistant au sein de l'instance couplée, vous pouvez associer cette instance couplée à un abonnement à Digital Assistant en tant que service individuel. Si l'instance couplée n'est pas associée de cette manière, des messages d'avertissement apparaissent lors de la création de briques ou d'assistants numériques, ou lors de l'exécution de toute autre tâche non couverte par les conditions de l'instance couplée.

Vous pouvez associer votre instance Digital Assistant couplée de deux manières :

• A l'aide du compte Oracle Cloud avec l'abonnement à Fusion Applications, achetez un abonnement Oracle Digital Assistant Platform for SaaS. Une fois que vous avez activé l'habilitation pour cet abonnement, l'association doit se faire automatiquement.

  Vous savez que l'association a été établie si vous pouvez effectuer des opérations dans l'instance couplée telles que créer des briques sans obtenir d'avertissement indiquant que vous ne disposez pas de l'habilitation nécessaire.

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

• A l'aide du compte Oracle Cloud avec l'abonnement à Oracle Applications, abonnez-vous à Digital Assistant Cloud Service via le programme de crédits universels, provisionnez une instance, puis associez manuellement cette instance à votre instance couplée. Reportez-vous à Association manuelle d'instances Digital Assistant.

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

Dans cette application de domaine d'identité se trouve un groupe appelé 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 que vous devez observer (et éventuellement qui doivent vous inciter à prendre des mesures) une fois qu'une instance a été migrée de Gen 1 à Gen 2 :

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

• Les packages de composants personnalisés que vous téléchargez vers un service de composant personnalisé imbriqué doivent contenir toutes les dépendances de module de noeud, comme décrit dans Préparation du package pour un service de conteneur imbriqué. Si le package ne contient pas toutes les dépendances, vous recevez une erreur de chemin de composant non valide.

• Dans l'infrastructure Gen 2, des limites s'appliquent aux services de composants personnalisés imbriqués.

  Si vous avez besoin d'augmenter la limite, vous pouvez demander une augmentation. Pour plus d'informations, reportez-vous à Affichage des limites de service dans la console Infrastructure et à Demande d'augmentation de limite de service.

• Si l'une de vos briquets utilise le composant OAuth2Client pour accéder aux API REST Oracle Digital Assistant, le service d'authentification sur lequel elles s'appuient doit être mis à jour afin d'utiliser la nouvelle application confidentielle OCI IAM provisionnée pour l'instance Gen 2. Vous devrez mettre à jour l'ID client, la clé secrète client et la portée. Pour savoir comment obtenir les nouvelles valeurs, reportez-vous à la rubrique Envoi de demandes dans API REST pour Oracle Digital Assistant sur Oracle Cloud Infrastructure. Pour en savoir plus sur la mise à jour du service d'authentification, reportez-vous à Services d'authentification.

• L'adresse d'API Sessions a changé. Elle inclut désormais l'ID utilisateur et l'ID de canal en plus de l'ID de session. Pour tout composant personnalisé appelant cette API afin d'obtenir le journal des conversations, vous devez modifier cet appel d'API. En outre, l'ID client, la clé secrète client et la portée que vous utilisez pour obtenir le jeton d'accès permettant d'autoriser l'appel REST doivent être mis à jour. Pour les composants personnalisés qui accèdent à l'API Sessions, vous devez apporter les modifications suivantes :

  • Votre code doit appeler conversation.channelId() pour obtenir l'ID de canal du chemin de demande.
  • Vous devez remplacer le chemin de demande par /api/v1/bots/sessions/{channelId}/{userId}/{sessionId}/log. Actuellement, l'ID utilisateur possède la même valeur que l'ID de session.
  • Si le composant personnalisé extrait le jeton d'accès, l'ID client, la clé secrète client et la portée doivent être mis à jour dans l'appel REST vers l'adresse du jeton d'accès. Pour savoir comment obtenir les nouvelles valeurs, reportez-vous à la rubrique Envoi de demandes dans API REST pour Oracle Digital Assistant sur Oracle Cloud Infrastructure.

  Après avoir apporté les modifications, repackagez les composants. Ensuite, pour toutes les briques avec un service de composant pour le package de composants, rechargez le package.

  Pour plus d'informations sur l'API, reportez-vous à API REST pour Oracle Digital Assistant sur Oracle Cloud Infrastructure.

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

• Les types de canal de kit SDK Web, Android et iOS dans les instances Gen 1 sont remplacés par les versions natives Oracle de ces types de canal dans Gen 2 (avec de nouveaux kits SDK pour chaque type de canal). Si vous disposez de briques ou d'assistants numériques qui utilisent les anciens types de canal, vous devez les migrer afin d'utiliser les nouveaux types de canal natifs Oracle.

  Reportez-vous à Exemples de personnalisation et de programmation de kit SDK Web Oracle Digital Assistant sur le blog TechExchange blog pour obtenir des exemples concrets d'adaptation du code d'application Web au nouveau kit SDK Web.

• Vous pouvez maintenant utiliser les intentions de réponse pour ajouter la fonctionnalité de FAQ à une brique. Contrairement à la fonctionnalité de questions/réponses, les intentions de réponse sont résolues avec le traitement du langage naturel. De plus, vous n'avez pas besoin de mettre à jour le flux de dialogue pour gérer les intentions de réponse comme pour un module de questions/réponses.

• Diverses autres fonctionnalités et améliorations sont disponibles dans les instances Gen 2 de Digital Assistant qui ne sont pas disponibles dans les instances Gen 1. Pour obtenir un résumé de ces fonctionnalités, reportez-vous à Nouveautés d'Oracle Digital Assistant.

Pour les instances Digital Assistant qui ont été migrées de l'infrastructure cloud Gen 1 vers Gen 2, vous utilisez une application de domaine d'identité OCI IAM pour gérer l'accès à Digital Assistant.

Dans les instances Gen 2, les rôles d'application suivants sont disponibles :

• ServiceAdministrator : fournit des droits d'accès complets pour l'instance. Dans les instances Gen 1, le rôle ServiceDeveloper fournit ce niveau d'accès.
• ServiceDeveloper : fournit des droits d'accès pertinents pour les utilisateurs qui développent des briques et des assistants numériques. Ce rôle ne dispose pas de droits d'accès administrateur (tels que la possibilité de purger les données).
• ServiceBusinessUser : fournit un sous-ensemble de droits d'accès ServiceDeveloper et se concentre principalement sur la possibilité de travailler sur les rapports d'analyse.

Par défaut, le rôle ServiceAdministrator est affecté à tous les utilisateurs d'une instance migrée. Pour les utilisateurs qui ne doivent pas disposer des droits d'accès ServiceAdministrator complets, vous pouvez modifier leur rôle afin qu'il soit en adéquation avec leur utilisation de l'instance.

Comme Oracle Cloud Infrastructure (Gen 2) est une architecture colocative, les instances Digital Assistant migrées vers Gen 2 ne possèdent pas leur propre plage d'adresses IP. A la place, vous disposez d'une plage d'adresses IP publiques déterminées par la région dans laquelle réside l'instance. Si une liste d'autorisation avec une plage d'adresses IP était déjà établie pour votre instance lorsqu'elle se trouvait sur l'infrastructure Gen 1, vous devez mettre à jour cette liste avec les adresses IP publiques fournies dans l'infrastructure Gen 2.

Pour déterminer la plage d'adresses IP de votre région, reportez-vous à Adresses IP publiques pour les réseaux cloud virtuel et Oracle Services Network.