Configurer Ask Essbase

Vous pouvez utiliser ces étapes pour configurer, activer et gérer efficacement Ask Essbase pour une interrogation transparente basée sur l'IA dans votre environnement Oracle Essbase.

Prérequis

Avant de configurer Ask Essbase, effectuez les étapes décrites dans Prérequis pour les fonctionnalités AI.

  • Déploiement Marketplace : assurez-vous que le type de stockage de catalogue est défini sur Bucket Object Storage.

Remarques :

L'option Demander à Essbase est activée par défaut dans les déploiements Marketplace. Tous les utilisateurs peuvent soumettre des requêtes, mais seuls les administrateurs peuvent configurer ses paramètres.

Remarques :

Pour des performances optimales, utilisez un modèle de discussion Meta Llama lors de la création d'une connexion AI, par exemple, "meta.llama-4-scout-17b-16e-instruct". Pour visualiser les modèles disponibles, voir Modèles de base préentraînés.

Configurer la connexion de base de données

  1. Accédez à Sources.
  2. Cliquez sur Créer une connexion.
  3. Sélectionnez Oracle Database comme type de connexion.
  4. Entrez vos informations d'identification d'instance Oracle AI Database 26ai dans les détails de connexion.
  5. Cliquez sur Enregistrer.

Créer une connexion AI

  1. Accédez à Sources.
  2. Cliquez sur Créer une connexion.
  3. Sélectionnez GenAI comme type de connexion.
  4. Renseignez les paramètres pour renseigner la section Détails des informations d'identification de vecteur et de discussion :
    1. OCID utilisateur : recherchez cette valeur dans l'aperçu du fichier de configuration.
    2. OCID de location : recherchez cette valeur dans l'aperçu du fichier de configuration.
    3. ID de compartiment OCI : accédez à Identité dans la console Oracle Cloud Infrastructure, puis sélectionnez Compartiments. Vous pouvez y trouver l'ID de compartiment.
    4. Clé privée : reportez-vous aux clés et OCID requis pour obtenir des instructions sur la création de la clé privée.
    5. Empreinte : recherchez cette valeur dans l'aperçu du fichier de configuration.

    Remarques :

    Pour obtenir vos informations d'identification OCI, procédez comme suit :
    1. Connectez-vous à la console Oracle Cloud Infrastructure.
    2. Cliquez sur l'icône Profil, puis sélectionnez Paramètres utilisateur.
    3. Accédez à Jetons et clés.
    4. Sous la liste Empreinte, sélectionnez votre clé d'API.
    5. Cliquez sur le menu (trois points).
    6. Sélectionnez Afficher le fichier de configuration pour afficher l'aperçu du fichier de configuration.

    Remarques :

    Si vous n'avez pas configuré votre configuration OCI :
    1. Connectez-vous à la console Oracle Cloud Infrastructure.
    2. Cliquez sur l'icône Profil, puis sélectionnez Paramètres utilisateur.
    3. Accédez à Jetons et clés.
    4. Cliquez sur Ajouter une touche d'API.
    5. Sélectionnez Coller une clé publique.
    6. Sur la machine virtuelle, ouvrez le fichier de clés publiques et copiez le contenu de la clé publique.
    7. Revenez à la page Oracle Cloud Infrastructure et collez votre contenu de clé publique.
    8. Cliquez sur Ajouter.
    9. Une fois la clé d'API ajoutée, cliquez sur le menu (trois points), puis sélectionnez Afficher le fichier de configuration pour visualiser l'aperçu du fichier de configuration.

    Pour plus d'informations, reportez-vous aux clés et OCID requis.

  5. Utilisez les détails suivants pour compléter la section Détails du profil de discussion et la section Vectorisation et détails du générateur MDX :
    1. Modèle de discussion : sélectionnez meta.llama-4-maverick-17b-128e-instruct-fp8 ou tout modèle actuel répertorié sous Modèles de base préentraînés.
    2. Région OCI : us-chicago-1 (toutes les régions sont disponibles)
    3. URL du service d'IA générative : https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/20231130/actions/embedText
    4. Modèle d'intégration de vecteur : cohere.embed-english-v3.0
    5. Délai d'expiration de transfert: 3000
    6. Description : (facultatif)

Vectoriser la documentation

  1. Accédez à l'Académie.
  2. Sélectionnez Demander Essbase.
  3. Cliquez sur l'icône Paramètres, puis sélectionnez la connexion GenAI active que vous avez configurée.
  4. Cliquez sur Vectoriser.
    1. Cela démarre un travail en arrière-plan qui crée un index vectoriel, télécharge des fichiers vers le stockage OCI et prépare le système aux requêtes de chatbot.
    2. Vous pouvez suivre l'avancement des travaux dans l'interface utilisateur des travaux ou directement dans l'interface de chatbot.
    3. Vous n'avez besoin d'effectuer ce processus qu'une seule fois.

Utiliser Ask Essbase

  1. Une fois la vectorisation terminée, posez des questions directement dans Ask Essbase.
  2. L'IA fournit des réponses complètes ainsi que des liens vers la documentation complémentaire.

Désactiver

  1. Sélectionnez Paramètres, puis l'icône Supprimer sur la page de formulaire pour désactiver Ask Essbase.

    Remarques :

    Cette action lance un travail en arrière-plan qui supprime l'index vectoriel et la table de vecteurs, supprime le profil de discussion lié à l'index vectoriel et enlève tous les fichiers de pointeurs de documentation du bucket OCI.