參考資料
工具
代理程式可以呼叫的工具。SPREVA 列出 49 個工具,其中 Studio 和 AI 圖片的工具需要包含 Studio 的方案。
所有工具
search搜尋工作空間
依文字,或依圖片或影片呈現的內容,找到貼文、檔案、行銷活動、帳號、佇列、腳本、Studio 專案和風格。名稱寫得不精確也找得到(大小寫、重音符號、連字號、空格、沒有副檔名),找不到符合的項目時,會回覆最接近的名稱。
- 風險
- 低
僅讀取fetch完整讀取一個項目
依連結或 ID 讀取一則貼文、一個檔案、行銷活動、佇列、帳號或 Studio 專案,或 SPREVA 參考資料的一個頁面。
- 風險
- 低
僅讀取overview工作空間總覽
對話中的第一個呼叫:時區和目前時間、需要處理的事項、接下來要發布的內容、帳號、佇列和行銷活動,以及方案允許的功能。
- 風險
- 低
僅讀取list_workspaces你的工作空間
列出這個連線可以使用的工作空間,包含你在每個工作空間中的角色與時區,並指出目前的呼叫是在哪一個工作空間中進行。
- 風險
- 低
僅讀取switch_workspace切換工作空間
當連線已允許用於所有工作空間時,依名稱或連結將對話移到你的另一個工作空間。之後的呼叫會使用該工作空間的帳號、媒體與代理權限。
- 風險
- 低
save_workspace變更工作空間的設定
重新命名工作空間,或變更它的時區、媒體描述使用的語言,以及新上傳的檔案是否自動加上描述。擁有者與管理員可以這麼做。變更時區不會移動已排程的貼文。
- 風險
- 中
list_members工作空間的成員
列出成員的電子郵件與角色,以及仍在等待的邀請和每個連結的到期時間。
- 風險
- 低
僅讀取invite_member邀請他人
以電子郵件和角色邀請一個人,一律先顯示預覽讓你確認,因為對方會收到電子郵件,也可能占用方案的一個席位。已用該地址註冊 SPREVA 帳號的人會立即加入。擁有者與管理員可以這麼做;管理員無法邀請擁有者。
- 風險
- 高
save_post建立或編輯貼文
為一個或多個帳號撰寫貼文,包括每個帳號不同的內容,並設定發布時間:指定時間、佇列的下一個時段,或存成草稿。在需要核准的工作空間中,指定時間或佇列會改為送出審核,等有人核准後才會發布。
- 風險
- 中, 在一小時內發布時為「高」。
publish_post立即發布貼文
在貼文的所有帳號上發布,或只在發布失敗的帳號上重新發布。已經發布的內容絕不會重複發布。在需要核准的工作空間中,沒有人核准的貼文會遭到拒絕:請用 save_post 加上時間或佇列送出審核。
- 風險
- 高
delete_post刪除貼文
從 SPREVA 移除草稿、已排程的貼文或已發布的貼文。已發布的貼文仍會保留在社群平台上。
- 風險
- 中, 已發布的貼文為「高」。
import_media把檔案匯入媒體庫
從公開連結,或從代理程式上傳的位元組,把圖片或影片加入媒體庫。
- 風險
- 中
update_media為媒體庫檔案重新命名、加標籤、歸檔或加上描述
變更檔案的名稱、標籤、資料夾或替代文字,也能依圖片內容撰寫替代文字。
- 風險
- 中, 用 AI 撰寫替代文字時為「高」。
delete_media刪除媒體庫檔案
從媒體庫刪除一個或多個檔案(圖片、影片、音訊),會先提供預覽並要求確認,顯示每個檔案的使用位置與釋出的空間。尚未發布的貼文或 Studio 專案正在使用的檔案會被拒絕,除非代理程式強制刪除。
- 風險
- 高
save_campaign建立或編輯行銷活動
建立或變更行銷活動,並把貼文加入或移出。
- 風險
- 中
save_queue建立或編輯佇列
建立或變更發布時程:名稱、時區和每週時段。
- 風險
- 中
analytics貼文成效
與前一段期間比較的總計、表現最好的貼文、依社群平台的分布,以及附上樣本數的比較,範圍可以是工作空間、行銷活動、帳號或貼文。
- 風險
- 低
僅讀取refresh_metrics更新數字
不必等待平常的排程,立即向各網路讀取貼文的數字或帳號的追蹤人數,且不會更動原本的排程。同一則貼文或同一個帳號在五分鐘後可再次更新。
- 風險
- 低
list_clippers你的剪片創作者和他們的觀看次數
與你的剪片創作者計畫相連結的帳號,依一段期間內的觀看次數排序,附上每個帳號的社群平台、@handle 和連結,等待你決定的帳號會排在最前面。
- 風險
- 低
僅讀取clipper_posts單一剪片創作者帳號的貼文
已連結的帳號自加入以來發布的貼文,由新到舊,附上觀看次數、連結和日期。可以用帳號的名稱、@handle、連結或 id 指定。
- 風險
- 低
僅讀取clipper_calendar剪片創作者排程的貼文
你的剪片創作者在 SPREVA 為接下來幾天排程的貼文,以及透過 SPREVA 發布的貼文,由近到遠,附上帳號、社群平台,發布後也附上連結。直接在社群平台發布的貼文不會出現在這裡。
- 風險
- 低
僅讀取create_video建立 Studio 影片
以指定格式建立一個空白的 Studio 專案,再由代理程式製作。如果已有同名專案,會回覆該專案,而不會建立副本。
- 風險
- 中
需要包含 Studio 的方案narrate_video為 Studio 影片加上旁白
把代理程式寫好的腳本配上聲音,並把每個字放到時間軸上。會使用 AI 點數,每 100 個字元 1 點。
- 風險
- 高
需要包含 Studio 的方案compose_video用 Markdown 腳本建立 Studio 影片
用一份 Markdown 腳本建立完整的解說影片:寫下說了什麼,以及哪個字出現時畫面上有什麼。旁白會配上聲音,風格決定顏色、進場動畫、轉場與音效,鏡頭會推近剛出現的內容,並加上字幕與音樂。結果是一般可編輯的 Studio 專案。會使用 AI 點數,每 100 個旁白字元 1 點,並會先回覆預覽。用修改過的腳本重建專案時,只有旁白改變才會重新配音。
- 風險
- 高
需要包含 Studio 的方案match_media為腳本配對媒體庫檔案
針對腳本的每個段落,依檔案呈現的內容、上面的文字、裡面說的話和品質,列出最適合的媒體庫檔案,並附上影片中合適的片刻。不會變更任何內容,也不會花費任何點數。
- 風險
- 低
需要包含 Studio 的方案僅讀取find_sfx依用途尋找音效
依意圖、情緒與強度(而非檔名),為影片的某個時刻列出資料庫中最合適的三個音效,說明各自合適的原因,並把最溫和的排在最前面。當沒有合適的音效,或有人要求時,會用 Spreva 自己的合成器製作新的聲音,存入資料庫並列在最前面。不會花費 AI 點數。
- 風險
- 低
需要包含 Studio 的方案find_music依氛圍尋找音樂,讓每支影片有所不同
依氛圍、曲風、能量,以及墊在人聲下是否合適,而不是檔名,為影片列出媒體庫中最合適的三首音樂,並說明每首適合的原因。工作區近期影片用過的曲目會排在後面,專案已使用的曲目則會被排除,讓影片不會共用同一首音樂。尚未分類的曲目會排入分類佇列。不會變更任何內容,也不會花費任何點數。
- 風險
- 低
需要包含 Studio 的方案僅讀取find_icon依意義尋找圖示
依幾個英文單字(例如 phone、security 或 growth chart),列出最相符的 Lucide 圖示,附上標籤並把最相符的排在最前面,同時說明如何把圖示放進動態圖形:使用會自己描繪出來的 icon 區塊,或在原始場景中使用路徑節點。不會變更任何內容,也不會花費任何點數。
- 風險
- 低
需要包含 Studio 的方案僅讀取create_sfx建立音效
用 Spreva 自己的合成器,依幾個英文或葡萄牙文的詞,或代理為了完整掌控而撰寫的配方,製作新的音效。它會存放在資料庫的「Generated sounds」資料夾,並像其他音效一樣分類,因此可以被找到並放進影片。不會花費 AI 點數。
- 風險
- 中
需要包含 Studio 的方案score_video為 Studio 影片配樂
為影片量身創作純音樂:安靜的開場、逐步堆疊、剛好落在揭曉瞬間的 drop,以及收尾。它會以音樂身分存入素材庫,並作為背景音樂放在專案下方,在人聲出現時自動降低音量。會消耗 AI 點數(影片每 30 秒或不足 30 秒收 30 點),並會先回覆預覽。
- 風險
- 高
需要包含 Studio 的方案plan_edit規劃 Studio 影片的剪輯
讀取 Studio 影片(說了什麼、鏡頭和剪接點、已經有的內容)和媒體庫中已分類的音效,為這類影片挑選剪輯方式(理論、清單、新聞、教學、宣傳、Podcast、Vlog、故事、精華),並一次套用完整的剪輯,存成一個版本:每個剪接點都是直接切換或附音效的轉場,加上畫面風格、字幕、開場鉤子、在人聲下自動降低音量的音樂、推近鏡頭、文字和 B-roll。把圖片從背景中去背會使用 AI 點數,所以只會提議,絕不會直接套用。不使用 apply 時,它不會變更任何內容,只會說明計畫。
- 風險
- 低
需要包含 Studio 的方案find_moments在長影片中找出精彩片刻
逐句顯示長影片說了什麼和對應的時間、哪裡音量變大、畫面呈現什麼,以及它建議的短片,讓代理程式能選出值得剪出的段落。不會變更任何內容,也不會花費任何點數。
- 風險
- 低
需要包含 Studio 的方案read_transcript逐字閱讀檔案內容
像剪輯師一樣閱讀影片或音訊檔案的逐字稿:附有時間與說話者的語句、保留並標示出來的贅詞(嗯、呃),以及列出的靜音區段。可以同時讀取多個檔案來比較不同的拍攝版本,也可以把某段範圍逐字列出,並附上每個字的起訖時間。不會更改任何內容,也不會花費任何額度。
- 風險
- 低
需要包含 Studio 的方案僅讀取make_clips從長影片剪出短片
把你從長影片中選出的段落,剪成直式的短 Studio 專案,每個段落一個專案,並依說話內容加上字幕。每一個都是可以編輯和匯出的專案。
- 風險
- 中
需要包含 Studio 的方案clips_from_link從長影片的連結製作短片
接收長影片的連結(YouTube、Twitch、Kick、Vimeo、X、TikTok 或任何公開頁面),請使用者確認有權使用後,啟動一個批次:下載影片、讀取內容、找出最精彩的片段,並為每個片段建立一個直式 Studio 專案。會立即回覆批次的連結;用 fetch 可查看進度,完成後可看到每段短片的分數與原因。會使用轉錄分鐘數,也可能使用 AI 點數。
- 風險
- 高
需要包含 Studio 的方案edit_video變更 Studio 影片
用 Studio 本身的編輯操作,編輯文字、時間、剪接點、圖片、片段、特效和聲音,並新增元素。
- 風險
- 中
需要包含 Studio 的方案save_video重新命名或整理 Studio 專案
重新命名專案,以及(或)將它放進 Studio 資料夾,或移出資料夾;可一次整理多個專案。重新命名需要專案的修訂版本;只整理則不會更動影片。也可以把專案複製到你的另一個工作空間:其檔案會以唯讀方式共用,品牌字型也會一併加入。
- 風險
- 中
需要包含 Studio 的方案delete_video刪除 Studio 專案
在預覽與確認之後,刪除一個或多個 Studio 專案。從中匯出的檔案仍留在媒體庫。
- 風險
- 高
需要包含 Studio 的方案preview_video查看 Studio 影片的影格
依代理程式指定的時間點繪製影格,和匯出的結果完全相同,讓它能在匯出前確認哪些元素遮住了什麼。不會變更任何內容,也不會花費任何點數。
- 風險
- 低
需要包含 Studio 的方案僅讀取inspect_media查看原始檔案的一段
將上傳的影片或音訊檔案中的一段畫成一張圖:等距的畫面、標示出停頓的聲音波形,以及在說出位置標上的字詞。不會變更任何內容,也不會消耗任何額度。
- 風險
- 低
需要包含 Studio 的方案僅讀取compare_video比較 Studio 影片的兩個版本
列出專案兩個版本之間的差異:新增、移除或變更的每個元素,以及其中變更了什麼。它也能顯示兩個版本在同一時間點的畫面。不會變更任何內容。
- 風險
- 低
需要包含 Studio 的方案僅讀取restore_video還原 Studio 影片的版本
把專案還原到它的某個版本。結果會存成新版本,所以還原也能復原。
- 風險
- 中
需要包含 Studio 的方案review_video檢查 Studio 影片
用 Studio 內建 AI 編輯器檢查自己作品的方式檢查專案,並由最嚴重的開始列出要修正的地方。它會標示匯出時會自動修正的項目。
- 風險
- 低
需要包含 Studio 的方案僅讀取render_video匯出 Studio 影片
把專案匯出成媒體庫中的 MP4 或 PNG,可直接用於貼文。它會先自動把專案提升到品質底線(字幕、開場鉤子、人聲下的音樂、在上限內的轉場),並把結果存成名為「Quality pass」的版本;你手動製作的內容絕不會被更動。
- 風險
- 高
需要包含 Studio 的方案generate_image生成圖片
依描述製作新圖片,有要求時會套用工作空間的某種風格。會使用 10 點 AI 點數。如果要求的是媒體庫中已經有的圖片,會先列出那些圖片,不花費任何點數。
- 風險
- 高
需要包含 Studio 的方案mascot選擇吉祥物
讀取或設定工作區的吉祥物:一個會說話、眨眼並擺姿勢的動態 SVG 主持人。免費,不使用 AI 點數。可選內建吉祥物、用品牌色上色,或使用自己的圖稿。
- 風險
- 中
需要包含 Studio 的方案use_skill讀取工作空間的剪輯技能
列出工作空間的剪輯技能(創作者的做法:一種風格、一種節奏、一套流程),或完整讀取其中一項,讓代理在製作或剪輯影片時照著做。
- 風險
- 低
需要包含 Studio 的方案僅讀取save_skill儲存剪輯技能
建立、變更、從 SKILL.md 匯入或刪除工作空間的剪輯技能。它的說明決定何時使用。
- 風險
- 中
需要包含 Studio 的方案
一般流程
代理程式會先用 overview 取得時區、目前時間和帳號,用 search 找到項目,用 fetch 完整讀取某個項目,再用 save_post 或其他工具進行變更。每個回覆都會說明下一步可以做什麼。
用名稱,不用 ID
工具接受人會說的話:確切的檔名、@帳號名稱、行銷活動的名稱,或 SPREVA 中任何項目的連結(從瀏覽器或先前的回覆貼上)。搜尋很寬鬆,變更則不然:符合多個項目的名稱會回傳選項,在選定其中一個之前,不會儲存任何內容。
給代理程式的參考資料
代理程式需要時,會用 fetch 讀取 SPREVA 的參考資料,而不是在每次呼叫時都帶著它:
spreva://docs/platforms/tiktok,每個社群平台各一頁:它接受的內容、長度和選項。spreva://docs/queues:時間、時區和佇列。spreva://docs/agent-permissions:風險等級、確認、修訂版本和請求 ID。spreva://docs/studio/making和spreva://docs/studio/editing:製作影片,僅限 SPREVA。