接入 Provider
Provider 轉接器把一個 AI Provider 發布到 Bricoop,使每個已連線的應用都能存取它的模型。轉接器宣告如何驗證、Provider 暴露了哪些 models 和 services,以及每個模型支援哪些能力。一旦發布,每個受支援的 Application 都能使用該 Provider,無需為每個應用撰寫膠水程式碼。
轉接器邊界
Provider 轉接器由 auths[](如何登入)、models[] 和 services[](Provider 提供什麼)以及每個模型支援的能力組成。Bricoop 把傳入的 Application 請求規範化到這個邊界,路由到 Provider,再把回應規範化回每個 Application 都能理解的形態。轉接器看不到任何 Application 專屬邏輯,也不儲存 Application 設定;它只在 Provider 的 API 與 Bricoop 協定之間翻譯。
開始之前
確認你擁有 Provider 穩定的 id、Provider 支援的全部驗證方式(如 api_key、oauth 或 device_code),以及 Provider 暴露的 models 和 services 清單。你還需要每個模型支援的能力,以便 Bricoop 與 Application 協商。每種 method 如何對映到 auths[] 條目,見 Provider 認證 頁面。
發佈
把 Provider manifest 寫成一個包含描述 Provider 中繼資料的 stable YAML 檔案,然後按照 registry 貢獻指南 提交到 bricoop-releases。倉庫的校驗會在 PR 合併前執行,所以在請求審查前修復每一個回報的問題。合併後會發布一個 release manifest,Bricoop Desktop 會自動取得它;使用者隨後可以連線該 Provider,並將它路由到任何受支援的 Application。