共用方式為


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

本文將教你如何在 API Center 註冊 A2A 代理,以及註冊後如何更新和管理它們。 你可以新增技能、設定能力,並更新提供者資訊。

先決條件

  • Azure API Center 實例
  • 由代理卡所描述的A2A代理人
  • 在你的 API 中心編輯 API 的適當權限

登記代理人

從代理人的代理人卡輸入所需金額。 可選擇加入技能及其他元資料,定義你的 A2A 代理能執行的能力與動作。

小提示

欲了解詳細技能架構資訊,請參閱 Agent2Agent (A2A) 協定官方規範

  1. 登入 Azure 入口網站,然後流覽至您的 API 中心。

  2. 在側邊欄功能表的 資產 下,選取 API>+ 註冊 API

  3. 「註冊 API 」頁面,填寫 標準屬性 以註冊 API,並選擇 A2A 作為代理類型。

    • 表單更新以顯示其他特定於 A2A API 類型的欄位。
  4. 代理人卡 欄位輸入以下細節:

    領域 Description
    協議版本 該代理所支援的 A2A 協定版本。
    代理網址 與代理互動的首選端點網址。
    優先交通方式 首選端點的傳輸協定。
    代理程式版本 代理程式自己的版本號。
  5. 找到 經紀人技能 專區。

  6. 選取 [+ 新增]。

  7. 代理人技能 頁面,透過提供所需欄位的資訊來定義技能。

  8. 選擇 新增 以新增技能。

  9. 代理人提供者 欄位輸入以下資訊:

    領域 Description
    組織名稱 代理提供者的組織名稱
    組織網址 代理供應商網站或相關文件的網址
  10. 根據需要啟用或停用 代理能力

    領域 Description
    串流支援 顯示代理程式是否支援串流回應的伺服器傳送事件 (SSE)
    推播通知 表示代理是否支援發送非同步任務更新的推送通知
    州過渡歷史 表示代理是否提供任務的狀態轉換歷史
  11. 選取 建立 以註冊 API。

更新程式代理

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

  2. 在側邊欄功能表的 資產 下,選取 API。

  3. 從表格中,透過選擇 [標題] 欄位中的代理程式名稱來選擇您的 A2A 代理程式。

  4. 選擇 編輯 按鈕,在工作窗格中開啟 編輯 頁面。

    Azure 入口網站中 AI 代理總覽的截圖,編輯按鈕被高亮顯示。

為你的經紀人增添技能

技能定義了你的A2A客服人員能執行的能力與行動。

小提示

欲了解詳細技能架構資訊,請參閱 Agent2Agent (A2A) 協定官方規範

  1. 編輯 頁面,找到 經紀人技能 區塊。
  2. 選取 [+ 新增]。
  3. 代理人技能 頁面,透過提供所需欄位的資訊來定義技能。
  4. 選擇 新增 以新增技能。

新增提供者資訊

提供者資訊有助於其他團隊辨識誰負責維護該代理人。

  1. 在代理人 編輯 頁面,找到 代理人提供者 區塊。

  2. 輸入下列詳細資料:

    領域 Description
    組織名稱 代理人所屬組織名稱
    組織網址 代理供應商網站或相關文件的網址
  3. 選取 [儲存]。

設定代理程式功能

代理能力描述你的 A2A 代理支援哪些功能。

  1. 編輯 頁面,找到代理 能力 區塊。

  2. 視需要啟用或停用以下功能:

    領域 Description
    串流支援 顯示代理程式是否支援串流回應的伺服器傳送事件 (SSE)
    推播通知 表示代理是否支援發送非同步任務更新的推送通知
    州過渡歷史 表示代理是否提供任務的狀態轉換歷史
  3. 選取 [儲存]。

局限性

API 管理中的代理對代理 API 不會與 API Center 同步。

Agent registry in Azure API Center