本文將教你如何在 API Center 註冊 AI 代理,包括 A2A 代理,讓使用者能發現它們,並更新和管理它們。
先決條件
- Azure API Center 實例
- 以 JSON 格式的 Agent 卡片或 Markdown 格式的 Agent 定義所描述的 Agent
- 在你的 API 中心編輯 API 的適當權限
登記代理人
登入 Azure 入口網站,然後前往你的 API 中心。
在側邊欄選單中,在 「物品欄」中選擇 「資產」。
選取 + 註冊資產>Agent。
在 「註冊代理人 」表單中,輸入以下表格所述的資訊:
領域 Description 標題 輸入客服人員的描述性名稱,例如客服台客服。 識別 API 中心會根據職稱自動產生識別碼,例如 幫助台代理。 如果需要,你可以編輯這個識別碼。 簡短摘要 輸入一段簡短的單行描述,說明代理程式的功能;此描述會顯示於 API Center 入口網站及其他位置。 Description 可選擇性地輸入更詳細的技能描述、使用情境與行為。 版本 版本標題 輸入您選擇的版本標題,例如 v1。 版本識別 API Center 會根據版本標題自動產生識別碼。 如果需要,你可以編輯這個識別碼。 版本生命週期 從下拉選單中選擇代理版本生命週期的當前階段。 在 API Center 了解更多版本資訊。 代理程式詳細資料 代理人定義 輸入 URL 或 選擇檔案 以上傳代理程式定義。 代理定義應以 Markdown 格式呈現,並包含代理能力、技能及其他相關資訊的詳細資訊。 通訊協定 若適用,若代理人遵守 A2A 協議,請選擇該協議。 代理人卡 可選擇輸入網址或 選擇檔案 ,上傳 JSON 格式的 A2A 代理卡。
選擇 建立 以新增代理人。
註冊後,代理人會出現在你的庫存>資產頁面。
更新登記代理人
您可以隨時更新代理人資訊。
- 在 Azure 入口網站,前往你的 API 中心。
- 在側邊欄選單中,在 「物品欄」中選擇 「資產」。
- 在表格中,選取 Title 欄中的代理人名稱。
- 選擇 編輯 按鈕,在工作窗格中開啟 編輯 頁面。
- 請先更改並選擇 儲存。
從 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 資產的自動評估:
在 Azure 入口網站,前往你的 API 中心。
在側邊欄選單裡。 前往 治理>>人工智慧評估。
選擇「 技能 」標籤來設定技能評量,或選擇「 代理人」 標籤來設定客服人員的評量。
在 評估狀態中,選擇 啟用。
輸入評估的 說明 。
在 評量標準中,請執行以下其中一項:
- 接受 API 中心提供的 預設 條件。 可選擇性地移除與你組織無關的預設標準。
以下截圖顯示技能的預設條件:
- 新增一個或多個自訂條件。
- 選擇 + 新增條件。
- 請輸入此準則的 名稱 及選填的 評量指示。
- 輸入 最低分 數與 最高分 數值(例如1和5)。
- 輸入 一個通過門檻 值(例如3),表示該標準的最低可接受分數。
- 輸入一個權 重 值,表示該準則對整體評量的貢獻(例如,權重為0.3會將分數乘以0.3,總評量貢獻30%)。
- 重複上述步驟,視需要增加更多標準。
選取 [儲存]。
接著你可以在 API 中心入口網站查看評估結果。 例如,在技能詳情頁面查看每個技能的評量結果。