View a markdown version of this page

使用合作夥伴管理的連接器 - AWS DevOps 代理程式

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用合作夥伴管理的連接器

合作夥伴管理的連接器會將 AWS DevOps 代理程式連線至合作夥伴託管的模型內容通訊協定 (MCP) 伺服器。範例包括合作夥伴的可觀測性或事件管理服務。合作夥伴在 GitHub 網站上的 AWS DevOps 代理程式工具儲存庫中發佈連接器。連接器會定義伺服器的端點及其接受的身分驗證方法。它也可以列出合作夥伴建議的技能。

使用連接器時,您不需要查詢合作夥伴的端點 URLs、OAuth URLs 或範圍。您可以選擇端點並僅輸入自己的登入資料, AWS DevOps 代理程式會從連接器建置剩餘的註冊。當合作夥伴為其 MCP 伺服器發佈連接器時,請使用連接器。如需註冊任何其他 MCP 伺服器的指示,請參閱註冊 MCP 伺服器。

在本主題中,連接器表示合作夥伴的定義,而 MCP 伺服器表示您從中建立的註冊。主控台使用相同的術語,例如移除 MCP 伺服器。

連接器會註冊 MCP 伺服器,因此其工具的運作方式與您自行註冊的 MCP 伺服器相同。連接器也提供下列項目:

  • 固定組態 – 端點 URLs、身分驗證方法,以及 OAuth URLs和範圍來自連接器。您無法變更它們。

  • 建議的技能 – 您可以在將連接器新增至客服人員空間時安裝連接器建議的技能。稍後,您可以安裝更多、開啟或關閉它們,或移除它們。

  • 警示 Webhook – 當您將連接器新增至代理程式空間時, AWS DevOps 代理程式會建立 Webhook,以便合作夥伴產品的警示可以開始調查。有些連接器也會為您定義提醒承載。

合作夥伴受管連接器的運作方式

下列清單說明誰執行連接器的伺服器,以及資料的目的地:

  • 伺服器操作 – 合作夥伴操作並支援 MCP 伺服器。 AWS 不操作它。如需伺服器的說明,請使用 主控台中連接器的支援連結。

  • 連接器維護 – 每個連接器會顯示合作夥伴管理或 AWS管理的徽章。維護連接器定義的徽章名稱。

  • 登入資料 – 您的登入資料只會前往連接器定義中的 URLs。

  • 請求 – 您選擇的端點屬於合作夥伴的區域或您帳戶中的 網站。它可以在 代理程式空間的 AWS 區域之外。如同您連線的任何 MCP 伺服器,對伺服器的請求會離開該 AWS 區域。

註冊和版本

下列清單說明註冊如何與 Agent Spaces 和連接器版本相關:

  • 註冊範圍 – 您在 AWS 帳戶中註冊連接器一次。然後,將其新增到每個需要它的客服人員空間。

  • 版本 – 註冊會保留您註冊的連接器版本。當合作夥伴棄用連接器時,連接器不會再出現在可用區段中,而且您無法再次註冊。其目前註冊下的卡片顯示已棄用,而檢視所有開啟的頁面可以命名取代它的連接器。現有的註冊會持續運作,直到您取消註冊為止。

建議的技能是合作夥伴為其連接器建議的技能,例如在調查期間使用合作夥伴工具的指導。建議的技能來自 GitHub 網站上的 AWS DevOps 代理程式工具儲存庫中的技能目錄。您可以在將連接器新增至客服人員空間時安裝建議的技能。當您稍後編輯 MCP 伺服器時,您可以安裝更多技能、啟用或停用已安裝的技能,或將其移除。

已安裝的建議技能與 代理程式空間中的其他技能一起顯示。其內容來自 目錄,因此您無法對其進行編輯。代理程式載入它的方式與任何其他技能相同。如需技能的詳細資訊,請參閱 DevOps Agent Skills。

開始之前

若要使用合作夥伴管理的連接器,請確認您有下列項目:

  • 合作夥伴的帳戶,可建立連接器所需的登入資料,例如 API 金鑰或 OAuth 用戶端。連接器的設定指南會列出合作夥伴產品中的步驟。

  • 在 AWS DevOps Agent 主控台中註冊功能提供者和將功能新增至 Agent Space 的許可。

  • (選用) 如果您透過私有網路到達合作夥伴的端點,則為現有的私有連線。如需私有連線的詳細資訊,請參閱連線至私有託管工具。

如需適用於任何 MCP 伺服器之安全考量的詳細資訊,例如只允許列出您需要的工具,請參閱安全考量。

尋找連接器

尋找連接器,在註冊之前查看其設定指南和建議的技能。您可以在能力提供者頁面或從客服人員空間開始。

在功能提供者頁面上尋找連接器

若要在能力提供者頁面上尋找連接器,請完成下列步驟:

  1. 開啟位於 https://https://console.aws.amazon.com/devops-agent/ 的 AWS DevOps 代理程式主控台。

  2. 在導覽窗格中,選擇功能提供者。

  3. 在可用區段中,尋找連接器。若要縮小清單範圍,請在尋找功能中輸入其名稱,或選擇類別。每張卡片會顯示連接器的徽章、描述和類別。

  4. 選擇連接器的名稱。

連接器的頁面隨即開啟。若要略過它並開始註冊,您可以選擇改為在卡片上註冊。

從 代理程式空間尋找連接器

若要從 代理程式空間尋找連接器,請完成下列步驟:

  1. 在 https://https://console.aws.amazon.com/devops-agent/ 開啟 AWS DevOps 代理程式主控台,然後選取您的代理程式空間。

  2. 選取功能索引標籤。

  3. 在連接器類別的 區段中,例如遙測、通訊或 DevOps,選擇新增。

  4. 在新增功能中,在合作夥伴受管連接器下,選擇註冊。

  5. 在連接器清單中,選擇連接器的選取。

連接器的頁面隨即開啟。

連接器的頁面顯示的內容

連接器的頁面會顯示下列資訊:

  • 合作夥伴、連接器版本及其類別

  • 合作夥伴文件和支援的連結

  • 連接器的設定指南

  • 連接器建議的技能

若要開始註冊,請選擇註冊。如需說明,請參閱註冊連接器。

註冊連接器

當您註冊連接器時, AWS DevOps 代理程式會從連接器定義在您的 AWS 帳戶中建立 MCP 伺服器註冊。註冊有四個步驟。主控台會略過連接器不需要的步驟。

步驟 1:MCP 伺服器詳細資訊

在此步驟中,您會命名 MCP 伺服器,並選擇 AWS DevOps 代理程式連線的位置。步驟標題包含連接器的名稱,例如 Example Corp MCP 伺服器詳細資訊。

如果步驟顯示設定指南,請在填寫表單之前將其展開,並完成合作夥伴的步驟。它們說明如何建立您在步驟 3:身分驗證組態中輸入的登入資料。若要保留步驟的副本,請選擇複製。

輸入下列資訊:

  • 名稱 – 輸入此 MCP 伺服器的簡短名稱。主控台會填入您可以變更的連接器名稱。使用字母、數字、連字號 (-) 和底線 (_)。名稱在您的帳戶中必須是唯一的 AWS 。 AWS DevOps 代理程式會將名稱新增至每個工具名稱的開頭,且工具名稱最多可有 64 個字元,因此請保持名稱簡短。

  • 端點 – 有些合作夥伴提供多個端點,例如區域網站。若是如此,請選擇您與合作夥伴帳戶使用的端點。否則,主控台會顯示連接器的端點。端點 URL 會顯示在您帳戶中的 AWS CloudTrail 日誌中。

  • 連接器欄位 – 有些連接器會要求更多值,例如與合作夥伴的執行個體名稱。每個欄位都會顯示連接器提供的標籤。向合作夥伴輸入您帳戶中的值。

  • 使用私有連線連線至端點 – (選用) 選取此選項,透過現有的私有連線將請求路由至合作夥伴的端點。對於使用 OAuth 的連接器,您可以選擇權杖交換的個別私有連線。

  • 進階組態 – (選用) 選擇客戶受管 AWS 金鑰管理服務 (AWS KMS) 金鑰來加密註冊。如需加密的詳細資訊,請參閱 DevOps Agent 的靜態加密。

選擇下一步。

步驟 2:身分驗證方法

在此步驟中,您可以選擇 AWS DevOps 代理程式如何向合作夥伴的產品進行身分驗證。只有在連接器提供多個身分驗證方法時,您才會看到此步驟。連接器會定義方法的順序。選擇下列其中一項:

  • API 金鑰 – AWS DevOps 代理程式會使用您在合作夥伴產品中建立的金鑰進行身分驗證,以便控制其許可。

  • OAuth 用戶端登入資料 – AWS DevOps Agent 會使用您在合作夥伴產品中建立的用戶端 ID 和秘密進行身分驗證。

  • 登入合作夥伴 (例如,登入 Example Corp) – 在您登入合作夥伴的產品後, AWS DevOps 代理程式會代表您。

  • 使用動態用戶端註冊來登入 – AWS DevOps 代理程式會向合作夥伴註冊自己的 OAuth 用戶端,然後在您登入後代表您執行動作。

選擇下一步。

步驟 3:身分驗證組態

在此步驟中,您會輸入身分驗證方法所需的登入資料。連接器定義的區段會顯示連接器設定的值,您無法變更。

主控台會略過以動態用戶端註冊登入的此步驟。當連接器提供自己的 OAuth 用戶端時,它也會略過此步驟,讓登入成為合作夥伴。

API 金鑰

針對 API 金鑰,輸入連接器列出的每個標頭的值。連接器會設定標頭名稱和任何字首,例如 Bearer ,因此請只輸入 金鑰。

OAuth 用戶端憑證

對於 OAuth 用戶端憑證,請完成下列步驟:

  1. 輸入您在合作夥伴產品中建立的用戶端 ID 和用戶端秘密。

  2. (選用) 新增其他範圍和其他交換參數。除了連接器定義的範圍和參數之外, AWS DevOps 代理程式還會請求它們。

登入合作夥伴

對於登入合作夥伴,請完成下列步驟:

  1. 如果連接器不提供自己的 OAuth 用戶端,請輸入您在合作夥伴產品中建立的用戶端 ID 和用戶端秘密。如果合作夥伴支援 Code Exchange (PKCE) 的驗證金鑰,您可以將用戶端秘密保留空白。

  2. (選用) 新增其他範圍。

選擇下一步。

步驟 4:檢閱並註冊

若要完成註冊,請完成下列步驟:

  1. 檢閱詳細資訊。若要變更步驟,請在該步驟的 區段中選擇編輯。

  2. 選擇註冊。

  3. 如果您選擇登入方法,請在主控台開啟的合作夥伴頁面上登入,然後核准存取權。

主控台會傳回至 AWS DevOps 代理程式,註冊完成。如果您是從客服人員空間註冊,則主控台會開啟將連接器新增至該客服人員空間的步驟。如果您已從功能提供者頁面註冊,請參閱將連接器新增至客服人員空間。

如果註冊失敗,主控台會保持在檢閱步驟中,並顯示錯誤。更正詳細資訊,然後再次選擇註冊。

將連接器新增至客服人員空間

當您將連接器新增至客服人員空間時,您可以選擇客服人員可在其中使用的工具,並選擇性地安裝連接器建議的技能。如果您已從功能提供者頁面註冊連接器,請從您的客服人員空間開始:

  1. 在 https://https://console.aws.amazon.com/devops-agent/ 開啟 AWS DevOps 代理程式主控台,然後選取您的代理程式空間。

  2. 選取功能索引標籤。

  3. 在連接器類別的 區段中,選擇新增。

  4. 在新增功能中,尋找您從連接器註冊的 MCP 伺服器,然後選擇新增。

步驟 1:選取工具

在此步驟中,您可以選擇代理程式可以在此代理程式空間中使用的工具。僅選取您的 Agent Space 所需的工具。如果您將工具分類為唯讀或變動,請為每個工具選擇分類。如需分類工具的詳細資訊,請參閱使用導向動作。如需客服人員空間中 MCP 工具數量上限的詳細資訊,請參閱配額。

有些連接器也會顯示 Webhook 身分驗證類型。選擇合作夥伴的產品如何向 Agent Space 的警示 Webhook 進行身分驗證:HMAC (預設) 或 API 金鑰。定義自己的提醒的連接器會為您設定此項目。

若要略過選用技能步驟,請選擇跳至檢閱並儲存。否則,請選擇下一步。

只有在連接器建議技能時,您才會看到此步驟。在此步驟中,您可以選擇要安裝的建議技能。主控台會列出連接器建議的技能,未選取任何項目。已安裝在客服人員空間中的技能會顯示已啟用或已停用,而且您無法選取它。選取您要安裝的技能,然後選擇下一步。

步驟 3:檢閱和儲存

若要將連接器儲存至客服人員空間,請完成下列步驟:

  1. 檢閱工具、技能和警示 Webhook 類型。若要變更它們,請在其區段中選擇編輯。

  2. 選擇儲存。

AWS DevOps Agent 會將 MCP 伺服器新增至 Agent Space,然後安裝您選取的技能。如果技能無法安裝,通知會列出它,而 MCP 伺服器會保留在客服人員空間中。若要再試一次,請在客服人員空間中編輯連接器,然後選取技能。如需說明,請參閱編輯客服人員空間中的連接器。

設定警示 Webhook

選擇儲存後,主控台會開啟設定提醒 Webhook。它會在每次您將連接器新增至客服人員空間時開啟,但不會在您編輯連接器時開啟。設定 Webhook 之後,傳送至 Webhook 的每個提醒都會在客服人員空間中開始調查。

若要設定 Webhook,請完成下列步驟:

  1. 複製 Webhook URL、標頭或簽署秘密,以及請求內文或請求內文格式。若要將 URL 和秘密儲存在檔案中,請選擇下載 .csv 檔案。 AWS DevOps 代理程式只會顯示秘密一次。

  2. 選取我已儲存並儲存我的 URL 和登入資料,然後選擇完成。

  3. 在合作夥伴的產品中設定 Webhook。如需說明,請參閱連接器的設定指南。

這些值的運作方式如下:

  • Webhook URL – 合作夥伴產品傳送提醒的 URL。

  • 標頭 – 對於使用承載字符的 Webhook,合作夥伴產品隨每個請求傳送的Authorization: Bearer標頭。

  • 簽署秘密 – 對於簽署請求的 Webhook,合作夥伴產品用來timestamp:body使用 HMAC-SHA256 簽署的秘密。合作夥伴的產品會在 x-amzn-event-timestamp標頭中傳送時間戳記,並在 x-amzn-event-signature標頭中傳送簽章。

  • 請求內文 – 對於定義其提醒的連接器,提醒承載。當警示觸發時,合作夥伴的產品會填入其範本值。

  • 請求內文格式 – 對於任何其他連接器,每個提醒必須使用的 JSON 格式。為每個提醒提供一個唯一的 incidentId。

您看到哪個標頭或簽署秘密取決於 Webhook 驗證的方式。連接器會設定它,或在選取工具中選擇它。它不取決於您在註冊連接器時選擇的身分驗證方法。

如需 Webhook 身分驗證和承載的詳細資訊,請參閱透過 Webhook 叫用 DevOps 代理程式。如需替換遺失秘密的詳細資訊,請參閱輪換 Webhook 登入資料。

連接器出現的位置

在功能索引標籤上,連接器會顯示在第一個類別的 區段中:遙測、管道、通訊或 DevOps。第一個類別為 Cloud 或目錄不再列出的連接器會出現在 MCP Server 區段中。

編輯客服人員空間中的連接器

您可以在 代理程式空間中變更連接器的工具,並安裝、啟用、停用或移除其建議的技能。若要編輯連接器,請完成下列步驟:

  1. 在 https://https://console.aws.amazon.com/devops-agent/ 開啟 AWS DevOps 代理程式主控台,然後選取您的代理程式空間。

  2. 在功能索引標籤上,選取其區段中的 MCP 伺服器,然後選擇編輯。

  3. 在選取工具上,變更工具。主控台會從您儲存的工具開始。如果 MCP 伺服器不再列出儲存的工具,主控台會從選取項目中移除該工具,並顯示警告。

  4. 在選取建議的技能上,選取要保留或安裝的技能。若要移除已安裝的技能,請將其清除。

  5. (選用) 在設定技能狀態時,開啟或關閉每個已安裝的技能。客服人員只會使用已開啟的技能。只有在至少一個技能保持已安裝狀態時,您才會看到此步驟。

  6. 檢閱並儲存時,檢閱每個技能的變更,然後選擇儲存。

AWS DevOps 代理程式會儲存您的變更,而警示 Webhook 會保持不變。在儲存之前,如果變更移除技能,檢閱會警告您。如果 Agent Space 中的另一個連接器建議您停用或移除技能,它也會警告您,因為變更也適用於該連接器。您可以稍後再次安裝移除的技能。

如果技能變更失敗,通知會列出它,並保留您的其他變更。若要再試一次,請再次編輯連接器。

從客服人員空間移除連接器

若要從客服人員空間移除連接器,請完成下列步驟:

  1. 在 https://https://console.aws.amazon.com/devops-agent/ 開啟 AWS DevOps 代理程式主控台,然後選取您的代理程式空間。

  2. 在功能索引標籤上,選取其區段中的 MCP 伺服器,然後選擇移除。

  3. 在移除 MCP 伺服器中,檢閱確認,然後選擇移除。

MCP 伺服器會從客服人員空間中移除。移除它也會刪除安裝在 代理程式空間中的連接器建議技能。這包括您自行安裝的建議技能。如果 Agent Space 中的另一個連接器也建議,則技能會保持已安裝狀態。在刪除任何項目之前,確認會命名技能或提供技能數量。您無法復原此動作。

If AWS DevOps 代理程式無法檢查已安裝哪些技能,確認就會顯示。在這種情況下,技能會保持安裝狀態,而移除只會移除 MCP 伺服器。

更新或取消註冊連接器

若要尋找連接器註冊,請完成下列步驟:

  1. 開啟位於 https://https://console.aws.amazon.com/devops-agent/ 的 AWS DevOps 代理程式主控台。

  2. 在導覽窗格中,選擇功能提供者。

  3. 在目前註冊下,尋找連接器的卡片,然後選擇檢視全部。

  4. 在註冊中,選取 MCP 伺服器。

如果註冊使用登入合作夥伴或使用動態用戶端註冊登入,您可以再次登入而不取消註冊,例如在合作夥伴撤銷存取權之後。選擇動作,然後選擇更新。在檢閱步驟中,將授權 URL 保留空白,選擇更新,然後在合作夥伴的頁面上登入。 AWS DevOps 代理程式重新整理其存取權,您的用戶端憑證和代理程式空間關聯保持不變。

若要變更 API 金鑰或 OAuth 用戶端憑證,或使用較新版本的連接器,請取消註冊 MCP 伺服器並再次註冊連接器。若要取消註冊,請先從每個使用它的客服人員空間移除 MCP 伺服器。如需說明,請參閱從客服人員空間移除連接器。然後選取 MCP 伺服器,選擇動作,然後選擇取消註冊。主控台會立即取消註冊 MCP 伺服器,而不會要求您確認。

對合作夥伴管理的連接器進行故障診斷

使用以下資訊來解決合作夥伴受管連接器的常見問題。

「此連接器不會為您選擇的端點定義 URL」

此錯誤表示連接器定義不包含您選擇的端點。若要解決此問題,請選擇另一個端點。如果錯誤繼續發生,請聯絡連接器的 支援。

註冊失敗,因為名稱正在使用中

MCP 伺服器名稱在您的 AWS 帳戶中必須是唯一的。若要解決此問題,請在步驟 1:MCP 伺服器詳細資訊中輸入另一個名稱,然後再次註冊。

提醒 Webhook 頁面未顯示登入資料

如果設定提醒 Webhook 顯示錯誤,而不是標頭或簽署秘密, AWS DevOps 代理程式不會傳回 Webhook 的登入資料。若要取得 Webhook,請輪換 Webhook。如需說明,請參閱輪換 Webhook 登入資料。

提醒不會開始調查

合作夥伴的產品必須完全按照主控台顯示的方式傳送請求。請嘗試下列步驟來解決此問題:

  1. 在合作夥伴的產品中,檢查 Webhook 是否使用主控台中的 Webhook URL。

  2. 檢查每個請求是否包含已簽署 Webhook 的 Authorization 標頭或 x-amzn-event-timestamp和 x-amzn-event-signature標頭。

  3. 檢查請求內文是否符合主控台的請求內文或請求內文格式。

如需更多故障診斷步驟,請參閱故障診斷 Webhook。