Leina 如何透過 OpenConnector 連接業務應用程式
探索 Leina 的 OpenConnector 授權閘道、提供者、動作與帳號權限之間的差異，以及如何以唯讀任務驗證連線。
概念示意圖：任務透過存取閘道抵達已授權的業務應用程式。
AI 代理需要先存取相關系統，才能摘要會議記錄、彙整客戶更新，或修改業務試算表。實際的問題很具體：連接的是哪個帳號、有哪些操作可用，以及可以存取哪些記錄？
Leina 透過 OpenConnector，我們自有的安全授權閘道 連接業務應用程式。此閘道為應用程式呼叫提供授權。可用的範圍也取決於連接器支援、業務帳號權限與團隊設定。
此閘道及其配套工具具有公開原始碼。請在我們的開源頁面探索範圍、社群貢獻與獨立使用途徑，或閱讀安全連線與我們的開源承諾。
從一項定義明確的任務開始，再往回推導它所需的能力與存取權。這能讓連線更容易驗證，並有助於避免為狹窄的任務授予廣泛的存取權。
1,500 個提供者與 16,000 個動作代表什麼？
根據發布時的產品涵蓋範圍，OpenConnector 閘道支援超過 1,500 個提供者 與超過 16,000 個動作。這些數字描述的是服務與操作的涵蓋範圍。請查閱目前的目錄與連接器，以了解特定能力。
| 概念 | 含義 | 應檢查的事項 |
|---|---|---|
| 提供者 | 可連接的服務 | 團隊的業務應用程式是否可用？ |
| 動作 | 其連接器所暴露的操作 | 是否支援所需的搜尋、建立或更新？ |
| 帳號權限 | 該帳號在該服務內的存取權 | 是否能觸及目標工作區、資料夾或記錄？ |
受支援的提供者不會暴露其服務的每一項功能。受支援的動作不會讓已連接的帳號存取所有資料。例如，連接器可能支援文件搜尋，但該帳號無權存取某個特定專案資料夾。
服務涵蓋範圍為團隊提供選項；適當的連線與授權範圍則決定其任務能否成功。
閘道在應用程式存取中的角色
Leina 的業務應用程式存取會經過 OpenConnector。團隊透過連線流程授權帳號，並透過成員、群組與應用程式端的權限定義可用的存取範圍。
從任務到已授權的呼叫
flowchart TB
accTitle: 從任務到已授權的呼叫
accDescr: Leina 使用 OpenConnector 透過已授權的帳號存取應用程式操作。可用的動作與資料範圍都必須檢查。
T("已定義任務"):::channel
T --> L("Leina"):::agent
L --> G("OpenConnector
授權閘道"):::gateway
G --> A("已授權帳戶
可存取資料"):::resource
G --> O("支援的
應用程式動作"):::resource授權是應用程式呼叫架構的一部分。設定仍須確立可使用哪些連線、帳號具有哪些權限，以及由誰接收結果。閘道不會取代這些決定。
請透過連線流程授權帳號，而不是將密碼或原始存取權杖貼到對話中。帳號與任務範圍的指引請參閱權限與資料存取。
從單一任務往回推導
對於諸如摘要本週專案會議記錄的任務，請在連接前確立四件事：
- 來源： 包含這些記錄的應用程式、專案或資料夾。
- 操作： 搜尋與讀取存取，此任務不需要更新或刪除操作。
- 範圍： 專案名稱、日期範圍與要擷取的欄位。
- 輸出： 要保留的目的地與來源連結。
在整合中尋找該服務，檢查所需操作，然後透過連線授權適當的帳號。如果該帳號無法存取來源記錄，僅變更提示並不能解決授權問題。
以可驗證的要求測試連線：
在已連接的文件應用程式中尋找本週的 Project A 會議記錄。回傳會議日期、決議、負責人與來源連結。僅讀取 Project A 的資料，不要變更文件。將缺少的資訊標示為缺少。
在將任務變成週期性工作流程之前，請確認來源與日期範圍正確，且缺口被準確回報。
從讀取轉為寫入前，重新檢查存取權
讀取、建立、更新與刪除是不同的需求。產出準確的摘要並不代表有權修改來源系統。
若要將會議行動項目寫入業務表格，請檢查連接器支援、帳號權限，以及目的地表格與欄位。先從類似這樣的要求開始：
根據我們剛剛驗證的會議行動項目，準備要新增的資料列。列出目的地表格、欄位與值。回傳草稿，先不要寫入任何內容。
在要求執行之前，請檢閱目的地、受影響的記錄與值。這是建議的工作流程；這並不表示每個連接器都具有相同的核准、草稿或回復功能。
為什麼已連接的應用程式仍可能回傳缺少的資料？
請依序檢查這些可能性：
- 服務與操作： 該應用程式是否支援此任務所需的動作？
- 帳號： 已連接的帳號是否為有權存取目標記錄的帳號？
- 範圍： 工作區、專案、資料夾與記錄是否在該帳號的存取範圍內？
- 團隊權限： 目前的成員或群組是否可使用該連線與操作？
- 連線狀態： 如果介面回報授權過期或連線錯誤，請依照目前的連線流程解決。
部分結果並不代表完整涵蓋範圍。請保留來源連結，並將重要摘要與預期範圍進行比對。如果問題仍不明確，請聯絡支援，並提供應用程式名稱與錯誤詳細資料，但不要包含憑證。
讓連線範圍可驗證
廣泛的連接器涵蓋範圍有助於 Leina 與團隊更多現有工具協作。請從一項任務開始，檢查其動作、帳號與資料需求，然後透過唯讀要求驗證結果。
若要供共同使用，請繼續閱讀成員與群組權限。關於進入點的關係，請閱讀一個代理橫跨多個聊天平台，或參閱Leina 總覽以了解更廣泛的產品介紹。