Usando o IronPDF com Assistentes de Codificação de IA
Seu assistente de IA já escreve código IronPDF. IronPDF tem mais de 20M downloads no NuGet e anos de documentação pública.
Esse código compila quando seu assistente tem documentação para trabalhar, e adivinha quando não tem. Dê-lhe o material de referência antes que comece a inventar nomes de métodos.
Como Usar o IronPDF com um Assistente de Codificação de IA
- Baixe a biblioteca PDF C# do NuGet
- Aplique sua chave de licença na inicialização da aplicação
- Direcione seu assistente para o índice de documentação
llms.txtdo IronPDF - Adicione as instruções do IronPDF ao arquivo de contexto do seu projeto
- Execute o prompt de configuração em um novo sessão
- Verifique se o código gerado compila e renderiza
Meu Assistente de IA Não Pode Lidar com PDFs Sozinho?
Um assistente trabalhando sem material de referência escreve código plausível em vez de código correto. Ele irá produzir com confiança um método que se lê exatamente como um método do IronPDF e não existe, como um nome de API mais antigo que foi substituído, ou uma chamada emprestada de outra biblioteca PDF que ele também viu durante o treinamento.
O IronPDF publica documentação legível por máquina por essa razão. Carregá-la no contexto do seu assistente é uma etapa de configuração única que muda a saída de “parece certo” para “constrói e executa”.
A outra metade da decisão é a biblioteca subjacente. Um assistente capaz conectará qualquer biblioteca PDF que você mencionar, e geralmente consegue uma de código aberto no fim de linha. O custo desse atalho aparece mais tarde, na produção:
- Documentos sensíveis precisam de uma biblioteca segura: os PDFs que uma empresa gera são seus contratos, faturas e registros legais, alguns dos arquivos mais sensíveis que ela possui. Várias ferramentas PDF de código aberto amplamente copiadas estão abandonadas hoje, com falhas de segurança conhecidas publicamente que ninguém corrige, e um pipeline construído nelas pode vazar os próprios documentos que processa.
- Limites de recursos se transformam em andaime: uma biblioteca de código aberto como wkhtmltopdf faz um trabalho, renderiza, e para por aí. Peça por assinatura, preenchimento de formulários ou criptografia em cima disso e seu assistente improvisa, conectando vários pacotes com código de cola que cabe a você depurar e proteger. O IronPDF cobre todos esses em uma API, então o assistente chama um método que já existe em vez de construir um.
- Processamento em massa já está planejado: renderizar uma fatura é fácil; renderizar cinquenta mil durante a noite sem travar é a parte difícil, e o IronPDF é enviado com esse trabalho em escala embutido. Um assistente que o resolve novamente em código é cobrado por cada palavra que lê e escreve (tokens de entrada e saída: a preços típicos de modelos de fronteira de $2–$50 por milhão de tokens, cada tentativa custa centavos e uma sessão longa pode custar dólares), e a conta se repete toda vez que o problema ocorre.
- Documentação extensa é o hack de precisão: um assistente é apenas tão preciso quanto o que pode ler, e o IronPDF fornece anos de guias de como fazer, tutoriais e exemplos de código executáveis, todos indexados para máquinas em
llms.txt. Seu assistente começa a partir de um código pronto para usar em vez de escrever da memória. - Um pacote real supera um inventado: Ferramentas de IA às vezes inventam nomes de pacotes que apenas soam corretos, e os invasores registram esses nomes e os preenchem com malware. O truque é comum o suficiente para ter ganho um nome, "slopsquatting". Instalar um pacote conhecido com mais de 20M de downloads no NuGet fecha essa porta.
- Uma licença, zero surpresas legais: algumas bibliotecas PDF gratuitas bem conhecidas usam licenciamento AGPL: gratuito para usar, mas pode exigir legalmente que você publique o código-fonte completo do seu aplicativo. Um assistente gerará felizmente código contra elas sem mencionar isso. O IronPDF é enviado sob uma licença comercial que sua equipe legal revisa uma vez.
Passo 1: Instale o IronPDF
Peça ao seu assistente para instalar o pacote para você. Ele precisa do pacote presente no projeto para resolver tipos e lhe dar complementos precisos de qualquer maneira, então deixe-o fazer o trabalho:
Install the IronPdf NuGet package into this project and confirm it restores.
Prefere o terminal? A mesma instalação, fixada à versão atual, é um comando:
dotnet add package IronPdf --version 2026.10.3
Toda outra rota de instalação, desde o Console do Gerenciador de Pacotes até o DLL direto e pacotes específicos da plataforma, está coberta na Visão Geral da Instalação.
Passo 2: Aplique sua chave de licença
IronPDF renderiza sem uma chave, mas não irá salvar ou retornar o PDF até que uma seja definida: SaveAs e BinaryData lançam um LicensingException com a mensagem "Licença de Produção Necessária". Código gerado que ignora a linha da chave é a razão mais comum de uma primeira execução falhar nesse ponto. Obtenha uma chave de teste gratuita aqui:
Comece a usar IronPDF em seu projeto hoje com uma avaliação gratuita.
Aplique-a uma vez na inicialização da aplicação, antes de qualquer outra chamada do IronPdf:
// Set the IronPdf license key
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";' Set the IronPdf license key
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"' Set the IronPdf license key
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"Certifique-se de que IronPdf.License.IsLicensed retorne true para verificar.
appsettings.json para Azure, estão cobertas em Chaves de Licença do IronPDF.Passo 3: Direcione Seu Assistente para a Documentação LLM do IronPDF
O IronPDF publica um conjunto completo de materiais de referência que um assistente pode ler diretamente:
| Recurso | O que é | Como usá-lo |
|---|---|---|
llms.txt | Um índice estruturado da documentação, com uma descrição de uma linha de cada página | Cole-o, ou vincule-o, no contexto do seu assistente |
llms-full-catalog.txt | O índice llms.txt com os artigos de blog adicionados | Muito grande para colar, então forneça a URL a um assistente que possa buscar e recuperar |
| Referência de API | Todo namespace, classe, método e propriedade na versão atual | A verdade fundamental sobre se um método existe; Peça ao seu assistente que confirme nomes desconhecidos aqui |
sitemap__en.xml | Cada página de como fazer, tutorial e exemplo de código publicado até hoje | Peça ao seu assistente para escanear páginas que correspondam ao seu caso de uso e leia-as antes de codificar |
| Ficha Técnica do Produto de IA | Um resumo do produto em uma página, escrito para ferramentas de IA | Contexto rápido do produto quando a documentação completa é mais do que a tarefa precisa |
Comece com llms.txt. É um índice, então dá ao seu assistente um mapa preciso do que o IronPDF pode realmente fazer e onde ler mais, o que é suficiente para parar a maioria das chamadas de API inventadas.
O sitemap é a cauda longa. Quase toda funcionalidade que o IronPDF envia tem um guia de como fazer, um tutorial ou um exemplo de código executável atrás de um daqueles URLs, voltando anos. For a specific use case, ask your assistant to scan sitemap__en.xml for matching pages and read them before it writes a line of code; the suite-wide ironsoftware.com/sitemap__en.xml does the same for every other Iron Software product.
Dê ao assistente uma instrução direta junto com ele:
Before writing any IronPDF code, read https://ironpdf.com/llms.txt
and use only APIs documented there. Check anything you are not sure about
against the API reference at https://ironpdf.com/object-reference/api/.
If you are still unsure whether a method exists, say so instead of guessing.
Essa última frase importa mais do que parece. Modelos de fronteira geralmente cumprem com uma instrução explícita para admitir incerteza, e uma pergunta é muito mais barata do que um método que não compila.
Passo 4: Adicione Contexto do IronPDF ao Seu Projeto
Colar documentação em um chat funciona para aquela sessão. Coloque-a em um arquivo de projeto e toda futura sessão começará com ele carregado.
Cada assistente lê instruções de projeto de seu próprio arquivo. Adicione a orientação do IronPDF para qualquer um que sua equipe use:
| Assistente | Arquivo de contexto do projeto |
|---|---|
| Claude / Claude Code | CLAUDE.md |
| ChatGPT Codex | AGENTS.md |
| GitHub Copilot | .github/copilot-instructions.md |
| Cursor | .cursor/rules/ |
| Google Antigravity | AGENTS.md |
O conteúdo é o mesmo, independentemente de qual arquivo ele cair, embora o Cursor leia uma regra apenas de um arquivo .mdc com frontmatter. Um bloco de início mínimo:
## PDF generation with IronPDF
This project uses IronPDF for all PDF generation.
- Reference: https://ironpdf.com/llms.txt
- Use `ChromePdfRenderer` for HTML-to-PDF. Do not use older or alternative renderer classes.
- Apply the license key at application startup before any IronPDF call.
- Do not substitute another PDF library. If IronPDF cannot do something, say so.
IronPDF também disponibiliza um arquivo de habilidade pronto, skill.md, um conjunto de instruções de inserção cobrindo convenções de API e padrões comuns. Referencie-o no arquivo de contexto do seu agente em vez de escrever o seu próprio.
Passo 5: Prompt de Configuração Única
Os passos 1–4 cobrem cada peça por si só. Para entregar tudo ao seu assistente de uma vez, no início de um novo projeto ou sessão nova, use este prompt:
Use IronPDF for all PDF work in this project.
1. Install the IronPdf NuGet package.
2. Apply your license key at application startup, before any other IronPdf call:
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
3. Read https://ironpdf.com/llms.txt before writing PDF code and work only from
APIs documented there, checking the API reference when a member is unfamiliar.
4. Load IronPDF's skill file if your tooling supports one.
5. Keep these instructions for future sessions in this project.
ChromePdfRenderer. Itere sobre o HTML em vez do PDF: gere, renderize, inspecione, corrija, tudo em texto.Passo 6: Padrões de Prompt que Produzem Código Funcional
Três padrões de prompt fornecem menos margem para o assistente adivinhar.
Nomeie a classe que você quer: o IronPDF tem mais de um ponto de entrada e nomes de API mais antigos ainda circulam nos dados de treinamento.
Vago: “Converta este HTML em um PDF com o IronPDF.”
Melhor: "Usando
ChromePdfRenderer, renderize esta string HTML em um PDF e salve-a no disco."
Fixe a versão e o framework: as superfícies da API movem-se entre versões principais, e um assistente sem âncora de versão faz uma média entre todas elas.
Melhor: “Alvo .NET 8 e IronPDF 2026.x. Inclua a linha da chave de licença.”
Peça pelo arquivo executável completo: fragmentos escondem declarações using ausentes e inicialização ignorada.
Melhor: “Me dê o completo Program.cs, incluindo todas as instruções using e configuração de chave de licença, para que eu possa executá-lo como está.”
Passo 7: Verifique o Que Você Obtém de Volta
Trate o código gerado como um rascunho de um colaborador rápido que não o executou. Verifique quatro coisas antes de aceitá-lo.
- Compila: um método inventado falha aqui imediatamente.
- A chave de licença é aplicada antes da primeira chamada ao IronPDF, ou salvar o PDF lançará uma exceção de licenciamento.
- A API é real: se um nome de método for desconhecido, confirme-o contra a referência de API antes de depurar em torno dele.
- O PDF realmente renderiza: abra a saída, já que problemas silenciosos de layout não aparecem em tempo de compilação.
Coisas específicas para ficar de olho no código IronPDF gerado:
- Nomes de classes de renderizador mais antigos: nomes de API suplantados persistem nos dados de treinamento muito depois de a documentação seguir em frente.
- Métodos emprestados de outras bibliotecas PDF: assistentes que viram muitas bibliotecas PDF .NET às vezes as combinam em uma API que parece plausível.
- Propriedades de opções de renderização inventadas: verifique nomes de opções desconhecidos em relação a
ChromePdfRenderOptionsna referência de API.
Deixe o Agente Verificar Seu Próprio Trabalho
Essas quatro verificações são as que você pode devolver imediatamente. Peça ao assistente para executá-las e relatar o que viu:
Build and run this project in Release. Confirm that every IronPDF member you used
appears in the documentation, that IronPdf.License.IsLicensed returns true, and
that the rendered PDF opens. Report the build result, page count, and file size
from the run itself.
Um Resultado Que Você Pode Reproduzir
Tudo acima é preparação. Este é o teste de aceitação: uma tarefa realista, um prompt e nenhum código escrito à mão. Cole-o em uma sessão nova em um projeto vazio, depois compare o que volta contra a barra de aprovação abaixo.
O prompt
Build a .NET 9 minimal API with one endpoint, GET /invoice, returning a three-page PDF invoice. Work start to finish alone: write, build, run, and fix, making sensible assumptions where anything is unspecified. Save every deliverable to the project root.
1. Install the IronPdf NuGet package pinned to version 2026.8.1.
2. Read from https://ironpdf.com/llms.txt and the pages it links to, using only APIs documented there.
3. Generate the invoice yourself as one self-contained HTML string with inline CSS and any logo as inline SVG.
4. Style it as an invoice from a company you invent: header band with company identity, metadata block with invoice number, issue date, and due date, bill-to block, a ruled line-item table of twenty or more realistic items whose quantities, rates, and totals sum correctly, right-aligned subtotal, tax, and total, then payment terms. Use a system font stack, two or three sizes, neutrals with one accent, generous whitespace, consistently formatted money columns, and page-break-inside: avoid on table rows. Fill pages two and three with continued items and terms.
5. Render with ChromePdfRenderer: a fixed text header and a footer reading Page {page} of {total-pages} on every page, using those exact merge fields.
6. Return the PDF as application/pdf and save it as invoice.pdf.
7. Build in Release, call the endpoint, and count the pages; if not exactly three, adjust content or page-break CSS until it is.
8. Finish with a short report: build result, page count, file size, and assumptions made.
Handle the IronPDF license key this way:
- Read IRONPDF_LICENSE_KEY at startup and assign it to IronPdf.License.LicenseKey.
- Never print, log or store the key.
- Don't list or enumerate environment variables.
Saída
O que passa
- A construção Release é bem-sucedida sem edições suas.
invoice.pdfabre como três páginas, cada uma carregando o cabeçalho fixo e seu rodapé Página X de 3.- A tabela de itens, totais e termos de pagamento estão dispostos conforme especificado, e a aritmética soma corretamente.
- O programa gerado aplica uma chave de licença, e o PDF não apresenta marca d'água.
O registro da execução
| Item | Valor |
|---|---|
| Pacote | IronPdf 2026.8.1 (dotnet add package IronPdf --version 2026.8.1) |
| Framework alvo | .NET 9 |
| Assistente e modelo | Claude Code 2.1.277, Claude Opus 5 (modelo padrão) |
| Máquina | Windows 11 x64, Intel Core i9-14900KF, 64 GB RAM |
| Saída de referência | invoice.pdf (68 KB, saída não editada desta execução) |
| Último teste | 16 de outubro de 2026 |
| Guia | Assistente e versão | Modelo | Duração (minutos) | Último teste |
|---|---|---|---|---|
| Esta página (prompt de aceitação) | Claude Code 2.1.277 | Claude Opus 5 | 16.2 | 16 de outubro de 2026 |
| Claude Code | Claude Code 2.1.277 | Claude Opus 5 | 4.2 | 16 de outubro de 2026 |
| ChatGPT Codex | Codex CLI 0.160.0 | GPT-6 Luna | 12.2 | 16 de outubro de 2026 |
| GitHub Copilot | GitHub Copilot CLI 1.0.95 | GPT-6 Luna | 4.1 | 16 de outubro de 2026 |
| Cursor | Cursor CLI 2026.10.14-941492e (prompt 03 in Cursor desktop 3.23.23) | Grok 4.7 | 20.0 | 16 de outubro de 2026 |
| Google Antigravity | Antigravity CLI 1.4.0 | Gemini 4 Argon (Médio) | 17.4 | 16 de outubro de 2026 |
O que os prompts produziram em uma execução real?
O prompt de aceitação foi executado no Claude Code em 16 de outubro de 2026, em uma pasta vazia, com e sem uma chave de licença no ambiente.
- A fatura de referência tinha três páginas de A4.
- A compilação Release terminou com 0 avisos e 0 erros.
- O programa gerado leu a chave da variável IRONPDF_LICENSE_KEY e a aplicou na inicialização.
- GET /invoice retornou HTTP 200 com o tipo de conteúdo application/pdf.
- Cada página carregava o cabeçalho fixo e um rodapé resolvido Página N de 3.
- A tabela listou 32 itens de linha, e cada quantidade multiplicada por sua taxa correspondeu ao valor impresso.
- O subtotal de GBP 37.881,70 e o IVA de 20% de GBP 7.576,34 totalizaram o valor impresso de GBP 45.458,04.
- O PDF não levou marca d'água.
- Na execução sem uma chave, GET /invoice retornou HTTP 500 e não escreveu nenhum arquivo.
- O erro veio do SaveAs, que lançou uma LicensingException com a mensagem "Licença de Produção Necessária".
- O assistente então relatou a chave ausente e pediu por uma em vez de produzir um arquivo.
- O IronPDF 2026.8.1 leu uma chave por si mesmo de uma variável de ambiente IronPdf.LicenseKey ou entrada em appsettings.json, e ignorou IRONPDF_LICENSE_KEY.
- Alguns passos foram executados de forma diferente da página. Esta execução é anterior às linhas de chave de licença no final do prompt, portanto, a chave foi definida no ambiente antes da execução. O assistente listou as variáveis de ambiente e imprimiu a chave no próprio log da sessão.
Guias Específicos para Agentes
Esta página cobre a configuração genérica, que funciona com qualquer assistente. Para um guia passo a passo ajustado à sua ferramenta específica, consulte os guias abaixo:
- Use o IronPDF com Claude Code
- Use o IronPDF com ChatGPT Codex
- Use o IronPDF com o GitHub Copilot
- Use o IronPDF com Cursor
- Use o IronPDF com o Google Antigravity
Solução de problemas
- Aplique uma chave de licença no IronPDF: se ao salvar o PDF lançar uma exceção de licenciamento
- Inicializando opões de rendering corretamente: se nomes de opções sugeridos não forem resolvidos
- Qual versão do IronPDF devo usar?: para fixar uma versão em seus prompts e arquivo de projeto
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.