本文へスキップ

リファレンス

ツール

エージェントが呼び出せるツールです。SPREVAには49個のツールがあり、StudioとAI画像のツールにはStudioを含むプランが必要です。

すべてのツール

  • fetch

    1つの対象をすべて読む

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

    リスク
    低
    読み取りのみ
  • overview

    ワークスペースの概要

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

    リスク
    低
    読み取りのみ
  • list_workspaces

    ワークスペース一覧

    この接続で使えるワークスペースを、それぞれのロールとタイムゾーンとともに一覧にし、いまの呼び出しがどのワークスペースで行われるかを示します。

    リスク
    低
    読み取りのみ
  • switch_workspace

    ワークスペースを切り替える

    接続がすべてのワークスペースで許可されている場合に、会話を別のワークスペースへ、名前またはリンクで移します。以降の呼び出しは、そのワークスペースのアカウント、メディア、エージェント権限で行われます。

    リスク
    低
  • save_workspace

    ワークスペースの設定を変更

    ワークスペースの名前、タイムゾーン、メディアの説明を書く言語、新しくアップロードしたファイルを自動で説明するかどうかを変更します。オーナーと管理者が行えます。タイムゾーンを変えても、予約済みの投稿の公開時刻は変わりません。

    リスク
    中
  • list_members

    ワークスペースのメンバー

    メンバーをメールアドレスとロールとともに一覧にし、まだ受け付けていない招待と、それぞれのリンクの有効期限を示します。

    リスク
    低
    読み取りのみ
  • invite_member

    メンバーを招待

    メールアドレスとロールを指定して人を招待します。相手にメールが届き、プランの席を使うことがあるため、必ずプレビューを確認してから送ります。そのアドレスですでに SPREVA アカウントを持っている人はすぐに参加します。オーナーと管理者が行えます。管理者はオーナーを招待できません。

    リスク
    高
  • save_post

    投稿を作成・編集

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

    リスク
    中, 1時間以内に公開される場合は高。
  • publish_post

    投稿を今すぐ公開

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

    リスク
    高
  • delete_post

    投稿を削除

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

    リスク
    中, 公開済みの投稿では高。
  • import_media

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

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

    リスク
    中
  • update_media

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

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

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

    ライブラリのファイルを削除

    ライブラリから1つまたは複数のファイル(画像、動画、音声)を削除します。事前にプレビューと確認が表示され、各ファイルの使用箇所と解放される容量がわかります。未公開の投稿やStudioプロジェクトで使われているファイルは、エージェントが強制しない限り拒否されます。

    リスク
    高
  • share_media

    ファイルやフォルダを他のワークスペースと共有

    ライブラリのファイルやフォルダ全体を、読み取り専用の参照として他のワークスペースに貸し出します。何もコピーされず、動画や投稿では使えますが、変更や削除はできません。取り消すときは、そこの動画や投稿が使っていれば確認が必要です。

    リスク
    中, 他のワークスペースの動画や投稿が使っているファイルを取り消す場合は高。
  • save_campaign

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

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

    リスク
    中
  • save_queue

    キューを作成・編集

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

    リスク
    中
  • analytics

    投稿の成果

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

    リスク
    低
    読み取りのみ
  • refresh_metrics

    数字を更新

    通常のスケジュールを待たずに、投稿の数字またはアカウントのフォロワー数を今すぐ各ネットワークから読み取ります。通常のスケジュールには手を加えません。同じ投稿やアカウントは5分後に再度更新できます。

    リスク
    低
  • list_clippers

    クリッパーと再生数

    クリッパープログラムに関連付けられたアカウントを、期間内の再生数順に並べます。SNS、@handle、リンクも付き、あなたの判断を待っているアカウントが先頭に来ます。

    リスク
    低
    読み取りのみ
  • clipper_posts

    クリッパーのアカウントの投稿

    関連付けられたアカウントが参加してから公開した投稿を、新しい順に返します。再生数、リンク、日付も付きます。アカウントの名前、@handle、リンク、idのどれでも指定できます。

    リスク
    低
    読み取りのみ
  • clipper_calendar

    クリッパーの予約済み投稿

    クリッパーがSPREVAで予約した今後の投稿と、SPREVAから公開された投稿を、近い順に返します。アカウント、SNS、公開後はリンクも付きます。SNSで直接投稿されたものは含まれません。

    リスク
    低
    読み取りのみ
  • create_video

    Studioの動画を作成

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

    リスク
    中
    Studioを含むプランが必要
  • narrate_video

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

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

    リスク
    高
    Studioを含むプランが必要
  • compose_video

    Markdownの台本からStudioの動画を作る

    1つのMarkdown台本から、解説動画をまるごと作ります。話す内容と、どの単語で何を画面に出すかを書きます。ナレーションを音声にし、ルックが色、登場の動き、トランジション、効果音を決め、カメラは登場したものに寄り、字幕とBGMも付きます。結果は通常の編集できるStudioプロジェクトです。AIクレジットをナレーション100文字ごとに1クレジット使い、先にプレビューで確認します。台本を変えてプロジェクトを作り直すときは、ナレーションが変わった場合だけ音声を作り直します。

    リスク
    高
    Studioを含むプランが必要
  • match_media

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

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

    リスク
    低
    Studioを含むプランが必要
    読み取りのみ
  • find_sfx

    役割から効果音を探す

    動画のある場面に合うライブラリの効果音を、ファイル名ではなく意図、感情、勢いで3つ選び、それぞれが合う理由とともに、最も穏やかなものを先頭に一覧にします。うまく合うものがないとき、または頼まれたときは、Spreva独自のシンセサイザーで新しい音を作ってライブラリに保存し、先頭に表示します。AIクレジットは使いません。

    リスク
    低
    Studioを含むプランが必要
  • find_music

    雰囲気から音楽を探す(動画ごとに変化をつける)

    ファイル名ではなく、雰囲気、ジャンル、勢い、声の下での馴染みやすさで、動画に合うライブラリの音楽を3つ選び、それぞれが合う理由とともに一覧にします。ワークスペースの最近の動画で使われた曲は順位が下がり、そのプロジェクトで使用済みの曲は除外されるので、動画ごとに同じ音楽になりません。まだ分類されていない曲は分類待ちに追加されます。何も変更せず、費用もかかりません。

    リスク
    低
    Studioを含むプランが必要
    読み取りのみ
  • find_icon

    意味からアイコンを探す

    英語の数語(phone、security、growth chart など)に最もよく合うLucideのアイコンを、タグとともに一致度の高い順に一覧にし、モーショングラフィックでの使い方を示します。自分で描き込まれるiconブロックか、生のシーンのパスノードを使います。何も変更せず、費用もかかりません。

    リスク
    低
    Studioを含むプランが必要
    読み取りのみ
  • create_sfx

    効果音を作成する

    Spreva独自のシンセサイザーで、英語またはポルトガル語の短い言葉、または完全に制御するためにエージェントが書くレシピから、新しい効果音を作ります。ライブラリの「Generated sounds」フォルダに保存され、他の音と同じように分類されるので、見つけて動画に配置できます。AIクレジットは使いません。

    リスク
    中
    Studioを含むプランが必要
  • score_video

    Studio動画の音楽を作曲する

    動画に合わせたインストゥルメンタル音楽を作曲します。静かなイントロ、盛り上がり、明かされる瞬間にぴったり合わせたドロップ、そして締めくくり。ライブラリに音楽として保存され、プロジェクトの下にBGMとして敷かれ、声の下では音量が下がります。AIクレジットを消費します(動画30秒ごと、開始分も含めて30クレジット)。まずプレビューで確認できます。

    リスク
    高
    Studioを含むプランが必要
  • plan_edit

    Studioの動画の編集を計画

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

    リスク
    低
    Studioを含むプランが必要
  • find_moments

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

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

    リスク
    低
    Studioを含むプランが必要
  • read_transcript

    ファイルを一語ずつ読む

    動画や音声ファイルの文字起こしを、編集者が読むように読みます。時間と話者つきのフレーズ、残したまま印を付けた言いよどみ(えー、あのー)、そして無音の区間を一覧にします。複数のファイルをまとめて読んでテイクを比べたり、範囲を一語ずつ、各語の開始と終了つきで一覧にしたりできます。何も変更せず、何も消費しません。

    リスク
    低
    Studioを含むプランが必要
    読み取りのみ
  • make_clips

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

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

    リスク
    中
    Studioを含むプランが必要
  • edit_video

    Studioの動画を変更

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

    リスク
    中
    Studioを含むプランが必要
  • save_video

    Studioプロジェクトの名前変更とフォルダ分け

    プロジェクトの名前を変更したり、Studioのフォルダに入れたり、フォルダから出したりします。複数のプロジェクトをまとめてフォルダに入れることもできます。名前の変更にはプロジェクトのリビジョンが必要で、フォルダ分けだけなら動画は変わりません。別のワークスペースへプロジェクトをコピーすることもでき、使用しているファイルは読み取り専用で共有され、ブランドフォントも追加されます。

    リスク
    中
    Studioを含むプランが必要
  • delete_video

    Studioプロジェクトの削除

    プレビューと確認のあとで、Studioプロジェクトを1つまたは複数削除します。そこから書き出したファイルはライブラリに残ります。

    リスク
    高
    Studioを含むプランが必要
  • preview_video

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

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

    リスク
    低
    Studioを含むプランが必要
    読み取りのみ
  • inspect_media

    元ファイルの一部を見る

    アップロードした動画または音声ファイルの指定した範囲を1枚の画像にします。等間隔のフレーム、間を陰影で示した音声の波形、話された言葉をその位置に並べます。何も変更せず、何も消費しません。

    リスク
    低
    Studioを含むプランが必要
    読み取りのみ
  • compare_video

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

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

    リスク
    低
    Studioを含むプランが必要
    読み取りのみ
  • restore_video

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

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

    リスク
    中
    Studioを含むプランが必要
  • review_video

    Studioの動画をレビュー

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

    リスク
    低
    Studioを含むプランが必要
    読み取りのみ
  • render_video

    Studioの動画をエクスポート

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

    リスク
    高
    Studioを含むプランが必要
  • generate_image

    画像を生成

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

    リスク
    高
    Studioを含むプランが必要
  • mascot

    マスコットを選ぶ

    ワークスペースのマスコットを読み取り、または設定します。動画の中で話し、まばたきし、ポーズをとるアニメーションSVGのホストです。無料でAIクレジットは不要。内蔵のものを選び、ブランドカラーで色を変えるか、自分の絵を使えます。

    リスク
    中
    Studioを含むプランが必要
  • use_skill

    ワークスペースの編集スキルを読む

    ワークスペースの編集スキル(クリエイターの手順書:見た目、テンポ、作り方)を一覧にするか、1つを全文で読みます。エージェントは動画を作成・編集するときにそれに従います。

    リスク
    低
    Studioを含むプランが必要
    読み取りのみ
  • save_skill

    編集スキルを保存

    ワークスペースの編集スキルを作成、変更、SKILL.mdから読み込み、または削除します。いつ使われるかは説明文で決まります。

    リスク
    中
    Studioを含むプランが必要

よくある流れ

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

IDではなく名前で

ツールは、人が言うのと同じ形で対象を受け取ります。正確なファイル名、@ユーザーネーム、キャンペーン名、またはブラウザや以前の応答から貼り付けた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のみ)。