Documentation sur Oracle Cloud Infrastructure

Création d'un outil SQL dans les agents d'intelligence artificielle générative

Dans les agents d'IA générative, chaque agent doit avoir un ou plusieurs outils. Vous pouvez créer l'outil d'un agent pendant ou après sa création. Pour les deux options, la création d'un outil a les mêmes étapes. Cette section présente les étapes de création d'un outil SQL.

Avant de créer un outil SQL, consultez les directives relatives aux outils SQL pour les agents d'IA générative et effectuez les tâches requises.

Créer un outil SQL

  1. Sélectionnez Créer un outil, puis SQL.
  2. Entrez le nom et la description de cet outil SQL.
    Une description du schéma de base de données dans cet outil aide l'agent à mieux comprendre comment générer des instructions d'interrogation SQL.
  3. Pour Importer la configuration du schéma de base de données, sélectionnez l'une des options suivantes pour fournir le schéma de base de données à utiliser pour cet outil. Un schéma est un ensemble d'énoncés SQL qui doivent inclure des tables, des colonnes, des types de données et des relations pour définir l'organisation des objets dans la base de données.
    • Dans le corps du message : Entrez une chaîne contenant les énoncés SQL. La chaîne doit commencer par un mot clé SQL valide tel que CREATE et ALTER ou par une parenthèse ouvrante (.
    • Sélectionner dans le stockage d'objets : Sélectionnez un compartiment et un seau. Sélectionnez ensuite le fichier .sql qui contient les énoncés SQL.
  4. Pour Personnalisation de modèle, sélectionnez une des options suivantes.
    • Petite : sélectionnez cette option pour les interrogations simples telles que "Obtenir le total des ventes pour janvier 2025". Un petit modèle offre des temps de réponse plus rapides.
    • Grande : Sélectionnez cette option pour les interrogations plus complexes telles que "Afficher les ventes moyennes des 5 produits les plus performants dans le répertoire Q1 2023 regroupés par région". Un grand modèle offre plus de précision, mais au prix d'une latence plus élevée.
  5. Pour Dialect, sélectionnez une des options suivantes.
    • SQLite : Sélectionnez cette option pour générer des interrogations SQL alignées sur les règles de syntaxe SQLite. Par exemple : SELECT * FROM users LIMIT 5;
    • Oracle SQL : Sélectionnez cette option pour générer des interrogations alignées sur les règles de syntaxe Oracle SQL. Par exemple : SELECT * FROM users FETCH FIRST 5 ROWS ONLY;

      Cette option garantit que le code SQL généré est entièrement compatible avec la syntaxe et l'environnement d'exécution d'Oracle Database.

  6. (Facultatif) Pour Exemples d'apprentissage en contexte, sélectionnez l'une des options suivantes pour fournir des exemples d'interrogations en langage naturel que les utilisateurs peuvent demander dans le contexte du schéma fourni et des interrogations SQL attendues à générer.
    • Dans le corps du message : Entrez une chaîne contenant des exemples de questions en langage naturel et les interrogations SQL attendues.

      Exemple :

      Question: Show all employees who were born in CA.
Oracle SQL: SELECT * FROM Employees WHERE BIRTHSTATE = 'CA';
    • Sélectionner dans le stockage d'objets : Sélectionnez un compartiment et un seau. Sélectionnez ensuite le fichier .txt qui contient des exemples de questions et de réponses dans le contexte du schéma de base de données.
    • Aucun : Aucun exemple à fournir.
  7. (Facultatif) Pour Connexion à l'outil de base de données, sélectionnez un compartiment, puis sélectionnez une connexion dans le menu.

    Une connexion n'est nécessaire que si vous souhaitez activer l'exécution SQL ou l'auto-correction au cours d'une session de clavardage.

    Pour vous assurer que la connexion sélectionnée fonctionne, sélectionnez Tester la connexion.

    Note

    Le test de connexion vérifie uniquement que la configuration de la connexion à la base de données dans le service d'outils de base de données fonctionne correctement et que la base de données est accessible. Le test ne valide pas l'accès de l'agent à la base de données. Utilisez des politiques pour vous assurer que les agents d'IA générative peuvent accéder à la base de données.
    Conseil

    Si vous ne voulez pas utiliser de connexion sur cet outil après en avoir sélectionné une, sélectionnez x à la fin du menu pour supprimer la connexion.
  8. (Facultatif) Pour Activer l'exécution SQL, sélectionnez pour activer ou désactiver l'exécution SQL.

    Lorsque l'exécution SQL est activée, l'agent génère l'énoncé d'interrogation SQL, exécute l'interrogation et envoie la réponse à l'utilisateur pendant la session de clavardage. Seules les interrogations SELECT, y compris la jointure, plusieurs conditions et l'agrégation, sont générées et exécutées. Si l'exécution échoue, l'agent retourne une erreur d'exécution de base de données avec le code ORA (par exemple, ORA-00933) ainsi que l'interrogation SQL générée.

    Conseil

    Pour stocker des résultats supérieurs à 100 rangées dans un seau de stockage d'objets, sélectionnez Activer le stockage des résultats de sortie volumineux dans le point d'extrémité de l'agent.
  9. (Facultatif) Pour Activer la correction SQL, sélectionnez pour activer ou désactiver l'auto-correction.

    Activez l'auto-correction pour corriger l'interrogation si une erreur est renvoyée lors de l'exécution. Envisagez de ne pas activer l'auto-correction pour une exécution plus rapide sur des interrogations plus simples.

  10. (Facultatif) Pour Instructions personnalisées, entrez du texte qui invite l'agent à se comporter de manière plus spécifique.

    Exemple :

    Always use aggregators such as COUNT, SUM, AVG, MIN, MAX in Oracle SQL queries that contain GROUP BY.

  11. (Facultatif) Pour Description des tables et des colonnes, sélectionnez l'une des options suivantes pour fournir des descriptions plus détaillées des tables et des colonnes utilisées dans la base de données.
    • Dans le corps du message : Entrez une chaîne.

      Exemple :

      birthYear      Year employee was born
birthMonth     Month employee was born
    • Sélectionner dans le stockage d'objets : Sélectionnez un compartiment et un seau. Sélectionnez ensuite le fichier .txt qui contient le texte descriptif des tables et des colonnes de la base de données.
    • Aucune : Aucune description à fournir.
  12. Sélectionnez Créer un outil.
Conseil

Effectuez une des actions suivantes :

Note

Pour permettre à un réviseur humain de surveiller et de modifier une interrogation générée avant de l'envoyer à l'utilisateur, sélectionnez la fonction facultative Activer l'humain dans la boucle dans le point d'extrémité de l'agent.