Agent 365 CLI

Agent 365 CLI to wieloplatformowe narzędzie wiersza poleceń do wdrażania i zarządzania aplikacjami Agent 365 w Azure.

Nie musisz instalować CLI ręcznie. Konfiguracja sterowana przez AI sprawdza obecność CLI, instaluje go lub aktualizuje automatycznie oraz wykonuje wszystkie wymagane polecenia w Twoim imieniu. Ta strona jest źródłem informacji dla programistów, którzy muszą bezpośrednio zainstalować lub korzystać z CLI – na przykład podczas budowania automatyzacji CI/CD, rozwiązywania problemów z określonym krokiem lub pracy bez agenta kodującego AI.

Notatka

Pełny workflow dewelopera – w tym konfiguracja sterowana przez AI, wskazówki dotyczące ról oraz kroki po wdrożeniu – znajduje się w Rozpocznij rozwój Agent 365. Ta strona to referencja CLI: instalacja, aktualizacja, odinstalowanie, dostępne polecenia i rozwiązywanie problemów.

Wymagania wstępne

CLI wymaga .NET 8.0 lub nowszej. W przypadku pozostałych wymagań – subskrypcji Azure, wymaganych ról Entra oraz rejestracji własnej aplikacji klienckiej – zobacz konfigurację wspomaganą przez AI.

Zainstaluj Agent 365 CLI

Wykonaj poniższe kroki, aby zainstalować Agent 365 CLI jako narzędzie globalne na swoim systemie operacyjnym.

Wymagania wstępne

Musisz mieć zainstalowany .NET. (Zalecamy przeglądarkę .NET 8.0).

Użyj polecenia „dotnet tool install”

Przejrzyj dane Agent 365 CLI i zainstaluj go, używając poniższego polecenia:

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli

Aby uzyskać najnowsze instrukcje i dostępne wersje, odwiedź oficjalną stronę NuGet: Microsoft.Agents.A365.DevTools.Cli on NuGet.org

Sprawdzanie instalacji

Po zainstalowaniu narzędzia Agent 365 CLI, sprawdź, czy zostało poprawnie zainstalowane, uruchamiając polecenie --help:

a365 -h

To polecenie wyświetla informacje dotyczące pomocy i potwierdza gotowość CLI do użycia.

Zaktualizuj

Zaktualizuj Agent 365 CLI za pomocą polecenia dotnet tool update:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

Notatka

Aby zaktualizować CLI Agent 365, potrzebujesz połączenia internetowego, aby uzyskać dostęp do najnowszego pakietu NuGet: Microsoft.Agents.A365.DevTools.Cli.

Odinstaluj

Odinstaluj Agent 365 CLI za pomocą polecenia dotnet tool uninstall:

dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli

Lokalizacje pliku

Domyślna lokalizacja pliku wykonywalnego narzędzia zależy od systemu operacyjnego:

System operacyjny Ścieżka
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

SDK dodaje tę lokalizację do zmiennej środowiskowej PATH, gdy zostanie uruchomiony po raz pierwszy. Dzięki temu możesz uruchamiać narzędzia globalne z dowolnego katalogu bez podawania lokalizacji narzędzia.

Dostęp do narzędzia jest przypisany do użytkownika, a nie globalny dla systemu. Narzędzie globalne jest dostępne tylko dla użytkownika, który je zainstaluje.

Dostępne polecenia

Aby uzyskać pełną listę dostępnych poleceń, użyj polecenia --help lub zapoznaj się z dokumentacją Agent 365 CLI Reference.

Wskazówka

Nie musisz ręcznie uruchamiać poleceń CLI. AI-guided setup automatyzuje cały przepływ pracy – instalację CLI, konfigurację, konfigurację blueprintów, wdrażanie i publikowanie – przy użyciu agenta AI do kodowania. Skorzystaj z dokumentacji CLI tutaj, jeśli tworzysz automatyzację CI/CD, rozwiązujesz problemy na określonym etapie lub pracujesz bez agenta kodującego AI.

Pełne instrukcje dotyczące konfiguracji agenta Agent 365 za pomocą CLI znajdziesz w artykule Rozpocznij rozwój Agent 365.

Rozwiązywanie problemów

Ta sekcja zawiera informacje o tym, jak diagnozować i rozwiązywać błędy związane z Agent 365 CLI.

Wskazówka

Przewodnik po rozwiązywaniu problemów Agent 365 zawiera wysokopoziomowe zalecenia dotyczące rozwiązywania problemów, najlepsze praktyki oraz odnośniki do treści dotyczących rozwiązywania problemów dla każdego etapu cyklu rozwoju Agent 365.

Problemy specyficzne dla CLI omawiane w tej sekcji:

Agent nie pojawia się w Teams

Rozwiązywanie problemów z tworzeniem instancji agenta: Agent nie pojawia się w Teams

Nie można utworzyć instancji agenta w Teams

Tworzenie instancji agentów – rozwiązywanie problemów: Nie można utworzyć instancji agenta w Teams

  • Last updated on