Communitygithub.com

pattern-ai-labs/built-with-agentcall

AgentCall.dev を使った実世界のユースケース集。各フォルダは自己完結型の動作例です。Pattern AI Labs 提供。

built-with-agentcall とは?

このスキルは、AI エージェントが会議に参加してドキュメントやトピックを自動でプレゼンテーションするための完全なワークフローを提供します。ユーザーは会議のURLとPDF、PowerPoint、Wordファイルを渡すだけで、エージェントがスライドを表示し、ナレーションを読み上げ、自動で進行します。スライドをそのまま表示する「showモード」と、文章からスライドを生成する「generateモード」の2つの動作モードがあり、音声制御やリモートコントロールページによる操作も可能です。Claude Code、Cursor、Codexなどのプラットフォームと互換性があり、音声認識、ファイル操作、API呼び出し、プロセス管理といった多彩な機能を活用します。

対応✓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 キー — この順序で確認し、既に存在する場合は質問しない(エージェントコールと同じファイルを使用する単一の設定です。これは load_api_key が使用する正確な順序です):
    1. ~/.agentcall/config.json が存在し、api_key がある? → 準備完了。
    2. AGENTCALL_API_KEY 環境変数が設定されている? → 準備完了。
    3. どちらもない? → ユーザーにキーを尋ね(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 を参照してください。

厳格なルール(それぞれ実際のセッションで問題が発生しました — コードはほとんどを強制します。それに逆らわないでください):

  1. 生のドキュメントを一度に present.py に渡して終わりにしないでください。 変換 → needs_narration を確認 → notes を作成 → プレゼンテーション。拒否終了コード(2)は、バイパスすべきエラーではなく、作成を促すシグナルです。
  2. 再変換によって作成済みの deck.json を上書きしないでください。 ソースが変更されていない場合 → 自動的に再利用されます。ユーザーが明示的に新しい変換を希望する場合のみ、デッキフォルダを削除してください。
  3. プレースホルダーデッキを発明したり、カメラの前で謝罪したりしないでください。 変換に失敗した場合、present.py は終了します — 入力を修正するか(または LibreOffice をインストールして)再起動してください。参加しないボットは、壊れているように見えるボットよりはましです。
  4. 実行中の通話を放置しないでください。 present.py はすべての終了パスで自動的に課金を停止します — しかし、自分が spawn した場合は、プレゼンテーション終了時にプロセスが実際に終了したことを確認してください。

1b · ユーザーの指示に従う — その指示はデッキとその駆動方法の両方を形作ります。 ユーザーが「これをプレゼンテーションして」以外のことを言った場合は、それを取得して適用します。それは次の2つの場所のいずれかに配置されます:

  • 作成時(deck.json に焼き付ける) — コンテンツや配信に関するもの:
    • 「短くして / 約5分で / スライドごとに一言で」 → より短い notes を書きます。スライドの保持時間は長さに基づいているため、短いノート = より速いトークになります。「深く掘り下げて」 → より豊かな notes。
    • 「価格スライドで‹X›と言って」、「ジョークで始めて」、「‹Y›を強調して」 → その行を該当するスライドの notes に入れ、意図した場所で正確に話されるようにします。
    • 「ロードマップスライドをスキップして」 → 作成中に削除/マージします。
  • ライブ駆動ポリシー(実行中にあなたが強制する) — 会議室内での反応に関するもの:
    • 「‹Z› / 価格 / 人員に関する質問には答えないで」 → そのような質問が heard.jsonl を通じて来た場合、答えないでください:簡単なかわしで返信します(`{

関連スキル