Cómo usar IronPrint con ChatGPT Codex

Curtis Chau
Curtis Chau
Actualizado: 26 de octubre de 2026

Un almacén imprime una lista de picking para cada pedido cada noche. Algunos pedidos necesitan una copia para el selector, otros necesitan una segunda para el empacador y una tercera para el encargado de facturas. Cuando el conteo de copias es incorrecto, nada falla. El empacador encuentra una hoja sin copia compañera, o el escritorio de facturación recibe nueve hojas de un pedido, y el registro de impresión todavía informa que esos pedidos se han enviado.

ChatGPT Codex, el agente de codificación de OpenAI, edita los archivos de un repositorio, ejecuta dotnet run y otros comandos, e informa lo que hizo. Funciona en la aplicación de escritorio de ChatGPT, un IDE, un terminal y la nube. IronPrint, la biblioteca de impresión .NET de Iron Software, envía archivos PDF e imágenes a una impresora instalada, silenciosamente o a través del diálogo de impresión del sistema operativo, con tamaño de papel, orientación, DPI, escala de grises y el número de copias configuradas en un objeto PrintSettings.

Codex recibe una noche de órdenes de listas de picking y un manifiesto de resultados esperados. Cada conteo de copias que Codex informa proviene de un archivo CSV, y todo el lote está planificado antes de que se envíe cualquier trabajo a una impresora.

Inicio rápido
NuGetInstalar con NuGet

PM > Install-Package IronPrint

Instale IronPrint ejecutando el comando arriba en la Consola del Administrador de Paquetes NuGet, o busque el paquete en el Administrador de Paquetes NuGet.

Ejecute Codex dentro de un proyecto de consola .NET con una carpeta de Órdenes.

$ironprint Install IronPrint 2026.10.1 from NuGet in this console project.
Program.cs should then plan the six orders in Orders/sample/ without sending a job.

Give each sample PDF a row in out/quickstart.csv. The columns are:

- file
- copies, from that order's row in Orders/manifest.csv
- printer, the PrinterName in appsettings.json
- found, yes or no, whether Printer.GetPrinterNames lists that printer

Read the total copies back from that CSV and show it.
Program.cs gets the key from IRONPRINT_LICENSE_KEY by itself.
Don't show the key's value anywhere, and don't list environment variables.
Keep the PrintCapture.Install line first in Program.cs.
Don't call Print, PrintAsync or ShowPrintDialog yet.
Stop after three failed builds or runs, and tell me what came out.
Text

La mención $ironprint carga la habilidad de IronPrint en la sesión.



¿Qué es ChatGPT Codex y cómo se integra en el trabajo de impresión .NET?

La documentación CLI de Codex explica la instalación y el uso en terminal, y su código fuente y versiones están en GitHub.

Codex se basa en los datos de entrenamiento y en los archivos en su contexto para IronPrint, y un nombre de miembro incorrecto falla la compilación.

IronPrint es compatible con Windows, macOS, iOS y Android. El proyecto en esta guía apunta a net9.0-windows.

¿Cómo escribir un prompt de IronPrint y configurar Codex para él?

Un prompt de lote de IronPrint nombra la entrada (cada pedido en Orders/manifest.csv), la impresora y la fuente de su nombre (appsettings.json, verificado contra Printer.GetPrinterNames), los ajustes para cada trabajo (el conteo de copias del manifiesto, tamaño de papel, retrato, escala de grises y 150 DPI), la prueba (un plan CSV con una fila por pedido), la verdad de base (los estados esperados en el manifiesto) y las restricciones (un nombre de impresora exacto y ningún llamado a ShowPrintDialog).

Codex busca en el directorio de trabajo y en cada directorio superior, hasta la raíz del repositorio, una carpeta .agents/skills. Cada carpeta de habilidades contiene un archivo SKILL.md cuya información inicial da un nombre y una descripción. Con skill.md de IronPrint copiado a .agents/skills/IronPrint/SKILL.md, la mención $ironprint se resuelve. El ejemplo de un solo archivo en la habilidad fija IronPrint 2026.8.1, y el Inicio rápido instala 2026.10.1.

Antes de cualquier trabajo, Codex carga los archivos AGENTS.md en la ruta desde la raíz del repositorio hasta la carpeta de trabajo. No lee más de uno por directorio, y cuando dos entran en conflicto, el archivo más cercano a la carpeta de trabajo tiene prioridad. Ejecutar /init produce un borrador inicial.

La máquina de pruebas no tiene impresora que termine un trabajo sin un diálogo, y un diálogo detiene una ejecución no asistida. Por lo tanto, el repositorio de prueba incluye una pequeña clase de captura que intercepta el trabajo que IronPrint envía a Windows y lo escribe en un archivo XPS, de modo que no se spool ningún trabajo. Un proyecto con una impresora en funcionamiento no la incluye.

Write a root-level AGENTS.md containing a section called Nightly picking lists.
These are its rules:

- IronPrint is the only printing library. Its package and namespace are both IronPrint.
- The target framework stays net9.0-windows.
- For the API, check the ironprint skill in .agents/skills/ironprint/.
- The installed IronPrint.xml settles any doubt about a member.
- Orders/ is read-only.
- The printer name comes from appsettings.json and has to appear in Printer.GetPrinterNames.
- The first line of Program.cs installs PrintCapture. It stays first, and Capture/ stays as it is.
- Print and PrintAsync run only from Program.cs, after that line.
- Tests never call them, and code that runs never calls ShowPrintDialog.
- The key lives in IRONPRINT_LICENSE_KEY. No output, log or file ever contains its value.
- A count in a reply has to come from a CSV that the same turn wrote.
- Name that CSV in the reply.

Show me the file once it's written.
Text

¿Cómo pedirle a Codex que agregue IronPrint y verifique la licencia?

Show me the IronPrint PackageReference in PickingBatch.csproj and the version that restore picked.
Then quote each IronSoftware package from the output of dotnet list package --include-transitive.
Don't touch any package reference.
Text

En nuget.org, IronPrint 2026.10.1 enumera tres dependencias, IronSoftware.Common 2026.4.2, IronSoftware.Abstractions 2026.1.2 e IronSoftware.System.Drawing 2026.8.2. En nuestra ejecución, restore también añadió IronSoftware.Drawing.Abstractions 2026.1.2. Cada compilación copia los archivos de tiempo de ejecución nativos de IronPrint en la carpeta de salida. Revise el changelog de IronPrint antes de fijar una versión.

Printer.GetPrinterNames, Printer.GetPrinterTrays y un nuevo PrintSettings todos logran éxito sin una clave, por lo que una lista de impresoras no prueba nada sobre la concesión de licencias. Una llamada de impresión sin una clave lanza una excepción de licencia antes de que se cree cualquier trabajo, y su mensaje dice Se requiere licencia de producción. El síncrono Print lo envuelve en un AggregateException, mientras PrintAsync lo lanza directamente. El código fuera de IronPrint 2026.10.1 no puede referenciar el tipo de excepción de licencia. Por lo tanto, un manejador captura Exception y compara el nombre del tipo.

Create Startup.ApplyIronPrintKey and make it the call right after PrintCapture in Program.cs.
It copies IRONPRINT_LICENSE_KEY into License.LicenseKey and reports License.IsLicensed.

Next, show me what IronPrint does with no key.
Run the program twice as child processes with the variable cleared for that child only:

1. A --licence-check run that lists the printers and builds a PrintSettings for PL-1023.
2. A --licence-check --send run that also calls Printer.Print once on Orders/sample/PL-1023.pdf.

Both runs use the printer from appsettings.json.
Log every call in out/licence-check.csv.
Its columns are run, call, result, exception type, inner type and message.
Give up after three repair attempts.
Text

IronPrint deja IRONPRINT_LICENSE_KEY sin leer, por lo que el programa copia su valor en License.LicenseKey. Una clave también puede ir en appsettings.json, Web.config o App.config, como describe la página de claves de licencia.

¿Cómo imprime IronPrint varias copias de un documento?

La guía de copias configura NumberOfCopies una vez y envía un solo trabajo, en lugar de llamar Print en un bucle. Una sonda de calibración envió tres copias de una lista de picking de dos páginas, e IronPrint construyó un trabajo de dos páginas con un conteo de copias de 3 en su ticket de impresión. El controlador de la impresora hace las copias adicionales. Microsoft Print to PDF convirtió ese ticket en un archivo de seis páginas, intercalado como páginas 1, 2, 1, 2, 1, 2.

Make a throwaway console project in scratch/copies-probe/ on your own.
Exclude scratch/** from PickingBatch.csproj with a Compile Remove item.
Run it yourself to find what NumberOfCopies holds on a new PrintSettings.
It also tries 0, -1 and 1000 and records what reads back.

Then the explorer agent answers these from IronPrint.xml and the ironprint skill:

- What the XML says happens when a driver can't make several copies.
- What GetPrinterTrays returns for each installed printer.
- Whether PrintSettings.DefaultSettings is static or belongs to an instance.

Nobody sends a job, and Services/ and Program.cs stay as they are.
Write all the answers to out/copies-probe.csv.
Beside each answer, quote IronPrint.xml, the ironprint skill or the probe output.
Where a page and the probe disagree, say so.
Text

NumberOfCopies predetermina a 1, y la propiedad acepta 0, -1 y 1000. La guía de copias indica que 0 o un valor negativo recurren a una sola copia. La llamada de impresión rechazó 0 y -1 en calibración, con un ArgumentOutOfRangeException cuyo mensaje es El valor debe ser positivo, y no se creó ningún trabajo. Por lo tanto, el lote rechaza esos pedidos antes de que se construyan las configuraciones. Los comentarios XML añaden que algunas plataformas ignoran el valor e imprimen una copia.

Cada página va a la impresora como una imagen en el DPI del trabajo. En la sonda, una página A4 a 150 DPI era de 1240 por 1753 píxeles. Con Grayscale configurado, el color de salida del ticket de impresión era Monocromo.

¿Cómo planificar un lote nocturno de trabajos de impresión?

Have the worker agent write Services/PickingPrinter.cs.
It applies Orders/README.md to every row of Orders/manifest.csv and follows these rules:

- A --printer option overrides the name in appsettings.json.
- An --inbox option picks the PDF folder. Orders/inbox/ is the default.
- Check the printer name against Printer.GetPrinterNames before reading any order.
- Match the name exactly, case included.
- An unknown name stops the run with a message that lists the installed printers.
- Build a new PrintSettings for each Ready order.
- NumberOfCopies comes from the copies column, and PaperSize from the paper column.
- Every order gets portrait, grayscale and 150 DPI.
- An empty file, or one without a %PDF header, is Unreadable.

Add a --plan mode that sends nothing and writes out/print-plan.csv with these columns:

- order_id and file
- status, always one of the README's four
- NumberOfCopies, PaperSize, PaperOrientation, Dpi and Grayscale as the job would send them
- printer

Add a --send mode that awaits PrintAsync once per Ready order, in manifest order.
It writes out/send-log.csv with order_id, file and NumberOfCopies, and no plan file.
Don't run --send yet.
Run --plan over Orders/inbox/ and report the status counts from print-plan.csv.
Text

IronPrint informa un archivo dañado solo cuando una llamada de impresión lo lee. Un archivo vacío falló en la calibración con un tipo de excepción de un espacio de nombres ofuscado cuyo mensaje enlaza a una página de solución de problemas de IronPDF, y un archivo de texto llamado .pdf falló con InvalidDataException. Un chequeo del encabezado PDF en el plan mantiene ambos fuera de la lista de trabajos.

¿Cómo confirmar lo que lleva cada trabajo de impresión?

PL-1028.pdf, uno de los seis pedidos de muestra, es una lista de picking A4 de dos páginas con un contenedor y una cantidad para cada SKU, y el manifiesto le da tres copias.

Now run --send with --inbox Orders/sample/.
Orders whose PDF isn't in that folder count as Missing and aren't sent.
PrintCapture writes each job to out/captured/ and adds a row to out/captured/jobs.csv.

Match send-log.csv to jobs.csv in sending order.
Then write out/sample-send.csv with one row per sent order and these columns:

- order_id and the NumberOfCopies it was sent with
- copies, pages, media and color from its jobs.csv row

Tell me whether each order went out as a single job carrying its copy count.
Text

Resultado

El PDF a continuación es el trabajo que IronPrint creó para PL-1028 en la prueba, convertido página por página desde el archivo XPS capturado.

Lista de picking PL-1028 según IronPrint construyó el trabajo, capturado a un archivo en lugar de una impresora. El trabajo contiene dos páginas A4 en orientación vertical a 150 DPI en escala de grises, y su ticket de impresión solicita tres copias.

¿Qué sucede cuando el nombre de la impresora no coincide?

La guía de nombres de impresoras indica que un nombre debe coincidir exactamente con el del sistema operativo, incluidas mayúsculas y minúsculas, y que un desajuste "fallará silenciosamente o lanzará un error". Los trabajos de calibración no generaron ninguna excepción. Un trabajo para Warehouse Laser 01, una cola que no existe, y un trabajo para adobe pdf en minúsculas ambos fueron enrutados a Microsoft Print to PDF, que la máquina de pruebas utiliza como su impresora predeterminada.

IronPrint sends a job with an unknown printer name to the Windows default printer.
Show me that PickingPrinter refuses before that can happen.

Run --plan two times, passing each of these names with --printer:

1. "Warehouse Laser 01", a queue this machine doesn't have.
2. "adobe pdf", the installed name in the wrong case.

Neither run may change out/print-plan.csv.
Write out/printer-check.csv with the columns run, printer, exit code, message and plan rows written.
Tell me which printers the message listed.
Text

¿Cómo diagnosticar una hoja que se imprimió incorrectamente?

La bandera -i (--image) adjunta una imagen al primer prompt de una sesión o al prompt que la reanuda, y el compositor interactivo acepta una imagen pegada.

I attached a scan of a picking list with -i.
The packer found it alone, without the copies that should have come with it.
Read the order number from the image.
Look that order up in out/print-plan.csv and Orders/manifest.csv.
Tell me the copy count and paper size that the plan sends.
Also say whether the page in the image fits that paper.
Don't change any code.
Text

¿Cómo depurar una salida incorrecta de lote de principio a fin?

Find out why last night's run printed the wrong number of picking lists.
Logs/nightly-2026-10-14/print.log reports these five orders as sent.
Orders/warehouse-complaint.csv lists what the warehouse counted by hand for them.

Have the explorer agent read Jobs/NightlyPrint.cs and that log before you write anything.
Your findings go in out/nightly-diagnosis.md, covering:

- the cause behind each count in the complaint file
- the smallest fix
- a --plan command that proves the fix without sending a job

Don't run or edit any code.
Then tell me what you found.
Text

Lea el diagnóstico antes de permitir una edición. Un diagnóstico sólido también explica por qué el registro informa el éxito, ya que el registro registra cada llamada y no las hojas impresas.

¿Cómo convierte el código único en componentes reutilizables y probados?

Put the worker agent on a PrintQueueService class, built like this:

- Install Microsoft.Extensions.DependencyInjection and resolve the service from its container.
- Configure it with a PrintOptions record holding printer, DPI, grayscale and plan-only.
- Keep the README rules and the printer check from PickingPrinter.
- PrintQueueService.cs stays under 150 lines, with XML doc comments.
- Nothing calls Jobs/NightlyPrint.cs.

Run it plan-only over Orders/inbox/ into out/final-plan.csv.
Then compare every status and copy count with manifest.csv and list any difference.
Text

Una refactorización puede perder la verificación de la impresora y aún compilar.

Add an xUnit project at tests/PickingBatch.Tests.
Keep it out of the main project's compile items, and put both projects in one solution.

Write tests on the real Orders/ files that check these:

- a 3-copy order gets NumberOfCopies 3 in a single PrintSettings
- a Letter order gets PaperSize.Letter, and an A4 order gets PaperSize.A4
- an order with copies 0 is Rejected and gets no settings
- the empty file and the text file are both Unreadable
- an unknown printer name is refused with a message naming the installed printers

Assert on settings objects and statuses.
Run the tests with dotnet test and a trx logger writing to out/tests/.
Report how many passed and how many failed, reading the trx file.
Text

Las aserciones sobre objetos de configuraciones evitan que el conjunto de pruebas envíe trabajos, aunque la verificación de nombre exacto aún necesita que la impresora configurada esté instalada.

$ironprint Look in the installed IronPrint.xml.
List every Printer member that sends a job or opens a dialog, then tell me:

- Which ones take a byte array instead of a path?
- Which ones show the operating system's print dialog?
- Which ones are asynchronous?

Back each member with one compiling line in a probe project under scratch/.
Build that probe with dotnet build only, and never run it.
It's the one place a ShowPrintDialog call may appear.
Then show me the line in PrintQueueService that stops plan-only mode from sending a job.
Text

¿Cómo reutilizar estos prompts en otro lote de impresión?

Con nuevos nombres de archivo, nombres de impresora y reglas de copias, los mismos prompts manejan etiquetas de envío o facturas. La guía de asistentes de codificación AI de IronPrint cubre la configuración compartida por cada asistente.

¿Qué produjeron los prompts en una ejecución real?

Codex recibió los prompts anteriores en orden, en una sola sesión. El proyecto .NET 9 contenía 40 pedidos, sus listas de picking y un manifiesto con el estado esperado y el conteo de copias de cada pedido. Scripts separados volvieron a verificar cada archivo de salida.

  • Antes del lote, el manifiesto listaba 35 pedidos Listos, 2 pedidos con cero copias, 1 archivo faltante y 2 archivos ilegibles.
  • El plan coincidió con el manifiesto en los 40 pedidos.
  • Cada pedido Listo en el plan tenía su conteo de copias del manifiesto y tamaño de papel, en orientación vertical a 150 DPI en escala de grises.
  • Enviar los seis pedidos de muestra produjo un trabajo capturado para cada uno.
  • Los conteos de copias en los seis tickets de impresión fueron 1, 2, 2, 1, 3 y 3, igual al manifiesto.
  • Los seis trabajos contenían 11 páginas, que los conteos de copias elevaron a 20 hojas.
  • El pedido de Carta se capturó como páginas de 215.9 por 279.4 mm y los pedidos A4 como páginas de 210 por 297 mm.
  • Cada página de los seis trabajos capturados era una imagen de 150 DPI sin píxeles de color, por lo que la banda de prioridad roja era gris.
  • Sin una clave, el programa enumeró las cuatro impresoras y construyó las configuraciones, y la llamada de impresión falló con Se requiere licencia de producción.
  • Ambos nombres de impresora incorrectos detuvieron el plan antes de que se escribiera cualquier fila, y el mensaje enumeró las cuatro impresoras instaladas.
  • Del escaneo, Codex identificó el pedido PL-1024 e informó tres copias en A4 del plan.
  • El diagnóstico nocturno rastreó las 9, 4 y 18 hojas a un bucle que llamaba a Imprimir una vez por copia con el conteo de copias ya establecido.
  • Rastreó la hoja para el pedido de cero copias a un tope que elevó 0 a 1.
  • El refactorizado PrintQueueService tenía 51 líneas, y su plan coincidió con el manifiesto en cada estado y conteo de copias.
  • Las 7 pruebas pasaron en la sesión de Codex y de nuevo en un clon nuevo.
  • Codex enumeró los ocho miembros de Printer que envían un trabajo o abren un diálogo y construyó una sonda para ellos sin ejecutarla.
  • Algunos pasos se ejecutaron de manera diferente a lo esperado. El Inicio rápido se detuvo después de tres intentos fallidos sin escribir su CSV. Un intento de verificación de licencia se ejecutó con la clave todavía configurada, y la clase de captura interceptó su llamada de impresión. El explorador respondió la pregunta de la bandeja desde el XML en lugar de consultar a cada impresora. Codex informó que la comprobación solamente de plan estaba en Program.cs, no en PrintQueueService.

La guía de Google Antigravity construye una página ASP.NET Core que espera la misma llamada de impresión asíncrona. En la guía de Claude Code, cada tipo de documento va a su propia impresora y un subagente revisa la comprobación del nombre de la impresora. Para la versión, modelo, máquina de prueba y sincronización de este ejecutamiento de Codex, consulte el registro de ejecución compartido.


Solución de problemas


¿Preguntas?

Si tienes alguna pregunta, contacta a support@ironsoftware.com

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

Leer más

¿Listo para empezar?

Descargas de NuGet 52,106Versión:2026.11recién lanzado