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.

​
핵심 개념

용어설명
Slide Master템플릿의 최상위 디자인. 전체 테마·폰트·색상. .pptx 하나당 여러 개 가능.
Slide Layout마스터 아래의 구체적 배치 (예: “Title Slide”, “Title + Content”, “Two Content”).
Placeholder레이아웃 내의 “꺼 구멍” — 제목/본문/이미지 등이 들어갈 영역. 인덱스로 식별 (0, 1, 2…).
즉 Word의 {{ name }} 태그 대신, 레이아웃 선택 + Placeholder 인덱스 + 값 으로 슬라이드를 생성합니다.

​
작성 워크플로

1

템플릿 파일 준비

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

템플릿 업로드

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

레이아웃 구조 확인

AI에게 요청:
list_template_layouts(template_name="my-template")
각 레이아웃의 이름과 사용 가능한 Placeholder 인덱스/타입이 반환됩니다.
4

빈 Presentation 생성

create_presentation(title="Q1 리포트", template_name="my-template")
→ returns spec_file
아직 슬라이드는 비어있는 spec 파일 이 생성됩니다.
5

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

edit_slide(spec_file, "insert", 1, { layout: "Title Slide", placeholders: {...} })
edit_slide(spec_file, "insert", 2, { layout: "Title + Content", placeholders: {...} })
...
한 번에 모든 슬라이드를 넣으려 하지 마세요. 반드시 슬라이드 단위 로 edit_slide(insert) 를 반복 호출합니다. 그렇지 않으면 placeholder 인덱스 오류로 깨진 슬라이드가 생성됩니다.
6

빌드 및 렌더

build_presentation(spec_file) → .pptx 생성
render_slide_screenshots(output_name) → PDF → 슬라이드별 PNG
review_slides(spec_file) → VLM 품질 리뷰 (0–10점)
score < 8.0 또는 중대 이슈 있으면 edit_slide("replace", N, new_slide) 로 재작업.

​
사용 가능한 도구

도구용도
list_templates업로드된 템플릿 목록
list_template_layouts템플릿의 레이아웃 + placeholder 정보
create_presentation빈 spec 파일 생성
edit_slide슬라이드 insert/replace/delete
build_presentationspec → .pptx 렌더
get_specspec 파일 조회 (전체 또는 특정 슬라이드)
render_slide_screenshots.pptx → PDF → PNG 스크린샷
review_slidesVision LLM 기반 품질 리뷰

​
템플릿 작성자를 위한 팁

​
레이아웃 구성

  • 필수 레이아웃: 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 템플릿과의 비교

Word (DOCX)PowerPoint (PPTX)
치환 방식Jinja2 스타일 태그 {{ var }}Slide Master + Layout + Placeholder 인덱스
작성 난이도텍스트 편집 (낮음)슬라이드 디자인 (중간)
AI 호출단일 렌더슬라이드 단위 반복
미리보기없음 (빌드 필요)render_slide_screenshots 로 PNG
품질 검증수동review_slides 자동 VLM 리뷰

​
관련 페이지