ツール

• search

  ワークスペースを検索

  投稿、ファイル、キャンペーン、アカウント、キュー、台本、Studioのプロジェクト、スタイルを、キーワードや画像・動画に写っている内容で探します。名前が大まかでも見つかり（大文字小文字、アクセント記号、ハイフン、スペース、拡張子の有無を問いません）、一致するものがなければ最も近い名前を返します。

  リスク

  低

  コネクタ

  両方

  読み取りのみ

• fetch

  1つの対象をすべて読む

  投稿、ファイル、キャンペーン、キュー、アカウント、StudioのプロジェクトをリンクやIDから読み取ります。SPREVAのリファレンスのページも読めます。

  リスク

  低

  コネクタ

  両方

  読み取りのみ

• overview

  ワークスペースの概要

  会話の最初に呼び出すツールです。タイムゾーンと現在時刻、対応が必要なもの、次に公開されるもの、アカウント、キュー、キャンペーン、プランで使える機能を返します。

  リスク

  低

  コネクタ

  両方

  読み取りのみ

• save_post

  投稿を作成・編集

  1つ以上のアカウント向けに、アカウントごとの違いも含めて投稿を書き、公開のタイミングを設定します。日時、キューの次の枠、または下書きを選べます。承認が必要なワークスペースでは、日時やキューを指定すると代わりにレビューに回され、人が承認した時点で公開されます。

  リスク

  中, 1時間以内に公開される場合は高。

  コネクタ

  両方

• publish_post

  投稿を今すぐ公開

  投稿をすべてのアカウントに公開します。失敗したアカウントだけに再公開することもできます。すでに公開されたものが二重に投稿されることはありません。承認が必要なワークスペースでは、誰も承認していない投稿は拒否されます。save_postで日時かキューを指定して、レビューに回してください。

  リスク

  高

  コネクタ

  両方

• delete_post

  投稿を削除

  下書き、予約済みの投稿、公開済みの投稿をSPREVAから削除します。公開済みの投稿は各SNS上には残ります。

  リスク

  中, 公開済みの投稿では高。

  コネクタ

  両方

• import_media

  ライブラリにファイルを取り込む

  公開リンクから、またはエージェントがアップロードしたデータから、画像や動画をライブラリに取り込みます。

  リスク

  中

  コネクタ

  両方

• update_media

  ライブラリのファイルの名前変更、タグ付け、整理、説明

  ファイルの名前、タグ、フォルダー、代替テキストを変更します。画像に写っている内容から代替テキストを書くこともできます。

  リスク

  中, AIで代替テキストを書く場合は高。

  コネクタ

  両方

• save_campaign

  キャンペーンを作成・編集

  キャンペーンを作成または変更し、投稿を追加したり外したりします。

  リスク

  中

  コネクタ

  両方

• save_queue

  キューを作成・編集

  投稿スケジュールを作成または変更します。名前、タイムゾーン、毎週の投稿枠を設定できます。

  リスク

  中

  コネクタ

  両方

• analytics

  投稿の成果

  ワークスペース、キャンペーン、アカウント、投稿ごとに、前の期間と比べた合計、上位の投稿、SNS別の内訳、サンプルサイズ付きの比較を返します。

  リスク

  低

  コネクタ

  両方

  読み取りのみ

• create_video

  Studioの動画を作成

  指定したフォーマットで空のStudioプロジェクトを作成し、エージェントがそこに動画を組み立てます。同じ名前のプロジェクトがすでにある場合は、コピーを作らずにそのプロジェクトを返します。

  リスク

  中

  コネクタ

  SPREVAのみ

• narrate_video

  Studioの動画にナレーションを付ける

  エージェントが書いた台本を音声にし、すべての単語をタイムラインに配置します。AIクレジットを100文字ごとに1クレジット使います。

  リスク

  高

  コネクタ

  SPREVAのみ

• match_media

  台本にライブラリのファイルを合わせる

  台本の各行について、写っている内容、含まれる文字、話されている内容、品質から、最も合うライブラリのファイルを一覧にします。クリップの場合は合う箇所も示します。何も変更せず、費用もかかりません。

  リスク

  低

  コネクタ

  SPREVAのみ

  読み取りのみ

• find_sfx

  役割から効果音を探す

  動画のある場面に合うライブラリの効果音を、ファイル名ではなく意図、感情、勢いで3つ選び、それぞれが合う理由とともに、最も控えめなものから順に一覧にします。何も変更せず、費用もかかりません。

  リスク

  低

  コネクタ

  SPREVAのみ

  読み取りのみ

• plan_edit

  Studioの動画の編集を計画

  Studioの動画（話されている内容、ショットとカット、すでにある要素）とライブラリの分類済みサウンドを読み取り、動画の種類（解説、ランキング、ニュース、チュートリアル、プロモーション、ポッドキャスト、Vlog、ストーリー、ハイライト）に合うレシピを選んで、完全な編集を1ステップで適用し、1つのバージョンとして保存します。すべてのカット（ハードカット、またはトランジションとその効果音）、ルック、字幕、フック、声の下で音量が下がる音楽、パンチイン、テキスト、Bロールを含みます。画像の背景の切り抜きはAIクレジットを使うため、提案するだけで適用はしません。applyを指定しない場合は何も変更せず、計画を説明するだけです。

  リスク

  低, 計画を適用する場合は中。

  コネクタ

  SPREVAのみ

• find_moments

  長い動画から見どころを探す

  長い動画で話されている内容を1文ずつ時刻付きで示し、音が大きくなる箇所、映像に写っているもの、提案するクリップを返します。エージェントはこれをもとに切り出す価値のある部分を選べます。何も変更せず、費用もかかりません。

  リスク

  低

  コネクタ

  SPREVAのみ

• make_clips

  長い動画から短いクリップを作る

  長い動画から選んだ部分を、縦型の短いStudioプロジェクトとして1部分につき1つずつ切り出し、話されている内容から字幕を付けます。それぞれが編集してエクスポートできるプロジェクトになります。

  リスク

  中

  コネクタ

  SPREVAのみ

• edit_video

  Studioの動画を変更

  Studio自身の編集操作で、テキスト、タイミング、カット、画像、クリップ、エフェクト、サウンドを編集し、新しい要素を追加します。

  リスク

  中

  コネクタ

  SPREVAのみ

• preview_video

  Studioの動画のフレームを見る

  エージェントが指定した時点のフレームを、エクスポートとまったく同じように描画します。エクスポートする前に、何が何に重なっているかを確認できます。何も変更せず、費用もかかりません。

  リスク

  低

  コネクタ

  SPREVAのみ

  読み取りのみ

• compare_video

  Studioの動画の2つのバージョンを比較

  プロジェクトの2つのバージョン間で変わった点を一覧にします。追加、削除、変更された要素と、それぞれの変更内容です。同じ時点の両方のバージョンを表示することもできます。何も変更しません。

  リスク

  低

  コネクタ

  SPREVAのみ

  読み取りのみ

• restore_video

  Studioの動画のバージョンを復元

  プロジェクトを過去のバージョンのいずれかに戻します。結果は新しいバージョンとして保存されるので、復元も元に戻せます。

  リスク

  中

  コネクタ

  SPREVAのみ

• review_video

  Studioの動画をレビュー

  Studio自身のAIエディターが自分の作業を確認するのと同じ方法でプロジェクトをチェックし、直すべき点を深刻なものから順に一覧にします。エクスポート時に自動で直る点には印を付けます。

  リスク

  低

  コネクタ

  SPREVAのみ

  読み取りのみ

• render_video

  Studioの動画をエクスポート

  プロジェクトをライブラリのMP4またはPNGとしてエクスポートし、投稿にすぐ使えるようにします。その前に、プロジェクトを品質の最低基準まで自動で引き上げ（字幕、フック、声の下の音楽、上限内のトランジション）、「Quality pass」というバージョンとして保存します。手作業で作った部分には一切触れません。

  リスク

  中

  コネクタ

  SPREVAのみ

• generate_image

  画像を生成

  説明から新しい画像を作ります。指定があれば、ワークスペースのスタイルのいずれかで作ります。AIクレジットを10使います。依頼がライブラリにすでにある画像に関するものなら、先にそれらを一覧にし、クレジットは使いません。

  リスク

  高

  コネクタ

  SPREVAのみ

エージェントはまずoverviewでタイムゾーン、現在時刻、アカウントを確認し、searchで対象を探し、fetchで1つをすべて読み、save_postなどのツールで変更します。どの応答にも、次にできることが書かれています。

ツールは、人が言うのと同じ形で対象を受け取ります。正確なファイル名、@ユーザーネーム、キャンペーン名、またはブラウザや以前の応答から貼り付けたSPREVA内のあらゆるもののリンクです。検索は寛容ですが、変更は厳密です。複数の対象に一致する名前は選択肢として返され、1つが選ばれるまで何も保存されません。

エージェントは、SPREVAのリファレンスを毎回の呼び出しに含めるのではなく、必要なときにfetchで読みます。

• spreva://docs/platforms/tiktokのように、SNSごとに1ページずつ：受け付ける形式、長さ、オプション。
• spreva://docs/queues：日時、タイムゾーン、キュー。
• spreva://docs/agent-permissions：リスクレベル、確認、リビジョン、リクエストID。
• spreva://docs/studio/makingとspreva://docs/studio/editing：動画の組み立て方（SPREVAのみ）。