Agent 365 CLI は、Azureにエージェント 365 アプリケーションをデプロイおよび管理するためのクロスプラットフォーム のコマンド ライン ツールです。
CLI を手動でインストールする必要はありません。 AI ガイド付きセットアップでは、CLI がチェックされ、自動的にインストールまたは更新され、必要なすべてのコマンドがユーザーに代わって実行されます。 このページは、CLI を直接インストールまたは使用する必要がある開発者向けのリファレンスです。たとえば、CI/CD オートメーションの構築、特定の手順のトラブルシューティング、AI コーディング エージェントなしで作業する場合などです。
Note
AI ガイド付きセットアップ、ロール ガイダンス、デプロイ後の手順など、完全な開発者ワークフローについては、「 エージェント 365 開発の概要」を参照してください。 このページは、インストール、更新、アンインストール、使用可能なコマンド、トラブルシューティングという CLI リファレンスです。
前提条件
CLI には、.NET 8.0 以降が必要です。 サブスクリプションのAzure、必要な Entra ロール、カスタム クライアント アプリの登録など、その他のすべての前提条件については、AI ガイド付きセットアップを参照してください。
Agent 365 CLI をインストールする
次の手順に従って、Agent 365 CLI をオペレーティング システムにグローバルにインストールします。
前提条件
.NETがインストールされている必要があります。 (.NET 8.0 をお勧めします)。
「dotnet tool install」コマンドを使用する
次のコマンドを使用して、Agent 365 CLI をインストールします。
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
最新の手順と利用可能なバージョンについては、公式の NuGet ページを参照してください: NuGet.org 上の Microsoft.Agents.A365.DevTools.Cli
インストールの確認
Agent 365 CLIをインストールした後、 --help コマンドを実行して正しくインストールされているか確認してください:
a365 -h
このコマンドはヘルプ情報を表示し、CLI が使用できる状態であることを確認します。
Update
dotnet tool update コマンドを使用して、Agent 365 CLI を更新します:
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
Note
エージェント365 CLIを更新するには、最新のNuGetパッケージにアクセスするためにインターネット接続が必要です: Microsoft.Agents.A365.DevTools.Cli。
アンインストール
dotnet tool uninstall コマンドを使用して、Agent 365 CLI をアンインストールします:
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
ファイルの場所
ツールの実行可能ファイルの既定の場所は、オペレーティング システムによって異なります。
| OS | パス |
|---|---|
| Linux または macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
SDKは最初に実行したときにこの場所をパスに追加します。 つまり、ツールの場所を指定しなくても、どのディレクトリからでもグローバルツールを呼び出せます。
ツールへのアクセスは、マシン全体ではなくユーザー固有です。 グローバルツールは、ツールをインストールしたユーザーのみが利用可能です。
使用可能なコマンド
利用可能なコマンドの完全なリストについては、 --help コマンドを使用するか、 Agent 365 CLI Referenceをご覧ください。
ヒント
CLI コマンドを手動で実行する必要はありません。 AI ガイド付きセットアップでは、AI コーディング エージェントを使用して、完全なワークフロー (CLI のインストール、構成、ブループリントのセットアップ、デプロイ、発行) が自動化されます。 CI/CD オートメーションの構築、特定の手順のトラブルシューティング、または AI コーディング エージェントなしで作業する場合は、ここでの CLI リファレンスを使用してください。
CLI を使用してエージェント 365 エージェントを設定する方法の詳細な手順については、「 エージェント 365 の開発を開始する」を参照してください。
Troubleshooting
このセクションでは、エージェント365 CLIでのエラーのトラブルシューティング方法についての情報を提供します。
ヒント
Agent 365トラブルシューティングガイドには、Agent 365 の開発ライフサイクルの各段階に対応した高レベルのトラブルシューティング推奨事項、ベストプラクティス、トラブルシューティングコンテンツへのリンクが含まれています。
このセクションで扱うCLI特有の問題:
エージェントはTeamsに表示されません
エージェントインスタンスの作成トラブルシューティング:エージェントがTeamsに表示されません