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