跳至主要內容

參考資料

工具

代理程式可以呼叫的工具。SPREVA 列出 49 個工具,其中 Studio 和 AI 圖片的工具需要包含 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 專案正在使用的檔案會被拒絕,除非代理程式強制刪除。

    風險
    高
  • share_media

    與其他工作空間共用檔案或資料夾

    把媒體庫的檔案或整個資料夾以唯讀參照借給你的其他工作空間:不會複製任何內容,對方可在影片與貼文中使用,但不能修改或刪除。收回時,若那邊的影片或貼文正在使用,會先要求確認。

    風險
    中, 收回其他工作空間的影片或貼文正在使用的檔案時為高。
  • 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 的方案
  • 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。