Agent 365 CLI

Agent 365 CLI je multiplatformní příkazový nástroj pro nasazování a správu aplikací Agent 365 v Azure.

Nemusíte instalovat rozhraní příkazového řádku ručně. AI-řízené nastavení ověřuje dostupnost CLI, automaticky ho instaluje nebo aktualizuje a provádí všechny potřebné příkazy za vás. Tato stránka je referencí pro vývojáře, kteří potřebují CLI instalovat nebo používat přímo – například při budování automatizace CI/CD, řešení konkrétního kroku nebo práci bez AI kódovacího agenta.

Poznámka

Celý proces vývoje – včetně AI-řízeného nastavení, pokynů k rolím a kroků po nasazení – je popsán v Začínáme s vývojem Agent 365. Tato stránka slouží jako referenční příručka pro CLI: instalace, aktualizace, odinstalace, dostupné příkazy a řešení problémů.

Předpoklady

CLI vyžaduje .NET 8.0 nebo novější. Pro všechny ostatní předpoklady – předplatné Azure, povinné role Entra a registraci vlastních klientských aplikací – viz AI-vedené nastavení.

Instalace Agent 365 CLI

Proveďte následující kroky k instalaci Agent 365 CLI jako globálního nástroje ve vašem operačním systému.

Předpoklady

Musíte mít nainstalovaný .NET. (Doporučujeme použít .NET 8.0.)

Použijte dotnet tool install

Nainstalujte Agent 365 CLI pomocí následujícího příkazu:

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

Pro nejnovější pokyny a dostupné verze navštivte oficiální stránku NuGet: Microsoft.Agents.A365.DevTools.Cli na NuGet.org

Ověření instalace

Po instalaci CLI Agent 365 ověřte správnou instalaci spuštěním příkazu --help:

a365 -h

Tento příkaz zobrazí nápovědu a potvrdí, že CLI je připraven k použití.

Aktualizovat

Aktualizujte Agent 365 CLI pomocí příkazu dotnet tool update:

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

Poznámka

Pro aktualizaci CLI Agent 365 potřebujete připojení k internetu pro přístup k nejnovějšímu balíčku NuGet: Microsoft.Agents.A365.DevTools.Cli.

Odinstalovat

Odinstalujte Agent 365 CLI pomocí příkazu dotnet tool uninstall:

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

Umístění souboru

Výchozí umístění spustitelného souboru nástroje závisí na operačním systému:

Operační systém Path
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

SDK při prvním spuštění přidá tuto lokaci do vašeho PATH. Takže můžete spouštět globální nástroje z libovolného adresáře, aniž byste museli zadávat cestu k nástroji.

Přístup k nástroji je vázán na uživatele, není globální pro celý počítač. Globální nástroj je dostupný pouze uživateli, který nástroj nainstaluje.

Dostupné příkazy

Pro kompletní seznam dostupných příkazů použijte příkaz --help nebo viz Agent 365 CLI Reference.

Zpropitné

Nemusíte spouštět příkazy CLI ručně. Nastavení s asistencí AI automatizuje celý pracovní postup – instalaci CLI, konfiguraci, nastavení blueprintu, nasazení a publikaci – pomocí AI kódovacího agenta. Použijte zde dokumentaci CLI, pokud vytváříte CI/CD automatizaci, řešíte konkrétní problém nebo pracujete bez AI kódovacího agenta.

Pro kompletní návod, jak nastavit agenta Agent 365 pomocí CLI, viz Začněte s vývojem Agent 365.

Řešení problému

Tato sekce poskytuje informace o tom, jak řešit chyby pomocí CLI Agent 365.

Zpropitné

Průvodce odstraňováním problémů Agent 365 obsahuje doporučení k odstraňování problémů na vysoké úrovni, osvědčené postupy a odkazy na obsah o řešení problémů pro každou část životního cyklu vývoje Agent 365.

Specifické problémy CLI řešené v této sekci:

Agent se nezobrazuje v Teams

Řešení problémů s instancemi agentů: Agent se v Teams nezobrazuje

Nelze vytvořit instanci agenta v Teams

Řešení problémů s vytvářením instancí agentů: Nelze vytvořit instanci agenta v Teams