Documentation Oracle Cloud Infrastructure

Création d'un outil SQL dans des agents d'IA générative

Dans les agents d'IA générative, chaque agent doit disposer d'un ou de 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 Instructions 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.
    La description du schéma de base de données dans cet outil aide l'agent à mieux comprendre comment générer des instructions de requête SQL.
  3. Pour Importer la configuration de schéma de base de données, sélectionnez l'une des options suivantes afin de fournir le schéma de base de données à utiliser pour cet outil. Un schéma est un ensemble d'instructions 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.
    • En ligne : entrez une chaîne contenant les instructions SQL. La chaîne doit commencer par un mot-clé SQL valide tel que CREATE et ALTER, ou par une parenthèse ouvrante (.
    • Choisir à partir d'Object Storage : sélectionnez un compartiment et un bucket. Sélectionnez ensuite le fichier .sql qui contient les instructions SQL.
  4. Pour Personnalisation de modèle, sélectionnez l'une des options suivantes.
    • Petit : sélectionnez cette option pour les requêtes 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 requêtes plus complexes telles que "Afficher les ventes moyennes des 5 produits les plus performants dans Q1 2023, regroupées 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 l'une des options suivantes.
    • SQLite : sélectionnez cette option pour générer des requêtes SQL qui correspondent aux règles de syntaxe SQLite. Par exemple : SELECT * FROM users LIMIT 5;
    • Oracle SQL : sélectionnez cette option pour générer des requêtes qui correspondent aux règles de syntaxe SQL Oracle. 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'une base de données Oracle Database.

  6. (Facultatif) Dans Exemples de formation en contexte, sélectionnez l'une des options suivantes pour fournir des exemples de requêtes en langage naturel que les utilisateurs peuvent demander dans le contexte du schéma fourni et des requêtes SQL attendues à générer.
    • En ligne : entrez une chaîne contenant des exemples de questions en langage naturel et les requêtes SQL attendues.

      Exemples :

      Question: Show all employees who were born in CA.
Oracle SQL: SELECT * FROM Employees WHERE BIRTHSTATE = 'CA';
    • Choisir à partir d'Object Storage : sélectionnez un compartiment et un bucket. 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 une connexion dans le menu.

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

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

    Remarque

    Le test de connexion vérifie uniquement que la configuration de la connexion à la base de données dans le service Database Tools 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 stratégies pour vous assurer que les agents Generative AI 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 enlever la connexion.
  8. (Facultatif) Dans Activer l'exécution SQL, sélectionnez cette option pour activer ou désactiver l'exécution SQL.

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

    Conseil

    Pour stocker les résultats supérieurs à 100 lignes dans un bucket Object Storage, sélectionnez Activer le stockage des résultats de sortie volumineux dans l'adresse d'agent.
  9. (Facultatif) Dans Activer la correction SQL, sélectionnez cette option pour activer ou désactiver l'auto-correction.

    Activez l'auto-correction pour corriger la requête si une erreur se produit lors de l'exécution. Envisagez de ne pas activer l'auto-correction pour une exécution plus rapide sur des requêtes plus simples.

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

    Exemples :

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

  11. (Facultatif) Dans 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.
    • En ligne : entrez une chaîne.

      Exemples :

      birthYear      Year employee was born
birthMonth     Month employee was born
    • Choisir à partir d'Object Storage : sélectionnez un compartiment et un bucket. Sélectionnez ensuite le fichier .txt contenant le texte descriptif des tables et colonnes de base de données.
    • Aucun : aucune description à fournir.
  12. Sélectionnez Créer un outil.
Conseil

Effectuez l'une des actions suivantes :

  • Si vous créez un agent, revenez à Création d'un agent dans des agents Generative AI pour créer un autre outil ou une adresse.
  • Si vous avez ajouté l'outil à un agent existant, une fois l'outil actif, sur la page de détails de l'agent, sélectionnez Lancer la discussion pour discuter avec l'agent à l'aide de cet outil.
  • Si vous avez créé l'agent sans adresse, lorsque vous êtes prêt à l'utiliser, créez une adresse pour cet agent.
Remarque

Pour permettre à un réviseur humain de surveiller et de modifier une requête générée avant de l'envoyer à l'utilisateur, sélectionnez la fonctionnalité facultative Activer l'humain dans la boucle dans l'adresse d'agent.