IronPPT와 Google Antigravity를 사용하는 방법
프로젝트 관리 사무소는 매주 월요일마다 모든 프로젝트의 상태 덱을 발행합니다. 상태Desk, 사무소의 웹 앱에서는, 프로젝트 관리자가 프로젝트 행에서 다운로드 상태 덱을 클릭하여 서버가 조금 전에 생성한 PowerPoint 파일을 수신합니다. 덱은 오류 없이 다운로드되고 여전히 첫 슬라이드가 빈 상태로 열리거나, 텍스트 상자가 서로 중첩되거나 다른 프로젝트의 슬라이드가 나타날 수 있습니다. 이러한 결함은 빌드 로그에는 나타나지 않습니다.
Google Antigravity는 프로젝트 관리자가 사용하는 방식으로 페이지를 확인할 수 있습니다. 그의 /브라우저 명령어는 각각의 다운로드 버튼을 클릭하고 스크린샷을 캡처하는 샌드박스 브라우저 서브에이전트를 시작합니다. IronPPT는 IronPPT의 슬라이드 요소 튜토리얼에서 다루는 요소인 텍스트, 도형 및 이미지를 서버에서 빌드합니다. 이 가이드는 페이지를 두 도구와 함께 빌드하고 사전 알려진 6개의 프로젝트에 대해 확인합니다.
이 가이드는 웹 서버에서 PowerPoint 파일을 생성하는 코드를 작성하기 위해 AI 에이전트를 사용하는 개발자를 대상으로 합니다. 슬라이드 디자인 또는 회사 템플릿에 대해서는 다루지 않습니다.
빠른 시작Antigravity에서 상태Desk 프로젝트를 열고 상태 페이지를 설명하세요.
/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.
성공적인 빌드는 세 가지 응답 중 어느 것도 증명하지 않으므로 승인하기 전에 계획에서 읽어보세요.
IronPPT는 독자적으로 IRONPPT_LICENSE_KEY을 읽지 않습니다. 우리의 Probe에서, 오직 변수를 설정했을 때License.IsLicensed는 거짓으로 남아 있었고, IronPPT.LicenseKey라는 환경 변수가 어떤 코드 없이 프로세스를 허가했습니다. 시작 시 License.LicenseKey를 할당하면 변수 이름을 애플리케이션의 통제 아래에 유지합니다. 라이선스 키 가이드는 키를 적용하는 다른 방법을 설명합니다.
최소 워크플로우(5단계)
- NuGet에서 C# PowerPoint 라이브러리 다운로드
- 이미 페이지를 빌드하고 제공하는 ASP.NET Core 프로젝트로 시작하십시오
- 모든 텍스트 상자, 도형 및 이미지에 독립적인 위치를 지정하십시오
- /브라우저가 모든 덱을 다운로드하고 각 파일을 알려진 목록과 비교하도록 하십시오
- 동시 다운로드를 실행한 다음 API 레퍼런스의 모든 구성원을 확인하십시오
Google Antigravity란 무엇이며 채팅 보조와 어떻게 다른가요?
Google의 개요에 따르면, Antigravity App은 AI 에이전트 팀을 시작, 관리 및 검토하는 독립형 데스크탑 애플리케이션입니다. 그의 에이전트는 텍스트를 반환하는 채팅 도우미 대신 구현 계획, 워크스루 및 스크린샷과 같은 아티팩트를 반환합니다.
패키지 이름을 확인하지 않고 선택한 에이전트는 맬웨어를 설치할 수 있습니다. 왜냐하면 공격자는 언어 모델이 환각한 이름 아래에 패키지를 발행하기 때문입니다. 이 공격을 슬롭스쿼팅이라고 합니다. 모든 패키지 추가 작업에서 IronPPT 패키지와 해당 버전을 명명하세요. AI 코딩 어시스턴트 가이드는 에이전트를 위한 IronPPT의 문서 파일을 나열하고, 그 수용 테스트는 하나의 프롬프로 적합합니다.
계획, 코드 변경, 워크스루에서 무엇을 확인해야 합니까?
계획에서 각 응답을 아래에서 측정한 덱 콘텐츠와 비교하세요. 코드 변경에서 각 텍스트 상자가 위치를 받는 위치를 찾고, API 레퍼런스의 각 IronPPT 멤버를 확인하십시오.
워크스루는 각각의 다운로드 스크린샷을 보유해야 합니다. 데스크탑 앱에서, Antigravity는 각 스크린샷을 이미지 아티팩트로 저장하며, 댓글을 수용하므로 잘못된 행의 댓글이 새로운 프롬프트 없이 프로젝트를 식별합니다.
실제 브라우저에서 다운로드 버튼을 어떻게 테스트합니까?
/브라우저에 모든 덱을 다운로드하고 파일을 열어야만 완성할 수 있는 표를 제공하십시오.
/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.
여섯 프로젝트는 상태 덱이 처리해야 하는 사례를 포괄합니다. Atlas와 Borealis는 로고와 개방된 위험을 가지고 있으며, Cobalt는 로고 파일이 없고, 델타는 위험이 없기 때문에 그 덱은 이정표 이후에 끝납니다. Ember의 로고는 이미지를 대신해 실패한 내보내기로 인해 HTML 오류 페이지를 포함하고 있으며, Fjord는 7개의 이정표가 있어 두 번째 이정표 슬라이드가 필요합니다.
P-102를 위한 다운로드 후 /상태 페이지, 최종 브라우저 패스가 스타일시트를 포함하지 않은 상태로 캡처했습니다.
산출
아래의 Borealis 덱은 최종 브라우저 패스가 변경 없이 다운로드한 파일입니다.
Borealis 모바일 앱 상태 덱, 두 번째에 로고가 있는 네 개의 슬라이드.
새로운 IronPPT 덱이 기본적으로 무엇을 포함합니까?
각 새로운 PresentationDocument는 하나의 슬라이드로 시작합니다. 해당 슬라이드는 제목 슬라이드 레이아웃을 사용하며, 비어 있는 플레이스홀더 타이틀 1과 서브타이틀 2를 유지하며 AddSlide가 그 후에 첨부됩니다. 슬라이드 추가 가이드는 기존 슬라이드를 언급합니다.
슬라이드는 4:3 비율로, 720x540 포인트입니다. Position, Width, Height는 포인트 단위로 값을 가지며, 100의 너비는 1,270,000 EMU를 기록합니다. IronPPT 2026.10.1에서는 유닛이 픽셀이라고 적힌 슬라이드 요소 튜토리얼의 코멘트가 잘못되었습니다.
IronPPT 허브 기사에서 측정된 바와 같이 Slide.AddText가 위치 없이 텍스트 상자를 생성합니다. 마지막 Slide.TextBoxes의 항목에 Position, Width 및 Height을 설정하면 호출이 추가한 상자의 위치를 지정합니다. Font.FontFamily는 파일에 서체를 기록하지 않고, Font.LatinFont는 합니다.
모든 슬라이드에 대해 AddSlide을 호출하고 위치 없이 AddText을 호출한 보정 빌드는 빈 슬라이드로 6개의 모든 덱을 열었으며, 각 덱에서 6개에서 15개의 텍스트 상자가 하나의 위치를 공유했습니다. 기존 슬라이드를 재사용하고 각 텍스트 상자의 위치를 지정한 두 번째 빌드는 여섯 프로젝트를 모두 통과했습니다.
Antigravity가 작업할 수 있는 프로젝트를 어떻게 설정하나요?
페이지를 컴파일하고 제공하는 저장소에서 에이전트를 시작하세요. 이 가이드의 프로젝트는 dotnet new mvc -f net9.0로 생성되었고, 첫 프롬프트 전에 한 번 빌드되었습니다. Properties/launchSettings.json의 http 프로필은 포트 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.
라이선스 키가 없으면, IronPPT 2026.10.1은 메모리에서 덱을 빌드하고 기존 PPTX 파일을 열었습니다. Save는 'Production License Required'라는 제목의 LicensingException을 발생시켰으며, 출력 파일은 나타나지 않았습니다. 보정 페이지에서 첫 번째 라이선스가 없는 다운로드는 871ms 후에 실패했고, 나중에는 33에서 48ms 사이에 실패했습니다. 핸들러는 LicensingException을 타입 이름별로 매치해야 합니다. 왜냐하면 타입이 공개되지 않았기 때문입니다.
유효하지 않은 키가 있으면, LicensingException 메시지는 제공된 키 텍스트를 반복했습니다. 예외 메시지를 표시한 보정 다운로드가 응답에서 해당 키 텍스트를 반환했습니다. 메시지를 기록하는 로그 항목은 동일한 텍스트를 포함하며, 위의 규칙은 타입 이름만 로그해야 함을 설명합니다.
덱 규칙을 나중의 작업에 어떻게 적용합니까?
모든 행이 통과하면 세션의 결정을 규칙으로 기록하십시오. Antigravity의 규칙 문서에 따르면, CLI는AGENTS.md, GEMINI.md 및 .agents/rules를 저장소 루트 및 하위 디렉터리에서 읽습니다. /learn 명령은 세션의 수정을 영구 규칙으로 요약합니다.
/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.
여러 사람이 동시에 다운로드하면 어떻게 됩니까?
심지어 각 요청이 자체 PresentationDocument를 빌드하고 파일에 저장하더라도 IronPPT는 두 요청을 동시에 사용할 수 없습니다. 메모리에서 16개의 스레드로 덱을 빌드하여 오류가 발생하지 않았습니다. 병렬 스레드로 저장하거나 로딩하는 것은 실패했으며, InvalidOperationException 및 IOException과 같은 오류가 발생했고, 예외 없이 저장된 일부 파일에는 다른 덱의 슬라이드가 포함되어 있었습니다. Save 주위에 잠금을 두고 단독으로 로딩하고 빌딩은 잠금 해제된 상태로 남겨둔 상태에서 32개 덱 중 1개에서 10개가 여전히 실패했습니다.
보정 앱에서, 각 프로젝트당 두 번의 다운로드가 세 번 실행되었습니다. 잠금 없이, 36개의 응답 중 30개가 HTTP 500을 반환했고, 6개 중 4개의 전달된 덱이 잘못되었습니다. 모든 IronPPT 호출 주위에 잠금이 있는 경우, 36개의 응답에서 올바른 덱을 유지했고, 가장 느린 것은 1,066ms를 소요했습니다.
/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.
예상되는 서비스는 IronPPT 2026.10.1과 컴파일되는 이 예제와 유사합니다. 여기에서 빌드된 덱은 첫 슬라이드에 비어 있는 제목 1과 부제목 2 플레이스홀더를 유지합니다. 이를 삭제하려면, 첫 번째 AddText 호출 전에 title.TextBoxes.ToList()의 각 항목에 대해 Remove 을 호출하세요.
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는 파일 경로만 수락하므로 예제로는 임시 파일을 작성하고 그 바이트를 반환합니다.
언제 한 에이전트 이상을 파견해야 하나요?
브라우저가 필요 없는 확인의 일부가 있을 때 두 번째 에이전트를 보내십시오.
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.
저장된 덱을 IronPPT로 다시 읽는 테스트는 텍스트를 손상 없이 수신합니다. 위치와 크기는 설정된 값보다 12,700배 더 크게 반환되었고, 채우기색과 텍스트 색상은 #00000000으로 반환되었으므로, 색상 확인은 슬라이드 XML을 읽어야 합니다.
실제 실행에서 프롬프트가 무엇을 생성했습니까?
여섯 프롬프트는 권한 프롬프트가 건너뛰어진 상태로 단일 Antigravity CLI 대화에서 비상주상태로 실행되었습니다. 애플리케이션은 IRONPPT_LICENSE_KEY를 통해서만 라이선스 키를 수신했습니다. 각 덱은 첫 프롬프트 후 한 번, 최종 애플리케이션에서 한 번 독립적으로 다운로드되고 확인되었습니다.
- 어떠한 편집도 하기 전에 계획은 새 문서의 첫 슬라이드에서 두 개의 빈 플레이스홀더를 발견했고, 빌드는 그것들을 제거했습니다.
- 첫 번째 프롬프트 후, 여섯 덱 모두에 예상되는 슬라이드 수와 제목이 있었습니다.
- 텍스트 상자는 서로 중첩되거나 슬라이드 경계를 넘어가지 않았습니다.
- 첫 빌드에서는 12개의 동시 다운로드가 3개, 1개, 3개의 올바른 덱을 반환했습니다.
- 이러한 버스트에서, 36개의 요청 중 27개가 덱 대신 HTTP 200 상태의 오류 페이지를 수신했습니다.
- 두 개의 전송된 덱이 잘못되었고, 한 Borealis 모바일 앱 덱에는 Delta Office Move 프로젝트의 이름이 포함되어 있었습니다.
- 에이전트의 수정 작업은 각 덱 개별로 빌드하고 저장할 때 한 번의 잠금을 적용하는 것이었습니다.
- 수정 작업은 또한 상태 페이지에 대한 첫 요청으로 여섯 덱 모두를 빌드하고 프로젝트 데이터나 로고가 변경될 때까지 그 바이트를 메모리에 유지했습니다.
- 수정 후, 세 개의 독립적인 버스트가 36개 중 36개의 올바른 덱을 반환했으며, 가장 느린 다운로드는 14ms 소요되었습니다. 각 응답은 메모리에 유지된 덱에서 나왔으므로, 이러한 버스트는 잠금을 사용하지 않았습니다. 동시성 섹션의 보정 테스트는 잠금이 작동함을 보여주는 측정입니다.
- 400x200 픽셀 로고는 152x110 포인트로 그려져 왜곡되었습니다.
- 키 없이 페이지에는 '해당 프로젝트의 상태 덱을 생성할 수 없습니다.'가 표시되었습니다.
- 잘못된 키는 응답이나 로그에 나타나지 않았습니다.
- /learn은 모든 7개의 포인트를 사용해 AGENTS.md를 저장소 루트에 작성했습니다.
- 13개의 xUnit 테스트 모두 키와 함께 통과했으며, 키 없이 실패했습니다.
- 두 에이전트 프롬프트에서 각 에이전트는 자체 자식 대화에서 실행되었으며, 에이전트 B는 테스트가 통과한 후 시작되었습니다.
- 일부 단계는 페이지와 달리 작동했습니다. /브라우저 서브에이전트는 처음에 Chrome에 도달하지 못하여, 에이전트는 원격 디버깅을 포함해 Chrome을 시작했습니다. 그 단계는 사용자의 Chrome 프로필에 DevToolsActivePort 파일을 다시 작성했습니다. 브라우저 스크린샷에는 스타일시트가 없는 페이지가 나타났으며, 독립적인 검사에서는 정상적으로 로드되었습니다. 계획 첫 프롬프트는 실행에서 승인 전송까지 계획에서 멈췄습니다. 설정 확인에서 아무것도 기록하지 않은 부분을 보고되었으며, 동시성 프롬프트가 나중에 그것을 대체했습니다.
ChatGPT Codex는 탐색자와 작업 에이전트에 할당된 작업의 이름이 있는 부분을 할당하고, GitHub Copilot은 이 가이드와 마찬가지로 COMMITTED 인스트럭션 파일에 규칙을 유지합니다. 허브 페이지에 있는 공유 실행 기록에는 Antigravity 버전, 모델, 실행 기간 및 테스트 머신이 나열됩니다.
문제 해결
- 슬라이드의 텍스트, 스타일링, 이미지 및 도형을 위한 슬라이드 요소
- 추가 빈 슬라이드로 덱이 열릴 때 슬라이드 추가
- 텍스트 스타일 및 단락에 대한 텍스트 추가
- 이미지 크기 및 위치를 위한 이미지 관리
- 서버에서
Save이 발생할 때 라이선스 키 적용
질문?
질문이 있으시면 support@ironsoftware.com으로 문의하세요.
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.