Voici un exemple d'utilisation de la fonctionnalité de recherche pour visualiser toutes les opérations de suppression :

1. Cliquez sur + Critères.
2. Dans le champ Filtre, sélectionnez Opération.
3. Dans le champ Opérateur, sélectionnez Commence par.
4. Dans le champ de valeur, entrez Delete.
5. Cliquez sur Rechercher.

Dans les résultats de cette recherche, vous verrez les entrées de toutes les opérations dont le nom commence par Delete, comme DeleteSkill ou DeleteSkillIntent.

Voici les types d'événement émis par les instances de service Oracle Digital Assistant :

com.oraclecloud.digitalassistant.changeodacompartment.begin

com.oraclecloud.digitalassistant.changeodacompartment.end

com.oraclecloud.digitalassistant.createodainstance.begin

com.oraclecloud.digitalassistant.createodainstance.end

com.oraclecloud.digitalassistant.deleteodainstance.begin

com.oraclecloud.digitalassistant.deleteodainstance.end

com.oraclecloud.digitalassistant.updateodainstance

Il s'agit d'un événement de référence pour les instances de service Oracle Digital Assistant.

{
  "id": "ocid1.eventschema.oc1.phx.abyhqljrfajridyag4epdbthdjuhwgkwxxog32ed4e36yx2zotmphyxe3z5q",
  "exampleEvent": {
    "eventID": "unique_id",
    "eventTime": "2019-10-09T13:58:03.575Z",
    "contentType": "application/json",
    "eventType": "com.oraclecloud.digitalassistant.createodainstance.end",
    "cloudEventsVersion": "0.1",
    "source": "DigitalAssistant",
    "extensions": {
      "compartmentId": "ocid1.compartment.oc1..unique_ID"
    },
    "eventTypeVersion": "2.0",
    "data": {
      "resourceName": "example_name",
      "compartmentId": "ocid1.compartment.oc1..unique_ID",
      "availabilityDomain": "all",
      "compartmentName": "example_name",
      "resourceId": "ocid1.odainstance.oc1.phx.unique_ID"
    }
  },
  "serviceName": "Digital Assistant",
  "displayName": "ODA Instance - Create End",
  "eventType": "com.oraclecloud.digitalassistant.createodainstance.end",
  "additionalDetails": [],
  "timeCreated": "2019-10-09T13:58:03.575Z"
}

Les mesures Oracle Digital Assistant sont émises avec l'espace de noms de mesure oci_digitalassistant.

Voici les mesures disponibles pour les instances Oracle Digital Assistant.

Vous pouvez afficher les mesures par instance de service ou de manière agrégée pour toutes les instances.

Pour afficher les mesures d'une instance de service, procédez comme suit :

1. Dans la console Infrastructure, cliquez sur , en haut à gauche, pour ouvrir le menu de navigation, sélectionnez Analytics et IA, puis cliquez sur Digital Assistant.
2. Sélectionnez le compartiment de l'instance.
3. Sélectionnez l'instance.
4. Accédez à la section Mesures de la page pour visualiser les mesures.

Pour afficher les mesures agrégées pour toutes les instances de service, procédez comme suit :

1. Dans la console Infrastructure, cliquez sur , en haut à gauche, pour ouvrir le menu de navigation, sélectionnez Observability and Management, puis cliquez sur Mesures de service.
2. Dans la liste déroulante Compartiments, sélectionnez le compartiment pour lequel afficher les mesures.
3. Dans Espace de noms de mesure, sélectionnez oci_digitalassistant.

La console Infrastructure propose différents outils de facturation et de paiement qui facilitent la surveillance de la facturation, des coûts de service et de l'utilisation d'Oracle Digital Assistant.

Pour visualiser les éléments d'utilisation et de facturation, procédez comme suit :

1. Connectez-vous à Oracle Cloud. Vous pouvez trouver votre nom de compte et vos informations de connexion dans le courriel de bienvenue.
2. Dans la console Infrastructure, cliquez sur en haut à gauche pour ouvrir le menu de navigation, sélectionnez Gouvernance et administration, puis l'une des options suivantes :

   • Analyse des coûts : fournit des outils de visualisation faciles à utiliser qui vous aident à suivre et à optimiser vos dépenses.

   • Rapports sur les coûts et l'utilisation : affichez des fichiers de valeurs séparées par des virgules (CSV) permettant d'obtenir une répartition détaillée des ressources pour les audits et le rapprochement des factures.

     Remarque
     
     

     La première fois que vous accédez aux rapports d'utilisation, vous devez créer une stratégie dans votre compartiment racine. Suivez la procédure de la page Rapport d'utilisation pour créer la stratégie, en copiant les instructions comme indiqué.

   • Budgets : définissez vos seuils de dépenses. Vous pouvez définir des alertes sur votre budget afin de savoir quand vous allez le dépasser, et vous pouvez consulter l'ensemble de vos budgets et dépenses au même endroit.

   • Factures : affichez et téléchargez les factures relatives à votre utilisation du service

Pour plus d'informations sur les outils de facturation et de paiement, reportez-vous à Présentation des outils de paiement et de facturation.

Si vous soumettez une demande de service et que le support technique Oracle détermine qu'il doit accéder à certaines de vos données à des fins de débogage, vous pouvez accepter de lui accorder un accès temporaire aux données de votre instance de service. Voici le flux général du processus :

1. Vous soumettez une demande de service.
2. Si le support technique Oracle estime qu'il a besoin d'accéder à vos données à des fins de débogage, il contacte l'administrateur par courriel pour approbation afin de recourir à une session Break Glass. (Le courriel contient un lien vers la page Approbation d'accès temporaire de votre instance Digital Assistant, où l'administrateur peut cliquer sur Approuver ou Rejeter.)
3. Si l'administrateur approuve la demande, un mot de passe temporaire est généré pour permettre au support technique Oracle de démarrer une session Break Glass dans laquelle il peut accéder aux données requises.
4. Une fois que le support technique Oracle a terminé son travail dans la session Break Glass, il y met fin. S'il ne met pas explicitement fin à la session, elle expire automatiquement dans le délai convenu avec vous.

Par défaut, Oracle fournit et gère les clés TDE pour le cryptage des données dans votre instance Digital Assistant.

Si l'option Break Glass est activée pour votre instance, vous pouvez également remplacer la clé privée fournie par Oracle par votre propre clé, ce qui vous assure également une rotation des clés selon vos besoins.

L'architecture Oracle Digital Assistant est conçue pour la haute disponibilité. Toutefois, si vous devez vous assurer que votre instance peut toujours fonctionner en cas de sinistre dans sa région, vous pouvez demander la configuration du basculement entre régions.

Lorsque le basculement entre régions est configuré et que l'instance principale tombe en panne :

• toutes les demandes d'exécution envoyées à l'instance principale sont redirigées vers l'instance de sauvegarde,
• une bannière apparaît dans l'interface utilisateur Digital Assistant, et indique que l'instance de sauvegarde est employée,
• Vous ne devez pas effectuer d'opérations sur les briques, les assistants numériques, les canaux, les analyses ou d'autres artefacts (via l'interface utilisateur ou via les API REST) dans l'instance de sauvegarde. Les modifications que vous apportez dans l'instance de sauvegarde ne seront pas conservées à la restauration de l'instance principale.

Lorsque la panne se termine :

• le service est restauré sur l'instance principale,
• toutes les données d'analyse cumulées sur l'instance de sauvegarde sont conservées et combinées avec les données d'analyse existantes associées à l'instance principale,
• Les artefacts tels que les briques et les assistants numériques sont restaurés à l'état dans lequel ils se trouvaient lors de la panne de l'instance principale. (En pratique, cela signifie simplement que toutes les modifications que vous apportez à ces artefacts dans l'instance de sauvegarde ne sont pas conservées.)

Pour configurer le basculement entre régions, procédez comme suit :

1. Enregistrez une demande de service pour le basculement inter-région et, dans la demande, indiquez l'URL d'instance de l'instance Digital Assistant principale.
2. Une fois que l'équipe de support technique vous a répondu avec des informations sur les régions de sauvegarde disponibles, abonnez-vous à une région de sauvegarde dans la console OCI.

   L'équipe de support créera ensuite l'instance de sauvegarde.

Lors de la configuration du basculement, une brique de niveau système (nommée Echo) est configurée dans l'instance que vous avez indiquée et exposée via un canal Web (nommé heartbeat) dans cette instance. A partir de la région de sauvegarde, l'instance principale est ensuite régulièrement interrogée pour connaître son état via cette brique.

Pour configurer une adresse privée pour Digital Assistant, procédez comme suit :

1. Assurez-vous que vous disposez des droits d'accès requis pour configurer des adresses privées et les attacher aux instances Digital Assistant.
2. Si vous ne les avez pas déjà en place, sur la console OCI, créez un réseau cloud virtuel (VCN) et ses ressources associées, notamment :
   • Au moins un sous-réseau.
   • Tables de routage : pour acheminer le trafic via le sous-réseau vers ses destinations.
   • Listes de sécurité ou Groupes de sécurité réseau afin d'établir un ensemble de règles de sécurité entrantes et sortantes que vous utiliserez pour l'adresse privée.
   • Eventuellement, une passerelle Internet pour accorder l'accès Internet au VCN.
   • (Facultatif) Une passerelle NAT (Network Address Translation), qui fournit aux ressources qui ne disposent pas d'adresses IP publiques accès à Internet sans les exposer aux connexions Internet entrantes.

   Reportez-vous à la documentation OCI relative aux réseaux cloud virtuels et aux sous-réseaux.

3. Créez l'adresse privée et associez-la à votre instance Digital Assistant.
4. Dans Digital Assistant, configurez un service de données ou un service REST qui pointe vers l'adresse.

Pour configurer des adresses privées, vous devez disposer des droits d'accès appropriés dans la console Infrastructure.

Il existe deux types de ressource pour les adresses privées qui englobent les droits d'accès requis suivants :

• oda-private-endpoints : permet de configurer des adresses privées et des proxies SCAN.
• oda-private-endpoint-attachments : permet d'attacher une adresse privée à une instance Digital Assistant.

Les droits d'accès de ces types de ressource font également partie du type de ressource oda-family. Par conséquent, si vous êtes couvert par une instruction de stratégie pour gérer les types de ressource oda-family dans le compartiment où se trouve votre adresse privée, vous n'avez pas à créer de stratégies distinctes pour vos adresses privées.

Vous trouverez ci-dessous des exemples de stratégies générales permettant de créer et de configurer des adresses privées et de les associer à des instances Digital Assistant.

allow group <group-name> to manage oda-private-endpoints in compartment <private-endpoint-compartment>
allow group <group-name> to manage oda-private-endpoint-attachments in compartment <private-endpoint-compartment>

Pour plus de détails sur le fonctionnement des stratégies, reportez-vous à Stratégies Digital Assistant.

1. 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).
2. Dans la navigation de gauche de la page Services AI qui apparaît, cliquez sur Adresses privées.
3. Si vous ne l'avez pas encore fait, créez le compartiment dans lequel vous souhaitez conserver l'adresse privée et, éventuellement, ajoutez le VCN et le sous-réseau que vous utiliserez à ce compartiment.

   Reportez-vous à Présentation des compartiments et à Gestion des compartiments.

4. Cliquez sur Créer une adresse privée et renseignez les champs requis, y compris le VCN et le sous-réseau privé.
5. Une fois l'adresse créée, cliquez sur Associer une instance ODA, sélectionnez le compartiment contenant l'instance Digital Assistant pour laquelle vous souhaitez pouvoir utiliser l'adresse privée, puis sélectionnez cette instance.

Une fois que vous avez créé une adresse privée, vous devez ajouter un service pour que cette adresse privée puisse l'utiliser dans Digital Assistant.

• Afin d'ajouter un service de données pour l'adresse privée, reportez-vous à Connexion au service de données.
• Afin d'ajouter un service REST pour l'adresse privée, reportez-vous à Ajout d'un service REST pour une adresse.

Si vous utilisez votre adresse privée pour une base de données compatible RAC, vous devez également configurer un proxy SCAN pour l'adresse privée.

Pour configurer un proxy SCAN :

1. Obtenez le nom DNS SCAN et le numéro de port de la base de données.
   • Si la base de données est sur site, obtenez-la auprès de l'administrateur de base de données.
   • Si la base de données se trouve sur OCI, procédez comme suit dans la console Infrastructure :
     1. Accédez à la page Détails du système de base de données de la base de données et sélectionnez l'onglet Informations sur le système de base de données.
     2. Dans la section Réseau de la page, copiez le nom DNS SCAN et collez-le à un endroit approprié.
     3. Notez le numéro de port.
2. Dans la console Infrastructure, cliquez sur en haut à gauche pour ouvrir le menu de navigation, sélectionnez Analytics et IA, puis Adresses privées (qui apparaît dans la catégorie Services d'IA sur la page).
3. Sélectionnez l'adresse privée.
4. Dans la section Ressources de la page, sélectionnez Proxies SCAN.
5. Cliquez sur Ajouter un proxy SCAN.
6. Dans la boîte de dialogue Ajouter un proxy SCAN, sélectionnez le type (Nom de domaine qualifié complet (pour le nom de domaine qualifié complet) ou l'adresse IP), puis renseignez les autres champs requis.
   • Si vous avez sélectionné Nom de domaine qualifié complet comme type de proxy, utilisez le nom DNS SCAN de la base de données pour le nom d'hôte et le numéro de port de la base de données comme port.
   • Si vous avez sélectionné Adresse IP comme type de proxy, cliquez sur Ajouter un processus d'écoute SCAN pour ajouter des adresses IP et des numéros de port pour des processus d'écoute SCAN dans la base de données.

En général, le processus d'import de packages à l'aide de l'API (directement ou via l'interface de ligne de commande ou l'un des kits SDK) est le suivant :

1. S'il n'existe pas encore, créez l'instance Oracle Digital Assistant dans laquelle importer le package.
   1. Appelez CreateOdaInstance pour créer l'instance.
   2. De la réponse à l'appel CreateOdaInstance, prenez la valeur d'en-tête de réponse opc-work-request-id et utilisez-la pour appeler GetWorkRequest afin de surveiller la progression de l'opération de création d'instance.
   3. Une fois la création de l'instance terminée, utilisez la valeur de l'attribut odaInstanceId renvoyée dans le corps de la réponse pour appeler GetOdaInstance.
2. Appelez ListPackages pour voir les packages disponibles pour la ou les instances que vous indiquez.
3. Pour tous les packages disponibles à importer, appelez GetPackage pour obtenir le contrat d'importation du package.

   Le contrat d'importation spécifie les conditions qui doivent être remplies pour que vous puissiez importer le package. Cela peut inclure des éléments tels que la spécification d'un fournisseur d'authentification et le remplissage de valeurs pour les paramètres personnalisés.

4. Satisfaire le contrat d'importation.

   Pour ce faire, vous créez une charge utile qui fournit des valeurs pour tous les paramètres requis dans le contrat d'importation. La charge utile peut ressembler à ceci :

   {
       "packageId": "<packageId-OCID>",
       "parameterValues": {
           "authProvider.providerX.clientSecret": "some value",
           "authProvider.providerX.authorizationEndpointUrl": "http://host:80/file",
           "authProvider.providerX.revokeEndpointUrl": "http://host:80/file",
           "authProvider.providerX.allowedScopes": "some value",
           "authProvider.providerX.tokenEndpointUrl": "http://host:80/file",
           "authProvider.IDCS_OAuthForIDR.allowedScopes": "some value",
           "authProvider.providerX.clientId": "some value",
           "skillParameter.da.backendRestEndPoint": "http://host:80/file",
       }
   }

   Pour simplifier cette tâche, la réponse GetPackage contient une section appelée defaultParameterValues que vous pouvez utiliser pour assembler la partie de valeur de paramètre de la charge utile.

5. Importez le package dans les instances.
   1. Appelez CreateImportedPackage en utilisant la charge utile que vous venez d'assembler.
   2. De la réponse à l'appel CreateImportedPackage, prenez la valeur d'en-tête de réponse opc-work-request-id et utilisez-la pour appeler GetWorkRequest afin de surveiller la progression de l'opération d'import de package.
   3. Une fois l'import de package terminé, utilisez la valeur de l'attribut odaInstanceId renvoyée dans le corps de la réponse pour appeler GetImportedPackage afin de visualiser les détails du package.

Si une mise à jour pour un package est disponible, vous pouvez ajouter ce package mis à jour à l'instance via l'opération UpdateImportedPackage.