Documentation sur Oracle Cloud Infrastructure

Utiliser le mot clé AI pour entrer des invites

Utilisez AI comme mot clé dans un énoncé SELECT pour interagir avec la base de données à l'aide d'invites en langage naturel.

Le mot clé AI dans un énoncé SELECT indique au moteur d'exécution SQL d'utiliser le LLM identifié dans le profil d'IA actif pour traiter le langage naturel et générer du SQL.

Vous pouvez utiliser le mot clé AI dans une interrogation avec des clients Oracle tels que SQL Developer, des carnets OML et des outils de tierce partie pour interagir avec une base de données en langage naturel.

Note

Vous ne pouvez pas exécuter d'énoncés PL/SQL, d'énoncés LDD ou d'énoncés LMD à l'aide du mot clé AI.

Syntaxe

La syntaxe d'exécution de l'invite d'intelligence artificielle est la suivante :
SELECT AI action natural_language_prompt

Paramètres

Les paramètres disponibles pour le paramètre action sont les suivants :
Paramètre Description

runsql

Exécute la commande SQL sous-jacente pour l'invite de langage naturel et prend en charge la génération augmentée par extraction (RAG). Il s'agit de l'action par défaut et ne nécessite pas de spécifier ce paramètre.

showsql

Affiche l'instruction SQL pour une invite en langage naturel.

explainsql

Explique le code SQL généré à partir de l'invite dans un langage naturel. Cette option envoie le code SQL généré au fournisseur d'IA pour produire une explication en langage naturel.

narrate

L'action narrate prend en charge le langage naturel en langage SQL (NL2SQL) et la RAG.

Pour NL2SQL, narrate envoie le résultat d'une interrogation SQL exécutée par la base de données au LLM, qui génère une description en langage naturel de ce résultat.

Pour la RAG, lorsque le profil IA inclut un index vectoriel, le système utilise le modèle de transformateur spécifié (ou transformateur par défaut) pour créer un vecteur incorporant à partir de l'invite de recherche de similarité sémantique par rapport à la banque de vecteurs. Le système ajoute ensuite le contenu extrait de la banque de vecteurs à l'invite de l'utilisateur et l'envoie au LLM pour générer une réponse basée sur ces informations.

Si vous ne voulez pas que les données de table ou les documents de recherche vectorielle soient envoyés à un LLM, un utilisateur disposant de privilèges d'administrateur peut désactiver cet accès pour tous les utilisateurs de la base de données indiquée. Cela, en effet, désactive l'action narrate.

chat

Transmet l'invite de l'utilisateur directement au GML pour générer une réponse, qui est fournie à l'utilisateur.

Pour les conversations à court terme basées sur une session, si conversation dans la fonction DBMS_CLOUD_AI.CREATE_PROFILE est réglé à true, cette option inclut le contenu d'interactions ou d'invites précédentes, y compris éventuellement les métadonnées de schéma.

Pour plusieurs conversations nommées, seuls les historiques d'invites liés au clavardage sont envoyés au LLM. Pour en savoir plus, voir Sélectionner des conversations avec l'intelligence artificielle.

showprompt

Cette action prend en charge NL2SQL et la RAG. Cette action ne prend pas en charge la génération de données synthétiques, explainsql et narrate.

Afficher l'invite construite qui serait envoyée au modèle d'IA générative.

summarize

Génère un sommaire du contenu de vos fichiers texte et volumineux à l'aide de fournisseurs d'intelligence artificielle spécifiés par l'utilisateur. Si votre profil d'intelligence artificielle est défini dans la session, vous pouvez utiliser SELECT AI SUMMARIZE <TEXT>.

Voir Générer un sommaire avec Sélectionner l'intelligence artificielle et Exemple : Sélectionner des actions d'intelligence artificielle pour en savoir plus.

Si vous voulez personnaliser la génération de sommaire, utilisez la fonction DBMS_CLOUD_AI.SUMMARIZE. Voir Exemple : Sélectionner le sommaire de l'intelligence artificielle pour en savoir plus.

feedback

Vous permet de fournir des commentaires en langage naturel pour améliorer la capacité du LLM à générer des interrogations SQL plus précises. Vous pouvez l'utiliser en même temps que les autres actions Select AI telles que runsql, showsql et explainsql. Pour en savoir plus, voir Rétroaction.

Note

Cette fonction est disponible uniquement sur Oracle AI Database 26ai. Si vous utilisez narrate, assurez-vous que le profil est configuré pour la génération SQL et non pour la RAG.

translate

Vous permet d'utiliser l'IA générative à partir du service de traduction OCI pour traduire votre invite dans la langue préférée spécifiée comme attribut target_language dans votre profil d'IA.

agent

Appelle l'équipe de l'agent à traiter l'invite de langage naturel. Pour plus de détails, voir Sélectionner un agent d'IA et Exemples d'utilisation de Sélectionner un agent d'IA.

Pour savoir comment utiliser ces actions, voir Exemples d'utilisation de Select AI.

Notes d'utilisation

  • Le mot clé AI pour Sélectionner l'intelligence artificielle n'est pas pris en charge dans Database Actions ou le service APEX. Vous ne pouvez utiliser que la fonction DBMS_CLOUD_AI.GENERATE.

    N'utilisez pas DBMS_CLOUD_AI.SET_PROFILE dans Database Actions ou le service APEX. Définissez plutôt le profil d'intelligence artificielle dans l'argument profile_name de DBMS_CLOUD_AI.GENERATE.

  • Le mot clé AI n'est pris en charge que dans un énoncé SELECT.

  • Vous ne pouvez pas exécuter d'énoncés PL/SQL, d'énoncés LDD ou d'énoncés LMD à l'aide du mot clé AI.

  • La séquence est SELECT suivie de AI. Ces mots clés ne sont pas sensibles à la casse. Après avoir défini votre profil d'intelligence artificielle à l'aide de DBMS_CLOUD_AI.SET_PROFILE et d'une action facultative, le texte suivant SELECT AI est une invite en langage naturel. Si aucun profil d'intelligence artificielle n'est défini, SELECT AI signale l'erreur suivante lors de l'exécution d'un énoncé SELECT AI : 

    ORA-00923: FROM keyword not found where expected
00923. 00000 -  "FROM keyword not found where expected"

  • Les règles d'utilisation de caractères spéciaux s'appliquent conformément aux directives d'Oracle. Par exemple, utilisez des guillemets simples deux fois si vous utilisez une apostrophe dans une phrase.

    select ai how many customers in SF don''t own their own home

  • Les LLM sont soumis à des hallucinations et les résultats ne sont pas toujours corrects :

    • Il est possible que SELECT AI ne puisse pas exécuter l'interrogation SQL générée pour une invite de langage naturel spécifique.

    • Il est possible que SELECT AI ne puisse pas générer une interrogation SQL pour une invite de langage naturel spécifique.

    • Il est possible que le LLM ne génère pas d'interrogation SQL qui produit un résultat correct à partir de votre invite de langage naturel.

    Dans un tel scénario, SELECT AI peut répondre avec des informations pour vous aider à générer un énoncé SQL valide.

  • Pour obtenir de meilleurs résultats avec le langage naturel pour la génération SQL, utilisez des vues de base de données ou des tables avec des noms de colonne contextuels ou envisagez d'ajouter des commentaires de colonne expliquant les valeurs stockées dans les colonnes.

  • Utilisez l'action explainsql, comme dans SELECT AI explainsql, pour obtenir une explication plus détaillée de l'énoncé SQL, par rapport à SELECT AI showsql.

  • Pour accéder aux vues DBA ou USER, voir Vues DBMS_CLOUD_AI.