Como usar IronPPT com o Google Antigravity
Um escritório de gerenciamento de projetos publica um relatório de status para cada projeto a cada segunda-feira. No StatusDesk, o aplicativo web do escritório, um gerente de projeto clica em Baixar relatório de status na linha de um projeto e recebe um arquivo PowerPoint que o servidor criou um momento antes. Um relatório pode ser baixado sem erro e ainda abrir com um primeiro slide em branco, caixas de texto sobrepostas ou slides de outro projeto. Nenhuma dessas falhas aparece em um log de compilação.
O Google Antigravity pode verificar a página da mesma forma que um gerente de projeto a usa. Seu comando /browser lança um subagente de navegador em sandbox que clica em cada botão de download e captura uma captura de tela. O IronPPT constrói o relatório no servidor a partir de texto, formas e imagens, os elementos cobertos no tutorial de elementos de slide do IronPPT. Este guia constrói a página com ambas as ferramentas e a verifica contra seis projetos cujos relatórios são conhecidos antecipadamente.
Este guia é destinado a desenvolvedores que usam agentes de IA para escrever código .NET que produz arquivos PowerPoint em um servidor web. Ele não aborda o design de slides ou modelos corporativos.
Início RápidoCom o projeto StatusDesk aberto no Antigravity, descreva a página de status.
/plan Give StatusDesk, the PMO's .NET 9 MVC site, a /Status page.
Each project row gets a Download status deck button.
The nav bar gets a Status link.
Install IronPPT 2026.10.1. Its namespace is IronPPT.
App_Data/projects.json holds the projects and the report week.
Each deck has these slides, in order:
1. Title: project name, "Status report, week of" plus the week, owner.
2. Status: status word, status-colored rectangle, summary, logo.
3. Milestones: name, due date and state, at most five per slide.
4. Risks: every risk, only if there are any.
Follow these rules too:
- Status colors: Green 00B050, Amber FFC000, Red C00000.
- Logo: App_Data/logos/<Id>.png, skipped if missing or unreadable.
- Text boxes don't overlap, and nothing runs off the slide IronPPT creates.
- Download name: status-<Id>.pptx, with the PowerPoint content type.
- If a deck fails, the page shows one plain sentence, never exception text.
Startup code reads IRONPPT_LICENSE_KEY itself and sets IronPPT.License.LicenseKey once.
Never print, log or store the key, or list environment variables.
Answer these in the Implementation Plan:
- What does a new PresentationDocument hold, and how big is its slide?
- Where does AddText put a text box, and what unit do Position, Width and Height use?
- How do the deck's bytes get into the HTTP response?
Show me the plan, then build until dotnet build shows zero errors.
Uma construção bem-sucedida não prova nenhuma das três respostas, então leia-as no plano antes de aprová-lo.
O IronPPT não lê IRONPPT_LICENSE_KEY por conta própria. Em nossa sonda, License.IsLicensed permaneceu falso quando essa variável sozinha foi configurada, enquanto uma variável de ambiente chamada IronPPT.LicenseKey licenciou o processo sem qualquer código. Atribuir License.LicenseKey na inicialização mantém o nome da variável sob controle do aplicativo. O guia de chave de licença descreve outras maneiras de aplicar a chave.
Fluxo de trabalho mínimo (5 etapas)
- Baixar a biblioteca PowerPoint C# do NuGet
- Comece com um projeto ASP.NET Core que já construía e servia uma página
- Dê a cada caixa de texto, forma e imagem sua própria posição em pontos
- Faça o /browser baixar cada relatório e comparar cada arquivo com uma lista conhecida
- Execute downloads simultâneos, então confirme cada membro na referência de API
O que é o Google Antigravity e como é diferente de um assistente de chat?
De acordo com a visão geral do Google, o Antigravity App é uma aplicação de desktop autonoma para lançar, orquestrar e inspecionar equipes de agentes de IA. Seus agentes retornam Artefatos, como um Plano de Implementação, um Guia Passo a Passo e capturas de tela, onde um assistente de chat retorna texto.
Um agente que escolhe um nome de pacote sem verificá-lo pode instalar malware, porque atacantes publicam pacotes com nomes que modelos de linguagem alucinam. Este ataque é chamado slopsquatting. Nomeie o pacote IronPPT e sua versão em cada tarefa que adiciona um pacote. O guia de assistentes de codificação de IA lista os arquivos de documentação do IronPPT para agentes, e seu teste de aceitação cabe em um único prompt.
O que você deve verificar no plano, nas mudanças de código e no Guia Passo a Passo?
No plano, compare cada resposta com o conteúdo do relatório medido abaixo. Nas mudanças de código, encontre onde cada caixa de texto recebe sua posição e confirme cada membro do IronPPT na referência de API.
O Guia Passo a Passo deve conter uma captura de tela de cada download. No aplicativo de desktop, Antigravity armazena cada captura de tela como um artefato de imagem que aceita comentários, então um comentário na linha errada identifica o projeto sem um novo prompt.
Como você testa o botão de download em um navegador real?
Forneça ao /browser uma tabela que ele só pode completar baixando cada relatório e abrindo o arquivo.
/browser Launch StatusDesk with dotnet run as a background process.
Then open http://localhost:5326/Status.
Do this for every project, top to bottom:
1. Click Download status deck.
2. Save the file as artifacts/decks/status-<Id>.pptx.
3. Take a screenshot of the page.
Next, write a console tool in tools/DeckCheck that opens a deck with IronPPT.
It prints the slide count and each slide's text, shape count and image count.
Leave tools/DeckCheck out of the web project's compile items.
Run DeckCheck on each deck in artifacts/decks and compare it with TestData/expected-decks.csv.
Put the results in a Walkthrough table and in artifacts/deckcheck.md.
The table has these columns:
- project
- slides expected and slides found
- first text on slide 1
- images found
- pass or fail
If a row fails, trace the cause in the deck code before you edit.
Then fix it, restart the site and download every deck again.
At the end, kill the dotnet process by its PID and show me the table.
Os seis projetos cobrem os casos que um relatório de status deve lidar. Atlas e Borealis têm um logotipo e riscos abertos, Cobalt não tem arquivo de logotipo e Delta não tem riscos, então seu relatório termina após os marcos. O logotipo do Ember contém uma página de erro HTML de uma exportação falhada em vez de uma imagem, e Fjord tem sete marcos, que precisam de um segundo slide de marcos.
A página /Status após o download para P-102, conforme a verificação final do navegador a capturou sem suas folhas de estilo.
Saída
O relatório do Borealis abaixo é o arquivo que a verificação final do navegador baixou, inalterado.
O relatório de status do aplicativo móvel Borealis, quatro slides com o logotipo no segundo.
O que um novo relatório do IronPPT contém antes de você adicionar qualquer coisa?
Cada novo PresentationDocument começa com um slide. Esse slide usa o layout de Slide de Título e mantém dois espaços reservados vazios, Título 1 e Subtítulo 2, e AddSlide é adicionado após ele. O guia Adicionar Slide observa o slide existente.
O slide é 4:3, 720 por 540 pontos. Position, Width e Height tomam valores em pontos, então uma largura de 100 escreve 1.270.000 EMU. Os comentários no tutorial de elementos de slide que chamam a unidade de pixels estão errados para IronPPT 2026.10.1.
Slide.AddText cria uma caixa de texto sem posição, conforme medido no artigo de hub do IronPPT. Definindo Position, Width e Height no último item de Slide.TextBoxes coloca a caixa que a chamada adicionou. Font.FontFamily não escreve nenhuma fonte no arquivo, e Font.LatinFont sim.
Uma compilação de calibração que chamou AddSlide para cada slide e AddText sem posições abriu todos os seis relatórios com um slide em branco, e de 6 a 15 caixas de texto em cada relatório compartilhavam uma posição. Uma segunda compilação que reutilizou o slide existente e posicionou cada caixa de texto passou por todos os seis projetos.
Como você configura um projeto no qual Antigravity pode trabalhar?
Inicie o agente em um repositório que compila e serve uma página. O projeto deste guia foi criado com dotnet new mvc -f net9.0 e construído uma vez antes do primeiro prompt. Seu perfil http em Properties/launchSettings.json serve a porta 5326.
Which IronPPT version is in StatusDesk.csproj? Quote that PackageReference line.
Next, find and quote the code that sets the key.
Answer from the code without running the app.
Check the key handling against these rules:
- The key comes in through IRONPPT_LICENSE_KEY at startup and nowhere else.
- No appsettings file has an IronPPT.LicenseKey entry.
- The key isn't set in Properties/launchSettings.json either.
- If the variable is missing, startup logs a single warning with its name and no value.
- IronPPT licensing errors get logged by type name only, because their message can contain the key.
If that warning is missing, add it to Program.cs and change nothing else.
For each other rule that fails, give me the file and line.
Sem uma chave de licença, o IronPPT 2026.10.1 construiu um relatório na memória e abriu um arquivo PPTX existente. Save lançou uma LicensingException intitulada "Licença de Produção Necessária", e nenhum arquivo de saída apareceu. Na página de calibração, o primeiro download não licenciado falhou após 871 ms e outros posteriormente em 33 a 48 ms. Um manipulador tem de corresponder a LicensingException pelo nome do tipo, porque o tipo não é público.
Com uma chave inválida, a mensagem de LicensingException repetiu o texto da chave que lhe foi dada. Um download de calibração que exibiu a mensagem de exceção retornou esse texto de chave na resposta. Uma entrada de log que registra a mensagem carrega o mesmo texto, por isso a regra acima registra apenas o nome do tipo.
Como você aplica as regras do relatório a tarefas posteriores?
Quando cada linha é aprovada, registre as decisões da sessão como regras. De acordo com a documentação de regras do Antigravity, o CLI lê AGENTS.md, GEMINI.md e .agents/rules da raiz do repositório e de subdiretórios. O comando /learn resume as correções da sessão em regras persistentes.
/learn Save what this session decided in a new AGENTS.md at the repo root.
Put it under the heading "Status decks" and cover these points:
- what a new PresentationDocument holds before any slide is added
- the unit of Position, Width and Height, and the slide size
- how each text box gets a position of its own
- how the deck's bytes reach the HTTP response
- that the key comes only from IRONPPT_LICENSE_KEY and is never printed, logged or stored
- that no command lists the environment variables
- that a change is done once every row of TestData/expected-decks.csv passes in /browser
Show me the file when you're done.
O que acontece quando várias pessoas baixam ao mesmo tempo?
O IronPPT não é seguro para uso em duas requisições ao mesmo tempo, mesmo quando cada requisição constrói seu próprio PresentationDocument e salva em seu próprio arquivo. Construir relatórios na memória em 16 threads não produziu erros. Salvar ou carregar em threads paralelos falhou, com erros como InvalidOperationException e IOException, e alguns arquivos que foram salvos sem exceção continham slides de outro relatório. Com um bloqueio em torno de Save, e carregando sozinho e construindo deixado desbloqueado, 1 a 10 de 32 relatórios ainda falharam.
No aplicativo de calibração, 12 downloads simultâneos, dois para cada projeto, foram executados três vezes. Sem um bloqueio, 30 das 36 respostas retornaram HTTP 500 e 4 dos 6 relatórios entregues estavam errados. Com um bloqueio ao redor de cada chamada IronPPT, todas as 36 respostas continham o relatório correto, e o mais lento levou 1.066 ms.
/plan On Monday mornings a dozen project managers download their decks within seconds of each other.
Write an Implementation Plan Artifact first, and wait for my approval before any edit.
Once I approve, measure the effect on the site before you touch the code:
1. Run the site in a separate process.
2. Send 12 download requests at once, two per project.
3. Save each response and check its slide count and title against TestData/expected-decks.csv.
4. Search each file for text from another project.
5. Count the failed responses and the files that don't match.
Then fix the root cause. Every download has to stay under two seconds.
After the fix, send the 12-request burst three more times.
Give me these results:
- the counts before the fix and for each later burst
- the first error from the log
End by stopping the site's dotnet process through its PID.
O serviço esperado se assemelha a este exemplo, que compila com IronPPT 2026.10.1. Os relatórios construídos a partir dele mantêm os espaços reservados Título 1 e Subtítulo 2 vazios no primeiro slide. Para excluí-los, chame Remove em cada item de title.TextBoxes.ToList() antes da primeira chamada AddText.
using IronPPT;
using IronPPT.Enums;
using IronPPT.Models;
namespace StatusDesk.Services;
public sealed class DeckBuilder(IWebHostEnvironment env)
{
// IronPPT is not safe to run on two requests at once, so every IronPPT call goes through this lock.
private static readonly object IronPptLock = new();
private static readonly Dictionary<string, string> StatusColors = new()
{
["Green"] = "#00B050",
["Amber"] = "#FFC000",
["Red"] = "#C00000",
};
public byte[] Build(Project project, string reportWeek)
{
lock (IronPptLock)
{
var deck = new PresentationDocument();
Slide title = deck.Slides[0];
AddText(title, project.Name, x: 40, y: 180, width: 640, height: 70, points: 40, bold: true);
AddText(title, $"Status report, week of {reportWeek}", x: 40, y: 260, width: 640, height: 40, points: 24);
AddText(title, $"Owner: {project.Owner}", x: 40, y: 310, width: 640, height: 40, points: 20);
Slide status = deck.AddSlide(new Slide());
AddText(status, "Status", x: 40, y: 30, width: 500, height: 60, points: 32, bold: true);
status.AddShape(new Shape
{
Type = ShapeType.Rectangle,
FillColor = new Color(StatusColors[project.Status]),
Position = (40, 110),
Width = 160,
Height = 60,
});
AddText(status, project.Status, x: 220, y: 120, width: 300, height: 40, points: 28, bold: true);
AddText(status, project.Summary, x: 40, y: 200, width: 640, height: 120, points: 20);
string logo = Path.Combine(env.ContentRootPath, "App_Data", "logos", project.Id + ".png");
if (File.Exists(logo))
{
try
{
var image = status.AddImage(logo);
image.Position = (560, 30);
image.Width = 120;
image.Height = 60;
}
catch (IronPPT.Models.Exceptions.ImageLoadException)
{
}
}
// Milestone and risk slides follow the same AddText pattern.
string path = Path.Combine(Path.GetTempPath(), $"status-{Guid.NewGuid():N}.pptx");
try
{
deck.Save(path);
return File.ReadAllBytes(path);
}
finally
{
File.Delete(path);
}
}
}
private static void AddText(Slide slide, string text, double x, double y, int width, int height, double points, bool bold = false)
{
slide.AddText(new Text(text)
{
TextStyle = new TextStyle { IsBold = bold, TextFont = new Font { LatinFont = "Calibri", FontSize = points } },
});
var box = (TextBox)slide.TextBoxes[^1];
box.Position = (x, y);
box.Width = width;
box.Height = height;
}
}
Save aceita apenas um caminho de arquivo, então o exemplo escreve um arquivo temporário e retorna seus bytes.
Quando você deve despachar mais de um agente?
Desencadeie um segundo agente quando parte da verificação não precisar de navegador.
Split this work between two agents.
Agent A writes an xUnit project, StatusDesk.Tests, with these tests:
- For each row of TestData/expected-decks.csv, check the slide count and title text.
- Check the status rectangle's fill color in the saved file's slide XML.
- Build and save all six decks on parallel threads, then check each file holds only its project.
The tests follow AGENTS.md and these rules:
- They copy IRONPPT_LICENSE_KEY into IronPPT.License.LicenseKey before any save.
- They build decks through the site's own deck code and never start the site.
- The web project is the repo root, so its compile items skip StatusDesk.Tests.
Agent A runs them with dotnet test StatusDesk.Tests.
Agent B starts once that suite passes:
1. Use /browser to download every deck.
2. Send the 12-request burst again.
3. Put a screenshot of each download in the Walkthrough, and note there that the tests passed first.
Tell me what each agent found.
Um teste que lê um relatório salvo com o IronPPT recebe o texto intacto. Posições e tamanhos voltaram 12.700 vezes maiores que os valores definidos, e cores de preenchimento e texto voltaram como #00000000, então uma verificação de cor precisa ler o XML do slide.
O que os prompts produziram em uma execução real?
Todos os seis prompts rodaram sem acompanhamento em uma única conversa CLI do Antigravity, com prompts de permissão pulados. A aplicação recebeu a chave de licença apenas por meio do IRONPPT_LICENSE_KEY. Cada relatório também foi baixado e verificado de forma independente, uma vez após o primeiro prompt e novamente na aplicação final.
- Antes de qualquer edição, o plano encontrou os dois espaços reservados vazios no primeiro slide de um novo documento, e a compilação os removeu.
- Após o primeiro prompt, todos os seis relatórios tinham a contagem de slides e título esperados.
- Nenhuma caixa de texto sobrepôs outra ou ultrapassou a borda do slide, em qualquer uma das verificações.
- Naquela primeira compilação, três rajadas de 12 downloads simultâneos retornaram 3, 1 e 3 relatórios corretos.
- Nessas rajadas, 27 dos 36 pedidos receberam a página de erro, com HTTP 200, em vez de um relatório.
- Dois relatórios entregues estavam errados, e um relatório do aplicativo móvel Borealis continha o nome do projeto Delta Office Move.
- A correção do agente colocou um bloqueio em torno de construir e salvar cada relatório.
- A correção também construiu todos os seis relatórios no primeiro pedido à página de status e manteve seus bytes na memória até que os dados do projeto ou um logotipo mudassem.
- Após a correção, três rajadas independentes retornaram 36 relatórios corretos de 36, e o download mais lento levou 14 ms. Toda resposta veio dos relatórios mantidos na memória, então essas rajadas não exercitaram o bloqueio. O teste de calibração na seção de concorrência é a medição que mostra que o bloqueio funciona.
- Os logotipos de 400 por 200 pixels foram desenhados em 152 por 110 pontos, o que os distorceu.
- Sem uma chave, a página mostrava "O relatório de status não pôde ser gerado para aquele projeto."
- Uma chave inválida não apareceu nem na resposta nem no log.
- /learn escreveu AGENTS.md na raiz do repositório com todos os sete pontos.
- Todos os 13 testes xUnit passaram com a chave e falharam sem ela.
- O prompt de dois agentes executou cada agente em sua própria conversa filha, e o Agente B começou após os testes passarem.
- Alguns passos foram executados de forma diferente da página. O subagente /browser não conseguiu acessar o Chrome inicialmente, então o agente iniciou o Chrome com depuração remota por conta própria. Essa etapa também reescreveu o arquivo DevToolsActivePort no perfil Chrome do usuário. As capturas de tela do navegador mostraram a página sem suas folhas de estilo, que foram carregadas normalmente na verificação independente. Ambos os prompts orientados pelo plano pararam após o plano até que a execução enviasse uma aprovação. A verificação de configuração relatou um bloco catch que não registrou nada, e o prompt de concorrência posteriormente o substituiu.
ChatGPT Codex atribui partes nomeadas de uma tarefa a agentes exploradores e trabalhadores, e GitHub Copilot mantém suas regras fixas em arquivos de instruções comprometidos, conforme este guia faz com AGENTS.md. O registro de execução compartilhado na página do hub lista a versão do Antigravity, o modelo, a duração da execução e a máquina de teste.
Solução de problemas
- Elemento de Slide para texto, estilo, imagens e formas em um slide
- Adicionar Slide quando um relatório abre com um slide em branco extra
- Adicionar Texto para estilos de texto e parágrafos
- Gerenciar Imagem para tamanho e posição da imagem
- Aplicando Chaves de Licença quando
Saveé lançado no servidor
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.