本文將教你如何在 API Center 註冊 A2A 代理,以及註冊後如何更新和管理它們。 你可以新增技能、設定能力,並更新提供者資訊。
先決條件
- Azure API Center 實例
- 由代理卡所描述的A2A代理人
- 在你的 API 中心編輯 API 的適當權限
登記代理人
從代理人的代理人卡輸入所需金額。 可選擇加入技能及其他元資料,定義你的 A2A 代理能執行的能力與動作。
小提示
欲了解詳細技能架構資訊,請參閱 Agent2Agent (A2A) 協定官方規範。
登入 Azure 入口網站,然後流覽至您的 API 中心。
在側邊欄功能表的 資產 下,選取 API>+ 註冊 API。
在 「註冊 API 」頁面,填寫 標準屬性 以註冊 API,並選擇 A2A 作為代理類型。
- 表單更新以顯示其他特定於 A2A API 類型的欄位。
在 代理人卡 欄位輸入以下細節:
領域 Description 協議版本 該代理所支援的 A2A 協定版本。 代理網址 與代理互動的首選端點網址。 優先交通方式 首選端點的傳輸協定。 代理程式版本 代理程式自己的版本號。 找到 經紀人技能 專區。
選取 [+ 新增]。
在 代理人技能 頁面,透過提供所需欄位的資訊來定義技能。
選擇 新增 以新增技能。
在 代理人提供者 欄位輸入以下資訊:
領域 Description 組織名稱 代理提供者的組織名稱 組織網址 代理供應商網站或相關文件的網址 根據需要啟用或停用 代理能力 :
領域 Description 串流支援 顯示代理程式是否支援串流回應的伺服器傳送事件 (SSE) 推播通知 表示代理是否支援發送非同步任務更新的推送通知 州過渡歷史 表示代理是否提供任務的狀態轉換歷史 選取 建立 以註冊 API。
更新程式代理
在 Azure 入口網站,前往你的 API 中心。
在側邊欄功能表的 資產 下,選取 API。
從表格中,透過選擇 [標題] 欄位中的代理程式名稱來選擇您的 A2A 代理程式。
選擇 編輯 按鈕,在工作窗格中開啟 編輯 頁面。
為你的經紀人增添技能
技能定義了你的A2A客服人員能執行的能力與行動。
小提示
欲了解詳細技能架構資訊,請參閱 Agent2Agent (A2A) 協定官方規範。
- 在 編輯 頁面,找到 經紀人技能 區塊。
- 選取 [+ 新增]。
- 在 代理人技能 頁面,透過提供所需欄位的資訊來定義技能。
- 選擇 新增 以新增技能。
新增提供者資訊
提供者資訊有助於其他團隊辨識誰負責維護該代理人。
在代理人 編輯 頁面,找到 代理人提供者 區塊。
輸入下列詳細資料:
領域 Description 組織名稱 代理人所屬組織名稱 組織網址 代理供應商網站或相關文件的網址 選取 [儲存]。
設定代理程式功能
代理能力描述你的 A2A 代理支援哪些功能。
在 編輯 頁面,找到代理 能力 區塊。
視需要啟用或停用以下功能:
領域 Description 串流支援 顯示代理程式是否支援串流回應的伺服器傳送事件 (SSE) 推播通知 表示代理是否支援發送非同步任務更新的推送通知 州過渡歷史 表示代理是否提供任務的狀態轉換歷史 選取 [儲存]。
局限性
API 管理中的代理對代理 API 不會與 API Center 同步。