Skip to main content

PowerPoint 템플릿 작성 가이드

경로: 하단 툴바 [6] PowerPoint → 템플릿 가이드 PowerPoint(.pptx) 템플릿은 Word와 전혀 다른 방식 을 씁니다. 텍스트 태그가 아닌 슬라이드 마스터/레이아웃과 Placeholder 인덱스 를 활용합니다.
원본 스펙: seahorse-mcp-agent-server/packages/pptx-mcp-server/instructions.py, presentation_builder.py, template_inspector.py.

핵심 개념

즉 Word의 {{ name }} 태그 대신, 레이아웃 선택 + Placeholder 인덱스 + 값 으로 슬라이드를 생성합니다.

작성 워크플로

1

템플릿 파일 준비

  • Microsoft PowerPoint에서 원하는 디자인의 .pptx 저장
  • 슬라이드 마스터 편집(보기 → 슬라이드 마스터)에서 필요한 레이아웃을 꾸밈
  • 각 레이아웃에 필요한 Placeholder를 배치 (Title, Content, Picture 등)
2

템플릿 업로드

Agent Chat 툴바 → PowerPointTEMPLATES 영역에 업로드.
3

레이아웃 구조 확인

AI에게 요청:
각 레이아웃의 이름과 사용 가능한 Placeholder 인덱스/타입이 반환됩니다.
4

빈 Presentation 생성

아직 슬라이드는 비어있는 spec 파일 이 생성됩니다.
5

슬라이드를 하나씩 추가 (중요!)

한 번에 모든 슬라이드를 넣으려 하지 마세요. 반드시 슬라이드 단위edit_slide(insert) 를 반복 호출합니다. 그렇지 않으면 placeholder 인덱스 오류로 깨진 슬라이드가 생성됩니다.
6

빌드 및 렌더

score < 8.0 또는 중대 이슈 있으면 edit_slide("replace", N, new_slide) 로 재작업.

사용 가능한 도구

템플릿 작성자를 위한 팁

레이아웃 구성

  • 필수 레이아웃: Title Slide, Title + Content, Two Content, Section Header, Blank
  • 권장 추가: Title + Chart, Title + Image, Comparison, Caption
  • 각 레이아웃 이름을 의미 있게 지으세요 (자동 추천 품질이 향상됨)

Placeholder 배치

  • 제목(Title): 각 레이아웃 상단에 고정
  • 본문(Content): 텍스트/표/차트가 들어갈 영역
  • 이미지(Picture): 사진 삽입 영역 — 크기와 비율을 명확히
  • 차트(Chart): 차트 영역 (빈 차트 placeholder 권장)

테마·폰트·색상

마스터 수준에서 설정하면 모든 슬라이드에 일괄 적용. 개별 슬라이드에서 덮어쓰기 가능하지만 가독성 저하 위험.

차트/표 지원

템플릿 빌더는 python-pptx 기반이며 내부 Registry로 다음을 지원:
  • Shape types — 도형 종류
  • Connector types — 연결선
  • Chart types — 차트 (bar/line/pie 등)
자세한 목록은 edit_slide 호출 시 AI가 자동으로 참조합니다.

Word 템플릿과의 비교

관련 페이지