在 Cline 中設定 OpenAI 相容 Provider，使用 JSON Schema 擷取資料

除了官方 OpenAI API，只要其他 Provider 提供 OpenAI 相容 endpoint，Cline 也能使用。若要開發結構化資料擷取專案，應將 Cline 視為協助建立處理流程的 coding agent，而不是把它當成模型必定會回傳符合 Schema 的 JSON 的保證。請依照 Provider 文件設定連線資訊，並在應用程式程式碼中驗證每筆擷取結果。

結構化資料擷取的正確設定方式

OpenAI 相容 API 描述的是介面，並不保證每個 Provider 都實作相同的模型、工具呼叫或結構化輸出功能。Cline 的 OpenAI 相容 Provider 指南 說明應設定 Provider 專用的 base URL、API 金鑰和模型 ID。指南也介紹了模型設定，例如 context window、maximum output tokens、圖片支援和電腦操作。

指南未說明 Cline 具備 JSON Schema 驗證功能。因此，請將兩者的工作分開：使用 Cline 開發並檢視擷取流程，再由應用程式剖析和驗證模型輸出。如此一來，格式錯誤的 JSON 和違反 Schema 的結果會成為明確錯誤，而不會被不知情地當成有效資料接受。

事前準備

開啟 Cline 設定前，請先向所選 Provider 確認以下資訊：

• 完整且正確的 API base URL，包括任何必要路徑。
• API 金鑰或文件所述的其他驗證方式。
• 該 endpoint 支援的確切模型 ID。
• 模型是否支援工具或函式呼叫，以及你打算使用的結構化輸出或 response format 選項之相關文件。

你還需要定義擷取規格：必填欄位、欄位型別、無效資料的判定方式，以及如何處理來源資訊缺漏或含糊不清的情況。Schema 可以驗證資料形狀和限制，但無法判定擷取值在事實上是否正確。

在 Cline 中設定 Provider

1. 按一下齒輪圖示開啟 Cline 設定，並將 API Provider 設為 OpenAI Compatible。
2. 輸入 Provider 提供的正確 Base URL。Cline 指南強調 URL 會依 Provider 而異；除非你設定的是官方 OpenAI API，否則不要改用官方 OpenAI endpoint。
3. 輸入 Provider 核發的 API Key 和正確的 Model ID。即使 API 格式相容，不同 Provider 的模型名稱也不能互換使用。
4. 檢視模型設定選項。context window 和 maximum output 值只能設為模型支援的數值。只有在 Provider 和模型文件明確列出電腦操作或圖片支援時，才啟用相關功能。
5. 如果 Cline 提供所選 Provider 的驗證功能，請使用該功能。若沒有，請先嘗試一項風險低、規模小的工作，並檢查 Provider 回應和 Cline 的錯誤詳細資訊。

若要使用 OneMux 路由，請參閱最新的 OneMux 快速入門和 API 文件，確認要輸入的 endpoint、驗證方式和模型資訊。OneMux 透過單一 OpenAI 相容 API 提供主流 AI 模型，並著重於模型存取、路由、金鑰和支出可視性。這不代表 OneMux 與 Cline 的整合已經過測試：只有在文件列出的 endpoint 和所選模型支援 Cline 所需的請求功能時，才進行連線。OneMux 模型目錄可協助你查找可用模型；請依據 Provider 最新文件確認確切模型 ID 和功能。

請 Cline 建立擷取工作流程

將 Schema 和實作需求一併提供給 Cline，作為 coding task 的內容。例如：

Implement invoice extraction for our application using the JSON Schema in the project. Do not guess missing values. Parse the model response and validate it locally against the schema before returning data. Add tests for valid JSON, malformed JSON, missing required fields, and values that violate constraints. Do not assume the provider supports a particular structured-output parameter; use only features documented for the configured endpoint and model.

這段指示是請 Cline 建立驗證層，並不會啟用特殊的 Provider 功能。以下 TypeScript 範例示範如何使用 Ajv 在本機進行驗證。請依照自己的擷取規格調整欄位和限制。

import Ajv from "ajv";

const schema = {
  type: "object",
  additionalProperties: false,
  required: ["invoice_number", "total", "currency"],
  properties: {
    invoice_number: { type: "string", minLength: 1 },
    total: { type: "number", minimum: 0 },
    currency: { type: "string", pattern: "^[A-Z]{3}$" }
  }
};

const ajv = new Ajv({ allErrors: true });
const validate = ajv.compile(schema);

export function validateInvoice(candidate: string) {
  let value: unknown;

  try {
    value = JSON.parse(candidate);
  } catch {
    return { ok: false as const, errors: ["Invalid JSON"] };
  }

  if (!validate(value)) {
    return { ok: false as const, errors: validate.errors ?? [] };
  }

  return { ok: true as const, value };
}

在此，additionalProperties: false 會拒絕未預期欄位；required 和屬性限制則定義可接受的資料形狀。Schema 驗證成功，代表資料符合這些規則，不代表發票內容已正確讀取。必要時請加入領域邏輯檢查，例如核對總額，或確認幣別是否位於允許清單中。

不只測試理想情況，也要測試邊界

請 Cline 至少為以下四種情況建立測試：有效擷取、格式錯誤的 JSON、缺少必填屬性，以及型別或格式錯誤的值。另請測試資訊含糊或缺漏的情況，並決定應用程式要拒絕結果、回傳需要人工審查的狀態，還是使用允許 null 值的 Schema。

在完成剖析與驗證前，一律將模型輸出視為不可信資料。若驗證失敗，請回傳明確錯誤，或將記錄送交審查。你可以在重試時把驗證錯誤作為回饋，但不要把重試視為正確性的保證。如果 Provider 文件說明支援原生 Schema 限制輸出，這項功能或許能作為額外防護；啟用前請確認該 endpoint 和模型確實支援。

限制與疑難排解

• API 金鑰無效： 確認金鑰屬於目前選取的 Provider，且複製內容正確。請勿將密鑰貼入提示詞或公開記錄。
• 找不到模型： 一併確認模型 ID 和 base URL。Cline 指南指出，各 Provider 提供的模型 ID 可能不同。
• 連線錯誤： 確認 endpoint 完整正確，且從你的電腦可以連線；也請檢查網路或防火牆限制。
• 輸出不是有效 JSON： Cline 設定指南並未證明 Provider 支援 Schema 限制輸出。請保留本機剖析與驗證，並依 Provider 文件確認 response format 功能。
• Cline agent 動作失敗： 指南將電腦操作列為模型設定功能之一，也提到支援工具或函式呼叫的模型。但指南並未保證所有相容 Provider 都支援這些呼叫。依賴 agent 動作前，請確認所選 endpoint 和模型的文件有列出相關支援。

若要使用其他 Provider，請採取相同流程：Cline 的Provider 設定說明指出要填寫哪些設定；Provider 文件則說明模型 ID 和功能限制。比較存取方案時，也可以查看 OneMux 定價；本文不對價格或節省金額作出任何主張。

總結

使用 Provider 文件列出的 base URL、API 金鑰和模型 ID 設定 Cline。進行結構化資料擷取時，可用 Cline 協助實作處理流程，但仍須在應用程式程式碼中依照自己的 JSON Schema 驗證已剖析的輸出。OpenAI 相容性是有用的起點，但不代表每個 endpoint 都支援 Schema 強制驗證或 coding agent 工具呼叫。

來源

• Cline：OpenAI Compatible Provider 設定 — Provider 設定、模型設定和疑難排解。