在 Azure Functions 中使用受控連接器

透過使用受管理連接器,你的函式可以對 Microsoft 365、Microsoft Teams、SharePoint 及許多第三方系統中的事件和呼叫操作做出反應,而無需撰寫 webhook 設定程式碼或管理 OAuth 令牌。 Azure Functions 與 Azure Connector 命名空間整合,提供觸發器和 SDK,讓你專注於商業邏輯,而連接器命名空間則負責 webhook、認證和重試。

Note

連接器觸發器目前不支援此語言。

連接器如何增強功能

連接器命名空間為函式程式設計模型新增了兩項功能:

  • 連接器觸發程序
    當外部服務發生事件時,函式會執行,例如在 Microsoft 365 中收到新郵件、新增到 SharePoint 的檔案,或是發佈到 Teams 的訊息。 連接器觸發器綁定會從連接器命名空間接收事件。 對於 .NET 隔離工作者、Python、JavaScript 和 TypeScript 函式,您可以選擇輪詢或 webhook 傳遞。
  • Connector SDK 動作
    您的函式程式碼 透過 SDK 用戶端呼叫連接器操作。 SDK 涵蓋管理型連接器,如 Microsoft 365 Outlook、Microsoft 365 Users、Teams、SharePoint 及 OneDrive。 尚未具備 SDK 模型的受管理連接器可作為 HTTP 端點呼叫。

你可以搭配傳統函式觸發器和綁定(如 HTTP、計時器、佇列、服務匯流排、Event Grid 和 Durable Functions)來使用受管理連接器。

Support

Dimension Availability
連接器命名空間區域 任何支援 Connector 命名空間 的區域。
語言 .NET 10 與 .NET 11 分離,Python 3.13+,Node.js 24+(JS/TS)。 Java、PowerShell 和 Go 都不被支援。
主辦計畫 Flex Consumption(建議)、Premium、Dedicated,以及 Container Apps。
作業系統 所有地區均支援 Linux 託管的功能應用程式。 Windows 託管的功能應用程式可用性有限。
定價 標準 Functions 定價及相關資源(例如 Azure 儲存體 和 Application Insights)的費用適用。 連接器命名空間有獨立的 按用量計費方式。

何時使用連接器

當你的函式主要需要與外部服務互動,而非執行複雜的自訂邏輯時,請使用連接器。 請考慮以下在功能應用程式中使用受管理連接器的方法:

  • 對外部事件的反應
    你的應用程式必須處理外部連接服務引發的事件(新郵件、行事曆邀請、檔案、清單項目、Teams 活動),但你不想花心力編碼 webhook 註冊、握手驗證和 OAuth 刷新。 假設你的函式執行時,會執行以處理在受監控Office 365 Outlook資料夾中送達的新郵件,分類郵件,呼叫Office 365 連接器進行豐富,並標記或移動該郵件。 您的應用程式會在連接器命名空間管理 OAuth 權杖重新整理時執行此處理。

  • 替換客製化服務客戶
    您的函式程式碼已經透過自訂 HTTP 用戶端呼叫 Microsoft 365 或第三方 API。 在多個連線間管理機密、範圍與重試政策,很快就會成為維護負擔。 改用型別連接器 SDK 用戶端,並讓受管理連接器管理連線。

  • 善用現有的應用程式部署
    你已經建立了一個事件驅動的功能應用專案,包含部署管線和監控工具。 你可以使用受管理連接器在同一專案中新增基於外部服務觸發的功能,並善用現有基礎設施。 例如,過去依賴訊息佇列或邏輯應用的功能式應用程式,現在能直接回應 Teams 活動,並連接 Office 365 進行組織內檢查與經理查詢。

  • 代理工作流程
    您正在建置工作流程,其中函式會接收事件、使用 AI 模型進行推理,然後再透過連接器作業對外部服務執行動作。 你可以利用 Azure Functions 託管技能,為您的代理式工作流程進行程式設計,同時仍可善用以受控連接器為基礎的觸發程序和受控連接器 SDK。

  • 以程式碼為先的控制與管理整合
    你想要管理型連接器來簡化與外部服務的入站與出站通訊,但你偏好以程式碼為先的程式設計模式,並完全掌控編排,包括分支、管理步驟間的認證,以及重複使用現有函式庫。

    Tip

    當工作負載純粹是跨連接器的編排,沒有自訂程式碼時,Logic Apps Standard 仍然是最簡單的選擇。 欲了解更多資訊,請參閱與其他 Azure 整合選項的關係。

與其他 Azure 整合選項的關係

Azure Functions 中的受控連接器可額外新增。 正確的選擇取決於工作負載需要多少自訂程式碼,以及團隊偏好視覺設計師還是程式碼。

Option 適用對象 你會得到...
Logic Apps 標準 跨連接器協調工作流程;團隊偏好視覺設計師;步驟之間有少量自訂程式碼。 適用於相同連接器生態系統的低程式碼設計器。
Azure Functions 搭配受控連接器 以程式碼為優先的體驗,包括自訂分支、進行中函式庫、其他綁定,以及觸發與動作之間的 AI 模型呼叫。 .NET、Python或 Node.js 創作;功能部署與監控;外部服務沒有 webhook 或 OAuth 程式碼。
搭配受控連接器的 Azure App 服務 為現有的網頁應用程式或 API 新增連接器事件與動作。 透過應用程式路由進行認證的 HTTP 回調,以及相同的 Connector SDK 用戶端用於外站操作;接收應用程式的認證則與觸發器分開設定。
具有服務 SDK 的 HTTP 觸發程序 例如目標服務沒有管理連接器,或需要連接器未提供的協定層級控制。 完全控制認證、重試及 webhook 驗證;連接器命名空間沒有要求。

函式應用程式可以使用連接器觸發器和直接服務 SDK,並參與 Logic Apps 的工作流程。 你可以在現有的 HTTP 觸發應用程式中新增連接器觸發器,並逐步採用 SDK 用戶端。

開始使用受管理連接器

如需安裝與實作指引,請參考以下參考資料:

任務 參考
安裝套件、選擇傳送模式,並設定主機設定 連接器擴充功能概觀
撰寫連接器觸發函式,並設定觸發資源、連線設定及驗證 連接器觸發器範例與參考
從函式程式碼呼叫連接器作業 在程式碼中使用連接器 SDK