Oracle et OpenAI : révolutionner le traitement de documents

Oracle et OpenAI : Une alliance pour transformer le traitement des documents

L'arrivée de l'Adaptateur OpenAI dans Oracle Integration Cloud (OIC) a suscité un intérêt particulier pour ses capacités au-delà des simples interactions textuelles. Initialement, l'outil semblait se limiter à des fonctions de type chatbot, mais une exploration plus approfondie a révélé son potentiel pour traiter divers types de fichiers, tels que des images, des PDFs et des documents Word. Cette découverte a ouvert la voie à des intégrations plus sophistiquées, sans nécessiter de développements REST personnalisés.

En examinant les fonctionnalités de l'adaptateur, j'ai découvert qu'il pouvait gérer des fichiers de manière plus avancée. Cela m'a amené à me demander si l'Adaptateur OpenAI pouvait télécharger des fichiers et les traiter ultérieurement en utilisant un identifiant unique. Pour tester cette hypothèse, j'ai développé un prototype qui a révélé des résultats prometteurs.

Grâce à l'Adaptateur OpenAI, il est possible de :

• Télécharger des fichiers directement vers OpenAI
• Obtenir et utiliser des identifiants de fichiers pour des traitements ultérieurs
• Analyser des images et des documents PDF
• Extraire des données structurées sous forme de JSON
• Gérer du contenu multilingue, y compris des documents en arabe et en persan

Cet article détaille l'approche adoptée, l'architecture mise en place, ainsi que quelques cas d'utilisation pratiques découverts lors du développement du prototype. À la fin, vous aurez un modèle réutilisable pour extraire des factures, traiter des documents et analyser du contenu, entre autres.

Décryptage de l'Architecture

Pour concevoir le prototype, j'ai opté pour une séparation en deux intégrations distinctes. La première se charge du téléchargement du fichier vers OpenAI et de l'obtention d'un identifiant unique. La seconde utilise cet identifiant pour traiter le document en fonction d'un prompt donné et renvoie une réponse structurée. Cette méthode permet de réutiliser le fichier téléchargé, le rendant accessible pour plusieurs analyses sans nécessiter de nouveaux téléchargements.

Intégration 1 — Téléchargement de Fichier

La première intégration est conçue pour accepter un fichier et le télécharger via l'opération Télécharger un fichier de l'Adaptateur OpenAI. Les formats de fichiers pris en charge incluent :

• Images (JPG, PNG)
• Documents PDF
• Documents Microsoft Word

L'adaptateur génère un identifiant de fichier unique, tel que file-xxxxxxxxxxxxxxxx, qui peut être stocké ou transmis pour un traitement ultérieur.

Intégration 2 — Traitement de Fichier

La seconde intégration utilise :

• Un identifiant de fichier
• Des instructions de traitement spécifiques

Elle invoque l'Adaptateur OpenAI avec l'opération Réponses. Selon le type de document et le prompt, OpenAI peut :

• Extraire des données de factures
• Analyser des documents
• Résumer du contenu
• Retourner un JSON structuré
• Traiter du texte multilingue

La réponse obtenue peut être directement intégrée dans l'OIC et mappée vers des systèmes en aval.

Architecture de la Solution

Flux Général

Le processus global est structuré comme suit :

Document (Image/PDF/DOCX) 
       | 
       v
+------------------+
|  Télécharger un Fichier  |
|    Adaptateur OpenAI     |
+------------------+
       | 
       v 
   ID de Fichier 
       v
+------------------+
|     API Réponses      |
|    Adaptateur OpenAI   |
+------------------+
       | 
       v 
Sortie Structurée (JSON)

Ce modèle repose entièrement sur l'Adaptateur OpenAI natif, éliminant le besoin d'appels REST personnalisés, de construction manuelle de charges utiles API, ou de gestion de contenu encodé en Base64.

Construction de l'Intégration 1 — Téléchargement de Fichiers vers OpenAI

La première intégration est dédiée au téléchargement d'un document vers OpenAI et à l'obtention d'un identifiant de fichier réutilisable. Les types de fichiers testés incluent :

• Images JPG
• Images PNG
• Documents PDF
• Documents Microsoft Word

Étape 1 — Créer la Connexion OpenAI

Commencez par établir une connexion en utilisant l'Adaptateur OpenAI. Fournissez :

• Une clé API OpenAI
• Un nom de connexion
• Une configuration de sécurité

Une fois la connexion testée avec succès, elle peut être intégrée dans votre processus.

Étape 2 — Créer l'Intégration de Téléchargement de Fichier

Développez une orchestration pilotée par une application.

2.1 Ajouter un Déclencheur

Ajoutez un Adaptateur REST pour accepter le fichier en entrée avec :

• Options de traitement des pièces jointes multipart
• Requête multipart avec une charge utile
• Requête multipart de type multipart/form-data avec une charge utile HTML

2.2 Ajouter l'Adaptateur OpenAI

Sélectionnez l'opération Télécharger un Fichier. Cette opération permet à l'OIC de télécharger un fichier directement vers OpenAI sans nécessiter d'appel manuel à l'API REST.

Étape 3 — Configurer le Mappage de la Requête

L'opération Télécharger un Fichier nécessite deux informations clés :

• But : Détermine l'utilisation du fichier téléchargé. Pour le traitement d'images : vision. Pour le traitement de documents : user_data.

• Contenu du Fichier : Mapper la pièce jointe ou la référence de fichier entrante à l'élément Fichier de l'adaptateur.

Exemple de mappage :

RequestWrapper
├── Purpose
└── File
    └── streamReference

L'adaptateur gère le téléchargement et stocke le fichier dans OpenAI.

Étape 4 — Exécuter l'Intégration

Après activation, invoquez l'intégration avec un document d'exemple. Si le téléchargement réussit, la réponse contient un identifiant de fichier, par exemple : file-3UoRxBRyqV7pJRgPC4WSgi. Cet identifiant sert de lien entre le téléchargement et le traitement du document.

Leçons Apprises : L'Importance des Noms de Fichiers

Lors de mes tests, j'ai rencontré un problème lié aux noms de fichiers. Certains téléchargements échouaient lorsque le nom du fichier contenait des espaces ou des caractères spéciaux. Par exemple, WhatsApp Image 2026-06-05 at 7.25.23 PM.jpeg générait une erreur si le nom contenait un espace.

En renommant le fichier avec un format plus simple, sans espaces ni caractères spéciaux, le téléchargement a réussi. Exemple : invoice_20260605.jpeg. Si vous rencontrez des échecs de téléchargement, vérifiez d'abord le nom du fichier. Bien que cela puisse varier selon la version de l'adaptateur et l'environnement, utiliser des noms de fichiers propres est une bonne pratique.

Pourquoi l'ID de Fichier est Crucial

Initialement, j'ai pensé qu'il serait nécessaire d'envoyer du contenu en Base64 à OpenAI pour chaque analyse de document. L'approche basée sur l'identifiant de fichier est bien plus efficace. Une fois le document téléchargé :

• Le fichier peut être réutilisé
• Plusieurs prompts peuvent être appliqués au même fichier
• Il n'est pas nécessaire de retransférer le document

Cette méthode optimise le processus et simplifie l'intégration, rendant l'ensemble plus efficace.