Extraire JSON avec Jsonpath

La requête JSONPath évalue une expression JSONPath sur un document JSON et renvoie les valeurs correspondantes sérialisées en chaîne de tableau JSON. La même bibliothèque jsonpath alimente cette page et l’API helper programmatique pour les agents qui ont besoin d’une extraction répétable.

Fonctionnement

Le document est analysé une fois, puis l’expression est évaluée sur l’arbre obtenu. Les correspondances sont collectées dans un tableau—les hits scalaires apparaissent comme éléments, les hits multiples issus de filtres ou de jokers sont tous inclus. Le résultat est re-sérialisé en texte JSON pour le coller dans d’autres outils ou prompts d’agents sans copier les champs un par un.

Quand l’utiliser

• Extraire des champs imbriqués de gros blobs JSON REST ou GraphQL
• Filtrer des tableaux avant une synthèse LLM pour réduire le coût en tokens
• Prototyper des requêtes avant de les intégrer dans du code d’agent ou des handlers de skills
• Déboguer des fixtures d’API en testant des chemins comme $.store.book[*].author

Exemple

Sur le JSON d’exemple « donut » fourni avec l’outil, l’expression $.topping[*].type renvoie ["None","Glazed","Sugar",...] dans le champ résultat.

Limites

Un JSON invalide ou une expression mal formée affiche une chaîne d’erreur au lieu de résultats partiels. Les très gros documents sont chargés entièrement en mémoire navigateur. Les détails du dialecte JSONPath (filtres, descente récursive) suivent la bibliothèque embarquée—vérifiez les cas limites face à votre runtime de production s’ils diffèrent.

Cette skill est disponible via A2A JSON-RPC et REST. Si vous connaissez déjà le skillId et l’export, appelez execute directement—sans découverte.

Exemple REST

curl -sS -X POST https://toolplaza.app/api/helpers/execute \
  -H 'Content-Type: application/json' \
  -d '{"skillId":"jsonpath__query","export":"queryJsonPath","args":["Hello"]}'

Exemple A2A JSON-RPC

Send POST https://toolplaza.app/api/a2a with:

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "message/send",
  "params": {
    "message": {
      "messageId": "uuid",
      "role": "user",
      "parts": [
        {
          "kind": "text",
          "text": "ignored"
        }
      ]
    },
    "metadata": {
      "toolplaza": {
        "skillId": "jsonpath__query",
        "export": "queryJsonPath",
        "args": [
          "Hello"
        ]
      }
    }
  }
}

Guide complet de l’API agents · Schéma de la skill