Agent 365 CLI

Agent 365 CLI är ett plattformsoberoende kommandoradsverktyg för att distribuera och hantera Agent 365-applikationer på Azure.

Du behöver inte installera CLI:n manuellt. Den AI-styrda uppsättningen kontrollerar om CLI finns, installerar eller uppdaterar den automatiskt och kör alla nödvändiga kommandon åt dig. Denna sida är en referens för utvecklare som behöver installera eller använda CLI direkt – till exempel när de bygger CI/CD-automation, felsöker ett specifikt steg eller arbetar utan en AI-kodningsagent.

Kommentar

Det kompletta arbetsflödet för utvecklare – inklusive AI-styrd uppsättning, rollvägledning och åtgärder efter distribution – finns i Kom igång med Agent 365-utveckling. Den här sidan är en referens för CLI: installation, uppdatering, avinstallation, tillgängliga kommandon och felsökning.

Krav

CLI:n kräver .NET 8.0 eller senare. För övriga förutsättningar – Azure-prenumeration, nödvändiga Entra-roller och registrering av skräddarsydda klientappar – se AI-styrd uppsättning.

Installera Agent 365 CLI

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

Krav

Du måste ha .NET installerat. (.NET 8.0 rekommenderas.)

Kör dotnet tool install

Installera Agent 365 CLI med följande kommando:

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

För de senaste instruktionerna och tillgängliga versioner, besök den officiella NuGet-sidan: Microsoft.Agents.A365.DevTools.Cli på NuGet.org

Kontrollera installation

Efter att du har installerat Agent 365 CLI, kontrollera installationen genom att köra --help-kommandot:

a365 -h

Detta kommando visar hjälpinformation och bekräftar att CLI är redo att användas.

Uppdatera

Uppdatera Agent 365 CLI genom att använda kommandot dotnet tool update:

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

Kommentar

För att uppdatera Agent 365 CLI behöver du en internetanslutning för att få tillgång till det senaste NuGet-paketet: Microsoft.Agents.A365.DevTools.Cli.

Avinstallera

Avinstallera Agent 365 CLI genom att använda kommandot dotnet tool uninstall:

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

Sökvägar

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

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

SDK:n lägger till denna plats i din sökväg när du kör den första gången. Så du kan köra globala verktyg från vilken katalog som helst utan att specificera verktygets plats.

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

Tillgängliga kommandon

För en fullständig lista över tillgängliga kommandon, använd kommandot --help eller se Agent 365 CLI-referensen.

Dricks

Du behöver inte köra CLI-kommandon manuellt. Den AI-guided setup automatiserar hela arbetsflödet – CLI-installation, konfiguration, blueprint setup, distribution och publicering – med hjälp av en AI-kodagent. Använd CLI-referensen här om du bygger CI/CD-automation, felsöker ett specifikt steg eller arbetar utan en AI-kodagent.

För fullständiga instruktioner om hur du skapar en Agent 365-agent med hjälp av CLI, se Kom igång med Agent 365-utveckling.

Felsökning

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

Dricks

Agent 365-felsökningsguide innehåller övergripande felsökningsrekommendationer, bästa praxis och länkar till felsökningsinnehåll för varje enskild del av Agent 365:s utvecklingslivscykel.

CLI-specifika problem som behandlas i detta avsnitt:

Agenten dyker inte upp i Teams

Felsökning av agentinstanser: Agenten visas inte i Teams

Det går inte att skapa agentinstans i Teams

Felsökning av agentinstanser: Kan inte skapa agentinstans i Teams