Usando IronPPT com Assistentes de Codificação de IA

Curtis Chau
Curtis Chau
Atualizado: 19 de outubro de 2026

IronPPT é a biblioteca PowerPoint da Iron Software para .NET. Ele cria, abre e edita apresentações PPTX a partir de código C# sem o Microsoft Office ou Interop, e um único pacote cobre todas as plataformas que executam .NET Standard 2.0.

Um conjunto de slides de revisão trimestral, um conjunto de folhetos de curso ou uma listagem de propriedades dependem das mesmas poucas operações, que são adicionar slides, colocar texto e imagens neles e alterar a ordem antes de enviar o arquivo. Um assistente sem a documentação do IronPPT não tem lista dos membros que existem, e um dos exemplos de guia do próprio IronPPT compila e executa, mas deixa o conjunto de slides salvo inalterado.

O processo de configuração é o mesmo para cada assistente. Adicione o pacote, atribua a chave do ambiente, forneça ao assistente a documentação legível por máquina do IronPPT e leia cada conjunto de slides salvo antes de marcar a tarefa como concluída. Isso se aplica a adicionar slides, adicionar texto, gerenciar imagens e gerenciar slides.

Logo do assistente de codificação de IA Claude CodeLogo do assistente de codificação de IA ChatGPT CodexLogotipo do assistente de codificação de IA GitHub CopilotLogotipo do editor de código da IA CursorLogotipo do agente de codificação de IA Google Antigravity

Meu Assistente de IA Não Pode Lidar com PowerPoint Sozinho?

Sem uma biblioteca de apresentação, o código .NET pode escrever arquivos PowerPoint através do Open XML SDK, que constrói uma apresentação parte por parte e vincula as partes através de relacionamentos.

IronPPT envolve essa estrutura de pacote em um pequeno modelo de objeto cujos tipos principais são PresentationDocument e Slide.

Três fatos se aplicam antes do primeiro prompt.

  • Uma chamada sem efeito não gera erro: apenas uma leitura do arquivo salvo mostra a alteração ausente, e o IronPPT realiza essa leitura quando abre o conjunto de slides novamente a partir do seu caminho.
  • Um nome para o pacote e o namespace: ambos são IronPPT. Os invasores registram pacotes maliciosos sob nomes que os assistentes recomendam para pacotes que não existem, uma prática chamada slopsquatting, portanto, inclua o nome exato no prompt.
  • A licença é perpétua: uma licença IronPPT é uma compra única sem taxas de renovação, e a página de licenciamento lista o número de desenvolvedores que cada nível permite.

Passo 1: Instalar o IronPPT

Com o pacote referenciado, o assistente utiliza os tipos que o IronPPT fornece.

Install IronPPT 2026.10.1 from NuGet and restore the project.
Tell me the IronPPT version it references afterwards.
Text

A partir de um terminal, fixe a versão de lançamento explicitamente.

dotnet add package IronPPT --version 2026.10.1
SHELL

O pacote não contém binários nativos, e suas únicas dependências são IronSoftware.Common e IronSoftware.System.Drawing.


Passo 2: Aplique sua chave de licença

Sem uma chave, um programa pode construir um conjunto de slides na memória e abrir um arquivo existente, mas cada chamada para Save falha com IronSoftware.Exceptions.LicensingException e a mensagem Licença de Produção Necessária. A mensagem também menciona sete dias de uso gratuito para desenvolvimento, no entanto, a gravação falhou na primeira tentativa na sondagem para este artigo. Uma chave digitada incorretamente causa Chave de Licença Não Reconhecida, e o restante dessa mensagem repete a chave. Uma chave curta apareceu por completo, e uma chave de comprimento total com um caractere alterado apareceu como seus últimos 32 caracteres. Código que registra mensagens de exceção, portanto, escreve material de chave em seu log. Uma chave de teste gratuita está disponível abaixo.

Comece a usar IronPPT em seu projeto hoje com uma avaliação gratuita.

Primeiro Passo:
arrow pointer

Atribua a chave de licença uma vez na inicialização do aplicativo, antes de qualquer chamada do IronPPT. Recupere-a de uma variável de ambiente para que não seja armazenada no repositório.

IronPPT.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPPT_LICENSE_KEY");
C#

IronPPT.License.IsLicensed é definido como verdadeiro após uma chave válida ser atribuída, e IronPPT.License.IsValidLicense relata se uma string de chave é válida. Sem a atribuição acima, o IronPPT ignora IRONPPT_LICENSE_KEY. Ele lê variáveis ​​de ambiente nomeadas IronPPT.LicenseKey e IRONPPT_LICENSEKEY sem nenhum código.

Por favor, note: Chaves de Licença do IronPPT também explica como definir a chave em appsettings.json.

Passo 3: Direcione Seu Assistente para a Documentação de LLM do IronPPT

  • llms.txt contém uma entrada de uma linha para cada uma de suas 15 páginas.
  • llms-full.txt fornece um resumo de cada uma das 16 páginas de documentação em um único arquivo.
  • llms-full-catalog.txt estende o índice incluindo artigos de blog.
  • A Referência de API lista a assinatura de cada membro.
  • Ferramentas que suportam arquivos de habilidade podem usar skill.md, que cobre configuração, licenciamento, receitas e erros comuns.
  • O Ficha Técnica do Produto de IA delineia as plataformas suportadas e os principais casos de uso.

Forneça o índice no início de cada sessão.

Open https://ironsoftware.com/ppt/csharp/llms.txt before you write more IronPPT code.
Keep to what its linked pages document.

The IronPPT object model works like this:
- PresentationDocument is the deck, and a new one already holds one blank slide.
- AddSlide appends a Slide.
- Slide.AddText, Slide.AddParagraph and Slide.AddImage fill a slide.
- Slide.Remove deletes a slide, and setting Slide.Show to false hides it.
- Save writes the .pptx file, and the constructor that takes a path opens one.

For a member those pages leave out, do this:
1. Search https://ironsoftware.com/ppt/csharp/object-reference/api/ for it.
2. Build once to prove it compiles.
3. If you still can't confirm it, say so instead of guessing.

After that, list the IronPPT calls in this project that the docs don't cover.
Text

A permissão para responder "não documentado" dá ao assistente uma opção além de inventar um método.


Passo 4: Adicione Contexto do IronPPT ao Seu Projeto

Armazene as regras do IronPPT em um arquivo de instrução do projeto para que cada nova sessão possa lê-las. Claude Code lê CLAUDE.md, ChatGPT Codex lê AGENTS.md, GitHub Copilot lê .github/copilot-instructions.md, Cursor lê arquivos .mdc em .cursor/rules/ou AGENTS.md, e o Google Antigravity lê AGENTS.md ou GEMINI.md. Um bloco único de texto é compatível com todos, embora os arquivos de regras do Cursor também incluam frontmatter MDC. Comece com o seguinte.

Every deck in this project is built with IronPPT, under these rules:
- `IronPPT` is both the NuGet package name and the namespace.
- Begin with the llms.txt index, https://ironsoftware.com/ppt/csharp/llms.txt.
- Tools that read skill files load https://ironsoftware.com/ppt/csharp/skill.md.
- Set `IronPPT.License.LicenseKey` from IRONPPT_LICENSE_KEY when the app starts.
- The program reads that variable itself and never lists environment variables.
- Keep the key out of output, logs, exception text, and source control.
- A wrong key's `LicensingException` message repeats the key. Log only its first line.
- A new `PresentationDocument` already has one slide. Use `Slides[0]` as the title slide.
- Add text, paragraphs, and images through `Slide` methods.
- Build slides in their final order, or set `Slide.Index` to move one.
- Edits to the `Slides` list do not change the deck.
- Remove a slide with `Slide.Remove()` and hide one with `Show = false`.
- On a deck opened from disk, replace a picture by removing it and adding the new image.
- Do not add the Open XML SDK or another presentation library.
- When IronPPT lacks a feature, report that rather than working around it.
Markdown

O arquivo de habilidade nomeia o IronPPT 2026.8.1 como a versão contra a qual foi testado, e seu exemplo de arquivo único fixa essa versão. Ele também descreve Slides como uma lista que pode ser editada para reordenar slides e promete um período de desenvolvimento de sete dias antes de Save exigir uma chave. As sondagens para 2026.10.1 contradisseram ambas as declarações.


Passo 5: Prompt de Configuração Única

Os Passos 1 a 4 podem ser enviados juntos como uma mensagem no início de um projeto ou sessão.

Set this project up for PowerPoint work with IronPPT, following these rules:
- Reference the IronPPT package at version 2026.10.1.
- Assign IRONPPT_LICENSE_KEY to IronPPT.License.LicenseKey first thing at startup.
- The code reads that variable itself. Don't list environment variables.
- The key never shows up in the console, a log, or a committed file.
- Before coding, go through https://ironsoftware.com/ppt/csharp/llms.txt, then keep to it.
- Look up anything it doesn't cover at https://ironsoftware.com/ppt/csharp/object-reference/api/.
- Compile before relying on a member found there.
- Load https://ironsoftware.com/ppt/csharp/skill.md if the tool accepts skill files.
- When the skill file and the compiler disagree, believe the compiler.
- Put content on slides with Slide methods, not with PresentationDocument.AddText.
- Create the slides in their final order, since editing the Slides list changes nothing.

Save these rules to the instructions file your next sessions read.
Tell me which file you wrote and what else you changed.
Text

Passo 6: Padrões de Prompt que Produzem Código Funcional

Especifique os slides, sua ordem e o conteúdo de cada um.

Vago Faça um conjunto de slides trimestral com IronPPT.

Melhor Use Slides[0] para o título, depois adicione um slide por região em ordem de receita, cada um com um cabeçalho em negrito de 32 pontos e três parágrafos, e salve quarterly.pptx.

Declare a versão do IronPPT e a estrutura-alvo. Os membros podem mudar entre as versões.

Melhor Use o IronPPT 2026.10.1 no .NET 9, e atribua a chave de IronPPT_LICENSE_KEY antes da primeira chamada do IronPPT.

Solicite arquivos completos. Um trecho pode omitir a diretiva using IronPPT.Models;, que fornece Slide, Text, e Image.

Melhor Retorne todo o Program.cs, com suas diretivas using e a linha de licença, pronto para compilar como está.


Passo 7: Verifique o Que Você Obtém de Volta

Cada um dos seguintes erros é reproduzível em 2026.10.1.

  • Adicionando o slide de título com AddSlide: cada novo PresentationDocument contém um slide desde o início, construído no layout de título. Um programa que adiciona seu próprio slide de título salva um conjunto de slides que abre em um slide em branco. Escreva o título em Slides[0], ou adicione todos os slides primeiro e remova o original, pois remover o último slide de um conjunto gera InvalidOperationException.
  • Adicionando texto através do documento: PresentationDocument.AddText anexou seu texto ao parágrafo final no último slide, e PresentationDocument.AddTextBox criou um novo slide para o caixa de texto. Adicione conteúdo através dos métodos Slide.
  • Estilizando o resultado de AddText com um argumento de string: o texto retornado não tem objeto de estilo, então definir uma propriedade nele gera NullReferenceException. A receita de estilização do arquivo de habilidade faz essa chamada. Atribua um novo TextStyle em vez disso.
  • Escolhendo uma fonte com FontFamily: a execução salva não carregou nenhum tipo. LatinFont escreveu o tipo no arquivo.

Um conjunto de slides reaberto com o IronPPT retorna corretamente sua contagem de slides e texto. Leia posição, tamanho, alinhamento e cor do XML do slide em ppt/slides/slideN.xml. Após um recarregamento, o IronPPT relatou texto centralizado como Esquerda, e uma sonda leu as cores hex #C00000 e #FFC000 de volta como #00000000. Posição, tamanho e tamanho da fonte voltaram na escala EMU descrita em saída de texto e imagem.

Deixe o Agente Verificar Seu Próprio Trabalho

O assistente pode executar essas verificações sozinho e apresentar os resultados.

Do a clean Release build and run the app once more.

Then show me the evidence:
- The IronPPT types and members the code calls, each with its documentation page.
- The value of IronPPT.License.IsLicensed.
- Each saved deck's slide count and every slide's first line of text, read back from the file.
- Any hidden slide.
- Every shape's a:off, a:ext, algn and solidFill values, taken from ppt/slides/slideN.xml.
- Any image or text whose position, size, alignment or color differs from what the code set.

Read those four properties from the XML, never from a deck reopened with IronPPT.
End by saying whether each deck matches what the code meant to build.
Text

Edição de slides com IronPPT

A ordem dos slides, a remoção e a substituição de imagens se comportam de maneira diferente do que mostram o guia de gerenciamento de slides e o guia de gerenciamento de imagens. As sondagens para este artigo salvaram cada alteração e leram as partes PPTX de volta.

  • PresentationDocument.Slides retorna uma nova lista a cada chamada. Remove, Insert, RemoveAt, e Add nessa lista não mudaram nada no conjunto de slides salvo, então o exemplo de reordenação do guia deixa a ordem como estava.
  • Slide.Remove() deletou o slide, tanto na memória quanto depois que o conjunto de slides foi carregado a partir de um arquivo.
  • Definir Show como falso manteve o slide no arquivo e marcou-o como oculto.
  • Slide.Clone() lançou MissingMethodException, então um slide não pode ser duplicado.
  • Adicionar um slide removido de volta com AddSlide resultou em um slide em branco.
  • Definir Slide.Index moveu um slide, tanto em um novo conjunto quanto em um aberto do disco, e o arquivo salvo manteve a nova ordem.
  • Slide.Images possui valores IImage, então a chamada Images[0].Replace(image) do guia vincula-se ao método do elemento geral Replace. Essa chamada substituiu a imagem em um conjunto de slides construído na memória e deixou a imagem antiga em um conjunto de slides aberto do disco.
  • Converter a imagem em Image alcança Image.Replace, que funcionou em um conjunto de slides reaberto e gerou NullReferenceException em um conjunto de slides na memória.
  • Remover a imagem e adicionar a nova imagem com AddImage funcionou em ambos os casos, embora o pacote salvo mantivesse a imagem antiga como uma parte de mídia não utilizada.

Saída de texto e imagem com IronPPT

O XML do slide salvo e o validador do Open XML SDK 3.5.1 deram os seguintes resultados.

  • Cada chamada Slide.AddText criou sua própria forma de texto de 150 por 100 pontos e não definiu posição, então a forma herda seu posicionamento da estrutura do slide.
  • AddParagraph adicionou seu parágrafo à última forma de texto do slide.
  • O primeiro slide de um novo conjunto manteve espaços reservados vazios para título e subtítulo ao lado do texto que AddText adicionou.
  • Imagem Position, Width, e Height estão em pontos. Um PNG de 400 por 200 pixels sem resolução definida, adicionado sem tamanho, tornou-se 300 por 150 pontos, seu tamanho de pixels a 96 DPI.
  • Em um conjunto de slides reaberto, as mesmas propriedades retornaram os valores EMU armazenados em pontos, 12.700 vezes os valores definidos.
  • FontSize com Point definido como 32 escreveu um tamanho de 32 pontos, e IsBold escreveu negrito.
  • Cada execução colorida através de TextStyle.Color falhou na validação com um erro de elemento filho inválido, tanto para cores nomeadas quanto para cores hexadecimais. Conjuntos de slides sem texto colorido foram validados sem erros.

Um Resultado Que Você Pode Reproduzir

O teste consiste em um único prompt, e você não escreve nenhum código. Abra uma nova sessão em uma pasta vazia, cole o prompt e compare o resultado com os critérios de aprovação.

Por favor, note: O teste requer o SDK .NET 9, uma conexão de rede, um assistente que possa executar comandos do terminal e uma chave de teste ou produção do IronPPT em IRONPPT_LICENSE_KEY.

O prompt

Create a .NET 9 console app that builds a quarterly regional deck with IronPPT.
If this directory isn't empty, tell me and stop.
Don't ask questions. Note your choice for each missing detail.
Keep every deliverable in this directory.

Work in this order:
1. Add IronPPT 2026.10.1 from NuGet.
2. Study https://ironsoftware.com/ppt/csharp/llms.txt, its license key page and four how-to guides.
3. Follow these code rules:
- Use only members those pages or the API reference document.
- At startup, the program itself assigns IRONPPT_LICENSE_KEY to IronPPT.License.LicenseKey.
- Never print the key, save it, or list environment variables.
- Stop with a message if IronPPT.License.IsLicensed is false.
- Print only the first line of a licensing error from Save.
4. Before building slides, the code writes qbr-data.json in thousands of dollars:
- Revenue/target: North 1240/1100, South 860/950, East 1410/1300, West 720/900.
- Three commentary lines of your own per region, under 60 characters each.
5. Draw each region's revenue and target as an 800 by 400 pixel PNG bar chart:
- Save charts/<region>.png and a grey background copy, charts/<region>-board.png.
- Encode the PNGs yourself, with no package or imaging library.
6. Build qbr.pptx with these seven slides in order, none blank:
- Title: "Quarterly Business Review" in bold 40 point, "Q3 2026" in 24 point.
- A slide headed "Agenda" listing the four regions.
- One slide per region, highest revenue first.
- A last slide headed "Next steps" with a "South: 90K below target" line per region below target.

Each region slide has:
- Its name as a bold 32 point heading, then one paragraph per commentary line.
- "Revenue 1410K against a target of 1300K" with its figures.
- That line in Color.Green if the target is met, otherwise Color.Red.
- Its chart at x 360, y 140, 320 by 160, all in points.
7. Reopen qbr.pptx from disk and save a board version, qbr-board.pptx, like this:
- Drop the agenda slide.
- Hide "Next steps" without removing it.
- Move the region with the largest shortfall right after the title.
- Swap that region's chart for its -board.png.
- Keep the rest in original order.
- Work around and note any change the save loses.
- As a last resort, rebuild from your data in the new order.
8. Build and run in Release.

The app fills readback.md only from both saved decks, reopened with IronPPT:
- A table per deck of each slide's position, first text line, visibility and image count.
- A section on each step where the guides' approach didn't work.

Its checks give expected, actual and match for both decks:
- Slide count and region order.
- Revenue line color, chart position and size per region slide.
- The board deck's moved region chart against its -board.png, by image bytes.
9. Fix each failed check and rerun, or describe an IronPPT cause nothing gets around and move on.
10. Report the Release build result, checks matched out of total, and your assumptions.
Text

Saída

readback.md não editado do aplicativo lista suas tabelas de slides e verificações, e ambos os conjuntos de slides estão disponíveis como o aplicativo os salvou, qbr.pptx e qbr-board.pptx. Os números abaixo vêm de uma leitura independente das partes PPTX salvas.

Gráfico de barras da receita da região Oeste contra o objetivo, desenhado pelo aplicativo gerado

A versão cinza do gráfico do Oeste, como o aplicativo desenhou com seu próprio codificador PNG e a colocou em qbr-board.pptx, sem edições.

  • Um build de Release para net9.0 foi concluído sem avisos e sem erros.
  • qbr.pptx continha sete slides na ordem solicitada, e nenhum deles estava em branco.
  • O aplicativo removeu o slide com que um novo conjunto começa chamando Remove nele, após a chamada de lista do guia não ter efeito.
  • Cada cabeçalho de região estava em negrito com 32 pontos.
  • As linhas de receita eram verdes para Norte e Leste e vermelhas para Sul e Oeste.
  • Todos os oito slides de região nos dois conjuntos de slides colocaram o gráfico em x 360 e y 140 pontos, medindo 320 por 160 pontos.
  • qbr-board.pptx continha seis slides, com Oeste, 180K abaixo do objetivo, diretamente depois do título.
  • Somente o slide Próximos passos estava oculto no conjunto de slides do conselho.
  • O aplicativo construiu o conjunto de slides do conselho a partir do qbr.pptx aberto do disco e moveu Oeste configurando a propriedade Index do seu slide.
  • O slide Oeste no conjunto de slides do conselho continha os bytes exatos do gráfico PNG que o aplicativo escreveu.
  • A leitura do aplicativo correspondeu a 22 de 22 verificações.
  • A leitura independente correspondeu a todas as 60 de suas verificações.
  • O validador do Open XML SDK relatou seis erros em cada conjunto, um para cada execução colorida.
  • Nenhum arquivo na pasta do projeto, seu histórico do Git ou os arquivos de sessão do Claude Code continha a chave de licença.
  • O prompt de configuração escreveu suas onze regras em um novo CLAUDE.md e instalou skill.md como uma habilidade do projeto.
  • Alguns passos foram executados de forma diferente da página. Os prompts dos Passos 1, 3, 5 e 7 foram executados após o prompt de aceitação na mesma sessão.

O que passa

  • Um build de Release é concluído sem quaisquer edições manuais.
  • qbr.pptx tem sete slides na ordem que o passo 6 estabelece, nenhum deles em branco, quando você lê o arquivo por si mesmo.
  • Cada slide de região contém seu cabeçalho, três parágrafos de comentários, a linha de receita e um gráfico na posição e tamanho solicitados.
  • qbr-board.pptx tem seis slides, com a região que perdeu sua meta mais logo após o título e o slide Próximos passos oculto.
  • readback.md toma todos os valores reais dos conjuntos de slides salvos e nomeia cada passo que precisou de uma abordagem diferente.
  • Uma busca na pasta do projeto não encontra nenhum arquivo que contém a chave de licença.
Por favor, note: Para testar uma versão diferente, edite a versão no passo 1 e reveja o changelog do IronPPT para alterações.

O registro da execução

  • Todas as execuções usaram um desktop Windows 11 x64 com um Core i9-14900KF e 64 GB de memória.
  • O projeto deste guia visa o net9.0 e fixa IronPPT 2026.10.1.
  • A duração de um guia é a soma dos tempos registrados para os prompts em sua página, e a linha deste guia conta apenas o prompt de aceitação.
  • Último teste em 16 de outubro de 2026, para cada guia na tabela.
GuiaAssistente e versãoModeloDuração (minutos)
Este guiaClaude Code 2.1.277, uma sessão, prompts de permissão desativadosClaude Opus 518.2
Claude CodeClaude Code 2.1.277, prompt 3 em modo de planoSoneto 5 com Planejamento Opus 533.3
ChatGPT CodexCodex CLI 0.160.0GPT-6 Luna22.2
GitHub CopilotCopilot CLI 1.0.98, prompt 3 em modo plano, o corpo do problema e a revisão em suas próprias sessõesGPT-6 Luna, escolhido pelo Auto16.1
CursorCursor CLI 2026.10.14, sem cabeça, prompt 3 no Modo Plano, que ficou ligado para os prompts de 5 a 7Composer 2.515.4
Google AntigravityAntigravity CLI 1.4.0, prompts de permissão ignoradosGemini 4 Argon (Médio)47.4

Guias Específicos para Agentes

Cada guia abaixo aplica esses passos a uma ferramenta e uma tarefa de apresentação.


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 7,110Versão:2026.11recém-lançado