Sdílet prostřednictvím

Rozhraní příkazového řádku agenta 365

Důležité

Abyste získali přednostní přístup k Microsoft Agentu 365, musíte být součástí programu Frontier Preview. Hranice vás spojuje přímo s nejnovějšími inovacemi umělé inteligence Microsoftu. Verze Preview hranice podléhají stávajícím podmínkám verze Preview vašich smluv se zákazníkem. Vzhledem k tomu, že tyto funkce jsou stále ve vývoji, jejich dostupnost a možnosti se můžou v průběhu času měnit.

Rozhraní příkazového řádku agenta 365 je multiplatformní nástroj příkazového řádku pro nasazování a správu aplikací agenta 365 v Azure.

Instalace rozhraní příkazového řádku agenta 365

Následující postup použijte k instalaci rozhraní příkazového řádku agenta 365 globálně do operačního systému.

Předpoklady

Musíte mít nainstalovanou technologii .NET. Doporučuje se protokol TLS 1.2.

Použití instalace nástroje dotnet

Přeinstalujte agenta Qualys pomocí následujícího příkazu:

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

Pokud se zobrazí microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json chyba, použijte --prerelease parametr, protože tento balíček může být stále označen jako předběžná verze.

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

Nejnovější pokyny a dostupné verze najdete na oficiální stránce NuGet: Microsoft.Agents.A365.DevTools.Cli na NuGet.org

Ověření instalace

Po instalaci rozhraní příkazového řádku agenta 365 ověřte, že je správně nainstalovaný, spuštěním následujícího příkazu:

a365 -h

Tento příkaz zobrazí informace nápovědy a potvrdí, že rozhraní příkazového řádku je připravené k použití.

Aktualizovat

Aktualizace rozhraní příkazového řádku agenta 365 pomocí příkazu dotnet tool update :

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

Poznámka:

Všechny aktualizace pro Rozhraní příkazového řádku agenta 365 vyžadují připojení k internetu pro přístup k nejnovějšímu balíčku NuGet: Microsoft.Agents.A365.DevTools.Cli

Odinstalace produktu

Odinstalace rozhraní příkazového řádku agenta 365 pomocí příkazu dotnet tool uninstall :

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

Umístění souboru

Výchozí umístění spustitelného souboru nástroje závisí na operačním systému:

Operační systém Cesta
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Toto umístění se přidá do cesty uživatele při prvním spuštění sady SDK. Globální nástroje je tedy možné vyvolat z libovolného adresáře bez zadání umístění nástroje.

Přístup k nástrojům je specifický pro uživatele, nikoli globální počítač. Globální nástroj je k dispozici pouze uživateli, který nástroj nainstaloval.

Dostupné příkazy

Úplný seznam dostupných příkazů najdete v --help tomto příkazu nebo v referenčních informacích k rozhraní příkazového řádku agenta 365.

Řešení problému

Tato část obsahuje informace o řešení chyb pomocí rozhraní příkazového řádku agenta 365.

Selhání instalace, aktualizace nebo odinstalace rozhraní příkazového řádku Not found in NuGet feeds

Pokud se zobrazí microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json chyba, použijte --prerelease parametr, protože tento balíček může být stále označen jako předběžná verze.

Nejnovější pokyny a dostupné verze najdete na oficiální stránce NuGet: Microsoft.Agents.A365.DevTools.Cli na NuGet.org

Instalace selže s chybou Authorization_RequestDenied

Pokud se při spuštění setup příkazu zobrazí Authorization_RequestDenied chyba, znamená to problém s oprávněními v prostředí Microsoft Entra.

Běžné příčiny

K této chybě obvykle dochází v těchto případech:

  • Váš účet nemá požadovaná oprávnění.
  • Aplikace Nástroje příkazového řádku Microsoft Graphu vyžaduje souhlas správce.
  • Konfliktní nebo nadprivilegovaná oprávnění se nacházejí ve vašem prostředí

Kroky řešení

  1. Ověřte, že váš účet má roli Čtenář

    Ujistěte se, že jste přihlášení pomocí účtu, který má jednu z těchto rolí:

    • Vývojář ID agenta
    • Správce ID agenta
    • Globální správce

  2. Kontrola a udělení souhlasu správce pro nástroje příkazového řádku Microsoft Graphu

    Instalační příkaz a365 používá aplikaci Nástroje příkazového řádku Microsoft Graphu, která může mít konfliktní oprávnění.

    Postup kontroly a opravy:

    1. Přihlaste se k portálu Azure Portal.

    2. Vyhledejte nástroje příkazového řádku Microsoft Graphu nebo vyhledejte ID aplikace: 14d82eec-204b-4c2f-b7e8-296a70dab67e

    3. V navigační oblasti vyberte Oprávnění zabezpečení>.

    4. Vyhledejte oprávnění.Directory.AccessAsUser.All

      • Toto vysoce privilegované oprávnění koliduje s vytvářením podrobného plánu.
      • Pokud je k dispozici, zvažte jeho odebrání nebo jeho nahrazení alternativami s nejnižšími oprávněními, jako je například Directory.Read.All

      Upozorňující

      Toto oprávnění odeberte jenom v případě, že jste si jistí, že toto oprávnění nevyžaduje jiné nástroje nebo skripty ve vašem prostředí.

    5. Pokud ještě není udělen souhlas správce, vyberte Udělit souhlas správce pro [vašeho tenanta].

  3. Po provedení změn spusťte a365 setup znovu

Další zdroje

Další informace o tomto známém problému najdete v tématu Známé problémy s ID agenta Microsoft Entra – Directory.AccessAsUser.All způsobí ignorování dalších oprávnění.

  • Last updated on