LangSmith 新增敏感資料權限控制:輸入輸出、使用者群組與 Trace 政策怎麼搭配?
LangSmith 敏感資料管理面臨一個常見衝突。工程師需要看 AI 代理哪裡變慢、哪項工具反覆失敗,但正式執行紀錄也可能帶著客戶姓名、醫療資料或付款內容,不能讓每個除錯的人都看到全文。了解功能開放條件、操作範圍與團隊試行方法,依官方公告釐清適用情境。
LangSmith 敏感資料管理面臨一個常見衝突。工程師需要看 AI 代理哪裡變慢、哪項工具反覆失敗,但正式執行紀錄也可能帶著客戶姓名、醫療資料或付款內容,不能讓每個除錯的人都看到全文。
有些團隊因此複製紀錄、拆成多個工作區,或乾脆不記錄正式環境行為。前者增加維護成本,後者卻讓工程師失去問題發生時的線索,兩種方式都會拖慢改善。
LangChain 在 2026 年 11 月 17 日宣布,LangSmith Enterprise 新增輸入輸出存取、使用者群組與依紀錄屬性設定政策的控制。工程師可以看執行樹、延遲與成本,敏感對話內容則另外授權。
這項改變處理的是「誰能看」,而非「資料有沒有上傳」。官方明確說明,完整紀錄仍送進並保存在 LangSmith,再依權限決定各團隊能看到哪些部分。
已經把正式環境追蹤送進 LangSmith 的企業,可以評估用這些控制減少不必要的內容曝光。若要求敏感文字根本不進平台,仍要先處理收集和傳輸,單靠介面隱藏無法達成。
要設計可維護的權限,先要分清整段紀錄、輸入輸出內容,以及用來判斷客戶身分的屬性。
LangSmith 敏感資料控制改變哪一層可見性?
新的輸入輸出權限,讓看得到代理行為的人不必同時看得到完整對話。Trace 是代理完成一項工作留下的執行紀錄,通常包含模型請求、工具呼叫、耗時,以及各步驟傳入和傳出的內容。
依 LangChain 官方公告,工程師可以查看執行樹、延遲、用量與其他追蹤資訊,而輸入輸出內容另受限制。執行樹指的是工作步驟與彼此關係,能幫忙找出哪個環節反覆重試。
這對日常除錯很實用。例如工具查詢變慢,工程師可能只需要知道呼叫哪個工具、等了多久與是否成功,不一定需要看到客戶姓名、完整病歷描述或付款資訊。
但若問題是模型誤解了客戶需求,負責處理的人可能確實要查看內容。這次設計讓團隊能依工作需要開放,而不是讓所有能看技術指標的人,順帶取得每一段正式對話。
限制閱覽與刪掉資料,有何差別?
官方明確說明,完整資料仍會送到並保存在平台。新控制決定各團隊能看哪些部分,因此它處理的是閱覽權限,並不是把敏感內容在上傳前移除。
如果公司要求某類資料根本不能送進外部平台,就要在收集與傳輸之前處理。不能因為一般工程師畫面上看不見內容,就推論平台沒有保存,或資料已被匿名化。
這也改變了權限討論的方式。團隊可以同時保留除錯所需訊號與限制內容曝光,但仍需清楚知道資料流向,避免把存取控制當成不需管理保留與刪除的理由。
官方舉出醫療和付款資訊,是說明可能出現在追蹤內容的敏感資料種類。這不等於啟用功能後就自動取得特定產業的合規資格,實際要求仍與資料、契約和部署方式有關。
內容可見性分開後,還要決定哪些人因工作需要取得哪一種權限。

群組與既有角色權限怎麼一起作用?
使用者群組把授權單位對齊團隊,但仍建立在既有角色和屬性政策之上。與其逐一修改每個人的設定,管理者可以把有相同工作需求的人放進群組,依工作區設定可見內容。
角色權限常簡稱 RBAC,就是依職務角色給一組能力,例如能不能閱讀或管理某個工作區。它容易管理,但如果同一個角色的人負責不同客戶,單靠角色可能還不夠細。
屬性權限常簡稱 ABAC,則依資源的特徵判斷能否存取。例如紀錄屬於哪個客戶、哪個應用程式或哪個環境,符合條件的人才能讀取,讓同一工作區內也能進一步分隔。
群組是否會蓋掉既有地區限制?
官方公告說明,新群組政策保留既有的限制。若員工原本因地區或資料處理安排不能看某些紀錄,不應因為加入另一個團隊群組,就推論限制已自動解除。
官方 ABAC 文件也指出,拒絕政策優先於允許政策。當同一筆資源同時符合允許和拒絕條件,結果會是拒絕,因此管理者不能只看某一條允許規則就判斷最後可見性。
如果角色原本就有讀取全部追蹤的權限,只加上允許特定客戶的政策,不會縮小原本範圍。要限定允許清單,需移除角色既有的完整讀取權限,或設計適當的拒絕政策,再用測試身分確認結果。
文件把同一組內的條件以同時成立處理,不同條件組之間則可任一成立。這些組合會影響授權範圍,所以複製政策時要確認結構,避免把原本「同時符合客戶與環境」改成「符合其中之一」。
對一般導入團隊,不一定需要先寫很複雜的政策。比較容易維護的起點,是列出工程、客服與內容註記人員各自需要的資料,再把同一需求對應到群組。
例如工程團隊先看步驟與耗時,客服只看自己服務客戶的輸入輸出,需要做內容評註的人則取得指定資料。這是官方情境延伸的設計示例,實際分工仍應依公司工作內容設定。
團隊層級處理完畢,同一個工作區內不同客戶的紀錄還需要更細的條件。
依 Root Run Metadata 限制客戶紀錄,關鍵在哪?
紀錄層級政策依賴最上層執行紀錄的屬性,因此資料標記的來源本身就是權限設計的一部分。Root Run 是一整段追蹤最上層的工作,Metadata 則是附在該工作上的結構化描述。
把兩者合起來,可以理解成整項任務的客戶編號、使用者編號或環境標記。政策依這些欄位決定誰能看該段追蹤,而不是從模型回答裡猜測它屬於哪個客戶。
官方舉例,客服可以只看自己負責客戶的紀錄,開發者也能只看屬於自己程式代理的紀錄。這讓權限能跟著任務分流,而不必為每個客戶都另外複製一套追蹤資料。
為什麼標記應由可信程式產生?
如果客戶編號可以由未驗證的輸入任意填寫,權限條件即使寫得正確,也可能套到錯誤對象。因此應用程式應依已登入身分與實際業務資料產生標記,而不是直接相信使用者提供的任意字串。
這是從政策依賴屬性所推導的部署建議,並非官方宣稱平台會替每個應用程式驗證業務身分。平台負責按條件判斷,資料來源是否可信仍是接入時要處理的責任。
標記位置也不能混淆。文件要求的是最上層執行紀錄屬性,不能只在某個子工具步驟加上一樣的欄位,就預設整段追蹤會按相同方式授權。
官方文件也明確指出,最上層執行紀錄的屬性在入庫後不能追加或修改來符合政策。因此客戶編號應在送入平台前就正確設定,不能把漏標資料留到事後才補。
如果資料管線有重試、批次匯入或不同語言的接入方式,也需要確認標記沒有在中途遺失。否則正常新資料可能符合政策,舊紀錄或另一個服務送來的資料卻得到不同結果。
對缺少標記的情境,團隊應先定義預期可見性,再以測試資料驗證。不能只測「欄位都有填」的正常路徑,因為實際權限問題常出現在漏填、錯填或名稱不一致。
當條件能正確分流紀錄,才能檢查完整內容仍留在平台造成的治理責任。
隱藏內容不等於停止收集,導入怎麼驗收?
存取控制減少的是不必要的閱覽,資料保留、傳輸與刪除仍需分別管理。這次公告的三種控制可以疊加使用,但不應讓它們掩蓋完整追蹤資料仍保存在平台的事實。
採用前可以先整理一份資料流向圖,列出應用程式送哪些內容、哪個工作區接收、哪些角色能看,以及資料何時刪除。這比只看控制台是否出現新開關,更能說明是否符合需求。
怎麼測試「不能看」的情境?
準備兩個測試客戶與不同團隊身分,讓它們產生結構相同、內容可辨認的測試追蹤。工程身分應能看到允許的執行資訊,卻不應看到原本限制的輸入輸出,客服則只看自己負責的客戶。
接著測試直接開啟另一筆紀錄、切換群組或修改政策後的結果。若平常介面隱藏了內容,但其他授權入口仍能取得,就需要重新釐清政策的實際保護範圍,不能只依單一畫面下結論。
這些是驗收建議,不是本文已操作過正式帳號的結果。測試應使用專門資料,避免為了驗證隱私設定,反而把真實客戶內容散布到更多工作區或報告裡。
政策調整也要留下原因與負責人。例如處理特定客訴時,因工作需要暫時開放完整內容,事件結束後應回到原本範圍,避免臨時例外逐漸累積成所有人都看得到。
Enterprise 方案與自架條件怎麼查?
官方宣布的新控制適用 LangSmith Enterprise。費用和契約條件需依實際方案確認,不能把公告中的可用功能直接套到免費或其他付費方案,也不能推論所有既有帳號都已開啟。
ABAC 文件另列出自架部署的啟用條件,包括 Helm 圖表與應用程式版本。這是一般 ABAC 的部署要求,不能據此保證任何自架版本已完整具備本次所有新控制,升級前仍要核對對應文件。
驗收完成後,還要確認工程師仍能完成日常除錯。如果權限限制到看不出工具卡在哪裡,團隊可能又回到私下複製紀錄的舊方式,所以應同時測試資料保護與工作可用性。
驗收要同時涵蓋能看與不能看的情境,才知道政策是否符合團隊分工。
LangSmith 敏感資料常見問題
把輸入輸出隱藏後,平台就不保存內容了嗎?
不是。官方說明完整資料仍送進並保存在平台,新權限決定誰能閱覽。如果要求敏感文字不進平台,仍需要在收集與傳送之前安排處理,不能只靠閱覽限制。
使用者群組能取代原本的角色設定嗎?
群組是在既有角色與屬性政策上管理團隊權限。最後能看什麼,仍受工作區設定和拒絕政策影響,因此應用實際測試身分確認結果,而不是只看群組名稱。
客戶編號放在任意工具步驟就夠了嗎?
這次紀錄層級政策依據最上層執行紀錄的屬性。接入時應確認欄位放在正確位置、由可信來源產生,並測試缺少或錯誤標記時的行為。
開啟控制就代表符合醫療或金融法規嗎?
功能提供權限管理能力,不是特定業務的合規認證。公司仍要依自己的資料種類、地區、契約與部署條件確認要求,不能把產品功能公告當成完整法律結論。
先讓工程師看必要訊號,再按事件開放內容
建議從一個正式環境專案建立角色矩陣,以最少內容可見性支援日常除錯。先確認工程師能找到慢工具與重試問題,再為需要處理內容的人配置較細的客戶範圍。
這次更新適合已在 LangSmith 收集正式追蹤、又想減少內容曝光的企業。若核心需求是完全不保存某類文字,就應先調整收集與資料處理方式,再評估權限控制是否足夠。
用不同客戶與團隊帳號測試同一批紀錄,確認授權和拒絕都符合預期再擴大。把「資料有沒有被存下來」和「誰能打開」分開驗證,才能讓代理除錯與資料治理同時運作。
延伸閱讀:LangSmith 如何查 AI 程式代理成本?從執行軌跡到模型路由
延伸閱讀:LangChain 模型分流實驗:Open SWE 成本中位數降低 64%,怎麼做到的?