Aktualizowanie punktu końcowego hostowanego agenta i karty agenta

Ważna

Elementy oznaczone podglądem w tym artykule są obecnie w wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług, a Microsoft nie zaleca korzystania z niej w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.

Użyj azd ai agent endpoint update, aby zaktualizować metadane punktu końcowego i karty w już wdrożonym agencie Microsoft Foundry. Możesz zaktualizować szczegóły widoczne dla klientów bez tworzenia nowej wersji agenta.

Jeśli używasz agenta kodowania, takiego jak GitHub Copilot, umiejętności Microsoft Foundry mogą pomóc w aktualizowaniu metadanych punktu końcowego i ustawień karty agenta przy zachowaniu oddzielnych zmian wdrożenia.

Wymagania wstępne

  • Istniejący agent hostowany wdrożony do projektu Foundry. endpoint update nie tworzy hostowanego agenta.
  • Projekt azd, w którym zadeklarowano agenta w azure.yaml, lub jawnie określony punkt końcowy projektu Foundry. Aby uzyskać więcej informacji, zobacz Ustawianie kontekstu projektu azd.
  • Zainstalowane rozszerzenia azd Foundry.
  • Uwierzytelniona sesja azd .

Zdecyduj, kiedy zaktualizować metadane

Użyj azd ai agent endpoint update, gdy wystarczy odświeżyć metadane, które odbiorcy i narzędzia odczytują na temat agenta. Te metadane obejmują publiczny punkt końcowy, nazwę wyświetlaną, opis i informacje kontaktowe.

Typowe przypadki obejmują:

  • Zmieniono publiczną nazwę wyświetlaną lub opis na karcie agenta i chcesz, aby została ona odzwierciedlona w portalu Foundry bez ponownego wdrożenia.
  • Przeniesiono lub ponownie wystawiono adres URL punktu końcowego agenta publicznego.
  • Zaktualizowano na karcie metadane właściciela lub osoby kontaktowej na potrzeby routingu lub zarządzania.

Jeśli zmieniono model, instrukcje, narzędzia, kod lub zmienne środowiskowe, nie używaj polecenia endpoint update. Te zmiany wymagają nowej wersji. Uruchom azd deploy lub azd up zamiast tego.

Zaktualizuj punkt końcowy i kartę

  1. Edytuj sekcję agent_endpoint, sekcję agent_card lub obie sekcje w usłudze azure.ai.agent w pliku azure.yaml.

  2. Uruchom polecenie aktualizacji:

    azd ai agent endpoint update

  3. W projekcie wielousługowym przekaż nazwę usługi jako argument pozycyjny:

    azd ai agent endpoint update my-agent

CLI odczytuje dwie sekcje z usługi agenta w azure.yaml i aktualizuje istniejący rekord agenta. Proces nie tworzy nowej wersji agenta, nie kompiluje kontenera ani nie zmienia żadnej infrastruktury.

Sprawdź aktualizację

Potwierdź, że zmiana weszła w życie:

azd ai agent show

Dane wyjściowe odzwierciedlają nowe wartości punktu końcowego i karty. Numer wersji jest niezmieniony.

Przejrzyj zaktualizowane pola

endpoint update aktualizuje tylko metadane punktu końcowego i karty. Użyj tabeli, aby zdecydować, czy zmiana wymaga pełnego wdrożenia.

Pole w usłudze azure.ai.agent Zaktualizowane przez endpoint update?
agent_endpoint Yes
agent_card Yes
model, model_deployment Nie — wymaga azd deploy
instructions Nie — wymaga azd deploy
tools, toolboxes, skills Nie — wymaga azd deploy
env Nie — wymaga azd deploy
Obraz kontenera / punkt wejścia / środowisko uruchomieniowe Nie — wymaga azd deploy

Jeśli nie masz pewności, czy zmiana kwalifikuje się do endpoint update, uruchom następnie azd ai agent doctor. Wskazuje wszelkie rozbieżności między azure.yaml a wdrożonym stanem agenta.

Treści powiązane

  • Ostatnia aktualizacja o