Como usar o IronPrint com o ChatGPT Codex
Um armazém imprime uma lista de separação para cada pedido a cada noite. Alguns pedidos precisam de uma cópia para o separador, outros precisam de uma segunda para o empacotador e uma terceira para o responsável pela fatura. Quando a contagem de cópias está errada, nada falha. O empacotador encontra uma folha sem cópia para o parceiro, ou a mesa de faturas recebe nove folhas de um pedido, e o log de impressão ainda relata esses pedidos como enviados.
O ChatGPT Codex, agente de codificação da OpenAI, edita os arquivos de um repositório, executa dotnet run e outros comandos, e relata o que fez. Ele funciona no aplicativo de desktop do ChatGPT, em um IDE, em um terminal e na nuvem. IronPrint, a biblioteca de impressão .NET da Iron Software, envia arquivos PDF e de imagem para uma impressora instalada, silenciosamente ou através da caixa de diálogo de impressão do sistema operacional, com tamanho do papel, orientação, DPI, escala de cinza e o número de cópias definido em um objeto PrintSettings.
O Codex recebe uma noite de pedidos de lista de separação e um manifesto de resultados esperados. Cada contagem de cópias que o Codex relata vem de um arquivo CSV, e todo o lote é planejado antes que qualquer trabalho seja enviado a uma impressora.
Início RápidoExecute o Codex dentro de um projeto de console .NET com uma pasta Orders.
$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.
A menção $ironprint carrega a habilidade do IronPrint na sessão.
Fluxo de trabalho mínimo (5 etapas)
- Baixe a biblioteca de impressão C# do NuGet
- Salve a habilidade do IronPrint como .agents/skills/ironprint/SKILL.md para que a menção
$ironprintseja resolvida. - Comite um AGENTS.md que nomeie a fonte do nome da impressora e exija um CSV para cada contagem.
- Construa um
PrintSettingspor pedido com sua contagem de cópias, após uma correspondência exata contraPrinter.GetPrinterNames. - Compare o arquivo de plano com o manifesto antes que qualquer trabalho seja enviado.
O que é o ChatGPT Codex e como ele se encaixa no trabalho de impressão .NET?
A documentação CLI do Codex explica a instalação e o uso no terminal, e seu código-fonte e lançamentos estão no GitHub.
O Codex depende de dados de treinamento e dos arquivos em seu contexto para o IronPrint, e um nome de membro incorreto falha na compilação.
O IronPrint suporta Windows, macOS, iOS e Android. O projeto neste guia tem como alvo net9.0-windows.
Como você escreve um prompt do IronPrint e configura o Codex para ele?
Um prompt de lote do IronPrint nomeia a entrada (cada pedido em Orders/manifest.csv), a impressora e a fonte de seu nome (appsettings.json, verificado contra Printer.GetPrinterNames), as configurações para cada trabalho (a contagem de cópias do manifesto, tamanho do papel, retrato, escala de cinza e 150 DPI), a prova (um CSV de plano com uma linha por pedido), a verdade terrestre (os status esperados no manifesto) e as restrições (um nome de impressora exato e nenhuma chamada para ShowPrintDialog).
O Codex pesquisa o diretório de trabalho e cada diretório acima dele, até a raiz do repositório, por uma pasta .agents/skills. Cada pasta de habilidade contém um arquivo SKILL.md cujo cabeçalho dá um nome e uma descrição. Com o skill.md do IronPrint copiado para .agents/skills/IronPrint/SKILL.md, a menção $ironprint é resolvida. O exemplo de arquivo único na habilidade fixa o IronPrint 2026.8.1, e o Quickstart instala o 2026.10.1.
Antes de qualquer trabalho, o Codex carrega os arquivos AGENTS.md no caminho da raiz do repositório para a pasta de trabalho. Ele lê no máximo um por diretório, e onde dois entram em conflito, o arquivo mais próximo da pasta de trabalho tem precedência. Rodar /init produz um rascunho inicial.
A máquina de teste não tem uma impressora que conclua um trabalho sem uma caixa de diálogo, e uma caixa de diálogo interrompe uma execução não assistida. O repositório de teste, portanto, inclui uma pequena classe de captura que intercepta o trabalho que o IronPrint envia ao Windows e o grava em um arquivo XPS, para que nenhum trabalho seja spooled. Um projeto com uma impressora funcional a exclui.
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.
Como você pede ao Codex para adicionar IronPrint e verificar a licença?
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.
No nuget.org, o IronPrint 2026.10.1 lista três dependências, IronSoftware.Common 2026.4.2, IronSoftware.Abstractions 2026.1.2 e IronSoftware.System.Drawing 2026.8.2. Na nossa execução, o restore também adicionou IronSoftware.Drawing.Abstractions 2026.1.2. Cada compilação copia os arquivos de runtime nativos do IronPrint para a pasta de saída. Revise o changelog do IronPrint antes de fixar uma versão.
Printer.GetPrinterNames, Printer.GetPrinterTrays e um novo PrintSettings todos têm sucesso sem uma chave, então uma lista de impressoras não prova nada sobre licenciamento. Uma chamada de impressão sem chave lança uma exceção de licenciamento antes que qualquer trabalho seja criado, e sua mensagem lê Produção Licença Necessária. O Print síncrono o encapsula em um AggregateException, enquanto o PrintAsync o lança diretamente. Código fora do IronPrint 2026.10.1 não pode referenciar o tipo de exceção de licenciamento. Um manipulador, portanto, captura Exception e compara o nome do 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.
IronPrint deixa IRONPRINT_LICENSE_KEY ilegível, então o programa copia seu valor para License.LicenseKey. Uma chave também pode ir em appsettings.json, Web.config ou App.config, conforme descrito na página de chaves de licença.
Como o IronPrint imprime várias cópias de um documento?
O guia de cópias define NumberOfCopies uma vez e envia um trabalho, em vez de chamar Print em um loop. Uma sonda de calibração enviou três cópias de uma lista de separação de duas páginas, e o IronPrint construiu um trabalho de duas páginas com uma contagem de cópias de 3 em seu ticket de impressão. O driver da impressora faz as cópias extras. O Microsoft Print to PDF converteu esse ticket em um arquivo de seis páginas, ordenado 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.
NumberOfCopies tem padrão 1, e a propriedade aceita 0, -1 e 1000. O guia de cópias afirma que 0 ou um valor negativo reverte para uma única cópia. A chamada de impressão recusou 0 e -1 na calibração, com um ArgumentOutOfRangeException cuja mensagem é Valor deve ser positivo, e nenhum trabalho foi criado. O lote, portanto, rejeita esses pedidos antes que qualquer configuração seja construída. Os comentários XML acrescentam que algumas plataformas ignoram o valor e imprimem uma cópia.
Cada página vai para a impressora como uma imagem na DPI do trabalho. Na sonda, uma página A4 a 150 DPI era de 1240 por 1753 pixels. Com Grayscale definido, a cor de saída do ticket de impressão era Monocromática.
Como você planeja um lote noturno de trabalhos de impressão?
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.
O IronPrint relata um arquivo danificado apenas quando uma chamada de impressão o lê. Um arquivo vazio falhou na calibração com um tipo de exceção de um namespace ofuscado cuja mensagem linka para uma página de solução de problemas do IronPDF, e um arquivo de texto chamado .pdf falhou com InvalidDataException. Uma verificação do cabeçalho do PDF no plano mantém ambos fora da lista de trabalhos.
Como você confirma o que cada trabalho de impressão transporta?
PL-1028.pdf, um dos seis pedidos de amostra, é uma lista de separação A4 de duas páginas com uma bin e uma quantidade para cada SKU, e o manifesto lhe dá três cópias.
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.
Saída
O PDF abaixo é o trabalho que o IronPrint construiu para PL-1028 na execução de teste, convertido página por página a partir do arquivo XPS capturado.
Lista de separação PL-1028 conforme o IronPrint construiu o trabalho, capturada em um arquivo no lugar de uma impressora. O trabalho contém duas páginas A4 em retrato a 150 DPI em escala de cinza, e seu ticket de impressão solicita três cópias.
O que acontece quando o nome da impressora não combina?
O guia de nome da impressora afirma que um nome deve corresponder ao do sistema operacional exatamente, incluindo maiúsculas e minúsculas, e que uma incompatibilidade "falhará silenciosamente ou lançará um erro". Os trabalhos de calibração não levantaram exceção. Um trabalho para Warehouse Laser 01, uma fila que não existe, e um trabalho para adobe pdf em letras minúsculas ambos foram roteados para Microsoft Print to PDF, que a máquina de teste usa como sua impressora padrão.
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.
Como você diagnostica uma folha que foi impressa incorretamente?
O sinalizador -i (--image) anexa uma imagem ao primeiro prompt de uma sessão ou ao prompt que a retoma, e o compositor interativo aceita uma imagem colada.
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.
Como você depura a saída incorreta de lotes de ponta a ponta?
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.
Leia o diagnóstico antes de permitir uma edição. Um diagnóstico sólido também explica por que o log relata sucesso, já que o log registra cada chamada e não as folhas impressas.
Como transformar código único em componentes reutilizáveis e testados?
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.
Um refatoramento pode perder a verificação da impressora e ainda 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.
Asserções em objetos de configurações impedem que o pacote envie trabalhos, embora a verificação do nome exato ainda necessite que a impressora configurada esteja 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.
Como você reutiliza esses prompts em outro lote de impressão?
Com novos nomes de arquivos, nomes de impressoras e regras de cópias, os mesmos prompts lidam com etiquetas de envio ou faturas. O guia dos assistentes de codificação de IA do IronPrint cobre a configuração compartilhada por todos os assistentes.
O que os prompts produziram em uma execução real?
O Codex recebeu os prompts acima em ordem, em uma única sessão. O projeto .NET 9 continha 40 pedidos, suas listas de separação e um manifesto com o status esperado de cada pedido e a contagem de cópias. Scripts separados reexaminaram cada arquivo de saída.
- Antes do lote, o manifesto listava 35 pedidos Prontos, 2 pedidos com zero cópias, 1 arquivo ausente e 2 arquivos ilegíveis.
- O plano correspondia ao manifesto em todos os 40 pedidos.
- Cada pedido Pronto no plano tinha sua contagem de cópias e tamanho do papel do manifesto, em orientação retrato a 150 DPI em escala de cinza.
- Enviar os seis pedidos de amostra produziu um trabalho capturado para cada.
- As contagens de cópias nos seis tickets de impressão eram 1, 2, 2, 1, 3 e 3, igual ao manifesto.
- Os seis trabalhos continham 11 páginas, que as contagens de cópias elevaram para 20 folhas.
- O pedido Carta foi capturado como páginas de 215,9 por 279,4 mm e os pedidos A4 como páginas de 210 por 297 mm.
- Cada página dos seis trabalhos capturados era uma imagem de 150 DPI sem pixels coloridos, então a faixa de prioridade vermelha era cinza.
- Sem uma chave, o programa listou as quatro impressoras e construiu as configurações, e a chamada de impressão falhou com Produção Licença Necessária.
- Ambos os nomes de impressoras incorretos pararam o plano antes que qualquer linha fosse escrita, e a mensagem listava as quatro impressoras instaladas.
- A partir da varredura, o Codex identificou o pedido PL-1024 e relatou três cópias em A4 do plano.
- O diagnóstico noturno rastreou as 9, 4 e 18 folhas para um loop que chamou Print uma vez por cópia com a contagem total de cópias já definida.
- Rastreou a folha para o pedido de zero cópias para uma trava que elevou 0 para 1.
- O PrintQueueService refatorado tinha 51 linhas, e seu plano correspondia ao manifesto em cada status e contagem de cópias.
- Todos os 7 testes passaram na sessão do Codex e novamente em um clone novo.
- O Codex listou os oito membros da Impressora que enviam um trabalho ou abrem uma caixa de diálogo e construiu uma sonda para eles sem executá-la.
- Alguns passos foram executados de forma diferente da página. O Quickstart parou após três tentativas fracassadas sem escrever seu CSV. Uma tentativa de verificação de licença foi executada com a chave ainda configurada, e a classe de captura interceptou sua chamada de impressão. O explorador respondeu à questão da bandeja a partir do XML em vez de consultar cada impressora. O Codex relatou que a verificação apenas do plano estava em Program.cs, não em PrintQueueService.
O guia Google Antigravity constrói uma página ASP.NET Core que aguarda a mesma chamada de impressão assíncrona. No guia Claude Code, cada tipo de documento vai para sua própria impressora e um subagente revisa a verificação do nome da impressora. Para a versão Codex, modelo, máquina de teste e tempo desta execução, consulte o registro de execução compartilhado.
Solução de problemas
- Como imprimir várias cópias se uma contagem de cópias for ignorada
- Como especificar o nome da impressora se os trabalhos forem para a impressora padrão
- O método Print() trava no WPF e WinForms se a interface parar de responder durante uma chamada de impressão
- Configuração de Licença web.config se cada chamada de impressão falhar com a mesma mensagem de licenciamento
Questões?
Se você tiver dúvidas, entre em contato com support@ironsoftware.com
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.