本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用合作夥伴管理的連接器
合作夥伴管理的連接器會將 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 代理程式工具儲存庫
已安裝的建議技能與 代理程式空間中的其他技能一起顯示。其內容來自 目錄,因此您無法對其進行編輯。代理程式載入它的方式與任何其他技能相同。如需技能的詳細資訊,請參閱 DevOps Agent Skills。
開始之前
若要使用合作夥伴管理的連接器,請確認您有下列項目:
合作夥伴的帳戶,可建立連接器所需的登入資料,例如 API 金鑰或 OAuth 用戶端。連接器的設定指南會列出合作夥伴產品中的步驟。
在 AWS DevOps Agent 主控台中註冊功能提供者和將功能新增至 Agent Space 的許可。
(選用) 如果您透過私有網路到達合作夥伴的端點,則為現有的私有連線。如需私有連線的詳細資訊,請參閱連線至私有託管工具。
如需適用於任何 MCP 伺服器之安全考量的詳細資訊,例如只允許列出您需要的工具,請參閱安全考量。
尋找連接器
尋找連接器,在註冊之前查看其設定指南和建議的技能。您可以在能力提供者頁面或從客服人員空間開始。
在功能提供者頁面上尋找連接器
若要在能力提供者頁面上尋找連接器,請完成下列步驟:
開啟位於 https://https://console.aws.amazon.com/devops-agent/
的 AWS DevOps 代理程式主控台。 在導覽窗格中,選擇功能提供者。
在可用區段中,尋找連接器。若要縮小清單範圍,請在尋找功能中輸入其名稱,或選擇類別。每張卡片會顯示連接器的徽章、描述和類別。
選擇連接器的名稱。
連接器的頁面隨即開啟。若要略過它並開始註冊,您可以選擇改為在卡片上註冊。
從 代理程式空間尋找連接器
若要從 代理程式空間尋找連接器,請完成下列步驟:
在 https://https://console.aws.amazon.com/devops-agent/
開啟 AWS DevOps 代理程式主控台,然後選取您的代理程式空間。 選取功能索引標籤。
在連接器類別的 區段中,例如遙測、通訊或 DevOps,選擇新增。
在新增功能中,在合作夥伴受管連接器下,選擇註冊。
在連接器清單中,選擇連接器的選取。
連接器的頁面隨即開啟。
連接器的頁面顯示的內容
連接器的頁面會顯示下列資訊:
合作夥伴、連接器版本及其類別
合作夥伴文件和支援的連結
連接器的設定指南
連接器建議的技能
若要開始註冊,請選擇註冊。如需說明,請參閱註冊連接器。
註冊連接器
當您註冊連接器時, 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 用戶端憑證,請完成下列步驟:
輸入您在合作夥伴產品中建立的用戶端 ID 和用戶端秘密。
(選用) 新增其他範圍和其他交換參數。除了連接器定義的範圍和參數之外, AWS DevOps 代理程式還會請求它們。
登入合作夥伴
對於登入合作夥伴,請完成下列步驟:
如果連接器不提供自己的 OAuth 用戶端,請輸入您在合作夥伴產品中建立的用戶端 ID 和用戶端秘密。如果合作夥伴支援 Code Exchange (PKCE) 的驗證金鑰,您可以將用戶端秘密保留空白。
(選用) 新增其他範圍。
選擇下一步。
步驟 4:檢閱並註冊
若要完成註冊,請完成下列步驟:
檢閱詳細資訊。若要變更步驟,請在該步驟的 區段中選擇編輯。
選擇註冊。
如果您選擇登入方法,請在主控台開啟的合作夥伴頁面上登入,然後核准存取權。
主控台會傳回至 AWS DevOps 代理程式,註冊完成。如果您是從客服人員空間註冊,則主控台會開啟將連接器新增至該客服人員空間的步驟。如果您已從功能提供者頁面註冊,請參閱將連接器新增至客服人員空間。
如果註冊失敗,主控台會保持在檢閱步驟中,並顯示錯誤。更正詳細資訊,然後再次選擇註冊。
將連接器新增至客服人員空間
當您將連接器新增至客服人員空間時,您可以選擇客服人員可在其中使用的工具,並選擇性地安裝連接器建議的技能。如果您已從功能提供者頁面註冊連接器,請從您的客服人員空間開始:
在 https://https://console.aws.amazon.com/devops-agent/
開啟 AWS DevOps 代理程式主控台,然後選取您的代理程式空間。 選取功能索引標籤。
在連接器類別的 區段中,選擇新增。
在新增功能中,尋找您從連接器註冊的 MCP 伺服器,然後選擇新增。
步驟 1:選取工具
在此步驟中,您可以選擇代理程式可以在此代理程式空間中使用的工具。僅選取您的 Agent Space 所需的工具。如果您將工具分類為唯讀或變動,請為每個工具選擇分類。如需分類工具的詳細資訊,請參閱使用導向動作。如需客服人員空間中 MCP 工具數量上限的詳細資訊,請參閱配額。
有些連接器也會顯示 Webhook 身分驗證類型。選擇合作夥伴的產品如何向 Agent Space 的警示 Webhook 進行身分驗證:HMAC (預設) 或 API 金鑰。定義自己的提醒的連接器會為您設定此項目。
若要略過選用技能步驟,請選擇跳至檢閱並儲存。否則,請選擇下一步。
步驟 2:選取建議的技能 (選用)
只有在連接器建議技能時,您才會看到此步驟。在此步驟中,您可以選擇要安裝的建議技能。主控台會列出連接器建議的技能,未選取任何項目。已安裝在客服人員空間中的技能會顯示已啟用或已停用,而且您無法選取它。選取您要安裝的技能,然後選擇下一步。
步驟 3:檢閱和儲存
若要將連接器儲存至客服人員空間,請完成下列步驟:
檢閱工具、技能和警示 Webhook 類型。若要變更它們,請在其區段中選擇編輯。
選擇儲存。
AWS DevOps Agent 會將 MCP 伺服器新增至 Agent Space,然後安裝您選取的技能。如果技能無法安裝,通知會列出它,而 MCP 伺服器會保留在客服人員空間中。若要再試一次,請在客服人員空間中編輯連接器,然後選取技能。如需說明,請參閱編輯客服人員空間中的連接器。
設定警示 Webhook
選擇儲存後,主控台會開啟設定提醒 Webhook。它會在每次您將連接器新增至客服人員空間時開啟,但不會在您編輯連接器時開啟。設定 Webhook 之後,傳送至 Webhook 的每個提醒都會在客服人員空間中開始調查。
若要設定 Webhook,請完成下列步驟:
複製 Webhook URL、標頭或簽署秘密,以及請求內文或請求內文格式。若要將 URL 和秘密儲存在檔案中,請選擇下載 .csv 檔案。 AWS DevOps 代理程式只會顯示秘密一次。
選取我已儲存並儲存我的 URL 和登入資料,然後選擇完成。
在合作夥伴的產品中設定 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 區段中。
編輯客服人員空間中的連接器
您可以在 代理程式空間中變更連接器的工具,並安裝、啟用、停用或移除其建議的技能。若要編輯連接器,請完成下列步驟:
在 https://https://console.aws.amazon.com/devops-agent/
開啟 AWS DevOps 代理程式主控台,然後選取您的代理程式空間。 在功能索引標籤上,選取其區段中的 MCP 伺服器,然後選擇編輯。
在選取工具上,變更工具。主控台會從您儲存的工具開始。如果 MCP 伺服器不再列出儲存的工具,主控台會從選取項目中移除該工具,並顯示警告。
在選取建議的技能上,選取要保留或安裝的技能。若要移除已安裝的技能,請將其清除。
(選用) 在設定技能狀態時,開啟或關閉每個已安裝的技能。客服人員只會使用已開啟的技能。只有在至少一個技能保持已安裝狀態時,您才會看到此步驟。
檢閱並儲存時,檢閱每個技能的變更,然後選擇儲存。
AWS DevOps 代理程式會儲存您的變更,而警示 Webhook 會保持不變。在儲存之前,如果變更移除技能,檢閱會警告您。如果 Agent Space 中的另一個連接器建議您停用或移除技能,它也會警告您,因為變更也適用於該連接器。您可以稍後再次安裝移除的技能。
如果技能變更失敗,通知會列出它,並保留您的其他變更。若要再試一次,請再次編輯連接器。
從客服人員空間移除連接器
若要從客服人員空間移除連接器,請完成下列步驟:
在 https://https://console.aws.amazon.com/devops-agent/
開啟 AWS DevOps 代理程式主控台,然後選取您的代理程式空間。 在功能索引標籤上,選取其區段中的 MCP 伺服器,然後選擇移除。
在移除 MCP 伺服器中,檢閱確認,然後選擇移除。
MCP 伺服器會從客服人員空間中移除。移除它也會刪除安裝在 代理程式空間中的連接器建議技能。這包括您自行安裝的建議技能。如果 Agent Space 中的另一個連接器也建議,則技能會保持已安裝狀態。在刪除任何項目之前,確認會命名技能或提供技能數量。您無法復原此動作。
If AWS DevOps 代理程式無法檢查已安裝哪些技能,確認就會顯示。在這種情況下,技能會保持安裝狀態,而移除只會移除 MCP 伺服器。
更新或取消註冊連接器
若要尋找連接器註冊,請完成下列步驟:
開啟位於 https://https://console.aws.amazon.com/devops-agent/
的 AWS DevOps 代理程式主控台。 在導覽窗格中,選擇功能提供者。
在目前註冊下,尋找連接器的卡片,然後選擇檢視全部。
在註冊中,選取 MCP 伺服器。
如果註冊使用登入合作夥伴或使用動態用戶端註冊登入,您可以再次登入而不取消註冊,例如在合作夥伴撤銷存取權之後。選擇動作,然後選擇更新。在檢閱步驟中,將授權 URL 保留空白,選擇更新,然後在合作夥伴的頁面上登入。 AWS DevOps 代理程式重新整理其存取權,您的用戶端憑證和代理程式空間關聯保持不變。
若要變更 API 金鑰或 OAuth 用戶端憑證,或使用較新版本的連接器,請取消註冊 MCP 伺服器並再次註冊連接器。若要取消註冊,請先從每個使用它的客服人員空間移除 MCP 伺服器。如需說明,請參閱從客服人員空間移除連接器。然後選取 MCP 伺服器,選擇動作,然後選擇取消註冊。主控台會立即取消註冊 MCP 伺服器,而不會要求您確認。
對合作夥伴管理的連接器進行故障診斷
使用以下資訊來解決合作夥伴受管連接器的常見問題。
「此連接器不會為您選擇的端點定義 URL」
此錯誤表示連接器定義不包含您選擇的端點。若要解決此問題,請選擇另一個端點。如果錯誤繼續發生,請聯絡連接器的 支援。
註冊失敗,因為名稱正在使用中
MCP 伺服器名稱在您的 AWS 帳戶中必須是唯一的。若要解決此問題,請在步驟 1:MCP 伺服器詳細資訊中輸入另一個名稱,然後再次註冊。
提醒 Webhook 頁面未顯示登入資料
如果設定提醒 Webhook 顯示錯誤,而不是標頭或簽署秘密, AWS DevOps 代理程式不會傳回 Webhook 的登入資料。若要取得 Webhook,請輪換 Webhook。如需說明,請參閱輪換 Webhook 登入資料。
提醒不會開始調查
合作夥伴的產品必須完全按照主控台顯示的方式傳送請求。請嘗試下列步驟來解決此問題:
在合作夥伴的產品中,檢查 Webhook 是否使用主控台中的 Webhook URL。
檢查每個請求是否包含已簽署 Webhook 的
Authorization標頭或x-amzn-event-timestamp和x-amzn-event-signature標頭。檢查請求內文是否符合主控台的請求內文或請求內文格式。
如需更多故障診斷步驟,請參閱故障診斷 Webhook。