Передача файлов

AACFlow упрощает работу с файлами в ваших рабочих процессах. Блоки могут получать файлы, обрабатывать их и передавать другим блокам без проблем.

Объекты файлов

Когда блоки выводят файлы (например, вложения Gmail, сгенерированные изображения или распарсенные документы), они возвращают стандартизированный объект файла:

{
  "name": "report.pdf",
  "url": "https://...",
  "base64": "JVBERi0xLjQK...",
  "type": "application/pdf",
  "size": 245678
}

Вы можете обращаться к любым из этих свойств при ссылке на файлы из предыдущих блоков.

Блок Файл

Блок Файл — это универсальная точка входа для файлов в ваших рабочих процессах. Он принимает файлы из любых источников и выводит стандартизированные объекты файлов, которые работают со всеми интеграциями.

Входы:

• Загруженные файлы — Перетащите или выберите файлы напрямую
• Внешние URL — Любой публично доступный URL файла
• Файлы из других блоков — Передавайте файлы из вложений Gmail, загрузок Slack и т.д.

Выходы:

• Список объектов UserFile с единой структурой (name, url, base64, type, size)
• combinedContent — Извлеченное текстовое содержимое из всех файлов (для документов)

Пример использования:

// Получить все файлы из блока Файл
<file.files>

// Получить первый файл
<file.files[0]>

// Получить объединенное текстовое содержимое из распарсенных документов
<file.combinedContent>

Блок Файл автоматически:

• Определяет типы файлов по URL и расширениям
• Извлекает текст из PDF, CSV и документов
• Генерирует кодировку base64 для бинарных файлов
• Создает предварительно подписанные URL для безопасного доступа

Используйте блок Файл, когда вам нужно нормализовать файлы из разных источников перед передачей их другим блокам, таким как Vision, STT или почтовые интеграции.

Передача файлов между блоками

Ссылайтесь на файлы из предыдущих блоков с помощью выпадающего меню тегов. Нажмите в любое поле ввода файла и введите <, чтобы увидеть доступные выходы.

Распространенные шаблоны:

// Один файл из блока
<gmail.attachments[0]>

// Передать весь объект файла
<file_parser.files[0]>

// Обратиться к конкретным свойствам
<gmail.attachments[0].name>
<gmail.attachments[0].base64>

Большинство блоков принимают полный объект файла и автоматически извлекают то, что им нужно. В большинстве случаев вам не нужно вручную извлекать base64 или url.

Запуск рабочих процессов с файлами

При вызове рабочего процесса через API, который ожидает ввод файла, включите файлы в ваш запрос:

curl -X POST "https://aacflow.io/api/workflows/YOUR_WORKFLOW_ID/execute" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "document": {
      "name": "report.pdf",
      "base64": "JVBERi0xLjQK...",
      "type": "application/pdf"
    }
  }'

curl -X POST "https://aacflow.io/api/workflows/YOUR_WORKFLOW_ID/execute" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "document": {
      "name": "report.pdf",
      "url": "https://example.com/report.pdf",
      "type": "application/pdf"
    }
  }'

Стартовый блок рабочего процесса должен иметь настроенное поле ввода для получения параметра файла.

Получение файлов в ответах API

Когда рабочий процесс выводит файлы, они включаются в ответ:

{
  "success": true,
  "output": {
    "generatedFile": {
      "name": "output.png",
      "url": "https://...",
      "base64": "iVBORw0KGgo...",
      "type": "image/png",
      "size": 34567
    }
  }
}

Используйте url для прямых загрузок или base64 для встроенной обработки.

Блоки, работающие с файлами

Входы файлов:

• Файл — Парсинг документов, изображений и текстовых файлов
• Vision — Анализ изображений с помощью AI-моделей
• Mistral Parser — Извлечение текста из PDF

Выходы файлов:

• Gmail — Вложения электронной почты
• Slack — Загруженные файлы
• TTS — Сгенерированные аудиофайлы
• Video Generator — Сгенерированные видео
• Image Generator — Сгенерированные изображения

Хранение файлов:

• Supabase — Загрузка/выгрузка из хранилища
• S3 — Операции с AWS S3
• Google Drive — Операции с файлами Drive
• Dropbox — Операции с файлами Dropbox

Рекомендации

1. Используйте объекты файлов напрямую — Передавайте полный объект файла вместо извлечения отдельных свойств. Блоки автоматически обрабатывают преобразование.

2. Проверяйте типы файлов — Убедитесь, что тип файла соответствует ожиданиям принимающего блока. Блоку Vision нужны изображения, блоку Файл — документы.

3. Учитывайте размер файла — Большие файлы увеличивают время выполнения. Для очень больших файлов рассмотрите использование блоков хранения (S3, Supabase) для промежуточного хранения.