Ouvrir le Studio

Static File

Embarque un fichier de données (CSV, PDF, JSON, Parquet, …) directement dans le workflow afin que les nodes en aval puissent le lire sans stockage externe

À quoi sert le node Static File ?

Le node Static File vous permet d’uploader un fichier une fois pour l’épingler au workflow. Les nodes en aval qui acceptent une entrée file (par ex. CSV Analyzer, parsers PDF, LLM avec contexte fichier) lisent le fichier directement — pas besoin de brancher Google Drive ni de re-uploader à chaque run.

Le fichier est uploadé sur le storage d’assets du workflow ; le node ne stocke que la référence (id, filename, mime type, taille en octets). Remplacer le fichier supprime l’ancien asset pour garder le storage propre.

Cas d’usage courants :

  • Données de référence qui changent rarement (table de lookup, taxonomie, glossaire de marque)
  • Un PDF ou DOCX brief embarqué dans le workflow comme input canonique pour un LLM
  • Un dataset Parquet utilisé par une étape d’analytique en aval
  • Un schéma JSON fixe ou fichier seed consommé par un node custom

Configuration rapide

Ajoutez le node au canvas

Ouvrez la Node Library, allez dans InputsStatic, puis glissez Static File sur votre workspace.

Uploadez un fichier

Ouvrez les settings du node et cliquez sur la zone d’upload (ou drag-and-droppez un fichier dessus). Extensions acceptées : .txt, .log, .md, .markdown, .csv, .tsv, .json, .jsonl, .ndjson, .xml, .html, .htm, .yaml, .yml, .toml, .pdf, .docx, .xlsx, .pptx, .parquet. Taille max : 100 Mo.

Le fichier s’upload automatiquement et le node persiste la référence — pas d’étape “Save” séparée.

Branchez la sortie

Connectez la sortie File à n’importe quel node en aval qui accepte une entrée fichier.

Paramètres de configuration

Champs obligatoires

Name string required default: Static File

Nom du node — Label affiché sur le canvas. Renommez en quelque chose de descriptif (“Catalogue produits CSV”, “Brief de marque PDF”) pour que le workflow se lise en un coup d’œil.

Description string required default: Embed a data file (CSV, PDF, JSON, Parquet, …) in the workflow

Description du node — Une courte note sur le contenu du fichier ou son rôle dans le workflow.

File file required

Le fichier uploadé. Le panneau de settings affiche le nom, le mime type et la taille. Trois actions sont disponibles sur un fichier configuré :

  • Replace — choisir un nouveau fichier ; l’ancien asset est automatiquement supprimé.
  • Download — re-télécharger le fichier courant via une URL signée à courte durée de vie.
  • Remove — supprimer l’asset et vider le node.
Info

Limites & stockage — Limite stricte de 100 Mo par fichier (rejet avec toast au-delà). L’asset est stocké sur le bucket GCS du workflow ; les URLs signées de download sont à courte durée de vie (régénérées via le bouton “Download” à chaque fois).

Que produit le node en sortie ?

Un seul anchor de sortie File.

file file

Un objet de référence asset que le node en aval peut lire. Porte l’id de l’asset, le nom de fichier original, le mime type et la taille — le node consommateur utilise l’id pour récupérer les bytes depuis le storage à la demande (typiquement via une URL signée).

Concrètement, les nodes en aval reçoivent un descripteur de fichier JSON :

{
  "id": "asset_abc123",
  "filename": "product-catalog-2026.csv",
  "file_type": "text/csv",
  "file_size": 2456790
}

Exemples d’utilisation

Exemple 1 : CSV de référence pour un pipeline CSV Analyzer

Épingler un CSV catalogue produits dans le workflow et l’analyser de la même façon à chaque run.

Static File (catalog.csv) → CSV Analyzer → LLM (synthèse) → Email Sender

Exemple 2 : PDF brief embarqué dans un workflow LLM

Uploader un PDF brief de marque ; faire en sorte que le LLM le lise pour le contexte à chaque run.

Static File (brief.pdf) → LLM (avec contexte fichier) → Google Docs Writer

Exemple 3 : Table de lookup partagée entre workflows

Un fichier Parquet de mappings produits internes, embarqué dans un workflow de reporting pour que l’équipe data en amont n’ait pas à maintenir une API séparée.

Google Ads Product Performance → Join avec Static File (mapping.parquet) → Google Sheets Writer

Bonnes pratiques

Tip

Renommez le node selon le rôle du fichier (“Pricing rules CSV”, “Q1 brief PDF”) — bien plus rapide à scanner sur le canvas qu’un générique “Static File”.

Tip

Replace, n’ajoutez pas un autre node. Utilisez le bouton Replace quand le fichier change ; l’ancien asset est garbage-collected automatiquement. Ajouter un second node Static File juste pour pointer sur “la nouvelle version” laisse des assets morts dans le storage.

Warning

N’uploadez pas de secrets (clés API, PII clients, credentials) dans Static File. Utilisez le node Static Constants pour des secrets courts, ou les intégrations de la plateforme pour les credentials. Le storage d’assets est scopé au workflow mais pas conçu pour du matériel sensible.

Problèmes courants

L'upload échoue avec un toast 'too large'

Cause : Le fichier dépasse la limite stricte de 100 Mo.

Solution : Compressez le fichier, splittez-le, ou déplacez les données vers un store externe (BigQuery, GCS) et référencez-les via une intégration avec credentials à la place.

L'extension sélectionnée n'est pas acceptée

Cause : L’extension du fichier n’est pas dans la liste autorisée. Static File rejette délibérément les formats binaires que les readers en aval de la plateforme ne supportent pas (images, vidéo, audio).

Solution : Utilisez Static Image / Static Video pour les médias. Pour les fichiers de données, convertissez vers un des formats supportés (.csv, .json, .parquet, etc.).

Le bouton Download ne fait rien ou renvoie 404

Cause : L’URL signée a expiré (elles sont à courte durée de vie) ou l’asset a été supprimé hors-bande.

Solution : Rouvrez le panneau de settings — l’URL est régénérée à chaque clic. Si le problème persiste, ré-uploadez le fichier.

Le node en aval dit 'cannot read file'

Cause : Le type de fichier attendu par le node en aval ne matche pas ce qui est épinglé. CSV Analyzer veut un CSV ; les readers PDF veulent un PDF.

Solution : Vérifiez les types acceptés du node en aval dans sa doc et remplacez le fichier par le bon format.

Nodes associés