更新託管代理端點與代理卡

Important

本文中標示為預覽的項目目前仍在預覽中。 此預覽版未簽訂服務等級協議,Microsoft 不建議用於生產工作負載。 某些功能可能不被支援或功能受限。 欲了解更多資訊,請參閱 Microsoft Azure 預覽版補充使用條款。

使用 azd ai agent endpoint update 修補已部署的 Microsoft Foundry 代理程式上的端點和卡片中繼資料。 你可以更新面向消費者的細節,而不必刪除新的代理版本。

如果你使用像 GitHub Copilot 這樣的程式代理程式,Microsoft Foundry 技能可以幫助更新端點的元資料和代理卡設定,同時保持部署變更的獨立。

先決條件

  • 已部署至 Foundry 專案的現有代管代理程式。 endpoint update 不會建立託管代理。
  • 在 azure.yaml 中已宣告代理程式的 azd 專案,或明確指定的 Foundry 專案端點。 欲了解更多資訊,請參閱 設定 azd 專案上下文。
  • azd Foundry 的擴充功能已安裝。
  • 一個經過 azd 認證的會話。

決定何時更新元資料

當您只需要重新整理取用者和工具會讀取的代理程式相關中繼資料時,請使用 azd ai agent endpoint update。 這些元資料包含公開端點、顯示名稱、描述及聯絡資訊。

常見案例包括:

  • 你更改了代理卡上的公開顯示名稱或描述,並希望它能反映在 Foundry 入口網站中,而不必重新部署。
  • 你已變更或重新簽發公開代理程式端點 URL。
  • 你更新了卡片上的擁有者或聯絡人元資料,用於路由或治理。

如果你更改了模型、指令、工具、程式碼或環境變數,請不要使用 endpoint update。 這些改動需要新版本。 改為執行 azd deploy 或 azd up。

更新端點與卡片

  1. 在你的 agent_endpoint 檔案中編輯 agent_card 服務中的 azure.ai.agent 區段、azure.yaml 區段,或兩者。

  2. 執行更新指令:

    azd ai agent endpoint update
    
  3. 在多服務專案中,將服務名稱作為位置參數傳遞:

    azd ai agent endpoint update my-agent
    

CLI 會從代理服務 azure.yaml 讀取這兩個區段,並修補現有代理紀錄。 這個流程不會建立新的代理版本、重建容器,或更改任何基礎設施。

請確認更新內容

確認變更是否生效:

azd ai agent show

輸出結果反映了新的端點和卡片值。 版本號未變。

審查欄位已更新

endpoint update 只更新端點和卡片的元資料。 請使用表格來判斷你的變更是否需要完整部署。

azure.ai.agent 服務上的欄位 由 endpoint update 更新?
agent_endpoint Yes
agent_card Yes
model、model_deployment 否 - 需要 azd deploy
instructions 否 - 需要 azd deploy
tools、toolboxes、skills 否 - 需要 azd deploy
env 否 - 需要 azd deploy
容器映像 / 入口點 / 執行時 否 - 需要 azd deploy

如果你不確定變更是否符合 endpoint update資格,請在之後再跑 azd ai agent doctor 。 它會標示出 azure.yaml 與已部署的代理程式狀態之間的任何差異。