Agent-Native Slides 문서는 프롬프트로 편집 가능한 슬라이드를 만들고 독립형 HTML로 내보내는 방법을 설명합니다. Node와 터미널 명령에 익숙한 독자를 위한 안내입니다. 자신의 사실 자료로 세 장을 만들고 지정한 항목을 고친 다음 다운로드 파일을 확인합니다. 제품 문서와 검토한 소스 코드가 근거이며, 앱 실행이나 내보내기 테스트는 하지 않았습니다.

주요 변화

  • 달라진 점: 생성된 자료를 슬라이드로 편집하고 하나의 HTML 파일로 다운로드해 볼 수 있습니다.
  • 중요한 이유: 원문 대조와 정확한 수정으로 사실에 대한 책임을 독자가 유지합니다. 결정적인 확인 대상은 내보낸 파일입니다.
  • 살펴볼 점: 로컬 호스팅은 앱에 해당합니다. 프롬프트 처리 위치와 가능한 비용은 모델 연결에 따라 결정됩니다. 자료당 고정 가격이나 패키지와 검토한 커밋의 완전한 일치는 확인하지 않았습니다.

원문과 로컬 앱 준비

  1. 검증할 수 있는 짧은 원문을 작성하고 출처, 정확한 수치와 날짜를 보관합니다. 생성 후 고칠 문장이나 수치 하나를 표시하고 정확한 대체 내용을 적습니다. 선택한 모델 제공업체에 보낼 권한이 있는 자료만 사용하세요. 개발 서버가 로컬이어도 클라우드 모델 호출이 로컬 호출로 바뀌지는 않습니다.
  2. Node.js 22.22 이상을 설치하고 pnpm을 사용할 수 있게 합니다. 터미널에서 실행합니다.
Terminal
   npx --yes @agent-native/core@0.209.2 create my-slides --standalone --template slides
   cd my-slides
   corepack enable
   pnpm install

고정한 0.209.2는 이 절차에서 확인한 npm 패키지 버전입니다. 아래에서 검토한 저장소 코드는 별도 커밋이며, 배포 패키지에 정확히 같은 코드가 들어 있다고 확인하지 않았습니다.

  1. 자료 생성을 요청하기 전에 모델을 연결합니다. 문서의 OpenAI 방식은 OPENAI_API_KEY를 생성된 앱의 서버 측 .env에 지금 추가하는 것입니다. 이어 pnpm dev를 실행하고 출력된 로컬 URL을 열어 Welcome에서 Continue as local dev를 선택합니다. 8080이 사용 중이면 포트가 달라질 수 있습니다. Settings에서 모델을 선택합니다. 또는 앱을 시작한 뒤 Custom keys로 개인·조직 자격 증명을 추가합니다. 키를 프롬프트, 화면 캡처 또는 브라우저 코드에 노출될 수 있는 VITE_ 변수에 넣지 마세요. 원문을 보내기 전 접근 조건과 요금을 확인하세요. 프레임워크의 오픈 소스 라이선스는 모델 사용을 포함하지 않습니다.

슬라이드 세 장 만들고 확인

  1. 이제 New deck을 누릅니다. 에이전트 요청에 원문을 붙이고 그 사실만으로 정확히 세 장을 만들라고 합니다. 각 장의 역할을 주제, 핵심 사실, 원문이 뒷받침하는 결론으로 지정합니다. 필요한 인용이나 출처도 유지하도록 요청합니다. 이런 제약이 생성 결과의 준수를 보장하지는 않습니다.
  2. 장수를 세고 사실을 담은 모든 줄을 원문과 대조합니다. 근거 없는 내용을 삭제하고 수치, 날짜, 이름, 단서가 유지되는지와 잘린 글자가 없는지 확인합니다. 예정한 수정 전에 해야 해당 변경과 다른 오류를 구분할 수 있습니다.
  3. 표시한 항목의 슬라이드를 열어 글자를 두 번 클릭합니다. 준비한 정확한 문구나 값으로 그 항목만 바꾸고 이 장과 나머지 두 장을 다시 읽습니다. 선택한 글자에는 Revise with AI도 있지만 직접 편집하면 수정 범위를 제한하고 추가 모델 요청을 피할 수 있습니다.
  4. 편집기에서 Export, Download HTML을 선택하고 다운로드한 .html을 브라우저에서 엽니다. 세 장, 앞뒤 이동, 수정한 글자, 각 장의 배치를 편집기와 대조합니다. 편집기에서 수정이 보인다고 다운로드에 반영되었다고 볼 수는 없습니다. 문서의 HTML은 키보드 탐색이 가능한 독립형 보기 파일이며 편집 가능한 PowerPoint가 아닙니다. Google Slides는 별도 PPTX 가져오기 경로를 사용합니다.

내보내기가 비활성화되면 슬라이드가 있는지 확인합니다. 설치 중 피어 의존성 오류가 나면 시작 안내는 npx clear-npx-cache 후 재시도를 권합니다. 원치 않는 편집은 기능 문서의 버전 기록과 복원 방법을 이용하고, 다시 내보내기 전에 복원한 글자를 확인합니다. 실제로 관찰한 장애가 아니라 문서에 나온 복구 방법입니다.

출처와 추가 자료

  • 시작 안내: Node/pnpm 요구 사항, 로컬 개발, Welcome 선택과 설정 복구.
  • Slides 개요: 초기 생성 명령, New deck, 자료 생성.
  • Slides 기능: 직접 글자 편집, 버전 복원, 독립형 HTML.
  • 환경 변수: OpenAI 키 위치, Custom keys, 모델 선택, 브라우저에 노출되는 변수.
  • 고정 커밋의 Export 메뉴 소스: Download HTML과 빈 자료에서의 비활성 상태. 검토한 커밋은 npm 패키지의 정확한 내용을 증명하지 않습니다.