Dela via

Agent 365 CLI

Viktigt

Du måste vara en del av förhandsversionen av Frontier för att få tidig åtkomst till Microsoft Agent 365. Frontier ansluter dig direkt till Microsofts senaste AI-innovationer. Förhandsversioner av Gräns omfattas av de befintliga förhandsversionsvillkoren för dina kundavtal. Eftersom dessa funktioner fortfarande är under utveckling kan deras tillgänglighet och funktioner ändras över tid.

Agent 365 CLI är ett plattformsoberoende kommandoradsverktyg för att distribuera och hantera Agent 365-program i Azure.

Installera Agent 365 CLI

Använd följande steg för att installera Agent 365 CLI globalt på operativsystemet.

Förutsättningar

Du måste ha .NET installerat. TLS 1.2 rekommenderas.

Installera dotnet-verktyget

Installera gästagenten med hjälp av följande kommando:

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

Om du får ett microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json fel använder du parametern --prerelease eftersom det här paketet fortfarande kan taggas som förhandsversion.

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

De senaste instruktionerna och tillgängliga versionerna finns på den officiella NuGet-sidan: Microsoft.Agents.A365.DevTools.Cli på NuGet.org

Kontrollera installation

När du har installerat Agent 365 CLI kontrollerar du att den är korrekt installerad genom att köra:

a365 -h

Det här kommandot visar hjälpinformationen och bekräftar att CLI är redo att användas.

Uppdatera

Uppdatera Agent 365 CLI med hjälp av kommandot för uppdatering av dotnet-verktyget:

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

Obs

Alla uppdateringar för Agent 365 CLI kräver internetanslutning för att få åtkomst till det senaste Nuget-paketet: Microsoft.Agents.A365.DevTools.Cli

Avinstallera

Avinstallera Agent 365 CLI med hjälp av avinstallationskommandot för dotnet-verktyget:

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

Filplats

Standardplatsen för ett verktygs körbara fil beror på operativsystemet:

OS Sökväg
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Den här platsen läggs till i användarens sökväg när SDK:et först körs. Globala verktyg kan därför anropas från valfri katalog utan att ange verktygsplatsen.

Verktygsåtkomst är användarspecifik, inte datorbaserad. Ett globalt verktyg är endast tillgängligt för användaren som installerade verktyget.

Tillgängliga kommandon

Om du vill ha en fullständig lista över tillgängliga kommandon använder du --help kommandot eller läser Agent 365 CLI-referens

Felsökning

Det här avsnittet innehåller information om hur du felsöker fel med Agent 365 CLI.

Installation, uppdatering eller avinstallation av CLI misslyckas med Not found in NuGet feeds

Om du får ett microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json fel använder du parametern --prerelease eftersom det här paketet fortfarande kan vara taggat som förhandsversion.

De senaste instruktionerna och tillgängliga versionerna finns på den officiella NuGet-sidan: Microsoft.Agents.A365.DevTools.Cli på NuGet.org

Installationen misslyckas med Authorization_RequestDenied fel

Om du får ett Authorization_RequestDenied felmeddelande när du kör setup kommandot anger detta ett behörighetsproblem i Din Microsoft Entra-miljö.

Vanliga orsaker

Det här problemet uppstår vanligtvis vid:

  • Ditt konto saknar de behörigheter som krävs
  • Microsoft Graph-kommandoradsverktygsappen kräver administratörsmedgivande
  • Motstridiga eller överprivilegierade behörigheter finns i din miljö

Steg

  1. Kontrollera att ditt konto har rollen Läsare

    Kontrollera att du är inloggad med ett konto som har någon av dessa roller:

    • Agent-ID-utvecklare
    • Agent-ID-administratör
    • Global administratör för

  2. Granska och bevilja administratörsmedgivande för Microsoft Graph-kommandoradsverktyg

    A365-installationskommandot använder microsoft Graph-kommandoradsverktygsappen, som kan ha motstridiga behörigheter.

    Så här granskar och åtgärdar du:

    1. Logga in på Azure Portal

    2. Sök efter Microsoft Graph-kommandoradsverktyg eller sök efter app-ID: 14d82eec-204b-4c2f-b7e8-296a70dab67e

    3. Välj Säkerhetsbehörigheter> i navigeringsområdet.

    4. Leta efter behörigheten Directory.AccessAsUser.All

      • Den här behörigheten med hög behörighet stör skapandet av skisser
      • Om det finns kan du överväga att ta bort det eller ersätta det med alternativ med minst privilegier, till exempel Directory.Read.All

      Varning!

      Ta bara bort den här behörigheten om du är säker på att det inte krävs av andra verktyg eller skript i din miljö

    5. Om administratörsmedgivande inte redan har beviljats väljer du Bevilja administratörsmedgivande för [din klient].

  3. När du har gjort ändringar kör du a365 setup igen

Ytterligare resurser

Mer information om det här kända problemet finns i Kända problem med Microsoft Entra-agent-ID – Directory.AccessAsUser.All gör att andra behörigheter ignoreras.

  • Last updated on