Del via

Agent 365 CLI

Vigtigt

Du skal være en del af Frontier-forhåndsversionsprogrammet for at få tidlig adgang til Microsoft Agent 365. Frontier forbinder dig direkte med Microsofts seneste AI-innovationer. Frontier-forhåndsversioner er underlagt de eksisterende forhåndsversionsbetingelser i dine kundeaftaler. Da disse funktioner stadig er under udvikling, kan deres tilgængelighed og egenskaber ændre sig over tid.

Agent 365 CLI er et kommandolinjeværktøj på tværs af platforme til installation og administration af Agent 365-programmer på Azure.

Installér Agent 365 CLI

Brug følgende trin til at installere Agent 365 CLI globalt på dit operativsystem.

Forudsætninger

.NET skal være installeret. (.NET 8.0 anbefales.)

Brug installation via DotNet-værktøjet

Installér Agent 365 CLI ved hjælp af følgende kommando:

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

Hvis du får vist en microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json fejl, skal du bruge parameteren --prerelease, da denne pakke muligvis stadig er mærket som foreløbig udgave.

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

Du kan finde de seneste instruktioner og tilgængelige versioner på den officielle NuGet-side: Microsoft.Agents.A365.DevTools.Cli på NuGet.org

Kontrollere installation

Når du har installeret Agent 365 CLI, skal du kontrollere, at den er installeret korrekt, ved at køre:

a365 -h

Denne kommando viser hjælpeoplysningerne og bekræfter, at CLI er klar til brug.

Opdatér

Opdater Agent 365 CLI ved hjælp af kommandoen dotnet tool update:

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

Bemærk

Alle opdateringer til Agent 365 CLI kræver internetforbindelse for at få adgang til den nyeste Nuget-pakke: Microsoft.Agents.A365.DevTools.Cli

Fjerne

Fjern Agent 365 CLI ved hjælp af kommandoen dotnet tool uninstall:

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

Filplaceringer

Standardplaceringen for et værktøjs eksekverbare fil afhænger af operativsystemet:

Operativsystem Sti
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Denne placering føjes til brugerens sti, når SDK'et køres første gang. Globale værktøjer kan derfor aktiveres fra en hvilken som helst mappe uden at angive værktøjsplaceringen.

Adgang til værktøjet er brugerspecifik, ikke maskinbaseret. Et globalt værktøj er kun tilgængeligt for den bruger, der har installeret værktøjet.

Tilgængelige kommandoer

Hvis du vil have vist en komplet liste over tilgængelige kommandoer, skal du bruge kommandoen --help eller se Agent 365 CLI-reference

Fejlfinding

Dette afsnit indeholder oplysninger om, hvordan du foretager fejlfinding af fejl med Agent 365 CLI.

Installation, opdatering eller fjernelse af kommandolinjegrænsefladen mislykkes med Not found in NuGet feeds

Hvis du får vist en microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json fejl, skal du bruge parameteren --prerelease, da denne pakke muligvis stadig er mærket som foreløbig udgave.

Du kan finde de seneste instruktioner og tilgængelige versioner på den officielle NuGet-side: Microsoft.Agents.A365.DevTools.Cli på NuGet.org

Installationen mislykkes med fejlen Authorization_RequestDenied

Hvis du får vist fejlen Authorization_RequestDenied, når du kører setup-kommandoen, angiver dette et problem med tilladelser i dit Microsoft Entra-miljø.

Almindelige årsager

Denne fejl opstår typisk, når:

  • Din konto mangler de nødvendige tilladelser
  • Appen Microsoft Graph Command Line Tools kræver administratorsamtykke
  • Der findes modstridende eller overprivilegerede tilladelser i dit miljø

Opløsningstrin

  1. Kontrollér, at din konto har den påkrævede rolle

    Sørg for, at du er logget på med en konto, der har en af disse roller:

    • Agent-id-udvikler
    • Agent-id-administrator
    • - global administrator

  2. Gennemse og tildel administratorsamtykke for Microsoft Graph Command Line Tools

    Installationskommandoen a365 bruger appen Microsoft Graph Command Line Tools, som kan have modstridende tilladelser.

    Sådan gennemser og løser du problemet:

    1. Log på Azure-portalen

    2. Søg efter Microsoft Graph Command Line Tools, eller søg efter app-id: 14d82eec-204b-4c2f-b7e8-296a70dab67e

    3. Vælg Sikkerhed>Tilladelser fra navigationsområdet.

    4. Søg efter Directory.AccessAsUser.All-tilladelsen

      • Denne tilladelse med mange rettigheder er i konflikt med oprettelsen af planen
      • Hvis den er til stede, kan du overveje at fjerne den eller erstatte den med alternativer med de færreste rettigheder, f.eks. Directory.Read.All

      Advarsel!

      Fjern kun denne tilladelse, hvis du er sikker på, at den ikke kræves af andre værktøjer eller scripts i dit miljø

    5. Hvis der ikke allerede er givet administratorsamtykke, skal du vælge Giv administratorsamtykke til [din lejer].

  3. Når du har foretaget ændringer, skal du køre a365 setup igen

Yderligere ressourcer

Du kan få flere oplysninger om dette kendte problem under Kendte problemer med Microsoft Entra Agent-id – Directory.AccessAsUser.All medfører, at andre tilladelser ignoreres.

  • Last updated on