Извлечь JSON с помощью Jsonpath

Запрос JSONPath вычисляет выражение JSONPath по документу JSON и возвращает совпадающие значения в виде сериализованной строки JSON-массива. Та же библиотека jsonpath обслуживает эту страницу и программный helper API для агентов, которым нужна повторяемая логика извлечения.

Как это работает

Документ разбирается один раз, затем выражение вычисляется по полученному дереву. Совпадения собираются в массив — скалярные попадания становятся элементами, множественные из фильтров или шаблонов включаются все. Результат снова сериализуется как текст JSON, чтобы вставить его в другие инструменты или промпты агентов без ручного копирования отдельных полей.

Когда использовать

• Извлекать вложенные поля из больших JSON-блоков REST или GraphQL
• Фильтровать массивы перед суммаризацией LLM, чтобы снизить стоимость токенов
• Прототипировать запросы перед встраиванием в код агента или обработчики skill
• Отлаживать фикстуры API, проверяя пути вроде $.store.book[*].author

Пример

На примере JSON с пончиком, входящем в инструмент, выражение $.topping[*].type возвращает в поле результата ["None","Glazed","Sugar",...].

Ограничения

Некорректный JSON или искажённые выражения показывают строку ошибки вместо частичных результатов. Очень большие документы полностью загружаются в память браузера. Детали диалекта JSONPath (фильтры, рекурсивный спуск) следуют встроенной библиотеке — сверяйте крайние случаи с вашим production-рантаймом, если они отличаются.

Этот скилл доступен через A2A JSON-RPC и REST. Если вы уже знаете skillId и export, вызывайте execute напрямую—без discovery.

Пример REST

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

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

Полное руководство Agent API · Схема скилла