Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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