Agent 365 CLI

Belangrijk

U moet deelnemen aan het preview-programma Frontier om vroegtijdige toegang te krijgen tot Microsoft Agent 365. Frontier verbindt u rechtstreeks met de nieuwste AI-innovaties van Microsoft. Op Frontier-previews zijn de bestaande preview-voorwaarden van uw klantovereenkomsten van toepassing. Omdat deze functies nog in ontwikkeling zijn, kunnen de beschikbaarheid en mogelijkheden hiervan na verloop van tijd veranderen.

Agent 365 CLI is een platformoverschrijdend opdrachtregelprogramma voor het implementeren en beheren van Agent 365-toepassingen in Azure.

De Agent 365 CLI installeren

Gebruik de volgende stappen om de Agent 365 CLI wereldwijd op uw besturingssysteem te installeren.

Vereisten

U moet .NET hebben geïnstalleerd. (.NET 8.0 wordt aanbevolen.)

Windows

.NET installeren in Windows

Linux

.NET installeren in Linux

macOS

.NET installeren in macOS

Dotnet-hulpprogramma installeren

Installeer de Agent 365 CLI en installeer deze met de volgende opdracht:

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

Als u een microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json fout krijgt, gebruikt u de --prerelease parameter omdat dit pakket mogelijk nog steeds wordt gelabeld als voorlopige versie.

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

Ga naar de officiële NuGet-pagina voor de nieuwste instructies en beschikbare versies: Microsoft.Agents.A365.DevTools.Cli op NuGet.org

Installatie verifiëren

Nadat u de Agent 365 CLI hebt geïnstalleerd, controleert u of deze juist is geïnstalleerd door het volgende uit te voeren:

a365 -h

Met deze opdracht wordt de Help-informatie weergegeven en wordt bevestigd dat de CLI gereed is voor gebruik.

Bijwerken

Werk agent 365 CLI bij met behulp van de opdracht dotnet-hulpprogramma bijwerken:

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

Notitie

Voor alle updates voor Agent 365 CLI is een internetverbinding vereist, voor toegang tot het nieuwste Nuget-pakket: Microsoft.Agents.A365.DevTools.Cli

Verwijderen

Verwijder Agent 365 CLI met behulp van de opdracht dotnet-hulpprogramma verwijderen:

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

Bestandslocaties

De standaardlocatie voor het uitvoerbare bestand van een hulpprogramma is afhankelijk van het besturingssysteem:

Besturingssysteem	Pad
Linux/macOS	$HOME/.dotnet/tools
Windows	%USERPROFILE%\.dotnet\tools

Deze locatie wordt toegevoegd aan het pad van de gebruiker, wanneer de SDK voor het eerst wordt uitgevoerd. Globale hulpprogramma's kunnen dus vanuit elke map worden aangeroepen, zonder de locatie van het hulpprogramma op te geven.

Toegang tot hulpprogramma's is gebruikersspecifiek, niet algemeen voor apparaten. Een algemeen hulpprogramma is alleen beschikbaar voor de gebruiker, die het hulpprogramma heeft geïnstalleerd.

Beschikbare opdrachten

Voor de volledige lijst met beschikbare opdrachten gebruikt u de --help opdracht of raadpleegt u naslaginformatie over Agent 365 CLI

Probleemoplossing

Deze sectie bevat informatie over het oplossen van fouten met Agent 365 CLI.

Installeren, bijwerken of verwijderen van CLI mislukt met Not found in NuGet feeds

Als u een microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json fout krijgt, gebruikt u de --prerelease parameter omdat dit pakket mogelijk nog steeds wordt gelabeld als voorlopige versie.

Ga naar de officiële NuGet-pagina voor de nieuwste instructies en beschikbare versies: Microsoft.Agents.A365.DevTools.Cli op NuGet.org

Setup mislukt met Authorization_RequestDenied fout

Als er een Authorization_RequestDenied fout optreedt bij het uitvoeren van de setup opdracht, geeft dit een machtigingsprobleem aan in uw Microsoft Entra-omgeving.

Veelvoorkomende oorzaken

Deze fout treedt meestal op wanneer:

• Uw account niet beschikt over de vereiste machtigingen
• Voor de hulpprogramma-app voor Microsoft Graph-opdrachtregels is beheerderstoestemming vereist
• Er zijn conflicterende of een teveel aan machtigingen zijn aanwezig in uw omgeving

Stappen voor het oplossen

1. Controleer of uw account de vereiste rol heeft

   Zorg ervoor dat u bent aangemeld met een account met een van deze rollen:

   • Agent-id-ontwikkelaar
   • Agent-id-beheerder
   • Globale beheerder

2. Beheerderstoestemming controleren en verlenen voor Microsoft Graph-opdrachtregelprogramma's

   De a365-installatieopdracht maakt gebruik van de hulpprogramma-app voor Microsoft Graph-opdrachtregels, die mogelijk conflicterende machtigingen heeft.

   Controleren en oplossen:

   1. Meld u aan bij het Azure Portal.

   2. Zoek naar Microsoft Graph-opdrachtregelprogramma's of zoek naar app-id: 14d82eec-204b-4c2f-b7e8-296a70dab67e

   3. Selecteer Beveiliging>Machtigingen in het navigatiegebied.

   4. Zoek naar de Directory.AccessAsUser.All machtiging

      • Deze machtiging met hoge bevoegdheden heeft invloed op het maken van blauwdrukken
      • Als dit aanwezig is, kunt u overwegen deze te verwijderen of te vervangen, door alternatieven met minimale bevoegdheden, zoals Directory.Read.All

      Waarschuwing

      Verwijder deze machtiging alleen als u zeker weet dat deze niet vereist is voor andere hulpprogramma's of scripts in uw omgeving

   5. Als er nog geen beheerderstoestemming is verleend, selecteert u Beheerderstoestemming verlenen voor [uw tenant].

3. Nadat u wijzigingen hebt aangebracht, voert u de opdracht a365 setup opnieuw uit

Aanvullende resources

Zie Bekende problemen met de Microsoft Entra-agent-id - Directory.AccessAsUser.All zorgt ervoor dat andere machtigingen worden genegeerd voor meer informatie over dit bekende probleem.