Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
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