Interfejs wiersza polecenia 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.

Interfejs wiersza polecenia agenta 365 to międzyplatformowe narzędzie wiersza polecenia do wdrażania aplikacji agenta 365 i zarządzania nimi na platformie Azure.

Instalowanie interfejsu wiersza polecenia agenta 365

Wykonaj poniższe kroki, aby zainstalować interfejs wiersza polecenia agenta 365 globalnie w systemie operacyjnym.

Wymagania wstępne

Musisz mieć zainstalowaną platformę .NET. Zalecany jest protokół TLS 1.2.

Instalowanie platformy .NET w systemie Windows

Linux

Instalowanie platformy .NET w systemie Linux

macOS

Instalowanie platformy .NET w systemie macOS

Korzystanie z instalacji narzędzia dotnet

Zainstaluj agenta gościa przy użyciu następującego polecenia:

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

Jeśli wystąpi microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json błąd, użyj parametru --prerelease , ponieważ ten pakiet może być nadal oznaczony jako w wersji wstępnej.

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

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

Sprawdzanie instalacji

Po zainstalowaniu interfejsu wiersza polecenia agenta 365 sprawdź, czy jest on poprawnie zainstalowany, uruchamiając polecenie:

a365 -h

To polecenie wyświetla informacje pomocy i potwierdza, że interfejs wiersza polecenia jest gotowy do użycia.

Zaktualizuj

Zaktualizuj interfejs wiersza polecenia agenta 365 za pomocą polecenia dotnet tool update :

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

Notatka

Wszystkie aktualizacje interfejsu wiersza polecenia agenta 365 wymagają połączenia internetowego w celu uzyskania dostępu do najnowszego pakietu NuGet: Microsoft.Agents.A365.DevTools.Cli

Odinstaluj program

Odinstaluj interfejs wiersza polecenia agenta 365 przy użyciu polecenia dotnet tool uninstall :

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

Lokalizacja 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

Ta lokalizacja jest dodawana do ścieżki użytkownika po pierwszym uruchomieniu zestawu SDK. Dlatego narzędzia globalne mogą być wywoływane z dowolnego katalogu bez określania lokalizacji narzędzia.

Dostęp do narzędzi jest specyficzny dla użytkownika, a nie globalny komputer. Narzędzie globalne jest dostępne tylko dla użytkownika, który zainstalował to narzędzie.

Dostępne polecenia

Aby uzyskać pełną listę dostępnych poleceń, użyj polecenia lub zobacz Dokumentacja interfejsu --help wiersza polecenia agenta 365

Rozwiązywanie problemów

Ta sekcja zawiera informacje dotyczące rozwiązywania problemów z błędami w interfejsie wiersza polecenia agenta 365.

Instalowanie, aktualizowanie lub odinstalowywanie interfejsu wiersza polecenia kończy się niepowodzeniem Not found in NuGet feeds

Jeśli wystąpi microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json błąd, użyj parametru --prerelease , ponieważ ten pakiet może być nadal oznaczony jako w wersji wstępnej.

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

Instalacja kończy się niepowodzeniem z Authorization_RequestDenied powodu błędu

Jeśli podczas uruchamiania Authorization_RequestDeniedsetup polecenia wystąpi błąd, oznacza to problem z uprawnieniami w środowisku firmy Microsoft Entra.

Typowe przyczyny

Ten problem zwykle występuje, gdy:

• Twoje konto nie ma wymaganych uprawnień
• Aplikacja Microsoft Graph Command Line Tools wymaga zgody administratora
• Uprawnienia powodujące konflikt lub naduprzywilejowane są obecne w twoim środowisku

Kroki umożliwiające rozwiązanie problemów

1. Sprawdź, czy Twoje konto ma rolę Czytelnika

   Upewnij się, że zalogowano się przy użyciu konta, które ma jedną z następujących ról:

   • Deweloper identyfikatora agenta
   • Administrator identyfikatora agenta
   • Globalny administrator usługi

2. Przeglądanie i udzielanie zgody administratora dla narzędzi wiersza polecenia programu Microsoft Graph

   Polecenie konfiguracji a365 używa aplikacji Microsoft Graph Command Line Tools, która może mieć uprawnienia powodujące konflikt.

   Aby przejrzeć i naprawić:

   1. Zaloguj się do witryny Azure Portal.

   2. Wyszukaj pozycję Narzędzia wiersza polecenia programu Microsoft Graph lub wyszukaj identyfikator aplikacji:14d82eec-204b-4c2f-b7e8-296a70dab67e

   3. Wybierz pozycję Uprawnienia zabezpieczeń>w obszarze nawigacji.

   4. Directory.AccessAsUser.All Wyszukaj uprawnienie

      • To uprawnienie o wysokim poziomie uprawnień zakłóca tworzenie strategii
      • Jeśli jest obecny, rozważ usunięcie go lub zastąpienie go alternatywami z najmniejszymi uprawnieniami, takimi jak Directory.Read.All

      Ostrzeżenie

      Usuń to uprawnienie tylko wtedy, gdy masz pewność, że nie jest to wymagane przez inne narzędzia lub skrypty w danym środowisku

   5. Jeśli zgoda administratora nie została jeszcze udzielona, wybierz pozycję Udziel zgody administratora dla [dzierżawy].

3. Po wprowadzeniu zmian uruchom a365 setup ponownie

Dodatkowe zasoby

Aby uzyskać więcej informacji na temat tego znanego problemu, zobacz Microsoft Entra Agent ID znane problemy — Directory.AccessAsUser.All powoduje ignorowanie innych uprawnień.