n8n-nodes-async-api

Nœuds n8n pour les services IA BRIO (async-api) : soumettre des tâches
à un service, suivre leur avancement et récupérer les résultats, directement depuis un workflow n8n.

Statut : socle (#484). Les opérations sont livrées dans les tickets suivants de
l'EPIC [N8N] Intégration dans des noeuds N8N.

Contenu

• Credential AsyncTaskAPI (BRIO) : Base URL + Client ID + Client Secret
  (authentification HTTP Basic). Le bouton « Tester » valide réellement les identifiants
  via GET /v1/me.

• Nœud BRIO — Services IA : opérations Soumettre et attendre, Soumettre une tâche,
  Récupérer une tâche, Envoyer un fichier (implémentation progressive).

• Explication contextuelle : dès qu'un service est choisi dans le dropdown, une notice
  explique en une ou deux phrases ce que fait ce service, suivie d'un lien vers sa page de
  documentation (ReDoc de l'API). Tant qu'aucun service n'est sélectionné, rien ne s'affiche.
  Le lien pointe l'instance prod Scaleway : le contenu d'une notice est statique, la
  baseUrl de la credential n'y est pas injectable (DOC_BASE_URL à changer si l'audience
  visée est MI/RIE ou staging). Contenu dans
  nodes/asyncTask/serviceDocs.ts — un nouveau service côté
  services.yaml apparaît dans le dropdown sans release du nœud, mais son explication demande
  une entrée ici.

  Le composant Notice de n8n assainit le contenu avec allowedTags: ['a', 'ul', 'li'] :
  <b>, <code>, <br> sont supprimés à l'affichage. D'où du texte brut (liens et listes à
  puces restent possibles).

• Body pré-rempli par service : à la sélection d'un service, le champ Body (JSON) contient
  un exemple soumettable de ce service (document_types pour la classification, entities pour
  l'extraction, data pour le publipostage…), avec un rappel des champs obligatoires sous le
  champ. Un champ générique à {} prend le relais pour un service inconnu du nœud — l'enum
  Service étant ouvert. Exemples dans le même
  serviceDocs.ts, aux côtés des explications, pour qu'ils ne
  divergent pas.

  n8n mémorise les valeurs par nom de paramètre : l'exemple se pose à la première sélection
  d'un service, mais un body déjà saisi n'est pas écrasé si l'on change de service ensuite (on ne
  détruit pas une saisie). Le hint sous le champ, lui, suit toujours le service sélectionné.

  Avant toute release touchant aux exemples, les confronter aux schémas réellement déployés :

  pnpm build && node scripts/verifier-exemples-vs-schemas.mjs ../async-api
  

  Un exemple non conforme serait pire que pas d'exemple : l'utilisateur le soumettrait tel quel
  pour récolter un 422.

Développement

pnpm install
pnpm build        # tsc + copie des icônes
pnpm lint
pnpm dev          # tsc --watch (hot-reload en dev)

Tester en local dans n8n

Pointer une credential sur le staging puis exécuter un workflow. Voir la doc n8n sur les
nœuds communautaires en développement (montage du dist/ dans ~/.n8n/custom).

Publication

Package scoped @minint/ publié sur le Nexus (Scaleway + DSO MI), puis intégré à
l'image n8n via n8n-image (nodes/package.json).
Voir tickets #481 (CI Nexus) et #482 (image).

Licence

MIT