香港
AI Agent 實戰框架:由提示詞走到可運行代理

AI Agent 實戰框架:由提示詞走到可運行代理

把提示詞變成可運行的代理,次序比工具重要:先寫清楚場景與完成標準,再把需要的權限與審批點列成清單,然後用真實任務小範圍試跑,最後才談復用與擴展。這篇用一個實戰框架講清楚 ai agent development 的四步操作,每一步都說明完成後應該看到什麼,讓你在動手之前就知道怎樣判斷它是否真的可用。

重點摘要

  • 代理與一般自動化的分別,在於它能否連上你正在用的系統,並在越權之前停下來。
  • 每一步都要有一個看得見的完成結果,否則這一步等於沒有做。
  • 審批與權限要在配置階段就寫成清單,不是出事之後才補。
  • 成效用自己團隊的試運行記錄衡量,不用別人的百分比。

這個框架適合誰,開工前要準備什麼

要我指出第一次做代理最容易走歪的地方,我會說是「一開始就想要全部自動」。比較穩的做法,是先挑一條高頻、輸入與輸出都說得清楚的流程,把它當成第一個試點。

適合的情況包括市場推廣與內容團隊把重複的報告和素材交出去,電商團隊把商品資料與客服查詢接起來,營運團隊把跨系統的核對收攏到同一段對話,客服與財務則把固定的查詢與對賬前置處理。共同點是流程重複、資料拿得到、結果可以驗收。反過來,目標說不清、又找不到核對人的工作,先不要碰。這也是 ai 工作流程自動化 通常由一條流程開始、而不是一次改造整個部門的原因。

先分清三個層級,再決定要準備什麼

原文用一個吃飯的比喻,把市場上的代理分成三層。這個分法到今天仍然好用:三層的分別不在模型強弱,而在你願意把多少工作交出去、又保留多少控制。

層級誰在做常見形式團隊要先準備
done-by-you你自己直接對着模型寫提示詞,資料自己上載清楚的問題與可重複的提示詞
done-with-you你與工具平台預先寫好指示與知識的迷你應用、低代碼流程系統連接、指示與審核點
done-for-you由服務方承接由目標出發、自行連接多個系統的完整流程驗收標準、權限邊界與接手人

原文在 2025 年 11 月 25 日刊出時,把三層寫成 done-by-you、done-with-you、done-for-you。名稱可以不同,判斷標準一樣:越往下走,你做得越少、付得越多,對驗收與權限的要求也越高。

一個人手持清單站在三級階梯前,近處自己動手,中段與人協作,遠處工作交給他人。

開工前要備好的東西

在寫第一句提示詞之前,先把以下幾項放到桌上,缺一項就先補:

  • 一個寫得成一句話的業務任務,以及它現在的產出格式
  • 相關系統的帳戶,與明確的讀取、寫入權限範圍
  • 一個審批入口與具名的批准人,用來處理花費、對外發送與關鍵變更
  • 成果存放的位置,讓下一次任務可以直接取用
  • 現狀基線:目前處理一件要多久、錯誤與返工通常出現在哪裡

這份清單同時是第一步的輸入。工具與平台可以後補,權限與負責人不能後補;沒有批准人,後面的審批設計就沒有落點。

逐步操作:四步與每步的完成結果

四步的次序有因果關係:場景定得清楚,權限才列得準;權限列得準,試運行才知道要記錄什麼;試運行有記錄,復用與擴展才有依據。這條 ai 流程 自動化 的路徑寫成一張清單如下,每一步都附上完成後應該看到的結果。

  1. 選場景,寫成一頁場景定義。把目標寫成一句話,列出輸入資料與輸出格式,指定負責人與核對人,並記下現狀基線。完成後應該看到一頁寫得完的定義;目標、輸入、負責人任何一項說不清,就退回重選。
  2. 接入與配置,列出權限清單與動作分級。核對服務與項目權限,設定審批規則,指定發布職責。完成後應該看到代理讀到正確的項目,需要審批的動作停在待批狀態,而且有一次被拒絕的測試記錄可以翻出來。
  3. 小範圍試運行,用真實任務跑一小批。逐筆記下人工修訂的位置與原因,不要用演示資料代替。完成後應該看到完成率、單件用時、返工次數與原因,以及人工介入的具體位置。
  4. 交付與迭代,把有效的規則、提示與模板沉澱下來,再增加能力與使用者。完成後應該看到交接文件、復用率,以及下一輪只改一兩項的清單。

第一步:把提示詞寫成可重複的輸入

場景定義寫得出來,才算是開始。目標、輸入、負責人三格之中有一格空着,後面的配置就會靠猜。原文給了幾條提示詞習慣,值得在第一步就用上。在提示詞結尾加一句「每次只問我一個問題,直到你掌握完成任務所需的資料」,逼模型先問清楚再動手,結果會比它直接交一份通用答案貼近得多。對話結尾再要求它把整段對話整理成下一次可用的系統指示,下次就不必從零開始。要求多個選項而不是單一答案,則讓你在幾個方向之間比較,而不是把判斷整份外判。

這幾條合起來做一件事:把一次性的對話,變成可以重複使用的輸入。它同時是場景定義的原料,也是第二步寫指示時的起點。

第二步:審批與權限要落到清單

接入時最容易含糊的是權限。把動作分成幾級,逐級寫明預設處理,比寫一句「會有人審批」有用。

動作例子預設處理
只讀讀取指標、渠道數據、知識文件可直接執行
產出生成報告、草稿、頁面、圖片可直接執行,預設以草稿交付
對外發送發訊息給客戶、發布貼文人工批准或預先授權
花費與預算投放、採購逐次批准
訂單與關鍵變更改價格、改交付範圍批准並另核權限與範圍
未納入範圍自動發布代理不得自行執行

清單要與實際系統對得上,它既是配置依據,也是日後驗收的證據。原文提到的 Opal 是一個合適的對照:它在 2025 年 7 月由 Google Labs 推出,只在 Google 生態內連接,當時免費,適合純內部的工作流;opal.google 已在 2026 年 11 月 17 日停止服務,功能併入 Gemini 的 skills。工具會退場,寫成指示與清單的部分留得下來。Anthropic 在 2025 年 12 月 18 日把 Agent Skills 發布為開放標準,同一份技能可以在不同產品之間帶走,方向一致:把能力寫成可攜帶的文件,而不是綁死在某個介面。

第三步:試運行用真實任務

試運行的目的,是找出系統在哪裡需要人。用真實任務跑一小批,逐筆記錄人工修訂,樣本再小也要包含一個曾經出錯的個案。完成後應該看到完成率、單件用時、返工次數與原因、人工介入率與介入點,以及一份事先約定的樣本、評分規則與通過門檻。沒有這份約定,之後就會變成各自解讀。

第四步:交付、復用與擴展

把有效的規則、提示與模板沉澱下來,再增加能力與使用者。完成後應該看到交接文件、復用率,以及連續幾個週期的穩定性。發布新版本不會自動升級所有已部署的代理,發布狀態與驗收狀態要分開確認;Plugin 一類的節點級擴展,安裝或升級可能重啟節點並影響其他代理,安排在低峰時段做。

幾位同事圍在桌旁,把整理好的資料夾與模板交到接手的人手上,時鐘顯示離峰時段。

常見錯誤與排查方法

把自動化當成全自動

最常見的誤解,是以為 done-for-you 等於無人看管。落地的界線是:重要動作要有批准點,未納入範圍的自動發布不由代理自行執行。排查方法很簡單,把每一個會影響外部或花費的步驟圈出來,問一句「這一步錯了,誰會知道、誰會停下來」。答不出來,就補審批點。我的判斷是,ai agent development 這一步最容易被當成可以後補的環節,代價通常要到上線之後才浮現。

用演示資料代替真實任務

演示資料跑得順,真實任務一上就露出問題,因為真實資料有缺漏、有例外、有沒人維護的欄位。試運行必須用真實任務,樣本可以小,但要包含至少一個曾經出錯的個案。

權限一次開到最大

為了省事把權限開到最大,等於把風險留在系統裡。按清單逐項開,並保留一次拒絕測試;被拒絕的記錄比批准的記錄更能說明邊界有效。

只驗功能,不驗例外

功能清單可以全部打勾,例外卻沒有人處理。配置時就要寫明失敗路徑:重試、提示、轉交人工。試運行時主動製造一次失敗,看它停在哪裡、誰收到通知。

把能力目錄的條目數當成成品數

平台的能力目錄會列出很多條目,當中有底層輔助能力,也有尚未完成業務驗收的部分。數字反映的是可選範圍,不是已交付的成品。選能力時看它有沒有說明、有沒有對應的驗收方式,而不是看總數。

如何驗證成效

成效要按流程的幾個可觀察指標對比基線,不看代理回答得多漂亮。以下幾類流程的指標可以直接套用,前提是數據來自自己團隊的試運行記錄。

流程可觀察指標
報告與分析整理與複核時間、數字一致性、報告返工原因
客戶查詢與跟進首次處理時間、資料完整度、逾期跟進比例
商品內容與協作製作與修訂時間、審核通過率、資料錯漏

衡量的是流程改善,不是商機轉化或收入增長的承諾。連續幾個週期的完成率與返工原因穩定,才算是站穩;一次跑得好,只能說明這次的樣本簡單。要做 ai 工作流程自動化,先把這張表填成自己的版本,再談擴大範圍。

今日就可以自己跑的檢查

  • 場景能否用一句話寫清,並指出誰是最終使用者
  • 系統帳戶與讀寫權限是否逐項列出,而不是一個管理員帳號通行
  • 需要審批的動作,是否真的停在待批狀態,並留下一次拒絕記錄
  • 試運行的樣本、評分規則與通過門檻,是否在開跑前寫好
  • 交接文件是否包含代碼或配置、接口說明與培訓記錄

Topkee 的觀點:把審批邊界與驗收寫進交付

Topkee 的 AI Agent 定製開發,把代理當成一個要交付的系統,而不是一段示範。它的四項設計原則,正好對應本文四步裡最容易漏掉的部分:資料有來源,指標必須來自檔案或接口,不能補造未知數;執行有權限,明確可讀的資料與可執行的動作,對外發送、預算等涉及資金或訂單的變更依約定審批或預先授權;成果可驗收,樣本與評分規則、通過門檻都先約定好;交付可接手,交付代碼、代理配置、接口與部署說明,並完成培訓。

在產品體系裡,定製 AI 代理屬於應用開發,定位是為業務需要構建與部署代理應用。人工審批與權限邊界的做法是:重要業務動作透過 Approvals 批准或拒絕待執行步驟,運行記錄與任務清單、證據相關聯,運行身分使用短期租戶 JWT 並自動刷新。上線驗收與落地方法則把工作分成四階段:評估與設計、開發與試點、驗收與上線、持續改進;正式啟用前再核對目錄與依賴、業務服務、運行環境、發布職責四項,並默認以草稿交付,不承諾無條件自動發布。

對準備起步的團隊,這個組合的意義是:第一步不必買齊所有能力,但要把權限清單、審批點與驗收標準一併寫進交付範圍。少了這三樣,後面的試運行只會得到一堆無法比較的結果。

一位同事在白板上圈出其中一條流程,旁邊貼着目標、輸入與負責人便條,眾人準備開始試跑。

下一步:由一條流程開始

如果團隊正卡在「知道要做,但不知道從哪裡開始」,先選一條流程做場景啟動:把目標、輸入、負責人與基線寫成一頁,然後按本文四步走一遍。想先看平台怎樣把配置與交付記錄接起來,可以讀 Weber 平台更新日誌;要理解由投放、內容到自動化的整體位置,可以看 Topkee Cloud 的介紹。需要人幫忙落地時,就由 ai 流程 自動化 的服務範圍開始核對自己的場景。

常見問題

agentic AI 與一般自動化有什麼分別?

一般自動化按固定規則執行,遇到沒寫過的例外就停。代理多了一層判斷與工具調用,可以在授權範圍內選步驟、取資料、交草稿。差別落在它可以處理沒有預先寫死的路徑,代價是必須有權限邊界與審批點。

一定要做到 done-for-you 才算成功嗎?

不必。多數團隊先從 done-with-you 起步,把提示詞、知識與審核點固定下來,再逐步把流程交出去。層級是按需要選的,不是成熟度的排名。

審批會不會拖慢流程?

會拖慢需要批准的動作,這正是它的作用。做法是把只讀與產出的動作設為直接執行,只把對外發送、花費與關鍵變更留給批准,讓大部分時間花在不需要等人回覆的部分。

試運行要跑多久才算夠?

看樣本與返工原因是否穩定,而不是看日曆。同一類任務連續幾個週期的完成率與返工原因不再大幅變動,就可以進入復用;若每次出錯的原因都不同,樣本還不夠。

沒有技術團隊可以做嗎?

可以做到 done-with-you 的階段,前提是有人願意負責場景與權限、也有人負責驗收。涉及系統對接與部署、審批規則的部分,仍需要工程或服務方的參與;把這部分寫進交付範圍,比事後補救省事。

Sources

  1. "Setting the Stage for Agentic AI: A Practical Framework", Social Media Examiner, 2025-11-25. https://www.socialmediaexaminer.com/setting-the-stage-for-agentic-ai-a-practical-framework/
  2. "Introducing Agent Skills", Anthropic, 2025-12-18. https://www.claude.com/blog/skills
分享到:
日期: 2026-11-21
Terry Wong

作者

Terry Wong

Website Production Manager