Agent 365 CLI

Agent 365 CLI er et kommandolinjeverktøy på tvers av plattformer for å distribuere og administrere Agent 365-apper på Azure.

Du trenger ikke å installere CLI manuelt. Det KI-styrte oppsettet sjekker CLI, installerer eller oppdaterer den automatisk, og kjører alle nødvendige kommandoer på dine vegne. Denne siden er en referanse for utviklere som trenger å installere eller bruke CLI direkte – for eksempel når de bygger CI/CD-automatisering, feilsøker et spesifikt trinn, eller jobber uten en KI-kodeagent.

Notat

Den komplette utviklerarbeidsflyten – inkludert KI-veiledet oppsett, rolleveiledning og trinn etter utrulling – finnes i Kom i gang med Agent 365-utvikling. Dette er CLI-referansen: installasjon, oppdatering, avinstallering, tilgjengelige kommandoer og feilsøking.

Forutsetning

CLI-en krever .NET 8.0 eller nyere. For alle andre forutsetninger – Azure-abonnement, påkrevde Entra-roller og registrering av egendefinerte klientapper – kan du se KI-veiledet oppsett.

Installer Agent 365 CLI

Følg disse trinnene for å installere Agent 365 CLI globalt i operativsystemet.

Forutsetning

Du må ha .NET installert. (.NET 8.0 anbefales.)

Bruk dotnet tool install

Installer Agent 365 CLI ved å bruke følgende kommando:

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

For de nyeste instruksjonene og tilgjengelige versjoner kan du gå til den offisielle NuGet-siden: Microsoft.Agents.A365.DevTools.Cli på NuGet.org

Bekrefte installasjon

Etter at du har installert Agent 365 CLI, må du verifisere at den er korrekt installert ved å kjøre --help-kommandoen:

a365 -h

Denne kommandoen viser hjelpeinformasjonen og bekrefter at CLI-en er klar til bruk.

Oppdater

Oppdater Agent 365 CLI ved å kjøre kommandoen dotnet tool update:

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

Notat

For å oppdatere Agent 365 CLI trenger du en internettforbindelse for å få tilgang til den nyeste NuGet-pakken: Microsoft.Agents.A365.DevTools.Cli.

Avinstaller

Avinstaller Agent 365 CLI ved å bruke dotnet tool uninstall-kommandoen:

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

Filplasseringer

Standardplasseringen for den kjørbare filen til et verktøy avhenger av operativsystemet:

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

SDK-en legger til denne plasseringen i banen når du kjører den for første gang. Du kan starte globale verktøy fra hvilken som helst katalog uten å spesifisere verktøyets plassering.

Verktøytilgangen er brukerspesifikk, ikke maskinglobal. Et globalt verktøy er bare tilgjengelig for brukeren som installerer det.

Tilgjengelige kommandoer

For den komplette listen over tilgjengelige kommandoer bruker du --help-kommandoen eller ser Agent 365 CLI-referanse.

Tips

Du trenger ikke å kjøre CLI-kommandoer manuelt. Det KI-styrte oppsettet automatiserer hele arbeidsflyten – installasjon av CLI, konfigurasjon, oppsett av blåkopier, distribusjon og publisering – ved bruk av en KI-kodeagent. Bruk CLI-referansen her hvis du bygger CI/CD-automatisering, feilsøker et bestemt trinn eller jobber uten en KI-kodeagent.

For komplette instruksjoner om hvordan du setter opp en Agent 365-agent ved hjelp av CLI kan du se Kom i gang med Agent 365-utvikling.

Feilsøking

Denne delen gir informasjon om hvordan du feilsøker feil med Agent 365 CLI.

Tips

Feilsøkingsveiledning for Agent 365 inneholder anbefalinger på høyt nivå for feilsøking, anbefalte fremgangsmåter og koblinger til feilsøkingsinnhold for hver fase i utviklingssyklusen i Agent 365.

CLI-spesifikke problemer dekkes i denne delen:

Agent vises ikke i Teams

Feilsøking av opprett agentforekomster: Agenten vises ikke i Teams

Kan ikke opprette agentforekomst i Teams

Feilsøking av opprett agentforekomster: Kan ikke opprette agentforekomst i Teams