Comment utiliser IronOCR avec ChatGPT Codex

Curtis Chau
Curtis Chau
Mis à jour : 9 octobre 2026

Un problème courant dans les premières tentatives de reconnaissance optique de caractères (OCR) assistées par IA est que les développeurs collent des importateurs de scan incomplets dans une discussion, reçoivent du code apparemment complet, puis découvrent plus tard des totaux mal lus ou des appels de configuration incorrects à partir d'autres wrappers Tesseract. De telles erreurs sont coûteuses avec de grandes API, car les moteurs OCR avec plusieurs filtres, langues et formats de sortie présentent de nombreuses opportunités d'erreurs.

IronOCR lit les textes, les codes-barres et les cellules de tableau des pages scannées directement au sein de votre application .NET, localement et sans service cloud.

Démarrage rapide
NuGetInstaller avec NuGet

PM > Install-Package IronOcr

Installez IronOCR en exécutant la commande ci-dessus dans la console du gestionnaire de packages NuGet, ou recherchez le package dans le gestionnaire de packages NuGet.

Ouvrez Codex dans un nouveau projet console et spécifiez la sortie souhaitée, puis laissez Codex sélectionner les appels à l'API.

$ironocr Add the IronOcr package, then update Program.cs to turn a scanned
multi-page PDF into a searchable one. Print the page count and the overall
confidence before the file is written. Read the license key from the
IRONOCR_LICENSE_KEY environment variable. Then run dotnet build and fix any
errors.
Text

Le préfixe $ironocr charge skill.md d'IronOCR, enregistré dans le référentiel sous .agents/skills/ironocr/SKILL.md, afin que Codex lise les recettes et correctifs connus d'IronOCR avant d'écrire le code.



Qu'est-ce que ChatGPT Codex, et comment s'inscrit-il dans le travail OCR avec .NET?

ChatGPT Codex est l'agent de codage d'OpenAI. Il peut inspecter le code, modifier des fichiers et exécuter des commandes dans un dépôt. Installez le CLI avec npm install -g @openai/codex, comme le décrit la documentation CLI de Codex.

La sortie de Codex peut varier à chaque exécution, même pour des demandes identiques. Le moteur OCR doit renvoyer le même texte pour le même scan à chaque fois, utilisez donc une bibliothèque maintenue et évitez de laisser les agents improviser la configuration.

  • Prétraitement déjà intégré : les scans inclinés et bruyants nécessitent une correction avant la reconnaissance. L'objet d'entrée d'IronOCR redresse l'inclinaison, enlève le bruit, et peut aussi binariser et améliorer la résolution, et le guide de correction de la qualité d'image explique quand les filtres de bruit et de résolution sont utiles.
  • PDFs sans couche de texte : IronOCR lit les PDFs scannés et écrit une copie avec une vraie couche de texte, comme le montre le guide des PDF consultables.
  • Plus que du texte : avec Configuration.ReadBarCodes activé, une seule lecture renvoie des codes-barres et QR codes en plus du texte, et la lecture de tables est couverte dans le guide de lecture de table.
  • Versions en cours : le wrapper Tesseract open-source sur NuGet a été mis à jour pour la dernière fois en novembre 2022. IronOCR publie des mises à jour régulièrement, comme le montre son journal des modifications.

Qu'est-ce qui rend une invite IronOCR efficace?

Une invite IronOCR efficace nomme le langage et le framework, où le code va, la version de la bibliothèque, l'entrée et ses champs, la sortie attendue, et les contraintes. Pour un lecteur de facture, c'est C# sur .NET 9, Services/InvoiceReader.cs, la version IronOcr dans le .csproj, des factures PDF scannées avec une ligne de Total dû, le total comme un décimal avec confiance, et pas de nouveaux packages.

Codex se repose sur ses données d'entraînement et toute information que vous fournissez, donc sa connaissance de l'API d'IronOCR peut être obsolète. La recherche sur l'hallucination d'OpenAI retrace les réponses inventées à la formation et à l'évaluation qui récompense la supposition.

Placez les règles OCR une fois dans un AGENTS.md validé, que Codex lit avant de commencer le travail. Le llms.txt d'IronOCR résume chaque page de documentation en une ligne.

Create AGENTS.md at the repository root with an OCR section stating that this
project uses IronOCR (NuGet package IronOcr, or IronOcr.Linux for Linux and
Docker, namespace IronOcr) for all OCR work, that you must read
https://ironsoftware.com/ocr/csharp/llms.txt before writing OCR code and use only
APIs documented there, that https://ironsoftware.com/ocr/csharp/skill.md should
be loaded if the tooling supports skill files, that the license key comes from
the IRONOCR_LICENSE_KEY environment variable and is never inlined, and that no
other OCR engine or cloud OCR service may be added.
Text

Comment demande-t-on à Codex d'ajouter IronOCR et de lire une première facture scannée?

Add the IronOcr NuGet package to this project. Then show me the resulting
PackageReference line from the .csproj and tell me which version was installed.
Do not change any other package references.
Text

La ligne PackageReference aide à identifier si un agent a installé un autre package avec OCR ou Tesseract dans son nom.

IronOCR n'offre pas de mode filigrane. Sans clé de licence, la première lecture génère une LicensingException.

Apply the IronOCR license key at application startup, before any other IronOCR
call, reading it from the IRONOCR_LICENSE_KEY environment variable rather than
hard-coding it. Then confirm IronOcr.License.IsLicensed returns true and tell me
where you put the call.
Text

Clés de licence IronOCR explique comment obtenir une clé d'essai et répertorie les fichiers de configuration à partir desquels IronOCR peut lire une clé.

Create Services/InvoiceReader.cs with a ReadTotal method that takes the path of a
scanned PDF, reads it with IronTesseract, finds the line containing Total due, and
returns the amount as a decimal with that line's confidence, or null when the
line is missing.

Then create Services/SearchablePdf.cs with a Convert method that writes a
searchable copy of a scanned PDF. Build and fix errors.
Text

Codex a généré deux classes concises. Le lecteur charge le scan dans un objet d'entrée avec une déclaration using, appelle une fois la méthode read du moteur, et parcourt les lignes du résultat pour trouver le total.

Comment migrer une implémentation OCR existante vers IronOCR?

Hand this to the explorer agent, since nothing should be written yet.

Imports/LegacyOcrService.cs currently reads scans with another OCR library.

1. List every read it performs, with the settings it uses (language, page
   segmentation, image preprocessing, region, output format).
2. Map each setting to its IronOCR equivalent, citing the documentation page.
3. Do not write any code yet. Wait for my approval on the plan.
Text

Si un agent écrit 400 lignes avant d'approuver l'approche, vous devez examiner toutes les 400 lignes. Une table de correspondance peut être corrigée avec une seule réponse.

Après avoir approuvé le plan, gardez la prochaine demande dans un périmètre restreint.

Put the worker agent on the approved plan.

Rewrite LegacyOcrService.cs to use IronOCR, keeping the existing public method
signatures so callers don't change. Before removing the old library, run both
implementations on every page in TestData/known/ and save a table of file,
expected values, and each engine's values to migration-check.md. Remove the old
library only if IronOCR returns the expected values at least as often, and
leave it in Git history only. Build and report the diff.
Text

Comment corriger des valeurs mal lues par le biais d'invites?

L'agent ne peut pas voir l'original papier, donc l'invite doit décrire l'erreur et, idéalement, inclure les scans.

I have attached one of the failing scans with codex --image, so look at it
rather than reasoning from file names.

Invoices in TestData/supplier-7/ return totals that are off by one digit in
about a third of cases. The scans are slightly rotated and have speckle from an
old scanner. Clean digital invoices read correctly.

Read InvoiceReader.cs and a sample of the scans. Explain the likely cause before
changing anything, then change the preprocessing only. Do not change how the
total is parsed. Report how many totals match before and after.
Text

Référez-vous au guide de correction d'orientation d'image pour les problèmes de rotation.

Les langues manquantes sont l'autre cas courant et nécessitent la même précision.

German invoices throw LanguagePackException on the first read. Add what IronOCR
needs to read German, prove three German sample invoices return the expected
totals, and link me to the documentation page you used.
Text

Les packs de langues conservent leurs propres numéros de version. Le dernier IronOcr.Languages.German est très en retard par rapport aux sorties de 2026 du moteur, donc un agent chargé de maintenir chaque package Iron à une version échoue lors de la restauration jusqu'à ce qu'il accepte le décalage. Mentionnez dans les règles de l'agent du référentiel que les packs de langues sont exonérés.

Quelles paramètres Tesseract devez-vous modifier?

IronOCR fournit l'accès aux contrôles de Tesseract via l'objet de configuration du moteur, et ceux-ci aident dans moins de cas que ne le suggèrent leurs descriptions.

Totals in TestData/supplier-7/ now match after the preprocessing change.
Before anything else is tuned, measure the Tesseract settings IronOCR documents
for single fields: a character whitelist, single-line page segmentation, and a
crop to the amount. Apply one at a time on top of the current reader, report
the total read for every page, and keep a setting only if no page gets worse.
Text

Codex a gardé la liste blanche dans WhiteListCharacters, qui a lu 9 totaux sur 9. PageSegmentationMode réglé sur SingleLine a lu 0 sur 9 et a été abandonné. Une découpe ContentArea a lu 9 totaux sur 9 fournisseurs mais 0 sur 3 allemands, donc elle a également été supprimée.

Un remaniement ultérieur a combiné ce lecteur avec un service qui lit également les numéros de facture, et la liste blanche a été retirée.

Dans une sonde séparée sur une découpe serrée autour du total de $9,924.31, une lecture de ligne unique de la liste blanche a retourné le bon montant, et en ajoutant deskew et suppression du bruit, cela a laissé un résultat vide ou un 7 isolé. Appliquez les filtres à la page entière avant de rogner. Les variables Tesseract brutes sans propriétés nommées sont définies via Configuration.TesseractVariables, un dictionnaire. Référez-vous au guide de configuration de lecture avancée pour les propriétés de configuration et au guide des régions pour le rognage.

Comment retracer un échec à travers une importation entière ou dans un conteneur ?

Send the explorer agent through the import history first, without writing
anything.

Last month's import read 3,000 scanned invoices, and finance found 45 totals
that do not match the paper. Reprocessing one of those invoices gives the same
wrong total every time.

Investigate:
1. Read ImportService.cs and find how pages are loaded and preprocessed.
2. Identify what the misread invoices have in common.
3. Explain the cause before changing anything.
4. Then propose the minimal fix, and how you will prove the 45 now read correctly.
Text

Dans notre test, un agent explorateur a découvert que l'importateur a rastérisé les pages à 96 DPI et enregistré les totaux manquants comme $0.00. L'agent a ensuite relu les 70 scans restaurés à 300 DPI et a récupéré 43 sur 45, mais deux restaient à zéro et une page précédemment correcte a échoué. L'agent a recommandé une nouvelle tentative à plus haute résolution seulement lorsque la première lecture retourne zéro. Référez-vous au guide des paramètres DPI et au guide de confiance.

Run this read-only until you have the cause.

This exception is thrown from InvoiceReader.ReadTotal in our Linux Docker
container but not on Windows:

[PASTE FULL EXCEPTION AND STACK TRACE HERE]

Check which IronOCR package the project references and whether it matches the
container's operating system, and whether IRONOCR_LICENSE_KEY reaches the
container. Explain the cause, then propose the change. Don't modify C# code
unless the cause is there.
Text

Le conteneur a besoin des dépendances natives listées dans le guide Docker. Ce guide installe encore IronOcr, qui dans la version testée ne fournit que des binaires natifs pour Windows.

Comment transformer un code ponctuel en composants réutilisables et testés?

Put the worker agent on this.

Refactor InvoiceReader and SearchablePdf into an InvoiceOcrService registered
with dependency injection. It should read totals and invoice numbers from
scanned PDFs, flag any value whose line confidence is below 80, and produce
searchable copies. Keep the preprocessing choices in one place. Add XML doc
comments. Keep it under 120 lines. Before you finish, run the service over
every folder in TestData/ that has an expected.csv and confirm each total
still matches.
Text
Write xUnit tests for InvoiceOcrService covering: every page in TestData/known/
returns its expected invoice number and total, a page without a total returns
null rather than a guess, a searchable copy has a text layer, and a missing
license key throws a clear exception. Assert on extracted values, not on the
full text of the page.
Text

Pour le scénario de clé manquante, testez votre propre logique de protection, car l'exception de licence d'IronOCR n'est pas un type public accessible aux tests.

Conservez les questions récurrentes d'IronOCR dans la compétence du référentiel plutôt qu'en ~/.codex/prompts/, que la page des invites personnalisées d'OpenAI marque comme obsolète.

$ironocr Read the IronOCR API reference for OcrInput and list every method that corrects
image problems, such as rotation, noise, and low resolution, then show which
ones this project already calls.
Text

Qu'est-ce que les messages ont produit lors d'une réelle exécution ?

Nous avons envoyé les invites ci-dessus à Codex dans l'ordre, contre un projet d'exemple de facture. Le projet est une application console avec des PDFs scannés, un service hérité utilisant le wrapper Tesseract open-source, et trois ensembles de pages avec des valeurs connues. Après l'exécution, une build Release indépendante, une suite de tests, et des sondes à travers les trois ensembles ont confirmé les résultats ci-dessous.

  • Les totaux de Supplier-7 sont passés de 6 sur 9 à 9 sur 9 avec Deskew et DeNoise. Seul, Deskew a lu 9 sur 9 et DeNoise 8 sur 9.
  • Le lecteur hérité et IronOCR ont tous deux correspondus à 10 sur 10 dans le contrôle de migration.
  • Avec le pack allemand, 3 totaux sur 3 allemands ont été lus correctement et l'ensemble fournisseur est resté à 9 sur 9.
  • Le service à 96 lignes a égalé 10 sur 10 connus, 3 sur 3 allemands et 9 sur 9 fournisseurs, et a signalé 2 en dessous de 80 de confiance.
  • Les tests ont réussi 13 sur 13.
  • Codex a exécuté 14 des 15 invites sans erreurs de build ou modifications manuelles du code. L'invite de conteneur nécessite une véritable trace de pile Linux et n'a pas été exécutée, et les échantillons allemands ainsi que l'historique d'importation ont été ajoutés avant leurs invites.
  • Une exécution antérieure a échoué de trois manières. Codex a rapporté une migration de 10 sur 10 sans exécuter aucun moteur, un remaniement a cassé un total connu, et une invite de paramétrage a supposé un filtre que le lecteur n'a pas utilisé.

La version de Codex de cette exécution, le modèle, le timing et la machine sont dans le compte-rendu d'exécution partagé.

Qu'est-ce qui se transfère au prochain projet ?

Le guide des assistants de codage AI ajoute une seule invite d'acceptation qui emmène un assistant d'un dossier vide à des résultats mesurés, et la même invite a réussi à 10 sur 10 dans Codex lors de nos tests.


Dépannage


Des questions ?

Si vous avez des questions, contactez support@ironsoftware.com

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 6,394,824Version :2026.11tout juste publié