註冊和管理 Azure API Center 中的代理

本文將教你如何在 API Center 註冊 AI 代理,包括 A2A 代理,讓使用者能發現它們,並更新和管理它們。

先決條件

  • Azure API Center 實例
  • 以 JSON 格式的 Agent 卡片或 Markdown 格式的 Agent 定義所描述的 Agent
  • 在你的 API 中心編輯 API 的適當權限

登記代理人

  1. 登入 Azure 入口網站,然後前往你的 API 中心。

  2. 在側邊欄選單中,在 「物品欄」中選擇 「資產」。

  3. 選取 + 註冊資產>Agent。

    在入口網站註冊代理人的截圖。

  4. 在 「註冊代理人 」表單中,輸入以下表格所述的資訊:

    領域 Description
    標題 輸入客服人員的描述性名稱,例如客服台客服。
    識別 API 中心會根據職稱自動產生識別碼,例如 幫助台代理。 如果需要,你可以編輯這個識別碼。
    簡短摘要 輸入一段簡短的單行描述,說明代理程式的功能;此描述會顯示於 API Center 入口網站及其他位置。
    Description 可選擇性地輸入更詳細的技能描述、使用情境與行為。
    版本
    版本標題 輸入您選擇的版本標題,例如 v1。
    版本識別 API Center 會根據版本標題自動產生識別碼。 如果需要,你可以編輯這個識別碼。
    版本生命週期 從下拉選單中選擇代理版本生命週期的當前階段。 在 API Center 了解更多版本資訊。
    代理程式詳細資料
    代理人定義 輸入 URL 或 選擇檔案 以上傳代理程式定義。 代理定義應以 Markdown 格式呈現,並包含代理能力、技能及其他相關資訊的詳細資訊。
    通訊協定 若適用,若代理人遵守 A2A 協議,請選擇該協議。
    代理人卡 可選擇輸入網址或 選擇檔案 ,上傳 JSON 格式的 A2A 代理卡。

    Azure入口中註冊代理人面板的截圖。

  5. 選擇 建立 以新增代理人。

註冊後,代理人會出現在你的庫存>資產頁面。

更新登記代理人

您可以隨時更新代理人資訊。

  1. 在 Azure 入口網站,前往你的 API 中心。
  2. 在側邊欄選單中,在 「物品欄」中選擇 「資產」。
  3. 在表格中,選取 Title 欄中的代理人名稱。
  4. 選擇 編輯 按鈕,在工作窗格中開啟 編輯 頁面。
  5. 請先更改並選擇 儲存。

從 API 來源同步代理程式

為了自動化代理人註冊並保持庫存最新,您可以將以下上游來源整合至您的 API 中心:

  • Azure API 管理:如果你在Azure API 管理管理 A2A 代理,可以啟用自動同步,讓 API 中心保持最新。 若要深入瞭解,請參閱 從 Azure API 管理實例同步 API。

  • Git 倉庫:對於儲存在 Git 倉庫中的 A2A 代理及其他 AI 資產,您可以啟用自動同步,以保持 API 中心的更新。 更多資訊請參閱 從 Git 倉庫同步 API 資產。

在 API 中心入口網站中發現代理

建立您的 API 中心入口網站 ,讓開發者及組織中的其他利害關係人能在 API 庫存中發現代理。 透過 API 中心入口網站,使用者可以:

  • 瀏覽並篩選庫存中的代理人。
  • 查看每位代理人的詳細資訊。

評估 AI 資產

API 中心可評估已註冊於您的 API 中心中的 AI 資產(例如技能和代理程式)的品質。 API Center 預設有評估標準,能在預先定義的維度上評估資產。 企業平台管理員可進一步擴展這些預設,定義符合組織特定標準、合規要求及治理政策的客製化評估標準。

要啟用對你庫存中 AI 資產的自動評估:

  1. 在 Azure 入口網站,前往你的 API 中心。

  2. 在側邊欄選單裡。 前往 治理>>人工智慧評估。

  3. 選擇「 技能 」標籤來設定技能評量,或選擇「 代理人」 標籤來設定客服人員的評量。

  4. 在 評估狀態中,選擇 啟用。

  5. 輸入評估的 說明 。

  6. 在 評量標準中,請執行以下其中一項:

    • 接受 API 中心提供的 預設 條件。 可選擇性地移除與你組織無關的預設標準。

    以下截圖顯示技能的預設條件:

    入口網站中 AI 技能評估設定的截圖。

    • 新增一個或多個自訂條件。
      1. 選擇 + 新增條件。
      2. 請輸入此準則的 名稱 及選填的 評量指示。
      3. 輸入 最低分 數與 最高分 數值(例如1和5)。
      4. 輸入 一個通過門檻 值(例如3),表示該標準的最低可接受分數。
      5. 輸入一個權 重 值,表示該準則對整體評量的貢獻(例如,權重為0.3會將分數乘以0.3,總評量貢獻30%)。
      6. 重複上述步驟,視需要增加更多標準。
  7. 選取 [儲存]。

接著你可以在 API 中心入口網站查看評估結果。 例如,在技能詳情頁面查看每個技能的評量結果。

API 中心入口網站技能評估的截圖。