Como Utilizar IronPPT com ChatGPT Codex

Curtis Chau
Curtis Chau
Atualizado: 19 de outubro de 2026

Uma equipe de operações de vendas envia o mesmo deck toda segunda-feira. Um modelo fornece os slides e os números da semana os preenchem. O slide de uma única região se torna um slide por região, um slide de promoção desatualizado é removido e o apêndice permanece no arquivo, mas fora da apresentação. Quando uma operação de slide falha silenciosamente, o deck ainda é salvo e o registro de trabalho ainda relata sucesso. Os gerentes regionais então recebem um resumo de uma promoção que terminou em 30 de junho, um slide antes dos destaques da semana.

ChatGPT Codex é a agente de codificação da OpenAI. Ele funciona em um repositório, onde edita arquivos, executa comandos como dotnet run e relata o que foi alterado. O mesmo agente executa em um terminal, uma extensão IDE, o aplicativo de desktop ChatGPT e a nuvem. IronPPT, a biblioteca .NET da Iron Software para PowerPoint, cria, abre, edita e salva arquivos .pptx sem o Microsoft Office.

Codex recebe um modelo de vendas semanal, um arquivo de regras e duas semanas de dados regionais. Cada contagem de slide que ele relata vem de um CSV escrito no mesmo turno, e cada operação de slide é testada em um deck salvo antes de o código em lote depender dele.

Início Rápido
NuGetInstalar com NuGet

PM > Install-Package IronPPT

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

Inicie o Codex em um projeto de console .NET 9 que contenha as pastas Templates e Data.

$ironppt Install IronPPT 2026.10.1 in this console app and list the slides of the sales template.

Program.cs opens Templates/weekly-sales-template.pptx and saves nothing.
Each slide gets a row in out/quickstart.csv, with these columns:

- number, counting from 1
- heading, the first text on the slide
- texts, how many text items the slide holds
- shown, yes or no from the slide's Show property

Program.cs reads IRONPPT_LICENSE_KEY itself and copies it into License.LicenseKey.
Never print the key or write it to a file or log, and don't list environment variables.

If three builds or runs fail, stop and show me the last error.
Otherwise, read the slide count back from the CSV and tell me the number.
Text

A menção $ironppt carrega a habilidade do IronPPT antes que o Codex escreva o código.



O que é o ChatGPT Codex e como ele se encaixa no trabalho de apresentação .NET?

O comando /permissions define quando o Codex edita arquivos ou executa comandos sem perguntar primeiro. A documentação CLI do Codex cobre a instalação e uso em terminal, e o repositório de código aberto publica suas versões.

O conhecimento do Codex sobre o IronPPT vem de seus dados de treinamento e dos arquivos fornecidos. Um nome de membro que o IronPPT não possui falha na compilação.

O IronPPT fornece uma assembly .NET Standard 2.0 e seu pacote NuGet lista Windows, Linux e macOS. A execução de teste construiu o projeto no Windows.

Como você escreve um prompt do IronPPT e configura o Codex para ele?

Os prompts abaixo nomeiam o modelo e os dados (Templates/weekly-sales-template.pptx e Data/week-41.csv) e as regras (Data/README.md, que define a ordem, os slides omitidos e ocultos e o estilo da casa).

Codex analisa .agents/skills em cada pasta, do diretório de trabalho até a raiz do repositório. Cada habilidade é uma pasta contendo um SKILL.md cujo frontmatter define um nome e uma descrição. Salvar o skill.md do IronPPT como .agents/skills/IronPPT/SKILL.md permite que a menção $ironppt seja resolvida. A habilidade afirma que foi verificada contra o IronPPT 2026.8.1, enquanto este guia instala 2026.10.1.

Codex lê o AGENTS.md antes de iniciar qualquer trabalho. Caminha da raiz do repositório até a pasta de trabalho, pega no máximo um arquivo por diretório e deixa o arquivo mais profundo substituir o mais raso. O comando /init gera um primeiro rascunho.

Write an AGENTS.md in the repository root, under a heading called Weekly sales deck.
Put these rules in it, one per line:

- IronPPT 2026.10.1 is the only PowerPoint library here. Package and namespace are both IronPPT.
- Don't add DocumentFormat.OpenXml or any other Office package.
- Data/README.md defines the deck, and it wins over anything else.
- Templates/ and Data/ are read-only.
- Look up IronPPT members in the ironppt skill under .agents/skills/ironppt/.
- A probe on a saved deck outranks both the skill and the installed IronPPT.xml.
- A deck counts as built only once it's saved, reopened from disk and checked.
- Every count you report comes from a CSV written in that turn. The reply names that CSV.
- The key stays in IRONPPT_LICENSE_KEY.

Show me the finished file.
Text

Como você pede ao Codex para adicionar o IronPPT e verificar a licença?

Show me the IronPPT PackageReference in WeeklySalesDeck.csproj and the version NuGet resolved.
Then quote the full output of dotnet list package with --include-transitive.
Don't change any package references.
Text

IronPPT 2026.10.1 depende do IronSoftware.Common 2026.4.2 e do IronSoftware.System.Drawing 2026.8.2, e a lista de pacotes da execução de teste mostrou 30 pacotes transitivos, entre eles SixLabors.ImageSharp 3.1.12 e Grpc.Net.Client 2.62.0. Revise o changelog do IronPPT antes de fixar uma versão.

Sem uma chave, o IronPPT abre um deck, lê seu texto, adiciona slides e texto, e oculta slides. Somente Save falha, com uma exceção de licenciamento cuja mensagem é Licença de Produção Necessária, e nenhum arquivo é escrito. O IronPPT lê uma chave da variável de ambiente IronPPT.LicenseKey ou IRONPPT_LICENSEKEY por si só, mas ignora IRONPPT_LICENSE_KEY. O código que mantém a chave sob esse nome atribui License.LicenseKey antes da primeira salvamento. O tipo de exceção de licenciamento não é público no IronPPT 2026.10.1, então um manipulador captura Exception e verifica o nome do tipo.

Move the key line into Startup.ApplyIronPptKey and call that method first in Program.cs.
It sets License.LicenseKey from IRONPPT_LICENSE_KEY, then prints License.IsLicensed.

Next, test what IronPPT does without a key.
Start the program three times as child processes, each with a --licence-check option:

1. Clear IRONPPT_LICENSE_KEY for that child only.
2. Keep the variable set, and pass a --no-startup flag that skips the Startup call.
3. Keep the variable set and the Startup call in place.

Each child opens the template, replaces {{WEEK}} with 41 and saves out/licence-check-N.pptx.
Write each call to out/licence-check.csv, with run, call, result, exception type and message.
Add a column that says whether each pptx file exists afterwards.
If three repair attempts fail, stop there.
Tell me which of the three runs saved a file.
Text

A página de chaves de licença lista outras maneiras de fornecer uma chave.

Por que o código de slides do guia deixa o deck inalterado?

O guia de gerenciamento de slides remove um slide com Slides.RemoveAt e move um com Slides.Remove seguido de Slides.Insert, e a habilidade do IronPPT descreve Slides como uma lista mutável. No IronPPT 2026.10.1, PresentationDocument.Slides retorna uma nova lista cada vez que é lido, e essas chamadas alteram apenas essa cópia. Na calibração, Slides.RemoveAt(0) em um deck de seis slides carregado deixou a contagem em seis, e um deck salvo após uma movimentação manteve sua ordem original. O código compila, não levanta exceção e salva o slide que pretendia remover.

Três operações em um slide existente alcançam o deck. Chamar Remove() no próprio slide o remove do arquivo salvo, e Show = false escreve um slide oculto que permanece no arquivo. Configurando Slide.Index move o slide, e uma sonda separada reabriu o deck salvo na nova ordem.

Probe which slide operations survive a save, in a console app at scratch/slides-probe/.

Run it yourself on a copy of the template in scratch/, and apply the key the way Startup does.
Add a Compile Remove item that keeps scratch/** out of WeeklySalesDeck.csproj.
Give each case its own try block and its own saved file.

Reopen each saved file and measure these cases:

- Slides.RemoveAt(4), and whether the slide count drops
- Slides.Remove, then Slides.Insert(1, ...) on Highlights, and the order that results
- Remove() on the Q2 Promotion Recap slide itself
- Clone() on the region slide
- AddSlide(new Slide()) with AddText, and where the new slide ends up
- Show = false on the appendix

Then have the explorer agent read IronPPT.xml and the ironppt skill, writing nothing.
It reports what each source says about the Slides collection and about Clone.

Put every finding in out/slides-probe.csv, quoting the probe output, the XML or the skill.
Mark the rows where the skill and the probe disagree, and tell me which they are.
Text

Uma verificação contra o objeto de lista editado passa, porque essa cópia foi alterada.

Como você monta o deck semanal a partir do modelo?

O guia de gerenciamento de slides não cobre a duplicação de um slide. No IronPPT 2026.10.1, Clone() em um slide lança uma MissingMethodException, e adicionar o mesmo objeto de slide duas vezes não deixa um slide extra no arquivo salvo. Remover um slide e adicioná-lo novamente no final deixou um slide vazio na sua posição antiga. O método que funciona adiciona um novo Slide para cada slide de saída, preenche-o com novo texto na ordem que o deck precisa e então chama Remove() nos originais do modelo.

Copiar o estilo de um deck carregado também falha. Na calibração, um cabeçalho de 36 pt copiado propriedade por propriedade foi escrito em 3.600 pt, e sua cor #1F4E79 se tornou preta. O prompt, portanto, define o estilo da casa do README em cada texto.

O modelo segue a lista de slides no README, com Q2 Recapitulação de Promoção em quinto e Destaques em sexto.

Baixar weekly-sales-template.pptx

O modelo de vendas semanal usado na execução de teste, com um slide de região que contém os tokens de região.

Have the worker agent write Services/DeckAssembler.cs. It builds the deck Data/README.md describes.

DeckAssembler accepts these options:

- --week, which picks Data/week-NN.csv and Data/week-NN.tokens
- --template, defaulting to Templates/weekly-sales-template.pptx
- --plan, which writes out/deck-plan.csv and saves no deck
- --build, which saves out/week-NN.pptx

The probe showed which calls reach the saved file.
Build the deck with those calls, in these steps:

1. Open the template and find each slide by its heading.
2. For every output slide, add a new slide with AddSlide and write its texts with AddText.
3. Set the README's house style on every text you write.
4. Set Show = false on the new appendix slide.
5. Call Remove() on the eight template slides, then save.

The plan CSV has one row per output slide, with position, template heading, final heading and shown.
Run --plan --week 41, then give me the row count and the hidden slides from the CSV.
Text

Como você verifica o deck que o Codex salvou?

Run --build --week 41, then check the saved deck with code that's separate from the build.

The check reopens out/week-41.pptx and writes out/week-41-check.csv with these columns:

- position and heading
- shown
- the slide's full text, joined with " | "
- whether any {{ is left

Compare the check CSV with out/deck-plan.csv row by row.
Tell me which rows differ, and whether Q2 Promotion Recap appears anywhere in the deck.
Text

Saída

DeckAssembler salvou o deck abaixo para a semana 41 na execução de teste, e ele é publicado inalterado.

Baixar week-41.pptx

O deck de vendas da semana 41 como o IronPPT o salvou.

O que acontece quando o modelo muda?

Show me that DeckAssembler refuses Templates/weekly-sales-template-v2.pptx.
Marketing sent it with Highlights renamed to Wins This Week.

Run --build --week 41 --template Templates/weekly-sales-template-v2.pptx.
The existing out/week-41.pptx has to stay the same, byte for byte.
Record the attempt in out/template-check.csv with these columns:

- exit code and message
- the headings the build found
- the SHA-256 of out/week-41.pptx before and after

Tell me whether the two hashes match.
Text

Como você verifica um slide a partir de uma captura de tela?

O Codex aceita imagens como contexto. Passe uma com a bandeira -i (forma longa --image) ao iniciar ou retomar uma sessão, ou cole-a no compositor interativo.

Check the screenshot I attached with -i against the data and the deck.
A regional manager sent it and says the West revenue is wrong.
Don't change any code, and work through these steps:

1. Read the region and its three figures from the image.
2. Compare them with Data/week-41.csv and Data/week-40.csv.
3. Compare them with the West slide in out/week-41.pptx, using its text in out/week-41-check.csv.
4. Write the comparison to out/screenshot-check.csv.

Tell me which week the screenshot shows, and whether out/week-41.pptx is right.
Text

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

Find out why the week 40 deck went out wrong. Data/week-40-complaint.md lists four problems.
Logs/week-40/deck.log says every step worked. Output/week-40.pptx is the deck that was sent.

Have the explorer agent read Jobs/LegacyWeeklyDeck.cs, the log and the deck before anything else.
A throwaway script under scratch/ may read the deck.
Don't edit any code outside scratch/.

Write out/week-40-diagnosis.md and cover these points in it:

- the line behind each of the four problems
- why the log reported success anyway
- the smallest fix for each, based on what the probe showed

Then give me one line per problem.
Text

Revise o diagnóstico antes de permitir qualquer edição. O trabalho legado escreveu cada linha de log após uma chamada retornar e nunca reabriu o deck.

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

Ask the worker agent for a DeckService class that meets these conditions:

- It resolves from a Microsoft.Extensions.DependencyInjection container.
- A DeckOptions record configures it, with week, template, plan-only and output folder.
- It keeps the README rules, the heading check and the house style from DeckAssembler.
- DeckService.cs stays below 150 lines, and its public members have XML doc comments.
- Nothing calls Jobs/LegacyWeeklyDeck.cs.

Then build week 41 with DeckService into out/final/week-41.pptx.
Check that deck the way you checked out/week-41.pptx, into out/final/week-41-check.csv.
Compare the two check files and list every difference.
Text

Uma refatoração pode descartar a verificação de cabeçalho e ainda compilar.

Add an xUnit project at tests/WeeklySalesDeck.Tests, in the same solution as the main project.
Exclude tests/** from what the main project compiles.
The tests get the key through Startup.ApplyIronPptKey.

Each test builds a deck in a temp folder and reopens it.
Between them, the tests check these conditions:

- week 41 gives 11 slides, with Highlights second and the appendix hidden
- the five region slides follow the CSV order
- East shows Revenue: $0 and still has its slide
- no {{ is left anywhere, and Q2 Promotion Recap is gone
- the v2 template is refused, and the message names the missing heading

Run dotnet test with --logger trx and --results-directory out/tests/.
Read the trx file and tell me how many tests passed and failed.
Text

Para perguntas de API, o IronPPT.xml instalado documenta membros de slide como AddSlide, Remove, Clone, Index e Show. Os resultados da sonda mostram quais deles alcançam um deck salvo.

$ironppt List the members in the installed IronPPT.xml that add, remove, move, copy or hide slides.
For each member you find, tell me these two things:

- what the XML says it does
- whether out/slides-probe.csv or the trx file in out/tests/ shows it working on a saved deck

Then write one compiling line per member in a probe project under scratch/api-probe/.
Build that probe with dotnet build, but don't run it.
Text

Como reutilizar esses prompts em outro deck?

Com o modelo, os arquivos de dados e as regras do README alterados, os mesmos prompts se aplicam a pacotes de diretoria, decks de status de projeto ou revisões de clientes. Para configuração que se aplica a cada assistente, consulte o guia de assistentes de codificação AI do IronPPT.

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

Os prompts acima foram para o Codex em ordem, em uma única sessão. O trabalho legado, seu registro e seu deck foram adicionados antes do prompt de depuração. Scripts separados reabriram cada deck salvo pela execução e leram cada slide do arquivo.

  • Antes da execução, o modelo continha oito slides, todos mostrados.
  • Com a variável limpa, a salvamento lançou a exceção de licenciamento, e o arquivo de saída não existia posteriormente.
  • Com a variável definida e a chamada de inicialização pulada, a salvamento falhou da mesma forma.
  • Na sonda, Slides.RemoveAt(4) deixou todos os oito slides no arquivo salvo.
  • Clone() no slide de região lançou uma MissingMethodException.
  • Codex iniciou três subagentes, e o prompt de depuração reutilizou o agente explorador do prompt de sonda.
  • O deck salvo da semana 41 continha 11 slides na ordem do README, com os cinco slides de região na ordem do CSV.
  • Dez slides foram mostrados, e o apêndice foi salvo como oculto.
  • Q2 Recapitulação de Promoção estava ausente do deck.
  • Leste manteve seu slide com receita de $0.
  • O modelo v2 recusado deixou o hash SHA-256 do deck existente inalterado.
  • Codex emparelhou a captura de tela com os números do Oeste da semana 40.
  • O diagnóstico ligou cada um dos quatro problemas da semana 40 às suas linhas no trabalho legado.
  • O diagnóstico rastreou o slide oculto do Norte até o slide de região reutilizado que Slides.Last() retornou.
  • Um deck construído com DeckService combinou a primeira construção em cada slide.
  • Todos os cinco testes passaram na execução do Codex e na nossa.
  • Alguns passos foram executados de forma diferente da página. Pacotes NuGet vieram de um cache restaurado antes da execução, porque o sandbox não tinha rede.

O guia do GitHub Copilot mede uma falha semelhante para imagens, onde a chamada Replace do guia de gerenciamento de imagem deixa a foto antiga em um deck carregado. O guia do Google Antigravity constrói decks para solicitações web simultâneas, que o IronPPT atendeu corretamente apenas quando um único bloqueio protegeu cada chamada do IronPPT. O registro de execução compartilhado fornece a versão do Codex, o modelo, o tempo e a máquina de teste.


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