27 AI 登錄

AI Registry 是 Oracle AI Data Platform 的代理程式和 MCP 伺服器的中央目錄。它支援開放標準,包括 MCP 和 A2A。

AI Data Platform 是建立和部署專員的地方。Oracle Agent Hub 是業務使用者與其交談的地方。「AI 登錄」是兩者之間的層。AI Registry 可讓代理程式或工具在內建的環境之外進行探索及使用。代理程式和工具必須先在 AI 登錄中註冊,才能在「代理程式中心」中共用。請參閱 Using Oracle Agent Hub 中的 Enterprise AI 如何運作於 Agent Hub 。

您可以在 AI Data Platform AI 登錄中註冊下列代理程式和工具:

Type 描述
AI 資料平台代理 AI 資料平台中建置並部署的代理程式,位於您可以存取的工作區中。也稱為 AI Data Platform AI 登錄中的本機代理程式。
外部專員 AI 資料平台外部代管的代理程式,由其 A2A 代理程式卡 URL 新增。
MCP 伺服器 顯示一組工具代理程式可呼叫的模型相關資訊環境協定 (MCP) 伺服器。

在 AI Registry 中,您可以管理使用兩者所需的 AI 代理程式、MCP 伺服器和憑證。在「AI 登錄」頁面上,您可以使用代理程式、 MCP 伺服器和證明資料頁籤來檢視每個伺服器的清單。您可以使用搜尋列,依名稱或描述篩選可見的選項。在「代理程式」頁籤上,您可以使用排序依據下拉式功能表,依最近新增代理程式至登錄的方式排序。

按一下代理程式卡即可顯示該代理程式的詳細資訊,其中提供建立者、來源、版本、代理程式卡的 URL 以及協定版本。您可以使用卡片右上角的選項,在卡片的詳細資料檢視與 JSON 檢視之間切換。

在註冊新的外部代理程式或 MCP 伺服器之前,您必須先在證明資料頁籤中註冊其認證證明資料。然後,您可以按一下右上方的註冊並選取適當的選項來註冊新的代理程式和 MCP 伺服器。「AI 登錄」的權限是從權限頁籤進行管理。

關於代理卡

「代理程式卡」是描述代理程式的中繼資料結構。「AI 登錄」會在註冊期間讀取這些檔案,並在您確認之前顯示供您複查。

如需詳細資訊,請參閱 A2A 通訊協定規格。

代理程式卡包含下列資訊:
  • 名稱、版本及描述。
  • 代理程式卡 URL,也就是卡本身發布的位置。
  • 協定版本。
  • 輸入與輸出模式。例如 text、text/plain 或 text/html。
  • 功能,例如串流處理。
  • 技能,每個技能都有自己的名稱和描述。
卡片是與協調流程相符的項目。當使用者在未選取專員的情況下在「專員中心」中提出問題時,此卡片上的名稱、描述、技能及功能會決定專員是否顯示出來。Vague 說明是從未選取代理程式的最常見原因。

在 AI 登錄中建立證明資料

您可以儲存認證 AI Registry 物件 (例如代理程式和 MCP 伺服器) 時所需的證明資料。

  1. 在「首頁」上,按一下 AI 登錄圖示 AI 登錄。
  2. 按一下「證明資料」頁籤,然後按一下「建立證明資料」。
  3. 輸入證明資料的名稱和描述。
  4. 從下拉式功能表中選取「證明資料」類型。
  5. 從下拉式功能表中選取「授權」類型。
  6. 輸入證明資料的授權 URL 、存取權杖 URL 、從屬端 ID 、從屬端加密密碼以及重新整理 URL 。
  7. 輸入範疇名稱和值。至少需有一個範圍名稱與值。按一下新增範圍來新增其他範圍名稱和值。
  8. 複製重新導向 URL。您必須將「重新導向 URL」貼到您識別網域中的機密應用程式。下列範例示範如何將重新導向 URL 複製到 Oracle Cloud Infrastructure :
    1. 登入 OCI 主控台。
    2. 依序按一下識別與安全性、網域及整合式應用程式。
    3. 選取您要更新重新導向 URL 的應用程式。
    4. 按一下 OAuth 組態頁籤,然後按一下編輯 OAuth 組態。
    5. 套用任何所需的重新導向 URL,然後按一下提交。
  9. 按一下建立。

在 AI 登錄中註冊本機代理程式

您可以從可存取的 Oracle AI Data Platform 工作區註冊本機 AI 代理程式。

必須先在 AI Data Platform 中部署代理程式,才能在 AI 登錄中註冊代理程式。請參閱代理程式部署。
  1. 在「首頁」上,按一下 AI 登錄圖示 AI 登錄。
  2. 按一下「註冊」,然後按一下「代理程式」。
  3. 按一下本機代理程式。
  4. 從工作區下拉式功能表中,選取本機代理程式所在的工作區。
  5. 從代理程式下拉式功能表中,選取您要註冊的代理程式。
  6. 選擇性:將游標暫留在卡片圖示上以預覽服務人員卡片。
  7. 按下一步。
  8. 確認代理程式詳細資訊正確無誤,然後按一下註冊。

在 AI 登錄中註冊外部代理程式

您可以從支援的來源向 AI 登錄外部 AI 代理程式。這些代理程式必須符合 A2A 協定。

如果您的外部代理程式需要認證,請先在「AI 登錄」的證明資料頁籤中建立這些證明資料。
  1. 在「首頁」上,按一下 AI 登錄圖示 AI 登錄。
  2. 按一下「註冊」,然後按一下「代理程式」。
  3. 按一下外部代理程式。
  4. 輸入代理程式卡 URL。
  5. 選擇性:如果您的端點需要安全認證,請選取需要認證,然後從認證下拉式功能表中選取認證。
  6. 按下一步。
  7. 選擇性:如果您選取「需要認證」,請在顯示的對話方塊中輸入有權使用代理程式之帳戶的證明資料。
  8. 複查代理程式詳細資訊的正確性,然後按一下註冊。

在 AI 登錄中註冊 MCP 伺服器

MCP 伺服器會公開一組工具,讓代理程式可以透過標準介面尋找和呼叫。在 AI 登錄中註冊,即可在平台上使用這些工具。

附註:

如果您的 MCP 伺服器需要驗證,您必須先在 AI Registry 中建立 OAuth 憑證。註冊 MCP 伺服器時無法新增證明資料。
  1. 在「首頁」上,按一下 AI 登錄圖示 AI 登錄。
  2. 按一下「註冊」,然後按一下「MCP 伺服器」。
  3. 輸入 MCP 伺服器端點的 URL。
  4. 輸入有用的顯示名稱和描述。使用者和代理程式會使用這些資訊來識別 MCP 伺服器的用途。
  5. 從下拉式功能表中,選取傳輸方法。
  6. 選擇性:如果您的 MCP 伺服器需要安全證明資料,請選取需要認證。從證明資料下拉式功能表中選取證明資料。
  7. 按一下繼續。
  8. 檢閱所選 MCP 伺服器的內含工具清單。選取您要包含的個別工具,或按一下全選以包含所有列出的工具。
  9. 按一下註冊。