Sparql Endpoint

La tâche « Sparql Endpoint » expose votre graphe de connaissances RDF comme un véritable point d'accès SPARQL, et ajoute par-dessus un champ en langage naturel : posez une question en mots simples et l'assistant écrit la requête SPARQL, que vous pouvez ensuite lire, corriger et exécuter.

Avertissement
Cette tâche ne fonctionne qu'avec des données RDF. Ajoutez une source de données graphe RDF et attendez la fin de l'indexation — jusque-là, la carte Sparql reste grisée.

Mettre la tâche en place

  1. Dans l'éditeur de l'assistant, sur l'onglet General , cliquez sur « Advanced » et sélectionnez la tuile « Sparql Endpoint ».
  2. Ajoutez votre fichier RDF sur l'onglet Add data si l'assistant n'en a pas encore.
  3. Cliquez sur Use pour ouvrir la page de l'assistant, dont le premier onglet est le point d'accès.
The SPARQL endpoint interface

Écrire du SPARQL soi-même

La moitié basse de la page est un éditeur SPARQL 1.1 sur votre graphe, adossé à qEndpoint. Il s'ouvre sur une requête « SELECT * … LIMIT 10 », moyen rapide de voir ce que contient réellement le graphe.

  • Onglets de requête — gardez plusieurs requêtes côte à côte ; « + » ajoute un onglet, le « × » le ferme.
  • Exécuter (▶) — exécute la requête de l'onglet actif. Les résultats apparaissent en dessous avec leur temps d'exécution.
  • Prefixes — insère les déclarations de préfixes usuelles, pour écrire « skos:Concept » au lieu de l'IRI complète.
  • Timeout — le nombre de secondes qu'une requête peut durer avant d'être abandonnée. À augmenter pour les requêtes coûteuses.
  • Partager — produit un lien qui réouvre le point d'accès avec cette requête déjà chargée.
SPARQL query results

Lire les résultats

Les résultats se lisent de quatre façons :

  • Table — une ligne par résultat, colonnes triables ; les IRI sont cliquables.
  • Response — la réponse brute renvoyée par le point d'accès, ce qu'il faut pour déboguer une requête.
  • Chart — trace les résultats, utile pour les comptages et les agrégations.
  • Clickable — les entités rendues de façon à parcourir le graphe en cliquant de l'une à l'autre.

Au-dessus des résultats se trouvent aussi un champ de filtre, un sélecteur de taille de page, les interrupteurs « Simple view » et « Ellipse » qui raccourcissent les IRI longues, et un bouton de téléchargement du jeu de résultats.

Demander en langage naturel

Le champ « Natural language query » en haut est la partie IA de cette tâche :

  1. Posez une question sur le graphe en mots simples, par exemple « Quels concepts sont définis dans le vocabulaire ? ».
  2. L'assistant la traduit en SPARQL et place la requête dans l'éditeur.
  3. Lisez la requête, ajustez-la si elle a manqué quelque chose, puis exécutez-la. Ce que vous voyez est exactement ce qui sera exécuté — rien ne se passe à votre insu.
Conseil
Les icônes à côté du champ notent la requête générée et permettent de la copier, la modifier ou la réinitialiser. Noter une mauvaise traduction est ce qui améliore la génération SPARQL pour votre graphe.
Avertissement
La traduction dépend de la langue des libellés du graphe. Si l'assistant est multilingue alors que vos libellés sont dans une seule langue, fixez cette langue sur l'assistant pour que les requêtes générées correspondent aux libellés.

Configurer la tâche

Tout se configure dans l'éditeur de l'assistant, non sur la page du point d'accès :

  • Instructions (onglet General) — le prompt qui transforme une question en SPARQL. C'est là que vous décrivez les particularités de votre schéma.
  • LLM Settings (onglet General) — le modèle, sa température et sa vitesse. Une température basse est de rigueur : SPARQL n'est pas un terrain de créativité.
  • Retrieving (onglet Add data → Parsing Options) — quelle part du vocabulaire du graphe est récupérée comme contexte, ainsi que les groupes de synonymes qui relient les mots de vos utilisateurs aux libellés du graphe.
An assistant configured for the Sparql Endpoint task
Conseil
Pour la génération SPARQL, le slot d'exemples de retours est particulièrement efficace : il réinjecte des paires question/requête dans le prompt, si bien que l'assistant apprend les idiomes de votre graphe. Voir Slots pour son utilisation.
Note
Le même point d'accès est joignable par programme — Sparql Endpoint API documente l'interface HTTP.