Como usar IronPDF com ChatGPT Codex

Curtis Chau
Curtis Chau
Atualizado: 26 de outubro de 2026

A maioria dos desenvolvedores encontra um agente de codificação de IA da mesma forma: eles colam uma classe inacabada em uma janela de chat, recebem algo plausível de volta e passam os próximos vinte minutos descobrindo quais partes são reais. Esse loop se torna caro rapidamente quando a biblioteca envolvida tem uma superfície de API específica, e geração de PDF é esse tipo de biblioteca.

ChatGPT Codex é o sistema de codificação agente da OpenAI. Lê um repositório, edita arquivos, executa comandos e relata o que mudou, e faz isso a partir de um terminal, um editor, um aplicativo de desktop ou a nuvem enquanto compartilha uma conta. IronPDF renderiza HTML, CSS e JavaScript em documentos PDF através de um mecanismo Chromium embutido. Os dois se encontram através de um fluxo de trabalho que você escreve, o que torna o prompt a parte que você realmente cria. Tudo abaixo é um prompt primeiro e C# segundo.

Início Rápido
NuGetInstalar com NuGet

PM > Install-Package IronPdf

Instale o IronPDF executando o comando acima no Console do Gerenciador de Pacotes NuGet, ou procure pelo pacote no Gerenciador de Pacotes NuGet.

Aponte Codex para um projeto de console limpo e descreva o resultado desejado:

In this C# console project, create Program.cs that uses IronPDF to render
the HTML string "<h1>Hello from IronPDF</h1>" to a file called hello.pdf.
Use only documented IronPDF APIs. Then run dotnet build and fix any errors.
Text

Codex escreve as três linhas que importam: construa um ChromePdfRenderer, chame RenderHtmlAsPdf em seu markup, e SaveAs o documento retornado para o disco. O prompt é mais longo que o código que ele produz. Você gasta seu esforço especificando, e o agente gasta seu esforço digitando e verificando.



O que é o ChatGPT Codex, e como ele se encaixa no trabalho com PDF no .NET?

Codex é um agente, não uma janela de chat. Ele lê arquivos, escreve arquivos e executa comandos de console dentro de um escopo que você concede a ele, então mostra seu trabalho. OpenAI o envia como um agente por trás de várias portas de entrada que compartilham uma conta. A documentação do Codex CLI e a documentação da extensão do Codex IDE cobrem as diferenças entre eles.

SuperfícieOnde ele executaAlcance-o quando
CLITerminalVocê quer o agente na mesma janela que dotnet build
Extensão de IDEVS Code, JetBrains, XcodeVocê deseja a diferença e o PDF renderizado lado a lado
Aplicativo de desktopmacOS, Windows, LinuxVocê está conduzindo uma tarefa mais longa a partir do terminal
NuvemNavegadorVocê está delegando uma tarefa e coletando a diferença depois

Um AGENTS.md comprometido com o repositório governa todos os quatro.

Instale o CLI com npm i -g @openai/codex, ou brew install --cask codex no macOS. Instaladores autônomos que não precisam de um runtime Node.js estão disponíveis para cada plataforma, e as notas de fonte e lançamento estão no repositório do Codex CLI.

Por favor, note: Mantenha o escopo @openai/ nessa instalação. O pacote codex não escopado no npm é um projeto não relacionado publicado pela última vez em 2012. Também é uma ilustração interessante de por que nomear pacotes exatos é importante quando um agente está digitando.

Codex oferece vários modelos, e /model se move entre eles no meio da sessão. O guia de modelos da OpenAI recomenda o GPT-6.1 Sol para codificação complexa e trabalho agente e GPT-6 Luna para tarefas focadas e repetitivas, e a execução nesta página usou o GPT-6 Luna. A maioria de uma sessão de PDF é do tipo de trabalho barato, editando um modelo, reconstruindo, olhando para o resultado novamente, com a ocasional extensão onde uma tabela se divide em uma página por motivos que nenhum compilador jamais explicará. Troque para cima para essa parte e depois volte para baixo.

Para desenvolvimento de PDF, esse comportamento agêncico altera o que um prompt pode pedir razoavelmente. Um assistente de chat responde a uma pergunta. Um agente adiciona a referência do NuGet, escreve o template, executa a build, lê o erro do compilador e corrige a si mesmo. Você descreve o resultado, então revisa uma diferença em vez de depurar uma colagem.

O que o Codex não pode fazer é saber com certeza a API atual do IronPDF. Seu conhecimento vem de dados de treinamento além do que você coloca na frente dele. A OpenAI treina o Codex para executar comandos e verificar seu próprio resultado, e ainda diz para você revisar o trabalho do agente antes de enviá-lo. Essa orientação se aplica duas vezes aqui: um compilador detecta um método inventado, mas nada detecta um PDF que renderiza um pouco errado, exceto abri-lo. O guia pai cobre a documentação para entregar a qualquer assistente antes de ele começar, e o mesmo procedimento se aplica a Claude Code e GitHub Copilot com apenas o nome do arquivo de contexto mudando.

Codex é a metade não determinística deste pipeline. Peça a ele a mesma fatura duas vezes e dois modelos plausíveis voltam. Qualquer coisa que renderize esses templates tem que se comportar ao contrário: HTML idêntico, as mesmas páginas renderizadas, em cada execução. Esse é o caso de entregar a renderização a uma biblioteca mantida em vez de deixar um agente montar uma, e a lacuna aparece nos recursos que ninguém prototipa até o dia em que são necessários.

  • Saída determinística: IronPDF fixa seu motor, e a mesma entrada renderiza as mesmas páginas em cada execução.
  • Criptografia e permissões: proteção por senha e sinalizadores de permissão geralmente significam uma segunda biblioteca conectada ao lado da primeira. IronPDF define ambos no documento que acabou de renderizar.
  • Formatos de conformidade: saída arquivada e acessível são os requisitos que ninguém prototipa e todos eventualmente precisam. SaveAsPdfA escreve um arquivo PDF/A, e SaveAsPdfUA escreve o PDF/UA marcado que um leitor de tela pode navegar.
  • Alguém consertando: várias das opções gratuitas mais copiadas estão arquivadas, então uma vulnerabilidade encontrada hoje permanece aberta. Uma biblioteca comercial tem um mantenedor do outro lado.

O custo da opção gratuita raramente é a licença. É o código que você escreve em torno dessas lacunas, e a auditoria que você falha no dia em que um documento precisa ser marcado ou criptografado.

O que torna um prompt do IronPDF eficaz?

Especificidade, em seis dimensões previsíveis. Um prompt vago produz código genérico que compila contra uma biblioteca imaginária; um prompt específico produz código que você pode revisar em trinta segundos.

ComponentePrompt fracoPrompt forte
Linguagem e framework"Faça um PDF""Em C# visando .NET 9"
Estrutura do projetoNão declarado"Adicionar ao Services/InvoiceService.cs"
Versão da bibliotecaNão declarado"Versão do IronPDF atualmente no .csproj"
Arquivos de origemNão declarado"Leia Templates/invoice.html primeiro"
Resultado esperado"Um belo PDF""Retrato A4, margens de 20mm, rodapé com números de página"
RestriçõesNoneSem novos pacotes. Apenas assíncrono. Pergunte se não tiver certeza sobre uma API."

A última restrição merece sua própria nota. Dizer a um agente que "Eu não sei" é uma resposta aceitável diminui as APIs inventadas, porque o padrão de um modelo de linguagem é produzir algo com uma forma plausível em vez de admitir uma lacuna. Dê permissão para parar.

Dicas: Mantenha a coluna forte como uma lista de verificação. Seis respostas, um prompt, e a maioria das APIs inventadas nunca são escritas.

Um segundo hábito que compensa em todo o projeto é um arquivo AGENTS.md comprometido na raiz do repositório. Esse é o arquivo que o Codex lê para instruções de projeto permanentes, e ele o lê automaticamente no início de cada sessão, concatenando o arquivo raiz primeiro e arquivos aninhados depois, para que a orientação em nível de diretório prevaleça. Execute /init em uma sessão para criar um esqueleto. Gravar "IronPDF é a biblioteca PDF; verifique APIs contra ironpdf.com; nunca adicione um pacote PDF concorrente" uma vez significa que você para de repetir isso em cada prompt.

Aponte esse mesmo arquivo para a documentação legível por máquina do IronPDF. llms.txt indexa páginas de documentação com uma descrição de uma linha, e skill.md é um conjunto de instruções integrado que cobre convenções de API e padrões comuns. Um prompt escreve ambos no projeto:

Create AGENTS.md at the repository root with a PDF section stating that this
project uses IronPDF for all PDF generation, that you must read
https://ironpdf.com/llms.txt before writing PDF code and use only APIs
documented there, that https://ironpdf.com/skill.md should be loaded if the
tooling supports skill files, that ChromePdfRenderer is the HTML-to-PDF entry
point, and that no competing PDF package may be added.
Text

Como você pede ao Codex para adicionar IronPDF e renderizar um primeiro PDF?

Comece fazendo o agente fazer a configuração, porque a configuração é onde surgem os desvios de versão.

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

Pedir a versão de volta é a pequena ação que importa. Isso lhe dá um fato para incluir em cada prompt posterior, e destaca o caso em que o agente instalou silenciosamente outra coisa. Espere no máximo uma diferença de uma linha e um número de versão declarado. Para fixar deliberadamente em vez de pegar a última, Que versão do IronPDF devo usar? cobre a escolha.

Sem uma chave de licença, IronPDF renderiza o documento na memória e depois lança um LicensingException quando é salvo ou lido como bytes, e a chave pertence ao início do aplicativo antes de qualquer outra chamada de IronPdf. Faça o Codex colocá-la em vez de fazer isso manualmente:

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

Chaves de teste, e todas as outras maneiras de aplicar uma de appsettings.json ao Azure, são cobertas em Chaves de Licença IronPDF.

Renderizar a partir de um arquivo HTML em vez de uma string embutida é o próximo passo realista, já que modelos reais vivem no disco.

Create Templates/invoice.html with plain HTML and inline CSS: a header with
a company name, a line-item table (description, quantity, unit price, total),
and a right-aligned totals block. No JavaScript.

Then write Services/InvoiceRenderer.cs with a method RenderAsync that loads
that file, substitutes {{CompanyName}}, renders it with IronPDF, and returns
a byte array. Use the async IronPDF rendering method. Build and fix errors.
Text

Em resumo, esse prompt se traduz no seguinte. Leia para confirmar que o agente aterrou em APIs reais em vez de digitá-lo você mesmo:

// IronPdf 2026.10.3, targeting .NET 9
using IronPdf;

public class InvoiceRenderer
{
    // One renderer, reused for every invoice. Constructing a new one
    // per request is the quiet performance mistake worth avoiding.
    private readonly ChromePdfRenderer _renderer = new ChromePdfRenderer();

    public async Task<byte[]> RenderAsync(string companyName)
    {
        // Read the HTML template off disk, exactly as written.
        var html = await File.ReadAllTextAsync("Templates/invoice.html");

        // Swap the placeholder for the real value before rendering.
        html = html.Replace("{{CompanyName}}", companyName);

        // Chromium renders the finished HTML. The async call leaves
        // the request thread free while that happens.
        var pdf = await _renderer.RenderHtmlAsPdfAsync(html);

        // BinaryData returns the raw bytes, ready for an HTTP
        // response or a storage upload.
        return pdf.BinaryData;
    }
}
C#

Cada membro ali é real: ChromePdfRenderer, RenderHtmlAsPdfAsync, e BinaryData aparecem todos na Referência de API, que é a verificação a ser realizada em qualquer bloco que um agente lhe entregar. Quando o HTML referencia imagens ou folhas de estilo locais, o renderizador precisa de um caminho base para resolvê-los, que é passado como o segundo argumento da chamada de renderização (BaseUrlOrPath em RenderHtmlAsPdf, um Uri em RenderHtmlAsPdfAsync) ao invés de ser configurado nas opções de renderização, e é documentado no Tutorial de HTML para PDF.

Como você migra uma implementação de PDF existente para IronPDF?

É aqui que um agente ganha seu valor, porque a migração é mecânica, tediosa e fácil de acertar em 90%. O prompt tem que apontar o código existente em vez de descrevê-lo.

Read Reports/LegacyReportBuilder.cs. It currently builds PDFs by positioning
text and drawing at coordinates with another library.

1. Summarize what the current output looks like: page size, sections, fonts.
2. Propose an HTML/CSS template that reproduces that layout.
3. Do not write any code yet. Wait for my approval on the plan.
Text

Separar análise da implementação é o padrão mais útil neste guia. Um agente que escreve 400 linhas antes de você ter concordado com a abordagem produz 400 linhas que você precisa ler cuidadosamente. Um agente que produz um plano de cinco tópicos produz algo que você pode corrigir em uma frase.

Por favor, note: Separar a análise da implementação custa uma viagem extra de ida e volta e economiza a leitura de um diff que você não concordou.

Após aprovar o plano, o acompanhamento é estreito:

Implement the plan. Create Templates/report.html and rewrite
LegacyReportBuilder.cs to render it with IronPDF, keeping the existing
public method signature so callers don't change. Leave the old file in
Git history only; don't keep dead code. Build and report the diff.
Text

Manter a assinatura pública estável é uma restrição que vale a pena declarar explicitamente todas as vezes. Sem isso, os agentes tendem a redesenhar a convenção de chamada como um bônus, e a migração cresce silenciosamente em um refatoramento.

Como você corrige problemas de layout, cabeçalhos e CSS através de prompts?

Os problemas de layout são visuais, e um agente não pode ver o PDF. O prompt precisa carregar a descrição do que está errado.

The rendered invoice.pdf has two problems: the line-item table splits a row
across pages 1 and 2, and the totals block sits at the top of page 2 instead
of directly under the table.

Fix this in Templates/invoice.html using CSS page-break properties. Do not
change InvoiceRenderer.cs. Explain which CSS rule fixes which problem.
Text

Nomear tanto o sintoma quanto o arquivo a ser alterado mantém a correção no modelo onde ela pertence. Porque IronPDF renderiza através do Chromium, o CSS de impressão padrão se aplica. page-break-inside, break-after, e a regra @page se comportam como em uma pré-visualização de impressão de um navegador, o que também lhe oferece uma maneira rápida de verificar uma correção sem regenerar o PDF. A exceção é @media print. IronPDF renderiza com o tipo de mídia da tela por padrão, então as regras dentro de um bloco @media print só se aplicam após RenderingOptions.CssMediaType ser definido para PdfCssMediaType.Print.

Cabeçalhos e rodapés funcionam de forma diferente. Eles são uma configuração de renderizador em vez de marcação de modelo, então o prompt deve dizer isso:

Add an HTML footer to the IronPDF renderer in InvoiceRenderer.cs showing
"Page {page} of {total-pages}", centered, 10mm max height. Use IronPDF's
HTML header/footer support on the rendering options, not markup inside
invoice.html. Link me to the documentation page you used.
Text

Pedir o link da documentação é um atalho de verificação. Se o agente não puder produzir uma página real para a API que acabou de usar, esse é um sinal que vale a pena agir antes que o código chegue a uma construção. Mantenha Inicializando RenderingOptions Corretamente à mão.

Como você depura a saída de PDF incorreta de ponta a ponta?

Os prompts acima fazem cada um uma coisa. O uso mais interessante é entregar ao Codex um sintoma e deixá-lo trabalhar em todo o ciclo: inspecionar, diagnosticar, corrigir, testar. Aqui é onde ele se comporta como um assistente de desenvolvimento em vez de um gerador de snippets.

Our generated invoices are missing the company logo. The PDF renders and
saves without error, and the logo displays correctly when I open
Templates/invoice.html in a browser.

Investigate:
1. Read InvoiceRenderer.cs and invoice.html.
2. Identify why the image resolves in a browser but not in the render.
3. Explain the cause before changing anything.
4. Then apply the minimal fix and rebuild.
Text

A estrutura em quatro etapas importa. Ela pede um diagnóstico que você pode avaliar antes de qualquer alteração de arquivo, o que é mais barato do que engenharia reversa de uma edição após o fato. Neste caso, a causa provável é a resolução de caminho relativo: o navegador resolve a imagem contra a própria localização do arquivo, enquanto o renderizador resolve contra qualquer caminho base que foi dado, e uma resposta correta nomeia esse mecanismo em vez de trocar por um caminho absoluto.

Mensagens de erro merecem o mesmo tratamento. Colar o rastreamento completo da pilha é a coisa de maior sinal que você pode dar a um agente.

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

[PASTE FULL EXCEPTION AND STACK TRACE HERE]

Check our Dockerfile for missing native dependencies IronPDF's Chromium
engine needs on Debian-based images. Explain the cause, then propose the
Dockerfile change. Don't modify C# code unless the cause is there.
Text

Falhas em contêineres geralmente rastreiam de volta para as dependências nativas que o motor Chromium do IronPDF precisa em uma imagem baseada em Debian, e essas pertencem a um Dockerfile em vez de em C#. Aponte o Codex para Como Executar o IronPDF em um Contêiner Docker e faça-o ler as diretrizes de implantação atuais antes de editar qualquer coisa.

Como transformar código único em componentes reutilizáveis e testados?

Uma vez que uma renderização funciona, o próximo prompt deve generalizá-la, e um agente é excepcionalmente bom nisso, porque o padrão já está sentado no arquivo.

Refactor InvoiceRenderer.cs into a reusable PdfDocumentService registered
with dependency injection. It should take a template path and a dictionary
of placeholder values. Reuse a single ChromePdfRenderer instance rather than
constructing one per call. Add XML doc comments. Keep it under 60 lines.
Text

A instrução de reuso de instância é o tipo de detalhe que vale a pena carregar em AGENTS.md, já que construir um renderizador por solicitação é um erro de desempenho comum e silencioso.

Os testes são um companheiro natural, e a saída de PDF é mais testável do que parece à primeira vista:

Write xUnit tests for PdfDocumentService covering: output is non-empty,
output begins with the %PDF- file signature, placeholder substitution
appears in extracted text, and a missing template throws a clear exception.
Use IronPDF's text extraction for the content assertion. No golden-file
byte comparisons; rendering output is not byte-stable.
Text

Desconsiderar a comparação byte a byte logo de cara evita toda uma classe de testes instáveis. Motores de renderização produzem bytes ligeiramente diferentes entre versões e plataformas, então asserções pertencem ao nível de texto extraído, contagem de páginas e metadados.

Codex também é útil como leitor. Aponte-o para uma classe desconhecida e ele transforma a referência de API em algo que você pode consultar em vez de rolar:

Read the IronPDF API reference for the rendering options type and list
every option that affects page size, then show which ones this project
already sets.
Text

Qual padrão de prompt se encaixa em qual tarefa?

Seis seções, seis padrões. O fio comum é que cada um deles nomeia algo específico: um arquivo, uma versão, um sintoma ou um ponto de parada.

TarefaNomeie isso no promptPadrão
Adicionando o pacoteA versão, e que nada mais pode ser adicionadoPeça o resultado de volta
Primeira renderizaçãoO caminho do modelo e o método a usarEspecifique, depois construa
MigraçãoO arquivo a ler, e a assinatura a preservarPlaneje antes do código
Correção de layoutO sintoma e o arquivo a mudarDescreva o que você vê
Falha de contêinerO rastreamento completo da pilha e a plataformaDiagnostique antes de editar
Refatorar e testarA forma do resultado e o que excluirRestrinja a saída

O que os prompts produziram em uma execução real?

Enviamos os prompts acima para o Codex em ordem, em uma única sessão, em um projeto console .NET 9 com IronPdf 2026.10.3. Cada construção de Release foi bem-sucedida. O Chromium falhou ao iniciar dentro do sandbox do Codex, então uma verificação separada renderizou cada PDF do código que cada prompt deixou para trás.

  • Antes do prompt de layout, a linha 9 do item da fatura foi dividida entre as páginas 1 e 2, com o bloco de totais no topo da página 2.
  • Antes do prompt do logotipo, a fatura mostrou um espaço reservado de imagem quebrada e o texto alt no lugar do logotipo.
  • O programa Quickstart lançou LicensingException em SaveAs, mesmo com a chave no ambiente, porque nada aplicou a chave.
  • O prompt de licença leu a chave de uma variável de ambiente e a aplicou antes da primeira renderização. O resultante hello.pdf era um arquivo A4 de 1 página com 17.385 bytes.
  • O prompt AGENTS.md produziu uma seção de PDF que continha todos os cinco requisitos.
  • O plano de migração não alterou nenhum arquivo e descreveu a página A4, as fontes, cores e seções do relatório original corretamente. O relatório migrado manteve a assinatura do método público, removeu o pacote PDFsharp e reproduziu cada figura.
  • O rodapé migrado foi movido para uma segunda página e lia Página 0 de 0, onde o relatório original de 1 página lia Página 1 de 1.
  • A correção de layout colocou cada regra de quebra de página dentro de um bloco @media print, que o tipo de mídia de tela padrão ignora. A fatura permaneceu inalterada, e a linha 9 do item ainda estava dividida.
  • Com CssMediaType definido para Print, o mesmo template manteve a linha 9 do item inteira na página 2, com os totais diretamente abaixo.
  • O prompt de rodapé adicionou um rodapé HTML, e as duas páginas então liam Página 1 de 2 e Página 2 de 2.
  • O diagnóstico do logotipo nomeou o caminho relativo e a URL base ausente como a causa. Com a pasta de templates passada como URL base e logo.png copiado para o resultado da build, o logotipo foi renderizado em 240 por 96 pixels.
  • O primeiro InvoiceRenderer criou um novo ChromePdfRenderer em cada chamada. O refatorado PdfDocumentService tinha 51 linhas, e a injeção de dependência compartilhava um ChromePdfRenderer.
  • Os dois testes xUnit cobriram todas as quatro condições e passaram com a chave. Sem a chave, o teste de extração de texto falhou com LicensingException.
  • A resposta da API nomeou doze membros, e todos os doze existem no IronPdf 2026.10.3, incluindo o campo PaperFit. Relatou corretamente que o projeto definiu apenas a margem inferior entre eles.
  • Nenhum PDF renderizado continha uma marca d'água, e a chave não apareceu em nenhum arquivo, commit ou log de sessão do Codex.
  • Alguns passos foram executados de forma diferente da página. O README do repositório nomeou a variável da chave e disse para nunca imprimi-la. O relatório PDFsharp, uma fatura de 9 itens e o logotipo foram adicionados antes dos prompts que precisavam deles. O prompt de container do Linux não foi executado, pois a máquina não tinha Docker. O sandbox não tinha rede, então Codex restaurou pacotes do cache local do NuGet, onde o pacote de injeção de dependência foi restaurado durante a execução.

A fatura abaixo é a saída não editada do serviço final PdfDocumentService. Ela contém o rodapé e o logotipo, e a linha 9 do item ainda está dividida.

O registro de execução compartilhado lista a versão do Codex, modelo, máquina e tempo para esta execução.

O que se leva para o próximo projeto?

Os prompts, não o código. Todo padrão acima sobrevive a uma mudança de projeto com apenas os nomes dos arquivos trocados, e é por isso que um AGENTS.md comprometido ganha seu lugar: ele transforma as restrições que você trabalhou uma vez no padrão do qual cada sessão posterior começa.

O teste de aceitação pelo qual esta série é medida, executado do início ao fim com um resultado publicado e uma data de última testagem, está no guia de assistentes de codificação de IA.


Solução de problemas


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.

Leia Mais

Pronto para começar?

Downloads no NuGet 22,198,312Versão:2026.11recém-lançado