工具

• search

  搜尋工作空間

  依文字，或依圖片或影片呈現的內容，找到貼文、檔案、行銷活動、帳號、佇列、腳本、Studio 專案和風格。名稱寫得不精確也找得到（大小寫、重音符號、連字號、空格、沒有副檔名），找不到符合的項目時，會回覆最接近的名稱。

  風險

  低

  連接器

  兩者皆有

  僅讀取

• fetch

  完整讀取一個項目

  依連結或 ID 讀取一則貼文、一個檔案、行銷活動、佇列、帳號或 Studio 專案，或 SPREVA 參考資料的一個頁面。

  風險

  低

  連接器

  兩者皆有

  僅讀取

• overview

  工作空間總覽

  對話中的第一個呼叫：時區和目前時間、需要處理的事項、接下來要發布的內容、帳號、佇列和行銷活動，以及方案允許的功能。

  風險

  低

  連接器

  兩者皆有

  僅讀取

• save_post

  建立或編輯貼文

  為一個或多個帳號撰寫貼文，包括每個帳號不同的內容，並設定發布時間：指定時間、佇列的下一個時段，或存成草稿。在需要核准的工作空間中，指定時間或佇列會改為送出審核，等有人核准後才會發布。

  風險

  中, 在一小時內發布時為「高」。

  連接器

  兩者皆有

• publish_post

  立即發布貼文

  在貼文的所有帳號上發布，或只在發布失敗的帳號上重新發布。已經發布的內容絕不會重複發布。在需要核准的工作空間中，沒有人核准的貼文會遭到拒絕：請用 save_post 加上時間或佇列送出審核。

  風險

  高

  連接器

  兩者皆有

• delete_post

  刪除貼文

  從 SPREVA 移除草稿、已排程的貼文或已發布的貼文。已發布的貼文仍會保留在社群平台上。

  風險

  中, 已發布的貼文為「高」。

  連接器

  兩者皆有

• import_media

  把檔案匯入媒體庫

  從公開連結，或從代理程式上傳的位元組，把圖片或影片加入媒體庫。

  風險

  中

  連接器

  兩者皆有

• update_media

  為媒體庫檔案重新命名、加標籤、歸檔或加上描述

  變更檔案的名稱、標籤、資料夾或替代文字，也能依圖片內容撰寫替代文字。

  風險

  中, 用 AI 撰寫替代文字時為「高」。

  連接器

  兩者皆有

• save_campaign

  建立或編輯行銷活動

  建立或變更行銷活動，並把貼文加入或移出。

  風險

  中

  連接器

  兩者皆有

• save_queue

  建立或編輯佇列

  建立或變更發布時程：名稱、時區和每週時段。

  風險

  中

  連接器

  兩者皆有

• analytics

  貼文成效

  與前一段期間比較的總計、表現最好的貼文、依社群平台的分布，以及附上樣本數的比較，範圍可以是工作空間、行銷活動、帳號或貼文。

  風險

  低

  連接器

  兩者皆有

  僅讀取

• create_video

  建立 Studio 影片

  以指定格式建立一個空白的 Studio 專案，再由代理程式製作。如果已有同名專案，會回覆該專案，而不會建立副本。

  風險

  中

  連接器

  僅限 SPREVA

• narrate_video

  為 Studio 影片加上旁白

  把代理程式寫好的腳本配上聲音，並把每個字放到時間軸上。會使用 AI 點數，每 100 個字元 1 點。

  風險

  高

  連接器

  僅限 SPREVA

• match_media

  為腳本配對媒體庫檔案

  針對腳本的每個段落，依檔案呈現的內容、上面的文字、裡面說的話和品質，列出最適合的媒體庫檔案，並附上影片中合適的片刻。不會變更任何內容，也不會花費任何點數。

  風險

  低

  連接器

  僅限 SPREVA

  僅讀取

• find_sfx

  依用途尋找音效

  依意圖、情緒和能量，而不是檔名，為影片的某個片刻列出媒體庫中最合適的三個音效，說明每個音效適合的原因，並把最柔和的排在最前面。不會變更任何內容，也不會花費任何點數。

  風險

  低

  連接器

  僅限 SPREVA

  僅讀取

• plan_edit

  規劃 Studio 影片的剪輯

  讀取 Studio 影片（說了什麼、鏡頭和剪接點、已經有的內容）和媒體庫中已分類的音效，為這類影片挑選剪輯方式（理論、清單、新聞、教學、宣傳、Podcast、Vlog、故事、精華），並一次套用完整的剪輯，存成一個版本：每個剪接點都是直接切換或附音效的轉場，加上畫面風格、字幕、開場鉤子、在人聲下自動降低音量的音樂、推近鏡頭、文字和 B-roll。把圖片從背景中去背會使用 AI 點數，所以只會提議，絕不會直接套用。不使用 apply 時，它不會變更任何內容，只會說明計畫。

  風險

  低, 套用計畫時為「中」。

  連接器

  僅限 SPREVA

• find_moments

  在長影片中找出精彩片刻

  逐句顯示長影片說了什麼和對應的時間、哪裡音量變大、畫面呈現什麼，以及它建議的短片，讓代理程式能選出值得剪出的段落。不會變更任何內容，也不會花費任何點數。

  風險

  低

  連接器

  僅限 SPREVA

• make_clips

  從長影片剪出短片

  把你從長影片中選出的段落，剪成直式的短 Studio 專案，每個段落一個專案，並依說話內容加上字幕。每一個都是可以編輯和匯出的專案。

  風險

  中

  連接器

  僅限 SPREVA

• edit_video

  變更 Studio 影片

  用 Studio 本身的編輯操作，編輯文字、時間、剪接點、圖片、片段、特效和聲音，並新增元素。

  風險

  中

  連接器

  僅限 SPREVA

• preview_video

  查看 Studio 影片的影格

  依代理程式指定的時間點繪製影格，和匯出的結果完全相同，讓它能在匯出前確認哪些元素遮住了什麼。不會變更任何內容，也不會花費任何點數。

  風險

  低

  連接器

  僅限 SPREVA

  僅讀取

• compare_video

  比較 Studio 影片的兩個版本

  列出專案兩個版本之間的差異：新增、移除或變更的每個元素，以及其中變更了什麼。它也能顯示兩個版本在同一時間點的畫面。不會變更任何內容。

  風險

  低

  連接器

  僅限 SPREVA

  僅讀取

• restore_video

  還原 Studio 影片的版本

  把專案還原到它的某個版本。結果會存成新版本，所以還原也能復原。

  風險

  中

  連接器

  僅限 SPREVA

• review_video

  檢查 Studio 影片

  用 Studio 內建 AI 編輯器檢查自己作品的方式檢查專案，並由最嚴重的開始列出要修正的地方。它會標示匯出時會自動修正的項目。

  風險

  低

  連接器

  僅限 SPREVA

  僅讀取

• render_video

  匯出 Studio 影片

  把專案匯出成媒體庫中的 MP4 或 PNG，可直接用於貼文。它會先自動把專案提升到品質底線（字幕、開場鉤子、人聲下的音樂、在上限內的轉場），並把結果存成名為「Quality pass」的版本；你手動製作的內容絕不會被更動。

  風險

  中

  連接器

  僅限 SPREVA

• generate_image

  生成圖片

  依描述製作新圖片，有要求時會套用工作空間的某種風格。會使用 10 點 AI 點數。如果要求的是媒體庫中已經有的圖片，會先列出那些圖片，不花費任何點數。

  風險

  高

  連接器

  僅限 SPREVA

代理程式會先用 overview 取得時區、目前時間和帳號，用 search 找到項目，用 fetch 完整讀取某個項目，再用 save_post 或其他工具進行變更。每個回覆都會說明下一步可以做什麼。

工具接受人會說的話：確切的檔名、@帳號名稱、行銷活動的名稱，或 SPREVA 中任何項目的連結（從瀏覽器或先前的回覆貼上）。搜尋很寬鬆，變更則不然：符合多個項目的名稱會回傳選項，在選定其中一個之前，不會儲存任何內容。

代理程式需要時，會用 fetch 讀取 SPREVA 的參考資料，而不是在每次呼叫時都帶著它：

• spreva://docs/platforms/tiktok，每個社群平台各一頁：它接受的內容、長度和選項。
• spreva://docs/queues：時間、時區和佇列。
• spreva://docs/agent-permissions：風險等級、確認、修訂版本和請求 ID。
• spreva://docs/studio/making 和 spreva://docs/studio/editing：製作影片，僅限 SPREVA。