도구
에이전트를 위한 크리에이티브 툴킷.
모든 도구는 일정한 형태의 JSON을 반환하며, AI가 읽기 쉬운 상세한 스키마로 에이전트에게 설명되어 있어 별도의 안내 없이도 알맞은 도구를 고를 수 있습니다.
01
생성 시작
generate_presentation_start새 프레젠테이션 생성 작업을 시작합니다. 기본적으로 호출 안에서 롱 폴링하므로, 보통 한 번의 도구 호출로 완성된 프레젠테이션을 받을 수 있습니다. 생성에는 보통 5분에서 7분이 걸립니다.
- userPrompt
- 만들고 싶은 프레젠테이션을 설명하는 프롬프트.
- systemInstructions
- AI 간 지침으로, designStyle, resourcesToUse, context 세 개의 필드가 있습니다.
- slideCount
- 목표 슬라이드 수. 1에서 25까지, 기본값은 10.
- generateImages
- 모델이 이미지를 생성할지 여부.
- themeId
- list_available_themes에서 가져온 선택적 테마 ID.
- images
- 선택적 첨부 이미지(최대 8장). 각각 공개 imageUrl이며 시각적 레퍼런스로 전달됩니다.
- waitForCompletionMs
- 롱 폴링 최대 시간(밀리초). 권장: 220000, 최대: 900000.
02
생성 상태 확인
generate_presentation_status실행 중인 작업의 상태를 반환합니다. waitForCompletionMs를 전달하면 작업이 최종 상태에 도달할 때까지 롱 폴링하며, progressToken을 통해 MCP 진행 알림을 받을 수 있습니다.
- jobId
- generate_presentation_start가 반환한 작업 UUID.
- waitForCompletionMs
- 롱 폴링 최대 시간(밀리초).
03
생성 취소
generate_presentation_cancel실행 중인 생성을 취소합니다. 작업이 이미 최종 상태라면 아무 작업도 하지 않습니다.
- jobId
- 취소할 작업 UUID.
04
엄선된 테마 목록
list_available_themes엄선된 디자인 테마 카탈로그를 반환합니다. 각 테마에는 systemInstructions.designStyle에 그대로 전달할 수 있는 designStyle 프롬프트 문자열이 포함되어 있습니다.
05
결제 및 AI 크레딧 확인
get_billing_status인증된 사용자의 billing_plan과 남은 ai_credits, 그리고 업그레이드나 크레딧 충전이 필요할 때 공유할 URL을 반환합니다.
06
상태 점검
health_check백엔드 MCP 프로세스의 기본 상태를 반환합니다. 연결 확인에 유용합니다.