Agent 365 CLI

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

Du behøver ikke at installere CLI manuelt. Den AI-guidede opsætning undersøger, om CLI'en findes, installerer eller opdaterer den automatisk og udfører alle påkrævede kommandoer på dine vegne. Denne side er en reference for udviklere, der har brug for at installere eller bruge CLI direkte – for eksempel når de bygger CI/CD-automatisering, fejlsøger et bestemt trin eller arbejder uden en AI-kodningsagent.

Bemærk!

Den komplette udviklerarbejdsgang – inklusive AI-styret opsætning, rollevejledning og efterimplementeringsskridt – findes i Kom i gang med Agent 365-udvikling. Denne side er CLI-referencen: installation, opdatering, afinstallation, tilgængelige kommandoer og fejlfinding.

Forudsætninger

CLI'en kræver .NET 8.0 eller nyere. For alle øvrige forudsætninger – Azure-abonnement, nødvendige Entra-roller og registrering af brugerdefinerede klientapplikationer – se AI-guidet opsætning.

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

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 --help:

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.

Fjern

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

SDK'en tilføjer denne placering til din sti, når du kører den 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.

Tip

Du behøver ikke at køre CLI-kommandoer manuelt. Den AI-guidede opsætning automatiserer hele arbejdsgangen – CLI-installation, konfiguration, blueprint-opsætning, udrulning og publicering – ved hjælp af en AI-kodningsagent. Brug CLI-referencen her, hvis du bygger CI/CD-automatisering, fejlsøger et bestemt trin eller arbejder uden en AI-kodningsagent.

Se Kom i gang med Agent 365-udvikling for fuldstændige instruktioner om, hvordan du indstiller en Agent 365-agent ved hjælp af CLI.

Fejlfinding

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

Tip

Agent 365 Fejlfindingsguide indeholder overordnede anbefalinger til fejlfinding, bedste praksis og links til fejlfindingsindhold for hver fase af udviklingslivscyklussen for Agent 365.

CLI-specifikke problemer, der dækkes i dette afsnit:

Agenten vises ikke i Teams

Fejlfinding ved oprettelse af agentinstanser: agenten vises ikke i Teams

Kan ikke oprette agent-instans i Teams

Fejlfinding af oprettelse af agentinstanser: Kan ikke oprette agentinstanser i Teams