Извлечение значения по ключу: компонент Extract Key (AI Flowi Workflow)

Извлечение значения по ключу описано в каталоге для Extract Key так: «Извлекает конкретный ключ из объекта Data или списка объектов Data и возвращает извлечённое значение или значения в виде объекта или объектов Data». Порт Extracted Data в экспорте имеет тип JSON.

Extract Key описан в каталоге; Ai Flowi не проверяла его в производственной среде.

Автор: Ai Flowi · Опубликовано

Сведения из каталога

Интерфейс извлечения по ключу с двумя полями взят из записи processing.ExtractaKey в экспорте AI Flowi Workflow 1.9.2 от 9 октября 2026; запись в соответствующей категории приведена в каталоге компонентов.

Входы

И data_input, и key отмечены как необязательные. Эти отметки не описывают поведение при отсутствии источника или ключа.

Входы Extract Key из каталога (на узких экранах прокручивайте таблицу)
ИмяТипОбязательныйДопустимые типы входных данныхПояснение
data_inputotherНетData, JSONИсходный объект Data или список согласно описанию записи; допустимые типы соединений — Data и JSON.
keystrНетНе указаныКонкретный ключ для извлечения. Допустимый тип соединения, ключ по умолчанию и синтаксис вложенных путей не указаны.

Выходы

Выходы Extract Key в экспорте
Отображаемое имяИмяТип
Extracted Dataextracted_dataJSON

Extracted Data имеет имя extracted_data и тип JSON. Хотя в описании сказано, что значения становятся объектами Data, экспорт не содержит ни объекта-обёртки, ни структуры ответа с несколькими значениями.

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

Используйте Extract Key, когда нужно выбрать один именованный ключ в одном объекте или списке объектов. Перед передачей результата на другой вход JSON проверьте структуру Extracted Data, особенно если в некоторых исходных элементах этого ключа может не быть.

Когда выбрать другой компонент

Для выбора одного элемента по индексу рассмотрите Select Data; для фильтрации объекта по списку ключей — Filter Data. Для текстового вывода на основе шаблона следуйте существующему руководству по Parser.

Минимальная конфигурация

пример конфигурации, а не зафиксированный тест

Пример конфигурации Extract Key
Имя входа в каталогеПример настройки
data_inputПодключите выход JSON, синтетический исходный объект которого содержит ключ sample.
keysample

sample — выбранный ключ в данных, а не дополнительный вход компонента. Эта настройка иллюстрирует только выбор одного ключа; она не содержит извлечённых данных и не предполагает ни точечной нотации, ни порядка списка, ни запасного поведения при отсутствии ключа.

Ограничения

  • Каталог упоминает конкретный ключ, но не определяет вложенные пути, экранирование или чувствительность к регистру. Пример с одним ключом не подтверждает доступ к вложенным свойствам.
  • Результат для отсутствующих ключей, значений null и пустых списков не документирован. Не предполагайте, что в любом из этих случаев извлечение пропускает элемент, возвращает null или вызывает ошибку.
  • Для нескольких исходных объектов описание допускает несколько извлечённых значений, но не определяет их порядок, количество выходных значений или возвращаемую обёртку Data. Один лишь тип порта JSON не позволяет установить эту структуру.
  • Для поля key отсутствуют метаданные input_types, а для data_input указаны Data и JSON. Этот экспорт не подтверждает возможность соединения Message с key.

Для более общего изменения структуры объектов и имеющихся подтверждений тестирования обратитесь к JSON Operations; эти подтверждения не распространяются на Extract Key.

Учёт использования узла

Оцените использование ресурсов рабочего процесса с извлечением по ключу с помощью страницы тарифов и руководства по стоимости автоматизации.

Select Data · Filter Data · JSON Operations · Parser