JSON mit Jsonpath extrahieren

Die JSONPath-Abfrage wertet einen JSONPath-Ausdruck gegen ein JSON-Dokument aus und gibt passende Werte als serialisierte JSON-Array-Zeichenkette zurück. Dieselbe jsonpath-Bibliothek treibt diese Seite und die programmatische Helper-API für Agenten mit wiederholbarer Extraktionslogik.

So funktioniert es

Das Dokument wird einmal geparst, dann der Ausdruck gegen den resultierenden Baum ausgewertet. Treffer werden in einem Array gesammelt—skalare Treffer erscheinen als Elemente, mehrere Treffer aus Filtern oder Wildcards werden alle einbezogen. Das Ergebnis wird erneut als JSON-Text serialisiert, damit Sie es in andere Tools oder Agenten-Prompts einfügen können, ohne einzelne Felder manuell zu kopieren.

Wann Sie es nutzen

• Verschachtelte Felder aus großen REST- oder GraphQL-JSON-Blöcken extrahieren
• Arrays vor einer LLM-Zusammenfassung filtern, um Token-Kosten zu senken
• Abfragen prototypisieren, bevor sie in Agenten-Code oder Skill-Handler wandern
• API-Fixtures debuggen, indem Sie Pfade wie $.store.book[*].author testen

Beispiel

Beim mitgelieferten Donut-Beispiel-JSON liefert der Ausdruck $.topping[*].type im Ergebnisfeld ["None","Glazed","Sugar",...].

Einschränkungen

Ungültiges JSON oder fehlerhafte Ausdrücke zeigen eine Fehlerzeichenkette statt Teilergebnisse. Sehr große Dokumente werden vollständig im Browser-Speicher geladen. Dialekt-Details von JSONPath (Filter, rekursiver Abstieg) folgen der gebündelten Bibliothek—prüfen Sie Grenzfälle gegen Ihre Produktionslaufzeit, falls sie abweichen.

Dieser Skill ist über A2A JSON-RPC und REST verfügbar. Wenn Sie Skill-ID und Export kennen, rufen Sie execute direkt auf—ohne Discovery.

REST-Beispiel

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

A2A JSON-RPC-Beispiel

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"
        ]
      }
    }
  }
}

Vollständige Agenten-API-Anleitung · Skill-Schema