AIKraft/Skills/Двоичные данные n8n

Двоичные данные n8n

Use when handling files, images, attachments, or binary data in n8n, OR when an AI agent needs to take a user-uploaded file as tool input or return a generated file. For Data Tables (schemas, dedup, persistent state), see the separate n8n-data-tables skill. Triggers on

n8n-io official Дизайн

Что делает навык

Навык описывает работу с бинарными данными ($binary) в n8n, которые существуют параллельно с JSON ($json). Он решает задачу корректной обработки файлов, изображений и вложений, учитывая ограничения передачи бинарных данных через границы инструментов агента.

Когда применять

  • Обработка загруженных пользователем файлов как входных данных для инструментов
  • Возврат сгенерированных файлов от агента
  • Работа с изображениями в контексте чата (vision)
  • Сохранение бинарных данных в хранилище с передачей ключей/URL через JSON
  • Восстановление бинарных данных после операций, их удаляющих (например, через Merge nodes)

Как работает

  1. Размещать бинарные данные исключительно в поле $binary, а не в $json
  2. Не передавать бинарные данные напрямую в параметры или результаты инструментов агента (только JSON)
  3. Предварительно сохранять бинарные данные в хранилище и передавать через JSON ключи или URL
  4. Использовать Merge nodes для возврата бинарных данных в контекст, если они были удалены побочными вычислениями
  5. Использовать параметр passthroughBinaryImages: true для отображения загруженных изображений LLM, но не для передачи их в инструменты

Примеры запросов агенту

Как передать загруженный пользователем файл в инструмент n8n?
Как вернуть сгенерированный файл из агента n8n?
Как сохранить изображение и передать ссылку на него дальше?

Что понадобится

  • Инструменты агента с поддержкой fromAi()
  • Хранилище для предварительной загрузки бинарных данных

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «n8n-binary-and-data» из репозитория: # https://github.com/n8n-io/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r n8n-binary-and-data/ ~/.claude/skills/n8n-binary-and-data/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.