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

1. Cliquez sur + Criteria (+ Critères).
2. Dans le champ Filter (Filtre), sélectionnez Operation (Opération).
3. Dans le champ Operator (Opérateur), sélectionnez Starts With (Commence par).
4. Dans le champ de valeur, entrez Delete.
5. Cliquez sur Search (Rechercher).

Les résultats de cette recherche contiennent des entrées pour toutes les opérations dont le nom commence par Delete, par exemple DeleteSkill ou DeleteSkillIntent.

Les instances du service Oracle Digital Assistant émettent les types d'événement suivants :

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

Un événement de référence pour les instances du service Oracle Digital Assistant est présenté ci-dessous.

{
  "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 liées à 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 individuelle ou sous forme agrégée pour toutes les instances.

Pour voir les mesures associées à une instance de service individuelle :

1. Dans la console Oracle Cloud Infrastructure, cliquez sur dans la partie supérieure gauche pour ouvrir le menu de navigation, sélectionnez Analyse et intelligence artificielle, puis Digital Assistant.
2. Sélectionnez le compartiment de l'instance.
3. Sélectionnez l'instance.
4. Faites défiler vers la page vers le bas jusqu'à la section Metrics (Mesures) pour voir les mesures.

Pour voir les mesures agrégées pour toutes les instances de service :

1. Dans la console Oracle Cloud Infrastructure, cliquez sur dans la partie supérieure gauche pour ouvrir le menu de navigation, sélectionnez Observabilité et gestion, puis cliquez sur Mesures de service.
2. Dans le menu déroulant Compartiments, sélectionnez le compartiment pour lequel vous voulez voir les mesures.
3. Dans le champ Espace de noms de mesure, sélectionnez oci_digitalassistant.

La console Oracle Cloud Infrastructure offre 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 voir votre facturation et votre utilisation, procédez de la façon suivante :

1. Connexion à Oracle Cloud. Vous trouverez le nom du compte et les informations de connexion dans votre courriel de bienvenue.
2. Dans la console Oracle Cloud Infrastructure, cliquez sur dans la partie supérieure gauche pour ouvrir le menu de navigation, sélectionnez Gouvernance et administration, puis une des options suivantes :

   • Analyse des coûts : Cette option offre des outils de visualisation faciles à utiliser qui vous aident à contrôler vos dépenses Oracle Cloud Infrastructure et à les optimiser.

   • Rapports de coût et d'utilisation : Consultez les fichiers CSV (valeurs séparées par des virgules) pour obtenir la répartition détaillée des ressources aux fins de vérification ou de rapprochement des factures.

     Note
     
     

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

   • Budgets : Définissez des seuils pour vos dépenses. Vous pouvez définir des alertes afin d'être informé des éventuels dépassements de budget et afficher l'ensemble de vos budgets et dépenses dans un emplacement unique.

   • Factures : Consultez et téléchargez les factures pour votre utilisation.

Pour plus d'informations sur les outils de facturation et de paiement, voir Aperçu des outils de facturation et de paiement.

Si vous soumettez une demande de service (DS) et qu'Oracle Support détermine qu'il a besoin d'accéder à certaines de vos données à des fins de débogage, vous pouvez accepter de lui donner 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 Oracle Support détermine qu'il a besoin d'accéder à certaines de vos données à des fins de débogage, il communiquera avec votre administrateur par courriel pour obtenir l'approbation nécessaire pour effectuer une session d'accès d'urgence. (Le courriel contient un lien vers la page d'approbation d'accès temporaire de votre assistant numérique, où votre administrateur peut cliquer sur Approuver ou Rejeter.)
3. Si votre administrateur approuve la demande, un mot de passe temporaire est généré pour permettre à Oracle Support de démarrer une session d'accès d'urgence, avec laquelle il peut accéder aux données requises.
4. Une fois que le soutien technique d'Oracle a terminé ses travaux dans la session d'accès d'urgence, il met fin à celle-ci. S'il ne met pas explicitement fin à la session, celle-ci expire automatiquement dans le délai convenu.

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

Si l'accès d'urgence est activé sur votre instance, vous pouvez également remplacer la clé privée fournie par Oracle par la vôtre, ce qui vous permet également d'effectuer une rotation des clés selon vos besoins.

Oracle Digital Assistant a une architecture haute disponibilité (HA). Toutefois, si vous devez vous assurer que votre instance peut toujours fonctionner si une catastrophe frappe la région où elle se trouve, vous pouvez demander la configuration d'un basculement inter-région.

Lorsque le basculement inter-région est configuré et que l'instance principale tombe en panne :

• Toute demande d'exécution vers l'instance principale est redirigée vers l'instance de sauvegarde.
• Une bannière apparaît dans l'interface utilisateur de Digital Assistant pour indiquer que l'instance de sauvegarde est utilisée.
• Vous ne devriez pas faire de travail sur les compétences, les assistants numériques, les canaux, les données clés ou d'autres artefacts (que ce soit par l'intermédiaire de l'interface utilisateur ou des API REST) dans l'instance de sauvegarde. Aucune des modifications effectuées dans l'instance de sauvegarde ne sera conservée lorsque l'instance principale sera restaurée.

À la fin de la panne :

• Le service à l'instance principale est restauré.
• Toutes les données clés accumulées sur l'instance de sauvegarde sont conservées et combinées avec les données clés existantes associées à l'instance principale.
• Des artefacts tels que les compétences et les assistants numériques sont restaurés à l'état où ils se trouvaient lorsque l'instance principale est tombée en panne. (Dans les faits, cela signifie simplement que tout changement que vous apportez à ces artefacts dans l'instance de sauvegarde ne sera pas préservé.)

Pour configurer le basculement inter-région :

1. Déposez une demande de service pour le basculement inter-région et, dans la demande, mentionnez l'URL d'instance de l'instance principale de Digital Assistant.
2. Une fois que l'équipe de soutien 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 soutien créera ensuite l'instance de sauvegarde.

Lors de la configuration du basculement, une compétence de niveau système (nommée Echo) est configurée dans l'instance que vous avez spécifiée et exposée au moyen d'un canal Web (nommé heartbeat) dans cette instance. À partir de la région de sauvegarde, l'instance principale est alors régulièrement interrogée pour connaître son statut d'état au moyen de cette compétence.

Pour configurer un point d'extrémité privé pour Digital Assistant, procédez comme suit :

1. Assurez-vous que vous disposez des autorisations requises pour configurer des points d'extrémité privés et les associer aux instances Digital Assistant.
2. Si vous ne les avez pas déjà en place, dans la console OCI, créez un réseau en nuage virtuel (VCN) et les ressources associées, notamment :
   • Au moins un sous-réseau.
   • Tables de routage pour acheminer le trafic à travers le sous-réseau vers ses destinations.
   • Listes de sécurité ou groupes de sécurité de réseau pour établir un jeu de règles de sécurité de trafic entrant et sortant que vous utiliserez pour le point d'extrémité privé.
   • Facultativement, une passerelle Internet pour accorder l'accès Internet au VCN.
   • Facultativement, une passerelle de traduction d'adresses de réseau, qui permet aux ressources qui n'ont pas d'adresses IP publiques d'accéder à Internet sans les exposer aux connexions Internet entrantes.

   Voir la documentation OCI pour les réseaux en nuage virtuels et les sous-réseaux.

3. Créez le point d'extrémité privé et associez-le à votre instance Digital Assistant.
4. Dans Digital Assistant, configurez un service de données ou un service REST qui pointe vers le point d'extrémité.

Pour configurer des points d'extrémité privés, vous devez disposer des autorisations appropriées dans la console d'infrastructure.

Il existe deux types de ressource pour les points d'extrémité privés qui englobent les autorisations requises suivantes :

• oda-private-endpoints - Permet de configurer des points d'extrémité privés et des mandataires SCAN.
• oda-private-endpoint-attachments - Permet d'attacher un point d'extrémité privé à une instance Digital Assistant.

Les autorisations pour ces types de ressource font également partie du type de ressource oda-family. Ainsi, si vous êtes couvert par un énoncé de politique pour gérer les types de ressource oda-family dans le compartiment où se trouve votre point d'extrémité privé, vous n'avez pas à créer de politiques distinctes pour vos points d'extrémité privés.

Voici des exemples de politiques étendues permettant la création et la configuration de points d'extrémité privés et leur association à 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 politiques, voir Politiques de Digital Assistant.

1. 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).
2. Dans la barre de navigation de gauche de la page Services d'intelligence artificielle qui s'affiche, cliquez sur Points d'extrémité privés.
3. Si vous ne l'avez pas encore fait, créez le compartiment dans lequel vous voulez conserver le point d'extrémité privé et, facultativement, ajoutez le VCN et le sous-réseau que vous allez utiliser à ce compartiment.

   Voir Présentation des compartiments et Gestion des compartiments.

4. Cliquez sur Créer un point d'extrémité privé et remplissez les champs obligatoires, notamment le VCN et le sous-réseau privé.
5. Une fois le point d'extrémité créé, cliquez sur Associer une instance ODA, sélectionnez le compartiment qui contient l'instance Digital Assistant que vous voulez pouvoir utiliser le point d'extrémité privé, puis sélectionnez cette instance.

Une fois que vous avez créé un point d'extrémité privé, vous devez ajouter un service pour ce point d'extrémité privé pour l'utiliser dans Digital Assistant.

• Pour ajouter un service de données pour le point d'extrémité privé, voir Se connecter au service de données.
• Pour ajouter un service REST pour le point d'extrémité privé, voir Ajouter un service REST pour un point d'extrémité.

Si vous utilisez votre point d'extrémité privé pour une base de données RAC, vous devez également configurer un mandataire SCAN pour le point d'extrémité privé.

Pour configurer un mandataire SCAN :

1. Obtenez le nom DNS SCAN et le numéro de port pour la base de données.
   • Si la base de données est une base de données sur place, obtenez-la auprès de l'administrateur de la base de données.
   • Si la base de données est sur OCI, effectuez les opérations suivantes dans la console d'infrastructure :
     1. Naviguez jusqu'à la page Détails du système de BD de la base de données et sélectionnez l'onglet Informations sur le système de BD.
     2. Dans la section Réseau de la page, copiez le nom DNS SCAN et collez-le à un endroit pratique.
     3. Notez le numéro de port.
2. Dans la console d'infrastructure, cliquez sur en haut à gauche pour ouvrir le menu de navigation, sélectionnez Analyse et intelligence artificielle et sélectionnez Points d'extrémité privés (qui s'affiche sous la catégorie Services d'intelligence artificielle dans la page).
3. Sélectionnez votre point d'extrémité privé.
4. Dans la section Ressources de la page, sélectionnez Proxies SCAN.
5. Cliquez sur Ajouter un mandataire SCAN.
6. Dans la boîte de dialogue Ajouter un mandataire SCAN, sélectionnez le type (Nom de domaine complet (pour le nom de domaine complet) ou Adresse IP), puis remplissez le reste des champs obligatoires.
   • Si vous avez sélectionné Nom de domaine complet comme type de mandataire, 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 pour le port.
   • Si vous avez sélectionné Adresse IP comme type de mandataire, cliquez sur Ajouter un module d'écoute SCAN pour ajouter des adresses IP et des numéros de port pour un ou plusieurs modules d'écoute SCAN dans la base de données.

En général, le processus d'importation d'ensembles à l'aide de l'API (directement ou au moyen de l'interface de ligne de commande ou de l'une des trousses SDK) est le suivant :

1. S'il n'existe pas encore, créez l'instance Oracle Digital Assistant dans laquelle vous voulez importer l'ensemble.
   1. Appelez CreateOdaInstance pour créer l'instance.
   2. À partir 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 pour 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 qui a été retournée dans le corps de la réponse pour appeler GetOdaInstance.
2. Appelez ListPackages pour voir quels ensembles sont disponibles pour l'instance (ou les instances) que vous spécifiez.
3. Pour tous les ensembles disponibles que vous voulez importer, appelez GetPackage pour obtenir le contrat d'importation de l'ensemble.

   Le contrat d'importation précise les conditions qui doivent être satisfaites avant que vous puissiez importer l'ensemble. 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 des données utiles qui fournissent des valeurs pour tous les paramètres requis dans le contrat d'importation. Les données utiles peuvent 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 nommée defaultParameterValues que vous pouvez utiliser pour assembler la partie de valeur de paramètre des données utiles.

5. Importez le paquetage dans les instances.
   1. Appelez CreateImportedPackage en utilisant les données utiles que vous venez d'assembler.
   2. À partir 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 pour surveiller la progression de l'opération d'importation d'ensemble.
   3. Une fois l'importation de l'ensemble terminée, utilisez la valeur de l'attribut odaInstanceId qui a été retournée dans le corps de la réponse pour appeler GetImportedPackage pour voir les détails de l'ensemble.

Si une mise à jour d'un ensemble est disponible, vous pouvez l'ajouter à l'instance au moyen de l'opération UpdateImportedPackage.