Presenter — 会議でドキュメント(またはトピック)をプレゼンテーションする
AI ボットが会議に参加してプレゼンテーションを行います:デフォルトではスライドが会議のメインステージに画面共有として大きく表示され、ボットの音声でナレーションが流れ、自動で進行します。ボットの顔は小さなカメラタイルに表示されます。(--avatar-mode を渡すか、ユーザーが「アバターモードで参加」と言った場合は、スライドをカメラタイル上に表示する、元のシングルタイルの見た目になります。)どちらの場合もクリッカーは不要です。
表示モード: 画面共有 がデフォルト(読みやすいフルステージのスライド + プレゼンターの顔);アバターモード(--avatar-mode)はスライドをカメラタイルのみに表示します。その他すべて — 音声制御、コンパニオンリモート、ナレーション、Q&A — は両方のモードで同じように動作します。
主な用途:ユーザーが会議リンクとドキュメント(PDF、PowerPoint、Word)を渡すと、ボットがそれをプレゼンテーションします。 トピックだけから始めることもできます。
この順序で実行(フロー全体 — 毎回同じ、回り道なし)
0 · 事前確認(一度だけ)。
- API キー — この順序で確認し、既に存在する場合は質問しない(エージェントコールと同じファイルを使用する単一の設定です。これは
load_api_keyが使用する正確な順序です):~/.agentcall/config.jsonが存在し、api_keyがある? → 準備完了。AGENTCALL_API_KEY環境変数が設定されている? → 準備完了。- どちらもない? → ユーザーにキーを尋ね(agentcall.dev/api-keys で無料)、
~/.agentcall/config.jsonに書き込む(セットアップ参照)— エージェントコールとまったく同じようにそのファイルを作成 — その後続行。
- 依存関係 —
pip install -r requirements.txt(高速;純粋な Python ホイール、システムツールは不要)。
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があなたの入力です。作成は簡潔に:スライドごとに1つのアイデア、短い箇条書き、自然なナレーション — 過度に磨き上げないでください。- 作成された作業は保護されます — ただし、デフォルトのデッキフォルダ内のみ。 変換(または
present.py --deck <同じドキュメント>)をソースが変更されていない状態で再実行すると、decks/<name>/内の作成済みdeck.jsonが再利用されます — 即座に、何も再レンダリングされず、ナレーションは保持されます。ドキュメント自体が変更された場合のみ再変換します(その場合は再作成 — フラグが戻ってきます)。作成してプレゼンテーションするドキュメントに対して--out <別のフォルダ>を渡さないでください — 新しいフォルダには再利用するデッキがないため、空のノートのドラフトが作成され(実際の作成済みデッキは古くなります)。--outは使い捨て/検査用の変換にのみ使用します。作成、プレゼンテーション、再プレゼンテーションはすべてデフォルトのdecks/<name>/deck.jsonから行います。 - 詳細 + デッキスキーマ:以下のセクション A と B を参照してください。
厳格なルール(それぞれ実際のセッションで問題が発生しました — コードはほとんどを強制します。それに逆らわないでください):
- 生のドキュメントを一度に
present.pyに渡して終わりにしないでください。 変換 →needs_narrationを確認 →notesを作成 → プレゼンテーション。拒否終了コード(2)は、バイパスすべきエラーではなく、作成を促すシグナルです。 - 再変換によって作成済みの
deck.jsonを上書きしないでください。 ソースが変更されていない場合 → 自動的に再利用されます。ユーザーが明示的に新しい変換を希望する場合のみ、デッキフォルダを削除してください。 - プレースホルダーデッキを発明したり、カメラの前で謝罪したりしないでください。 変換に失敗した場合、present.py は終了します — 入力を修正するか(または LibreOffice をインストールして)再起動してください。参加しないボットは、壊れているように見えるボットよりはましです。
- 実行中の通話を放置しないでください。 present.py はすべての終了パスで自動的に課金を停止します — しかし、自分が spawn した場合は、プレゼンテーション終了時にプロセスが実際に終了したことを確認してください。
1b · ユーザーの指示に従う — その指示はデッキとその駆動方法の両方を形作ります。 ユーザーが「これをプレゼンテーションして」以外のことを言った場合は、それを取得して適用します。それは次の2つの場所のいずれかに配置されます:
- 作成時(
deck.jsonに焼き付ける) — コンテンツや配信に関するもの:- 「短くして / 約5分で / スライドごとに一言で」 → より短い
notesを書きます。スライドの保持時間は長さに基づいているため、短いノート = より速いトークになります。「深く掘り下げて」 → より豊かなnotes。 - 「価格スライドで‹X›と言って」、「ジョークで始めて」、「‹Y›を強調して」 → その行を該当するスライドの
notesに入れ、意図した場所で正確に話されるようにします。 - 「ロードマップスライドをスキップして」 → 作成中に削除/マージします。
- 「短くして / 約5分で / スライドごとに一言で」 → より短い
- ライブ駆動ポリシー(実行中にあなたが強制する) — 会議室内での反応に関するもの:
- 「‹Z› / 価格 / 人員に関する質問には答えないで」 → そのような質問が
heard.jsonlを通じて来た場合、答えないでください:簡単なかわしで返信します(`{
- 「‹Z› / 価格 / 人員に関する質問には答えないで」 → そのような質問が