將 OpenCode 與 Agent Redactor 搭配使用

先決條件:Microsoft Store 安裝 Agent Redactor,或透過 PowerShell 單行指令安裝。您也需要安裝 OpenCode
  1. 建立設定檔並設定 API Proxy

    設定檔 側邊欄中,選取或建立一個設定檔。設定 設定檔名稱,選擇一個可用的 本機 URL 連接埠(例如 8080),輸入您提供者的真實 轉送到 端點(例如 https://openrouter.ai/api/v1),並貼上您的真實 API 金鑰。金鑰在本機加密,絕不會離開您的電腦。

    Agent Redactor API Proxy 區段,包含設定檔名稱 OpenRouter Provider、本機 URL localhost:8080、轉送到 openrouter.ai/api/v1 以及 API 金鑰欄位
    設定設定檔。本機 URL 是 OpenCode 將連接的位置,轉送到是真實的 API 端點。
  2. 啟用 AI 驅動的偵測與遮蔽規則

    選取您要遮蔽的 PII 類別。您也可以為專案特定的機密新增regex 規則關鍵字

    Agent Redactor 顯示 AI 驅動的偵測模型已啟用、PII 類別已勾選、統計資料面板以及顯示偵測到之 PII 的工作階段遮蔽記錄
    AI 偵測已開啟並選取所有類別。工作階段遮蔽記錄 面板會顯示攔截到的 PII(例如將“Bob”偵測為 private_person)。
  3. 開啟 OpenCode

    啟動 OpenCode。您會看到主介面,包含聊天輸入框和目前的模型選擇器。

    OpenCode 主畫面顯示 New session,包含聊天輸入框和顯示 Big Pickle 的模型選擇器
    OpenCode 主畫面,包含聊天輸入框和模型選擇器。
  4. 開啟模型選擇器

    在聊天輸入框中輸入 /model 以開啟模型選擇對話方塊。您也可以按下 Ctrl+' 作為捷徑。

    OpenCode 在聊天輸入框中輸入 /model,顯示模型選擇提示
    輸入 /model 以開啟模型選擇器。
  5. 點擊“Connect provider”

    在模型選擇對話方塊中,點擊右上角的 Connect provider 按鈕以新增提供者連線。

    OpenCode 模型選擇對話方塊,右上角有 Connect provider 按鈕
    點擊 Connect provider 以新增 Agent Redactor。
  6. 選取“Custom OpenAI-compatible provider”

    在提供者清單中,捲動到 Other 區段並選取 Custom OpenAI-compatible provider。這可讓您將 OpenCode 指向任何與 OpenAI 相容的端點。

    OpenCode Connect provider 對話方塊顯示提供者清單,其中 Custom OpenAI-compatible provider 位於 Other 區段下
    從 Other 區段中選取 Custom OpenAI-compatible provider
  7. 填寫提供者詳細資料

    在自訂提供者表單中輸入以下內容:

    • Provider ID: agent-redactor
    • Display name: Agent Redactor
    • Base URL: http://localhost:8080/(必須與 Agent Redactor 中的連接埠一致)
    • API key: 留空。Agent Redactor 會透過標頭管理身分驗證
    OpenCode 自訂提供者表單,包含 Provider ID agent-redactor、Display name Agent Redactor 和 Base URL http://localhost:8080/
    填寫提供者詳細資料。Base URL 必須與您的 Agent Redactor Proxy 連接埠一致。
  8. 新增您的模型並提交

    向下捲動到 Models 區段。輸入模型 ID(例如 nvidia/nemotron-3-ultra-550b-a55b:free)和顯示名稱(例如“Nemotron 3 Ultra”)。點擊 Submit 以儲存。

    OpenCode 自訂提供者表單的 Models 區段,包含模型 ID nvidia/nemotron-3-ultra-550b-a55b:free 和 Submit 按鈕
    新增模型並點擊 Submit
  9. 選取您的模型

    回到 /model 對話方塊,搜尋“agent”,您會看到您的 Agent Redactor 提供者,且模型列在其之下。選取它以將所有要求路由至 Proxy。

    OpenCode 模型選擇器搜尋 agent,顯示帶 Nemotron 3 Ultra (Free) 的 Agent Redactor 提供者
    搜尋“agent”以找到您的 Agent Redactor 提供者,並選取模型。
  10. 開始聊天

    傳送一則訊息。在此範例中,使用者說了“My name is Bob”。Agent Redactor 將“Bob”偵測為 PII,在轉送至 LLM 之前將其遮蔽,並在回應中將它還原。

    透過 Agent Redactor 的 OpenCode 聊天,其中名字 Bob 被遮蔽並在回應中還原
    “Bob”在傳出時被遮蔽,並在傳回時被透明還原。

驗證遮蔽

檢查 Agent Redactor 中的工作階段遮蔽記錄面板,以確切查看攔截到的內容。

Agent Redactor 統計資料顯示 Requests: 1, PII: 1,工作階段遮蔽記錄顯示 PII private_person Bob
統計資料面板顯示“Requests: 1, PII: 1”,工作階段遮蔽記錄會列出攔截到的值,包含時間戳記與類型。
提示:在您的設定檔中使用regex 規則關鍵字,以擷取 AI 模型可能遺漏的專案特定機密,例如內部主機名稱、專有 ID 或專案代號。