Communitygithub.com

pattern-ai-labs/built-with-agentcall

agentcall.dev로 구축된 실제 사용 사례 모음 — 각 폴더는 독립적으로 동작하는 실제 예제입니다. Pattern AI Labs 제공.

built-with-agentcall란 무엇인가요?

이 스킬은 AI 에이전트가 회의에 참여하여 문서(또는 주제)를 발표할 수 있게 해주는 Presenter 봇을 구현합니다. 사용자는 회의 링크와 PDF, PowerPoint, Word 문서를 제공하면 봇이 자동으로 자료를 슬라이드로 변환하고, 음성 해설과 함께 화면 공유 방식으로 발표를 진행합니다. 봇은 '듣기'와 '명령' 파일을 통해 실시간 음성 제어를 지원하며, 참가자가 봇 이름을 부르면 질문에 응답하거나 진행을 조정할 수 있습니다. 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있도록 설계되었으며, 문서 변환부터 발표까지 전 과정을 자동화합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add pattern-ai-labs/built-with-agentcall

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Presenter — 회의에서 문서(또는 주제) 발표하기

AI 봇이 회의에 참여하여 발표합니다: 기본적으로 슬라이드는 회의 메인 스테이지에 크게 화면 공유되고, 봇의 음성으로 해설이 제공되며 자동으로 넘어갑니다. 봇의 얼굴은 작은 카메라 타일에 표시됩니다. (--avatar-mode를 전달하거나 사용자가 "아바타 모드로 참여"라고 말하면 슬라이드가 카메라 타일 위에 표시되는 원래 단일 타일 모양이 됩니다.) 어떤 모드든 클리커는 필요 없습니다.

표시 모드: 화면 공유가 기본값입니다(읽기 쉬운 전체 슬라이드 + 발표자 얼굴). 아바타 모드(--avatar-mode)는 슬라이드를 카메라 타일에만 표시합니다. 그 외의 모든 것 — 음성 제어, 컴패니언 리모컨, 해설, Q&A — 두 모드 모두 동일하게 작동합니다.

핵심 사용 사례: 사용자가 회의 링크와 문서(PDF, PowerPoint 또는 Word)를 제공하면 봇이 발표합니다. 주제만으로 시작할 수도 있습니다.

이 순서대로 수행하세요 (전체 흐름 — 매번 동일, 우회 금지)

0 · 사전 점검 (한 번).

  • API 키 — 이 순서로 확인하고, 이미 있으면 묻지 마세요 (AgentCall이 사용하는 동일한 파일 하나만 설정하면 됩니다; 이것이 load_api_key가 사용하는 정확한 순서입니다):
    1. ~/.agentcall/config.json이 존재하고 api_key가 있습니까? → 준비 완료.
    2. AGENTCALL_API_KEY 환경 변수가 설정되었습니까? → 준비 완료.
    3. 둘 다 아니요? → 사용자에게 키를 요청하고(agentcall.dev/api-keys에서 무료로 얻을 수 있음) ~/.agentcall/config.json에 기록하세요 (설정 참조) — AgentCall이 생성하는 것과 정확히 동일한 파일을 만든 후 계속 진행합니다.
  • 종속성 — pip install -r requirements.txt (빠름; 순수 Python wheel, 시스템 도구 불필요).

1 · 입력을 슬라이드로 변환합니다. 당신(에이전트)은 항상 해설을 직접 작성합니다 — 절대 봇이 화면에서 슬라이드를 읽게 하지 마세요. 먼저 doc_to_deck.py를 실행하고, 생성된 결과를 확인하세요:

  • .pptx/.ppt 파일 또는 슬라이드 형태의 PDF → 실제 슬라이드를 표시하지만, 해설은 당신이 작성합니다:
    • 파일의 모든 슬라이드에 발표자 노트가 있는 경우(.pptx만 해당 — 레거시 .ppt 노트는 읽을 수 없으므로 .pptx를 요청하세요), 노트가 해설이 됩니다 — 완료, 바로 발표하면 됩니다. 일부 슬라이드에만 노트가 있는 경우 → 슬라이드에 플래그가 지정됩니다; 누락된 슬라이드의 해설을 작성하세요.
    • 노트가 없는 경우, 슬라이드는 needs_narration 플래그와 함께 모든 notes가 비어 있는 상태로 반환됩니다(그리고 decks/<name>/source.json 파일도 함께 생성됩니다). 발표하기 전에 각 슬라이드에 대해 음성 notes를 작성하세요(source.json을 읽고 슬라이드 이미지를 살펴보세요) — present.py는 작성되지 않은 변환된 슬라이드 실행을 거부하므로, 이 과정을 우회할 수 있는 지름길은 없습니다. 작성 자체가 발표입니다.
  • .docx/.doc 파일, 보고서 형태의 PDF 또는 주제 → 슬라이드를 작성합니다: doc_to_deck.py --mode generate를 실행하고, decks/<name>/source.json(텍스트 + 추출된 그림)을 읽은 후 decks/<name>/deck.json에 작성합니다. 파일을 직접 열거나 렌더링하려고 하지 마세요(pdftoppm이나 이미지 도구 사용 금지) — source.json이 입력입니다. 작성은 간결하게 유지하세요: 슬라이드당 하나의 아이디어, 짧은 불릿, 자연스러운 해설 — 너무 다듬지 마세요.
  • 작성된 작업은 보호됩니다 — 그러나 기본 슬라이드 폴더에서만 그렇습니다. 변환을 다시 실행하거나(또는 present.py --deck <동일 문서>) 소스가 변경되지 않은 경우 decks/<name>/에 있는 작성된 deck.json을 재사용합니다 — 즉시, 다시 렌더링하지 않으며, 당신의 해설은 유지됩니다. 문서 자체가 변경된 경우에만 다시 변환합니다(그러면 다시 작성하세요 — 플래그가 다시 나타납니다). 작성하고 발표할 문서에 대해 --out <다른 폴더>를 전달하지 마세요 — 새 폴더에는 재사용할 슬라이드가 없으므로 빈 노트 초안이 생성되고(실제 작성된 슬라이드는 사용되지 않습니다). --out은 일회용/검사용 변환에만 사용하세요. 기본 decks/<name>/deck.json에서 작성, 발표 및 재발표를 모두 수행하세요.
  • 전체 세부 사항 + 슬라이드 스키마: 아래 A 및 B 섹션을 참조하세요.

엄격한 규칙 (각각은 실제 세션에서 문제를 일으킨 경우입니다 — 코드는 대부분을 강제하므로, 이를 위반하지 마세요):

  1. 가공되지 않은 문서를 present.py에 한 번에 전달하고 그냥 넘어가지 마세요. 변환 → needs_narration 확인 → notes 작성 → 발표 순서를 따르세요. 거부 종료 코드(2)는 우회해야 할 오류가 아니라, 작성해야 한다는 신호입니다.
  2. 작성된 deck.json을 다시 변환하여 덮어쓰지 마세요. 변경되지 않은 소스 → 자동으로 재사용됩니다. 사용자가 명시적으로 새 변환을 요청하는 경우에만 슬라이드 폴더를 삭제하세요.
  3. 자리 표시자 슬라이드를 만들거나 카메라에서 사과하지 마세요. 변환에 실패하면 present.py가 종료됩니다 — 입력을 수정하거나(또는 LibreOffice 설치) 다시 실행하세요. 참여하지 않는 봇은 고장난 봇보다 낫습니다.
  4. 회의 실행을 그대로 두지 마세요. present.py는 모든 종료 경로에서 자체적으로 요금 청구를 중단합니다 — 그러나 당신이 실행을 시작했다면, 발표가 끝날 때 프로세스가 실제로 종료되었는지 확인하세요.

1b · 사용자의 요청을 존중하세요 — 사용자의 지시는 슬라이드와 진행 방식을 모두 결정합니다. 사용자가 "이것을 발표해" 외에 다른 말을 하면, 이를 파악하고 적용하세요. 다음 두 가지 중 하나로 적용됩니다:

  • 작성 시점 (deck.json에 반영) — 내용이나 전달 방식에 관한 모든 것:
    • "짧게 / 약 5분 / 슬라이드당 한 줄" → 더 짧은 notes를 작성하세요. 슬라이드 유지 시간은 길이 기반이므로, 짧은 노트 = 더 빠른 발표입니다. "자세히" → 더 풍부한 notes.
    • "가격 슬라이드에 ‹X›라고 말해", "농담으로 시작해", "‹Y›를 강조해" → 해당 내용을 해당 슬라이드의 notes에 넣어 의도한 위치에서 정확히 말하도록 하세요.
    • "로드맵 슬라이드는 건너뛰어" → 작성할 때 해당 슬라이드를 삭제/병합하세요.
  • 실시간 진행 정책 (당신이 실행하면서 적용) — 회의장에서 반응하는 방식에 관한 모든 것:
    • "‹Z› / 가격 / 인원수에 대한 질문은 답변하지 마" → heard.jsonl을 통해 그러한 질문이 들어오면, 답변하지 마세요: 실제 답변 대신 간단한 회피 답변({"cmd":"say","text":"좋은 질문입니다 — 그 부분은 따로 이야기하시죠."})으로 응답하세요. "모든 Q&A는 마지막으로 미뤄" → 슬라이드 중간에 답변하지 말고 인정하고 계속 발표하세요.
    • "슬라이드 3에서 토론을 위해 멈춰", "내가 말할 때만 넘어가" → next/present를 보내는 시점을 조정하세요. 이러한 규칙을 세션 내내 짧게 기억하세요 — 규칙은 첫 번째 슬라이드뿐만 아니라 통화 전체에 적용됩니다. 요청이 모호하면 실행하기 전에 사용자에게 물어보세요.

2 · (선택 사항) 미리 보기 — present.py --local --deck <슬라이드>는 라이브 전에 시청할 수 있는 localhost URL을 출력합니다.

3 · 라이브 실행, 백그라운드에서 — python scripts/present.py "<url>" --deck <슬라이드> & (이름/음성은 ~/.agentcall/config.json에서 가져옵니다. --name/--voice로 실행 시 재정의할 수 있습니다.) 봇이 나타나는 데 30~90초 정도 걸리며, 인사하고 기다립니다.

4 · 실행 — 즉시 감시를 시작하세요. link/heard.jsonl을 추적하고 link/commands.jsonl에 응답하세요(전체 프로토콜은 음성 제어 아래에 있습니다). "계속 진행"에 present라고 응답할 때까지 시작되지 않습니다.

5 · 종료 — 모든 사람이 떠나거나, 시간 제한에 도달하거나, leave 명령이 있을 때 자동으로 떠나고 요금 청구를 중지합니다. 당신이 실행을 시작했다면 프로세스가 종료되는지 확인하세요.

두 가지 모드 (핵심 아이디어)

모드기능기본값 대상
show문서의 실제 페이지/슬라이드를 이미지로 렌더링하고 변경 없이 표시.pptx/.ppt 및 슬라이드 형태 PDF
generate문서를 분석한 후, 당신이 의미 있는 슬라이드(제목, 불릿, 음성 해설)를 작성하고 소스 자체 그림을 가져옴.docx/.doc, 밀집 보고서 PDF 및 주제

경험 법칙: 이미 슬라이드인 파일 → 표시합니다. 문서(산문) → 슬라이드를 생성합니다. auto(기본값)는 파일 형식으로 결정하며, PDF의 경우 페이지 모양(가로 + 적은 텍스트 = 슬라이드 → 표시; 세로 + 밀집 = 문서 → 생성)으로 결정합니다. --mode show|generate로 재정의할 수 있습니다. 사용자의 의도가 항상 우선합니다("내 슬라이드를 정확히 보여줘" → 표시; "이것을 슬라이드로 요약해" → 생성).

A) 슬라이드를 있는 그대로 표시 (PowerPoint 또는 슬라이드 스타일 PDF)

표시 모드는 모든 슬라이드의 실제 디자인을 유지합니다(실제 슬라이드의 전체 이미지). 말하는 내용은 파일에 발표자 노트가 있는지 여부에 따라 다릅니다:

python scripts/doc_to_deck.py "/path/deck.pptx"      # 슬라이드 렌더링 + 노트 감지
  • 모든 슬라이드에 발표자 노트가 있음(.pptx) → 노트가 해설입니다. 바로 발표:
    python scripts/present.py "<MEETING_URL>" --deck decks/deck/deck.json
    
  • 노트가 없거나 — 일부 슬라이드에만 있음 → 슬라이드에 needs_narration 플래그가 지정됩니다(노트가 없는 슬라이드는 조용히 표시됩니다). 노트가 없는 모든 슬라이드에 대해 음성 notes를 작성하세요(decks/<name>/source.json + 슬라이드 이미지에서), 그런 다음 작성된 deck.json을 발표하세요. 이것이 발표자가 화면 읽기 프로그램과 다른 점입니다.

present.py는 모든 슬라이드에 notes가 있을 때까지 needs_narration 슬라이드 발표를 거부합니다(오류와 함께 source.json을 가리키며 종료됩니다). "슬라이드 텍스트를 소리내어 읽기" 대체 기능은 없습니다 — 의도적인 설계입니다. 따라서 노트가 없는 원시 파일을 present.py에 전달하여 말하게 하지 마세요: 변환, notes 작성, 그런 다음 작성된 deck.json을 발표하세요. 거부는 안전 장치이며, 작성이 작업입니다.

B) 의미 있는 슬라이드 생성 (Word, 밀집 PDF 또는 주제)

문서는 슬라이드가 아닙니다 — 페이지를 표시하면 좋은 발표가 되지 않습니다. 따라서 당신이 슬라이드를 만듭니다.

  1. 변환하여 소스 내용 + 그림 가져오기:
    python scripts/doc_to_deck.py "/path/file.docx" --mode generate
    # decks/<name>/deck.json 작성 — 빈 NOTES가 있는 기계적인 초안, needs_narration 플래그 지정;
    #   present.py는 notes를 작성할 때까지 거부합니다(다음 단계, 선택 사항 아님)
    #    및 decks/<name>/source.json  ← 분석된 섹션 + 추출된 이미지, 작성할 때 사용
    #    및 decks/<name>/img/         ← 문서의 자체 그림, 이미 추출됨
    
  2. source.json에서 deck.json 작성 — 이것이 중요한 부분입니다. 잘 수행하세요:
    • 먼저 개요를 작성하고, 그런 다음 채우세요. 주요 아이디어당 하나의 슬라이드를 만드세요. 문서의 섹션/제목에 대한 정신적 체크리스트를 만들고 모든 핵심 포인트가 슬라이드에 포함되도록 하세요 — 내용을 빼먹지 마세요.
    • 각 슬라이드: 짧은 title, 6개 이하의 짧은 bullets, 그리고 notes = 자연스러운 음성 해설 (1~4문장; 약어는 "A.P.I."처럼 음성으로 철자를 알 수 있게 작성하여 TTS가 올바르게 발음하도록 하세요).
    • 소스의 그림을 재사용하세요. source.json은 문서에서 추출된 이미지를 나열합니다(sections[].images 및 all_images에). 관련 이미지를 슬라이드의 image 필드에 넣으세요 — 슬라이드는 불릿 옆에 실제 그림을 표시합니다(분할 레이아웃). 이미지를 만들어내지 마세요.
    • 한 줄짜리 소개 슬라이드로 시작하고, 마무리 슬라이드로 끝내세요(봇은 마지막 슬라이드 후에 떠납니다).
  3. 미리 보기 및 발표 (C 및 D 섹션). 파일이 없는 주제의 경우 변환을 건너뛰고 decks/<name>.json을 직접 작성하세요.

슬라이드 JSON 스키마 (텍스트 슬라이드, 이미지 슬라이드 또는 둘 다 함께):

{
  "title": "내 발표",
  "slides": [
    { "title": "소개", "notes": "음성 소개입니다." },
    { "title": "한 가지 포인트", "bullets": ["짧은 문구", "다른 문구"], "notes": "해설입니다." },
    { "title": "그림 포함", "bullets": ["표시 내용"], "image": "fig1.png", "notes": "해설입니다." },
    { "image": "slide3.png", "notes": "전체 화면 실제 슬라이드(표시 모드)." }
  ]
}

(bullets/notes/image는 모두 선택 사항입니다. 별칭: points→bullets, say→notes. 제목만 있는 슬라이드는 표지입니다.)

C) 미리 보기 (권장)

python scripts/present.py --local --deck decks/<name>/deck.json     # 또는 decks/<name>.json, 또는 원시 파일

http://localhost:PORT/?ws=local URL을 출력합니다 — 열면 슬라이드가 렌더링되고 자동으로 넘어가는 것을 볼 수 있으며, 회의는 없습니다.

D) 라이브 발표

python scripts/present.py "<MEETING_URL>" --deck <file-or-deck> [--mode show|generate]

라이브 회의는 기본적으로 대화형입니다(동의 기반): 봇이 참여하여 자신을 소개하고, 누군가가 시작하라고 말할 때까지 기다립니다. 두 가지 제어 방법:

  • 음성으로 → 당신(두뇌)에게 전달됩니다. 코드에 키워드 매칭이 없습니다. 참가자가 말하는 모든 내용 — 봇 이름을 부르거나 짧은 후속 질문 기간 동안 — 해석을 위해 당신에게 전달되며, 당신은 하나의 명령으로 응답합니다. 프로토콜은 아래에 있습니다.
  • 컴패니언 제어 페이지(직접). 전화/브라우저 페이지(이전 / 일시 정지 / 다음 / 슬라이드 탭 / 다시 시작 / 닫기)로, 봇이 회의 채팅에 링크를 보내고, 콘솔에도 출력합니다(▸ Controls page: …) — 콘솔 URL을 사용자에게 직접 전달하세요. Meet의 채팅 전달은 신뢰할 수 없을 수 있습니다. 버튼은 명확하며 프로세스 내에서 즉시 작동합니다(당신을 거치지 않음). 따라서 신뢰할 수 있는 대체 수단이며 에이전트 없이도 구동할 수 있는 방법입니다.

봇은 다른 모든 사람이 떠나거나, 하드 제한에 도달하거나, 깔끔하게 종료될 때 자동으로 떠나고 요금 청구를 중지합니다 — 방치된 봇이 비용을 발생시킬 수 없습니다. **--auto**를 추가하면 묻지 않고 즉시 발표합니다. --pace <s>는 슬라이드 간 간격을 설정합니다.

음성 제어 — 당신이 두뇌입니다 (중요한 부분)

대화형 모드에서 봇은 들은 내용을 파일 링크로 전달하고 당신이 다시 작성한 명령을 실행합니다. 하드코딩된 문구는 없습니다: 당신이 요청을 이해하고 작업을 결정합니다. 백그라운드에서 실행하고 루프를 도세요:

  1. 시작 (라이브의 기본값은 대화형): python scripts/present.py "<url>" --deck <file> & 두 개의 경로를 출력합니다: link/heard.jsonl (봇 → 당신) 및 link/commands.jsonl (당신 → 봇). 즉시 감시를 시작하세요 — 인사말은 자체적으로 재생되지만, 첫 번째 "계속 진행"에 응답할 때까지 발표는 시작되지 않습니다. 새 줄만 읽고(바이트/줄 오프셋을 추적하거나 파일에서 차단 — 이전 줄을 다시 처리하지 마세요), ~45초 이내에 응답하세요(그 이후에는 슬라이드가 자동으로 다시 시작됩니다). 효율적이고 이벤트와 같은 방식으로 감시하려면, 폴링 없이:
    tail -n +1 -f link/heard.jsonl     # 각 새 발화를 한 줄로 스트리밍; 처리한 후 link/commands.jsonl에 회신을 추가하세요
    
    (&/tail은 POSIX 명령입니다. Windows에서는 백그라운드 실행 기능과 Get-Content link/heard.jsonl -Wait를 사용하세요.) present.py는 commands.jsonl에 추가하는 내용을 약 0.3초 이내에 실행합니다.
  2. 봇이 이름으로 호출될 때 ("Presenter, …") — 또는 짧은 후속 질문 기간 동안 — 봇은 메시지를 heard.jsonl에 씁니다(JSON 줄, 아래 프로토콜 참조). 당신은 그 내용을 읽고, commands.jsonl에 한 줄의 JSON 명령을 추가하여 응답합니다.
  3. 당신의 답변은 두 가지 역할을 합니다: 봇이 말할 내용 제어 + 필요한 경우 다음 슬라이드로 진행.

당신이 부재 중이거나 응답하지 않으면 봇은 여전히 작동합니다: 약 45초 후에 첫 번째 슬라이드(다시 시작 중)를 다시 표시하고 자동 진행을 재개합니다. 그런 다음 3분마다 재시도합니다.

명령 프로토콜

heard.jsonl (봇 → 당신, 줄당 하나의 JSON 객체, 대부분 event 유형):

{"event":"on_intro_complete","bot":"<name>"}
{"event":"on_advance_ready","slide":3,"total":12}               // 각 슬라이드가 표시될 때
{"event":"on_heard","text":"Presenter, skip to the pricing slide","userId":"…"}
{"event":"on_heard","text":"Wait, go back one","userId":"…","followUp":true}
{"event":"on_followup_started"}
{"event":"on_followup_ended"}

on_advance_ready: 슬라이드가 표시되고(준비됨) 다음 슬라이드로 넘어갈 수 있을 때 발생합니다. 당신이 명령을 보내지 않으면 (또는 발표가 --auto인 경우) 약 45초 후에 자동으로 넘어갑니다. on_heard: 가벼운 도우미 팁: 이러한 메시지를 정리할 때 userId가 이전 메시지와 일치합니까? 그렇다면 같은 사람이 계속 말하고 있을 수 있습니다 — 두 번째 메시지는 첫 번째 메시지의... 후속 조치임을 의미할 수 있습니다(참가자가 "Presenter"라고 두 번 말할 필요 없음). 또한 followUp 플래그는 봇이 후속 질문 기간 내에 있음을 나타냅니다. 3초 휴지 시간 후 on_followup_ended가 전송됩니다. 후속 질문 기간을 놓쳤거나 응답하지 않은 경우 다시 "Presenter"라고 말해야 합니다.

commands.jsonl (당신 → 봇, 줄당 하나의 명령):

{"cmd":"say","text":"물론입니다, 가격 슬라이드로 넘어갑니다."}

{"cmd":"next"}                              // 다음 슬라이드로 즉시 이동 ("say" 없이)
{"cmd":"present","text":"좋습니다, 시작하겠습니다."}     // (첫 번째) 시작 명령, 선택적 음성
{"cmd":"goto","slide":8}                    // 특정 슬라이드로 이동 (1부터 시작)
{"cmd":"prev"}                              // 이전 슬라이드로 (또는 2초 동안 현재 슬라이드 다시 표시)
{"cmd":"pause"}
{"cmd":"resume"}
{"cmd":"leave","text":"이것으로 발표를 마치겠습니다."}   // 회의 나가기 + 요금 청구 중지

"cmd":"say"는 봇이 말할 것을 제어합니다. "cmd":"next" 및 친구들은 슬라이드 진행을 제어합니다. 함께 할 수 있습니다. "cmd" + "text"는 두 가지 역할을 합니다: 내용을 말하고 (필요한 경우) 진행합니다.

중요: "계속 진행" (present)은 첫 번째 on_intro_complete 이벤트에만 응답하세요 — 봇이 준비되면 한 번 수신됩니다. 그런 다음 일반 on_advance_ready 이벤트 및 명령의 세계로 전환됩니다.

설계 원칙

  • 단일 진입점, 단일 문서화된 흐름. 변환 → (작성) → 발표. 세 단계 모두 SKILL.md를 벗어나지 않고 여기서 수행하세요.
  • 자리 표시자 없음, 대체 동작 없음. 변환할 수 없음 = 봇이 참여하지 않음(사용자가 봇에 대해 알게 됨). 작성되지 않은 슬라이드 = 거부됨. 거부는 안전 장치이므로 우회하지 마세요.
  • 소리내어 읽기 없음. 봇은 슬라이드를 읽지 않습니다. 당신이 말을 합니다. 슬라이드의 텍스트는 시각적 참조용입니다.
  • 당신은 발표자입니다. 명확하게 말하고, 질문을 예상하며, 대화를 주도하세요 — 일반 발표자처럼. 봇의 음성을 "당신" 목소리로 생각하세요.
  • present.py는 안정적입니다. 인터넷이 끊어지면 자체적으로 종료됩니다. 명시적으로 leave를 보내거나 확인 없이 프로세스를 종료할 필요가 없습니다 — 자체적으로 처리합니다.
  • 일반 파이썬. venv, pip install, python script.py — 특별한 설정 없음, 시스템 도구 불필요, 도커 불필요.
  • 파일을 직접 열지 마세요. source.json은 당신이 읽는 것입니다. deck.json은 당신이 쓰는 것입니다. doc_to_deck.py는 이미지를 처리하고 변환을 처리합니다.

자주 묻는 질문

  • Q: 파워포인트가 없으면 슬라이드를 렌더링할 수 없나요? A: --mode generate를 사용하세요(Word 문서인 것처럼 슬라이드 작성). 또는 LibreOffice를 설치하세요 — doc_to_deck.py는 LibreOffice가 설치되어 있으면 감지하고 사용합니다(LibreOffice는 모든 것을 처리합니다).

  • Q: 생성된 슬라이드의 디자인이 없나요? A: 기본 템플릿은 깔끔합니다. --template <path>로 템플릿을 전달할 수 있지만 "나중에" — 먼저 실제 내용을 만드세요.

  • Q: 시크릿 모드로 카메라를 켜도 되나요? A: 아니요. 봇의 "얼굴"은 아바타 이미지(기본값) 또는 --avatar-file <경로>의 이미지입니다. 실제 비디오가 아닙니다.

  • Q: 오디오가 끊기거나 건너뛰나요? A: TTS는 클라이언트 측에서 스트리밍됩니다. 인터넷 연결이 좋지 않으면 음성이 왜곡될 수 있습니다 — 발표를 일시 중지하고(음성 명령 또는 제어 페이지), 연결이 복구되면 다시 시작하세요.

  • Q: 어떤 회의 플랫폼이 지원되나요? A: Google Meet, Zoom, Teams — 표준 웹 회의. 봇은 웹 페이지처럼 참여합니다.

  • Q: 회의 비용은 어떻게 청구되나요? A: present.py만 사용량을 발생시킵니다(분당). doc_to_deck.py는 오프라인에서 실행되며 비용이 들지 않습니다. ~/.agentcall/config.json에서 예산 제한을 설정할 수 있습니다. 봇은 가능한 한 빨리 떠나지만 완전히 제어할 수 있습니다.

관련 스킬