Udostępnij za pośrednictwem

Dokumentacja poleceń interfejsu wiersza polecenia deploy agenta 365

Ważne

Aby uzyskać wczesny dostęp do programu Microsoft Agent 365, musisz być częścią programu Frontier w wersji zapoznawczej. Usługa Frontier łączy Cię bezpośrednio z najnowszymi innowacjami firmy Microsoft dotyczącymi sztucznej inteligencji. Wersje zapoznawcze platformy Frontier podlegają istniejącym warunkom obowiązywania wersji zapoznawczej umów klienta. Ponieważ te funkcje są nadal opracowywane, ich dostępność i możliwości mogą ulec zmianie w miarę upływu czasu.

Wdrażanie plików binarnych aplikacji agenta 365 w skonfigurowanych Azure App Service i aktualizowanie uprawnień narzędzia Agent 365 Polecenie deploy udostępnia opcje tworzenia wdrożeń agenta 365. Użyj tego polecenia, aby wdrożyć pliki binarne aplikacji w infrastrukturze Azure i przyznać uprawnienia Narzędzia agenta 365.

wymagana rola Minimum: Azure Współautor + Global Administrator

Aby uzyskać informacje na temat korzystania z tego polecenia, zobacz Deploy agent to Azure.

Składnia

a365 deploy [command] [options]

Opcje

Option Description
-c, --config <config> Ścieżka do pliku konfiguracji (wartość domyślna: a365.config.json)
-v, --verbose Włącz szczegółowe logowanie
--dry-run Pokaż, co można zrobić bez wykonywania
--inspect Wstrzymywanie przed wdrożeniem w celu sprawdzenia folderu publikowania i zawartości zip
--restart Pomiń kompilację i rozpocznij od skompresowania istniejącego folderu publikowania (aby przyspieszyć iterację po ręcznych zmianach)
-?, , -h--help Pokaż informacje pomocy i użycia

Uwagi

Uruchomienie a365 deploy bez podpolecenia powoduje uruchomienie wdrożenia dwufazowego:

  • Phase 1 — pliki binarne aplikacji: kompiluje i wdraża aplikację w Azure App Service.
  • Faza 2 — uprawnienia MCP: odczytuje wymagane zakresy z toolingManifest.json i aktualizuje strategię agenta przy użyciu niezbędnych uprawnień.

Obie fazy są uruchamiane nawet przy użyciu polecenia --dry-run. Dane wyjściowe przebiegu suchego są podzielone na dwie oznaczone etykietami sekcje, dzięki czemu można sprawdzić, co zrobi każda faza.

Testy wstępne

Przed wdrożeniem interfejs wiersza polecenia sprawdza poprawność:

  • Azure uwierzytelnianie i subskrypcja: Sesja Azure CLI i subskrypcja muszą być prawidłowe. Jeśli tak nie jest, wdrożenie zatrzymuje się z powodu błędu. Naprawiono za pomocą polecenia az login --tenant <TENANT_ID> i az account set --subscription <SUBSCRIPTION_ID>.
  • Azure App Service istnienie: Docelowa aplikacja internetowa musi istnieć przed kontynuowaniem wdrażania. Jeśli aplikacja nie zostanie znaleziona, uruchom a365 setup polecenie lub poprawność webAppName i resourceGroup w pliku a365.config.json.

Konfiguracja

Interfejs wiersza polecenia odczytuje z dwóch plików konfiguracji:

  • a365.config.json — konfiguracja projektu (utrzymywana przez użytkownika).
  • a365.generated.config.json — stan dynamiczny generowany przez polecenia konfiguracji.

Zakresy narzędzi MCP są odczytywane toolingManifest.json z katalogu projektu wdrożenia.

Interfejs wiersza polecenia przechowuje również globalną kopię konfiguracji i stanu w:

  • Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli
  • Linux/macOS: ~/.config/a365

Zachowanie flagi

--restart: pomija krok kompilacji i rozpoczyna się bezpośrednio od kompresji istniejącego publish/ folderu. Jeśli publish/ nie istnieje, wdrożenie zakończy się niepowodzeniem. Uruchom pełne wdrożenie (bez --restart) najpierw, aby utworzyć publish/ folder.

--inspect: wstrzymuje się przed wykonaniem kroku przekazywania, aby można było sprawdzić publish/ folder i wygenerowany plik ZIP. Dostępne tylko dla fazy aplikacji.

--dry-run: Drukuje wszystko, co się stanie bez wprowadzania żadnych zmian. Podczas uruchamiania a365 deploy (dwufazowe) dane wyjściowe są podzielone na:

  • Część 1 — Wdrażanie plików binarnych aplikacji
  • Część 2 — Wdrażanie/aktualizowanie uprawnień narzędzia agenta 365

deploy app

Wdraża kod agenta w aplikacji internetowej Azure utworzonej podczas instalacji.

a365 deploy app [options]

Wdróż pliki binarne aplikacji programu Microsoft Agent 365 w skonfigurowanym Azure App Service. To polecenie wdraża pliki binarne aplikacji w skonfigurowanej usłudze Azure App Service w Azure.

app Opcje

Option Description
-c, --config <config> Ścieżka do pliku konfiguracji (wartość domyślna: a365.config.json)
-v, --verbose Włącz szczegółowe logowanie
--dry-run Pokaż, co można zrobić bez wykonywania
--inspect Wstrzymywanie przed wdrożeniem w celu sprawdzenia folderu publikowania i zawartości zip
--restart Pomiń kompilację i rozpocznij od skompresowania istniejącego folderu publikowania (aby przyspieszyć iterację po ręcznych zmianach)
-?, , -h--help Pokaż informacje pomocy i użycia

deploy mcp

Aktualizuje uprawnienia serwera MCP w strategii agenta.

a365 deploy mcp [options]

mcp Opcje

Option Description
-c, --config <config> Ścieżka pliku konfiguracji (wartość domyślna: a365.config.json)
-v, --verbose Włącz szczegółowe logowanie
--dry-run Pokaż, co można zrobić bez wykonywania
-?, , -h--help Pokaż informacje pomocy i użycia

Uwagi dotyczące użycia

Zaktualizuj zakresy i uprawnienia serwerów MCP w istniejącej strategii agenta. To polecenie dodaje uprawnienia dla narzędzi Agent 365 do strategii agenta.

Jeśli dodasz lub zmodyfikujesz serwery MCP w kodzie agenta, użyj tego polecenia, aby zaktualizować uprawnienia do strategii agenta.

To polecenie:

  • Odczytuje konfigurację serwera MCP z kodu.
  • Aktualizuje strategię agenta z wymaganymi uprawnieniami.
  • Przyznaje niezbędne uprawnienia interfejsu API dla serwerów MCP.

Aktualizacja uprawnień ma zastosowanie w następującej kolejności:

  1. Udzielanie uprawnień OAuth2 (jednostka usługi strategii → platformy MCP)
  2. Uprawnienia dziedziczone (strategia agenta → zasób MCP)
  3. Zgoda administratora (tożsamość agenta → platformy MCP)

Kiedy należy użyć polecenia deploy mcp:

  • Po dodaniu nowych serwerów MCP do agenta.
  • Po zmianie konfiguracji serwera MCP.
  • Gdy narzędzia MCP nie są dostępne dla agenta.

Nie musisz uruchamiać polecenia deploy mcp:

  • Podczas początkowego wdrażania. Ta funkcja jest obsługiwana automatycznie podczas instalacji.
  • W przypadku zmiany logiki agenta tylko bez zmian MCP.
  • Po rutynowych aktualizacjach kodu, które nie mają wpływu na narzędzia.

Uwaga / Notatka

a365 deploy mcp tylko aktualizuje uprawnienia — nie wdraża kodu. Uruchom najpierw polecenie a365 deploy app , jeśli masz zmiany kodu.

Troubleshooting

Skorzystaj z poniższych sekcji, aby rozwiązać potencjalne problemy z poleceniem deploy .

Nie zalogowano się do Azure lub nieprawidłowej subskrypcji

Uruchom az login --tenant <TENANT_ID> i az account set --subscription <SUBSCRIPTION_ID>.

Nie można odnaleźć aplikacji internetowej

Upewnij się a365 setup , że uruchomiono polecenie lub sprawdź, czy webAppName element i resourceGroup jest poprawny w pliku a365.config.json.

Aktualizacja uprawnień kończy się niepowodzeniem

  • Upewnij się, że AgentBlueprintIdustawienia , AgenticAppIdi środowiska są ustawione w elem.a365.config.json
  • Upewnij się, że Twoje konto ma uprawnienia do zarządzania jednostkami usługi i grantami.
  • Sprawdź, czy toolingManifest.json istnieje w katalogu projektu wdrożenia i zawiera prawidłowe zakresy.

--restart Nie powiedzie się

Uruchom pełne wdrożenie bez --restart , aby utworzyć publish/ folder, a następnie użyj --restart go do kolejnych iteracji.

Dzienniki

Pliki dziennika interfejsu wiersza polecenia są przechowywane w:

  • Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli\logs\
  • Linux/macOS: ~/.config/a365/logs/

Aby wyświetlić ostatnie 80 wierszy najnowszego pliku dziennika wdrażania, użyj Get-Content w Windows lub tail w systemie Linux/macOS:

# Windows
Get-Content $env:LOCALAPPDATA\Microsoft.Agents.A365.DevTools.Cli\logs\a365.deploy.log -Tail 80

# Linux/macOS
tail -80 ~/.config/a365/logs/a365.deploy.log

W przypadku dzienników aplikacji środowiska uruchomieniowego użyj Log Stream w portalu Azure dla narzędzia stdout/stderr z usługi App Service.

  • Last updated on