Aktualisieren eines gehosteten Agent-Endpunkts und einer Agentkarte

Important

Elemente, die in diesem Artikel als Vorschau gekennzeichnet sind, befinden sich derzeit in der Vorschau. Diese Vorschau wird ohne Service Level Agreement (SLA) bereitgestellt, und Microsoft empfiehlt sie nicht für Produktionsworkloads. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Supplementale Nutzungsbedingungen für Microsoft Azure Previews.

Verwenden Sie azd ai agent endpoint update, um die Endpunkt- und Kartenmetadaten eines bereits bereitgestellten Microsoft Foundry-Agents zu aktualisieren. Sie können für Kunden sichtbare Details aktualisieren, ohne eine neue Agent-Version zu erstellen.

Wenn Sie einen Programmieragenten wie GitHub Copilot verwenden, kann die Microsoft Foundry Skill dabei helfen, Endpunktmetadaten und die Einstellungen der Agent-Card zu aktualisieren, während Bereitstellungsänderungen separat bleiben.

Voraussetzungen

  • Ein vorhandener gehosteter Agent, der in einem Foundry-Projekt bereitgestellt wird. endpoint update erstellt keinen gehosteten Agent.
  • Ein azd-Projekt mit einem in azure.yaml deklarierten Agent oder einem explizit angegebenen Foundry-Projektendpunkt. Weitere Informationen finden Sie unter "Festlegen des azd-Projektkontexts".
  • Die azd Foundry Erweiterungen installiert.
  • Eine authentifizierte azd Sitzung.

Entscheiden, wann Metadaten aktualisiert werden sollen

Verwenden Sie azd ai agent endpoint update, wenn Sie nur Metadaten aktualisieren müssen, die Consumer und Tools über den Agent lesen. Diese Metadaten umfassen den öffentlichen Endpunkt, den Anzeigenamen, die Beschreibung und die Kontaktinformationen.

Häufige Fälle sind:

  • Sie haben den öffentlich zugänglichen Anzeigenamen oder die Beschreibung auf der Agent-Karte geändert und möchten, dass dies im Foundry-Portal widergespiegelt wird, ohne eine erneute Bereitstellung durchzuführen.
  • Sie haben die URL des öffentlichen Agent-Endpunkts verschoben oder neu ausgestellt.
  • Sie haben Besitzer- oder Kontaktmetadaten auf der Karte für Routing oder Governance aktualisiert.

Wenn Sie das Modell, Anweisungen, Tools, Code oder Umgebungsvariablen geändert haben, verwenden Sie endpoint update nicht. Diese Änderungen benötigen eine neue Version. Führen Sie stattdessen azd deploy oder azd up aus.

Aktualisieren des Endpunkts und der Karte

  1. Bearbeiten Sie den agent_endpoint Abschnitt, den agent_card Abschnitt oder beide Abschnitte im azure.ai.agent Dienst in Ihrer azure.yaml Datei.

  2. Führen Sie den Updatebefehl aus:

    azd ai agent endpoint update

  3. Übergeben Sie in einem Projekt mit mehreren Diensten den Dienstnamen als Positionsparameter:

    azd ai agent endpoint update my-agent

Die CLI liest die beiden Abschnitte aus dem Agentdienst in azure.yaml und aktualisiert den bestehenden Agentendatensatz. Der Prozess erstellt keine neue Agentversion, erstellt einen Container neu oder ändert keine Infrastruktur.

Überprüfen des Updates

Bestätigen Sie, dass die Änderung wirksam wurde:

azd ai agent show

Die Ausgabe spiegelt die neuen Endpunkt- und Kartenwerte wider. Die Versionsnummer ist unverändert.

Überprüfen von Feldern, die aktualisiert wurden

endpoint update aktualisiert nur Endpunkt- und Kartenmetadaten. Verwenden Sie die Tabelle, um zu entscheiden, ob Ihre Änderung eine vollständige Bereitstellung erfordert.

Feld für den azure.ai.agent Dienst Aktualisiert von endpoint update?
agent_endpoint Yes
agent_card Yes
model, model_deployment Nein – erfordert azd deploy
instructions Nein – erfordert azd deploy
tools, toolboxesskills Nein – erfordert azd deploy
env Nein – erfordert azd deploy
Containerimage/ Einstiegspunkt/Laufzeit Nein – erfordert azd deploy

Wenn Sie nicht sicher sind, ob eine Änderung für endpoint update infrage kommt, führen Sie anschließend azd ai agent doctor aus. Sie markiert alle Abweichungen zwischen azure.yaml und dem Status des bereitgestellten Agenten.

Verwandte Inhalte

  • Zuletzt aktualisiert um