Activepieces0.93.0納入MCP OAuth2與代理工具：登入、保留欄位與PDF填表怎麼接？
Activepieces0.93.0納入MCP OAuth2、按需工具與PDF填表。理解自動探索的相容條件、未指定欄位如何保留、模型金鑰範圍與Latin字元限制。
想讓代理替你處理文件或更新業務資料，常卡在工具還沒完成登入，或一次更新連沒交代的設定也一起改掉。連得上之外，輸入還要能精確表達哪些欄位該動。
Activepieces0.93.0在2026年11月8日釋出，集中納入MCP客戶端OAuth2、適合代理使用的工具動作，以及多項輸入與執行修正。這些改動包含先前數週已合併的開發。
Activepieces把外部服務的動作包成pieces，讓它們接進自動化流程或由代理呼叫。新增的OAuth2路徑會探索伺服器資訊，減少使用者手動尋找登入端點的工作。
工具數量增加後，系統也改用按需載入的技能與輸入結構，避免每輪都把所有工具定義交給模型。模型選擇則連同可用金鑰與專案範圍顯示。
這版還提供PDF表單檢查與填寫，但字元與表單格式仍有限制。對台灣使用者而言，能填英文表格，不等於可以直接處理繁體中文姓名。
我認為這版適合已用Activepieces串流程、想讓代理接手具體工具工作的人研究。重點是連線、欄位與結果能否對上，而不是把新增連接器數量當成完成工作的保證。
先從OAuth2如何減少手填資料開始，才能看清工具真正可用前需要哪些條件。
Activepieces0.93.0如何連到OAuth2 MCP伺服器？
新的連線路徑會讀取伺服器公布的資訊並登記客戶端，缺少相容條件時仍要手動設定。
MCP讓代理以共同格式探索與呼叫工具，但伺服器要求使用者登入時，客戶端還得知道登入位置、取得授權及交換憑證的方式。OAuth2處理的就是這條授權路徑。
這次實作會探索受保護資源的資訊，再取得授權伺服器資料，接著嘗試動態登記客戶端。對應的標準分別是RFC9728、RFC8414與RFC7591。
這些步驟能把原本要人工查文件的端點帶進連線流程。使用者仍會經過登入與同意畫面，並不是貼上MCP網址後，平台就取得服務內所有帳號的存取權。
若既有連線已有授權網址，就先使用該設定。否則才依探索結果繼續，最後開啟授權視窗並保存連線。這讓既有人工設定和新探索路徑可以並存。
不過，目前支援的是持有客戶端密鑰的機密型客戶端。沒有密鑰的公開型客戶端尚未支援，所以相容標準相同，也可能因登記方式不同而無法直接接通。
若對方沒有公布必要資訊，或不提供動態登記，仍要填寫相容的客戶端資料。自動探索減少的是設定工作，沒有消除外部服務本身的支援條件。
授權流程使用PKCE的S256方式，讓取得授權碼和交換憑證的步驟彼此綁定。對自架者而言，連線問題因此需要分成端點探索、客戶端登記和使用者同意來看。
另外，重新連線可能建立新客戶端，舊的登記不一定隨之清除。若MCP位在私有網路，還要另外處理AP_SSRF_ALLOW_LIST允許清單，登入成功不代表網路已可達。
連線成立後，代理還得找到正確工具，而不是每輪接收全部功能定義。
工具按需載入，如何維持穩定的對話起點？
聊天與儲存代理把主要工具清單保持固定，其他功能透過技能和工具結構再取用。
過去若把每個外部動作的說明與欄位都塞進提示，連一個簡單問題也要帶上大量工具資料。工具愈多，模型每輪要讀的前置內容就可能愈長。
這次改動讓聊天與已儲存的代理保留最多16個核心工具。其他能力以技能方式提供，再由代理載入所需技能、取得特定工具的輸入結構，並於執行前檢查資料。
因此，16代表這段固定核心清單的上限，不能解讀成整個平台只能連接16項工具。流程步驟中的代理和流程建構器，也沒有一律改用相同路徑。
固定前段的另一個用途，是讓可重用的提示起點較穩定。模型服務若支援提示快取，就比較有機會重用同一段內容。官方沒有提供所有模型通用的省費百分比。
按需載入也多了一個步驟。代理必須先辨認要用哪種技能，再讀正確工具的欄位，才有機會產生可執行輸入。因此，工具名稱與欄位說明仍會影響結果。
輸入檢查能抓出結構不合的要求，卻不會自動判斷業務意圖。像是要更新哪個客戶、保留哪個設定，仍需要能對照原始資料的指令和工具設計。
工具定義能載入後，該使用哪個模型與金鑰，也必須跟專案權限一致。
模型選單怎麼把方案、點數與自帶金鑰放在一起？
共用選單列出專案實際能執行的選項，並顯示模型來源與備援順序。
新版把方案可用模型、平台點數與自帶金鑰放進同一套選擇方式。使用者比較時，能先看這次呼叫會從哪個來源執行，而不是只看到相同模型名稱。
這個選單也會依使用位置過濾能力。聊天與代理需要工具呼叫支援，因此不適用的模型會隱藏，避免選上之後才發現無法接續外部動作。
專案範圍同樣會影響可用項目。某個專案設定了金鑰，不代表其他專案也能借用。備援選項也要符合這次執行所在的範圍，不能只追求清單上還有替代品。
若原選項已不可用，介面會呈現不可用狀態，沒有悄悄換到另一個模型。這對比較代理結果很重要，否則同一份流程可能在使用者沒注意時改變執行來源。
金鑰的固定關聯會在建立或儲存時寫入，既有項目不會只因升級就全部補上。因此，老流程的選擇行為，要和新建流程分開確認，不能只看新版選單外觀。
此外，AI中心的方案門檻與共用選單不是同一件事。某個管理頁需要Plus，不能直接推成社群版所有共用模型選擇端點都被停用。
這版沒有替所有模型服務訂出共同費率。用平台點數、自帶金鑰或方案額度執行，費用來源不同，應依實際帳戶和供應者條件判斷。
模型能執行只是條件之一，送到外部服務的欄位還要保留使用者沒要求更動的設定。
為什麼沒有填的欄位，應該和否分開？
這版修正多個代理更新動作，把保持原狀、是與否分成不同輸入，避免省略值變成關閉。
以GitHub儲存庫設定為例，使用者可能只要求改描述，沒有交代要不要公開儲存庫。如果可選的布林欄位把沒填當成否，就可能把另一項設定也一起改掉。
新的做法在相關動作提供「是」、「否」與「保持不變」的區別。只有明確指定的欄位才送出更新，讓缺少輸入和刻意關閉不再共用同一個意思。
這類修正涵蓋儲存庫公開性、Issues與封存狀態等操作，但不能據此宣稱所有舊版輸入都已自動遷移。既有流程仍要依實際使用的piece與動作版本來看。
其他服務也有相近問題。Zoom只改會議時間時，不應連等候室設定一起重設。Notion的核取方塊與語言、Discord角色的顯示與提及設定，也有保留原值的修正。
對代理來說，這比新增幾個操作更直接影響可信度。當使用者只說要改某一欄，工具若能表達其餘欄位不動，模型就不必猜測沒被交代的部分。
不過，「保持不變」只處理這次請求省略的欄位，沒有替代理確認目標選對了。更新錯誤儲存庫或文件，仍可能是結構正確、對象錯誤的操作。
因此，設計一段業務工作時，可以先從只更新一個欄位開始，對照外部服務原有設定是否保留。這是在確認該動作的具體語意，不是要求所有工具都重做同一套測試。
資料更新需要精確欄位，PDF填表則把同樣問題帶到文件上的格子。
PDF表單檢查與填寫，哪些格式可以接？
先檢查欄位再填寫，可以提早發現不相容資料，但目前只支援可處理的表單與Latin字元。
先讀欄位，再決定輸入
檢查動作會讀出表單欄位的種類、標籤、型別、選項與現有值，也能提供空白資料結構。代理因此可以先知道哪些是文字、選項或勾選欄位，再決定要送什麼內容。
填寫時可以逐欄輸入，也可以提供Data JSON。同時提供時，JSON會覆蓋逐欄設定。若欄位超過200個，使用JSON也比在介面中逐一填寫更合適。
系統會先檢查整份輸入，再開始寫入。欄位不存在、值太長、選項不符、唯讀欄位或文字無法放入等問題，會集中回報，避免只成功寫一部分而不容易察覺。
成功後會產生新的PDF下載連結。預設的扁平化會把填入內容固定在文件上，適合交付成品。若後續還要編輯表單，就需要理解這個選項的影響。
空白資料結構也提供另一個用途。把它和現有值分開看，代理才知道自己是在準備新的填寫資料，還是在延續已經填過的文件，不必靠欄位顯示位置猜測。
字元與文件格式的限制
目前標準Helvetica字型的寫入路徑只處理Latin字元。遇到不支援的文字會報錯，而非默默丟掉字元。因此，繁體中文姓名與地址不能直接當成已支援的使用案例。
它處理的是PDF內既有的可填欄位，也不是辨識掃描影像上的空格。純影像、已扁平化文件或單獨的XFA表單，都不能直接套用相同流程。
部分帶有AcroForm欄位、且XFA標籤能對上的混合文件可以處理，但這不等於支援所有XFA格式。先檢查欄位，才知道文件是否落在這次工具的範圍內。
文件能生成後，使用條件還要回到部署版本、piece版本與實際費用來源。
自架升級與工具費用，怎麼看整套流程？
平台版本不等於所有工具費用，發行說明也要求自架者另外核對不相容變更。
這次釋出收進大量累積改動，其中個別PR在更早時間已合併。看到0.93.0的日期，應理解為這個版本的釋出時間，而非每項能力都在同一天首次完成。
提供代管的平台也可能有自己的更新排程。分享同版消息的PikaPods原貼說明是即將提供，不能拿平台發版直接推成每個代管帳戶已經可用。
若工作重點是英文PDF資料填入，可以先用檢查結果挑出可填文件。若重點是代理更新服務設定，則先確認欄位保留與連線授權，比比較整頁新增功能更有幫助。
這兩類工作都需要模型、連線與外部服務共同完成。平台本身能編排流程，沒有保證模型一定選對資料，也沒有把其他服務的訂閱或呼叫成本一併取消。
延伸閱讀：Hermes 提供 Grok Bot 遷移入口：搬設定之前，模型帳務與工具權限怎麼確認？
延伸閱讀：永別了 n8n！Anthropic Managed Agents 實作教學：一句話打造雲端全自動 AI 員工
Activepieces0.93.0常見問題 FAQ
代理最多只能使用16個工具嗎？
16是聊天與儲存代理的固定核心工具上限，其他工具能按需載入。它不是整個平台的連接器總數，也不代表所有流程步驟代理都採相同方式。
新PDF工具可以直接填繁體中文嗎？
目前寫入路徑只支援Latin字元，不支援的文字會報錯。可填AcroForm欄位與中文字型是兩種條件，不能只因檢查得到欄位，就視為中文內容也能填入。
PikaPods帳戶已經可以使用新版嗎？
分享同版消息的原貼說明是即將提供。Activepieces釋出0.93.0和代管平台完成部署是不同時間，應依代管帳戶實際提供的版本確認。
結論
Activepieces0.93.0值得看的，是工具從登入、被選中，到精確更新欄位的整段路徑。新增PDF工具則提供具體落點，也清楚劃出目前文字與文件格式的限制。
已有流程的使用者，可以選一個相容MCP連線，加上一項只修改指定欄位的動作來比較。若目標是繁體中文PDF，應先確認字型與格式是否支援，再決定是否採用這條填表路徑。
