Configurer

Intégrez Dify Enterprise Edition avec Oracle AI Database 26ai pour tirer parti du stockage vectoriel multimodal et de l'extraction efficace. Pour activer les capacités de stockage vectoriel et d'extraction d'Oracle AI Database 26ai, préconfigurez la base de données et modifiez les paramètres dans Dify pour vous assurer que les données vectorielles peuvent être écrites et extraites de manière transparente au moyen de l'intégration de l'application Dify et d'Oracle AI Database 26ai.

Préconfigurer un environnement Oracle AI Database 26ai dédié

Dans Dify Enterprise Edition (EE), installez et configurez la base de données Pluggable Database (PDB) Oracle.
Vous devez d'abord créer un utilisateur d'accès à la base de données dans la base de données enfichable Oracle. Configurez ensuite l'utilisateur et le mot de passe de la connexion à la base de données dans le fichier de configuration Dify EE. Le nom du service de base de données enfichable est suffisant. Procédez de la façon suivante :
  1. Connectez-vous à Oracle AI Database 26ai.
  2. Passez à la base de données enfichable cible.
    1. Exécutez la commande show pdbs pour voir toutes les bases de données enfichables disponibles (telles que PDB1).
    2. Passez au conteneur de la base de données enfichable cible à l'aide de l'exemple de commande suivant :
      alter session set container=PDB1
  3. Créez un utilisateur Dify et autorisez.
    1. Exécutez la commande suivante pour créer un utilisateur dédié :
      create user dify identified by password default tablespace users quota unlimited on users
    2. Exécutez la commande suivante pour accorder des autorisations de développement de base de données à l'utilisateur :
      grant db_developer_role to dify
    Cela garantit que l'utilisateur dispose des autorisations de création de table et d'opérations d'index vectoriel.
  4. Créez un tokeniseur de recherche vectorielle.
    Exécutez des instructions PL/SQL pour créer un disjoncteur de mots multilingue. Par exemple :
    BEGIN CTX_DDL.CREATE_PREFERENCE('dify.world_ lexer ','WORLD_LEXER');
    END; /.
    Ce briseur de mots peut traiter le texte en plusieurs langues, y compris le chinois et l'anglais, pour assurer une récupération de texte précise.

Connecter Dify à Oracle AI Database

Suivez ces étapes pour codifier les valeurs et les modèles Helm Dify, puis appliquez et vérifiez la configuration pour vous connecter à Oracle AI Database 26ai.
  1. Modifiez la configuration values.yaml.
    Ajoutez des paramètres de base de données vectorielle Oracle au fichier de configuration Helm de Dify pour spécifier les informations de connexion à la base de données et la méthode d'authentification.
    vectorDB:
      externalType: "oracle"
      externalOracleVectoRS:
        dsn: "Oracle_IP:1521/PDB1"  # Database address and PDB
        user: "dify"                # Dify dedicated username
        password: "dify_1234"       # Password
        config_dir: "/app/api/storage/wallet"
        wallet_location: "/app/api/storage/wallet"
        is_autonomous: "false"      # Is it an autonomous database?
  2. Modifiez le fichier de modèle Dify. Ajustez le modèle de configuration sous le répertoire d'installation Dify pour vous assurer que les variables d'environnement et les clés Oracle peuvent être montées correctement.
    1. Ajoutez la déclaration de variable d'environnement Oracle dans vectordb-config.yaml.
      {{- else if eq .Values.vectorDB.externalType "oracle" }}
      ORACLE_DSN: {{ .Values.vectorDB.externalOracleVectoRS.dsn | quote }}
      ORACLE_USER: {{ .Values.vectorDB.externalOracleVectoRS.user | quote }}
      ORACLE_CONFIG_DIR: {{ .Values.vectorDB.externalOracleVectoRS.wallet_location | quote }}
      ORACLE_WALLET_LOCATION: {{ .Values.vectorDB.externalOracleVectoRS.wallet_location | quote }}
      ORACLE_IS_AUTONOMOUS: {{ .Values.vectorDB.externalOracleVectoRS.is_autonomous | quote }}
    2. Ajoutez une configuration de chiffrement de mot de passe à vectordb-secret.yaml pour éviter de stocker les données d'identification en texte brut.
      {{- else if eq .Values.vectorDB.externalType "oracle" }}
      ORACLE_PASSWORD: {{ .Values.vectorDB.externalOracleVectoRS.password | b64enc | quote }}
      ORACLE_WALLET_PASSWORD: {{ .Values.vectorDB.externalOracleVectoRS.wallet_password | b64enc | quote }}
  3. Appliquez la configuration et vérifiez.
    1. Exécutez la mise à niveau de Helm pour mettre à jour la configuration Dify.
    2. Exécutez kubectl dans le pod d'API pour vérifier que les variables d'environnement sont en vigueur et assurez-vous que VECTOR_STORE=oracle.
    3. Répétez la vérification dans le groupe de travail pour confirmer que tous les composants d'affaires peuvent lire la configuration Oracle.