ツール
エージェントのためのクリエイティブツールキット。
すべてのツールは安定した形式のJSONを返し、AIが読みやすい詳細なスキーマでエージェントに説明されるため、手助けなしで適切なツールを選べます。
01
生成を開始
generate_presentation_start新しいプレゼンテーション生成ジョブを開始します。デフォルトでは呼び出しの中でロングポーリングするため、通常は1回のツール呼び出しで完成したプレゼンテーションが返ります。生成には通常5分から7分かかります。
- userPrompt
- 作成したいプレゼンテーションを説明するプロンプト。
- systemInstructions
- AIからAIへの指示。designStyle、resourcesToUse、contextの3つのフィールドがあります。
- 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プロセスの基本的なステータスを返します。接続確認に便利です。