Documentation Oracle Cloud Infrastructure

Commentaires

Select AI vous permet de fournir des commentaires pour aider à améliorer la capacité de votre LLM sélectionné à générer des requêtes SQL plus précises.

Remarque

Remarque : cette fonctionnalité n'est disponible que sur Oracle AI Database 26ai. Vous pouvez l'utiliser avec les actions Select AI existantes : runsql, showsql et explainsql. Assurez-vous que votre profil AI est configuré pour la génération NL2SQL et non pour la RAG.

Vous pouvez fournir des commentaires pour améliorer la précision du code SQL généré via l'action feedback ou la procédure DBMS_CLOUD_AI.FEEDBACK. Sélectionnez AI crée un index vectoriel par défaut nommé <profile_name>_FEEDBACK_VECINDEX avec des attributs par défaut lorsque vous utilisez la fonctionnalité de retour pour la première fois. Cet index permet d'affiner les instructions SQL générées ultérieurement en fonction des commentaires fournis. Pour plus d'informations, reportez-vous à la section Vector Index for FEEDBACK.

A savoir : Utilisez la procédure DBMS_CLOUD_AI.FEEDBACK lorsque le LLM indiqué ne génère pas la requête SQL correcte ou ne renvoie pas le résultat attendu de l'une des actions SELECT AI NL2SQL. Vous pouvez également utiliser la procédure DBMS_CLOUD_AI.FEEDBACK pour ajouter directement le code SQL approprié à la table vectorielle. Cela aide à guider la génération future d'instructions SQL en servant de référence pour des invites similaires.

Les types de retour suivants sont acceptés :

  • Retour positif : vous approuvez et confirmez l'exactitude du code SQL généré. Le système stocke la requête confirmée pour référence ultérieure.

  • Retour négatif : si les résultats de l'action SELECT AI NL2SQL ne génèrent pas le code SQL correct, vous pouvez apporter les améliorations nécessaires à la requête SQL à l'aide de SELECT AI feedback <feedback> ou de la procédure DBMS_CLOUD_AI.FEEDBACK en identifiant les erreurs dans la requête ou en fournissant des conseils sur ce qui était attendu en prose. Le système affine la requête à l'aide d'un LLM et stocke la version affinée pour la génération future de requêtes Select AI. Les requêtes affinées stockées sont ensuite utilisées comme conseils et envoyées au LLM dans le cadre de l'invite augmentée.

Pour en savoir plus, reportez-vous à Procédure FEEDBACK et à Exemple : sélection d'un retour AI.

Avantages du retour

L'action et la procédure de retour dans Select AI introduit un mécanisme de réglage des invites qui améliore la précision de la génération des requêtes SQL.

Le propriétaire du profil AI peut fournir un retour pour les requêtes SQL générées et le système Select AI apprend à partir de l'interaction utilisateur au fil du temps. Cet apprentissage implique l'accumulation d'un référentiel d'invites et de contenu de retour où la recherche vectorielle est utilisée pour identifier les invites similaires à votre invite actuelle. Les principaux exemples de correspondance sont fournis en tant que métadonnées pour le LLM dans le cadre de l'invite augmentée. Les avantages sont les suivants :

  • Peut améliorer la précision des requêtes SQL.

  • Permet au propriétaire du profil AI de fournir un retour en confirmant les requêtes correctes ou en suggérant des corrections en fournissant l'intention sémantique ou les définitions métier pour produire une requête correcte.

  • Utilise les commentaires historiques comme conseils pour la génération future de requêtes, s'adaptant ainsi à vos besoins.

Comment utiliser les retours ?

Sélectionnez AI pour fournir des commentaires à l'aide de l'action feedback ou en appelant la procédure DBMS_CLOUD_AI.FEEDBACK.

Attention : n'utilisez pas l'action de retour dans les applications où plusieurs utilisateurs partagent des sessions de base de données sous un seul utilisateur de base de données propriétaire du profil AI. Le propriétaire du profil AI ne doit fournir un retour qu'après avoir confirmé que la requête corrigée est appropriée pour tous les utilisateurs de ce profil.

Vous pouvez fournir des commentaires en incluant les éléments suivants :

  • SQL_TEXT : incluez les commentaires entre guillemets pour la requête SQL en cours, ou vous pouvez obtenir SQL_TEXT pour une requête particulière en interrogeant la vue V$MAPPED_SQL.

  • SQL_ID : vous pouvez obtenir SQL_ID en interrogeant la vue V$MAPPED_SQL.

  • Utiliser le dernier SQL généré : fournissez vos commentaires en langage naturel.

Remarque

Remarque : pour utiliser le dernier SQL, veillez à désactiver la sortie du serveur dans Oracle SQL*Plus ou Oracle SQLcl. Vous devez disposer du privilège READ sur les tables sys.v_$session et v_$mapped_sql.

GRANT READ ON SYS.V_$MAPPED_SQL TO ADB_USER;
GRANT READ ON SYS.V_$SESSION TO ADB_USER;

Pour en savoir plus, reportez-vous à Procédure FEEDBACK et à Exemple : sélection d'un retour AI.