Все ноды/Data/DataFrame I/O

Конвертер форматов

Универсальный конвертер payload: json ↔ dataframe ↔ csv. Выберите исходный и целевой тип.

Конвертер форматов▶

ЗначениеЗначение

Ошибка

Тип в графе: convert

Exec

Можно включить выход ошибки и обработать сбой отдельным путём.

Порты можно разделить на исполнение и данные (split ports).

Как попробовать

Минимальный рабочий сценарий

Вход

Конвертер форматов▶

Выход▶

Исполнение + данные

Нажмите «Скопировать ноды», откройте редактор и нажмите Ctrl+V на холсте.

Запускается сразу

Как применять

Переводит значение между тремя формами: JSON (объект или список объектов), CSV-текст и таблица DataFrame. Чаще всего нода нужна на выходе из «табличного мира»: таблицу нельзя подставить в промпт, в тело HTTP-запроса или в Шаблон — сначала её надо превратить в JSON или CSV.

В обратную сторону конвертер требуется реже: ноды семейства DF и обе записи (CSV, XLSX) сами приводят к таблице список объектов и CSV-текст. Ставьте конвертер явно, когда нужно задать разбор — например разделитель ; или другую строку заголовка.

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

Пар конвертации четыре: JSON → DataFrame, DataFrame → JSON, DataFrame → CSV, CSV → DataFrame. Прямого пути между JSON и CSV нет: нужны две ноды подряд, через DataFrame. Проверка графа скажет об этом до запуска.

Поля меняются вместе с выбранной парой: «Разделитель» появляется, когда CSV участвует в паре, «Записывать заголовок» — при выводе в CSV, «Строка заголовка» — при чтении, «Макс. строк» — только при выводе в JSON.

Если «Из» и «В» совпадают, значение проходит насквозь без изменений.

Частые ошибки

«Из» не совпадает с тем, что пришло. Поле — это объявление, а не определение типа: нода не угадывает формат. Строка при «Из: JSON» даст ошибку вида «Cannot convert str to dataframe».
JSON → DataFrame из списка не-объектов. Ожидается список объектов (или один объект). Список чисел или строк таблицей не станет.
CSV → DataFrame с чужим разделителем. По умолчанию ,; выгрузка с ; превратится в одну колонку, а ошибки не будет.
DataFrame → JSON без «Макс. строк» перед моделью. В промпт уедет вся таблица, и она будет оплачена токенами. Ограничьте число строк или переведите в CSV — он заметно компактнее.

Входы

Порт	Провод	Данные	Примечания
Значение`value`	Исполнение + данные`execute_data`	—

Выходы

Порт	Провод	Данные	Примечания
Значение`output`	Исполнение + данные`execute_data`	—
Ошибка`on_error`	Исполнение + данные`execute_data`	—	показывается, когда expose_error_output = true

Настройки

Поле	Тип	По умолчанию	Описание
Разделитель`delimiter`	`string`	`,`	Символ между колонками. Для файлов из русского Excel обычно «;».
Из формата`from_kind`	`string`	`json`	Что приходит на вход. Варианты: `json` — JSON, `csv` — CSV (текст), `dataframe` — DataFrame
Строка заголовка`header_row`	`integer`	`0`	Индекс строки-заголовка при чтении CSV, 0 = первая строка (CSV → DataFrame). показывается при «Из формата» = CSV (текст)
Записывать заголовок`include_header`	`boolean`	`true`	Писать строку заголовка при выводе CSV (DataFrame → CSV). показывается при «В формат» = CSV (текст)
Макс. строк в JSON`max_rows`	`integer`	`0`	Ограничить число строк при конвертации DataFrame → JSON (0 = без ограничения). показывается при «В формат» = JSON
В формат`to_kind`	`string`	`dataframe`	Что нода отдаёт дальше. CSV и JSON преобразуются друг в друга через таблицу. Варианты: `json` — JSON, `csv` — CSV (текст), `dataframe` — DataFrame

Общие поля

Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.

expose_error_output — Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этой ноды.
split_ports_in — Показывать отдельные порты входа для выполнения и данных вместо одного объединённого.
split_ports_out — Показывать отдельные порты выхода для выполнения и данных вместо одного объединённого.