Estrai JSON con Jsonpath

La query JSONPath valuta un’espressione JSONPath su un documento JSON e restituisce i valori corrispondenti serializzati come stringa di array JSON. La stessa libreria jsonpath alimenta questa pagina e l’API helper programmatica per agenti che necessitano di estrazione ripetibile.

Come funziona

Il documento viene analizzato una volta, poi l’espressione viene valutata sull’albero risultante. Le corrispondenze sono raccolte in un array: i hit scalari compaiono come elementi, i multipli da filtri o wildcard sono tutti inclusi. Il risultato viene ri-serializzato come testo JSON così puoi incollarlo in altri strumenti o prompt di agenti senza copiare i singoli campi a mano.

Quando usarlo

• Estrarre campi annidati da grandi blob JSON REST o GraphQL
• Filtrare array prima di una sintesi LLM per ridurre il costo in token
• Prototipare query prima di incorporarle in codice agente o gestori di skill
• Eseguire il debug di fixture API testando percorsi come $.store.book[*].author

Esempio

Sul JSON di esempio del donut incluso nello strumento, l’espressione $.topping[*].type restituisce ["None","Glazed","Sugar",...] nel campo risultato.

Limitazioni

JSON non valido o espressioni malformate mostrano una stringa di errore invece di risultati parziali. Documenti molto grandi vengono caricati per intero nella memoria del browser. I dettagli del dialetto JSONPath (filtri, discesa ricorsiva) seguono la libreria inclusa: verifica i casi limite rispetto al runtime di produzione se differiscono.

Questa skill è disponibile via A2A JSON-RPC e REST. Se conosci già skillId ed export, chiama execute direttamente—senza discovery.

Esempio REST

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

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

Guida completa Agent API · Schema della skill