重要
Microsoft Agent 365 への早期アクセスを得るには、Frontier プレビュー プログラムのメンバーである必要があります。 フロンティアは、Microsoftの最新の AI イノベーションと直接接続します。 Frontier のプレビューは、お客様の契約書に記載されている既存のプレビュー利用規約に従います。 これらの機能は現在開発中であるため、提供状況や機能は今後変更される可能性があります。
Agent 365 CLI は、Azureにエージェント 365 アプリケーションをデプロイおよび管理するためのクロスプラットフォーム のコマンド ライン ツールです。
前提条件
開始する前に、以下の前提条件を確認してください。
- Custom クライアント アプリの登録 - CLI では、認証のためにMicrosoft Entra ID テナントにカスタム クライアント アプリが必要です。 詳細なセットアップ手順は 「カスタムクライアントアプリ登録 」をご覧ください。 設定時にアプリケーション(クライアント)IDが必要です。
- Azure サブスクリプション - リソースを作成できるAzure サブスクリプションへのアクセス。
- 必要な権限 - アカウントは以下のいずれかの役割を持つ必要があります:
注意
インストール後の a365 config init ステップでは、CLIがカスタムクライアントアプリの登録を自動的に検証し、アプリの存在、必要な権限、管理者の同意が付与されているかを確認します。
ヒント
異なるCLIコマンドは異なる役割や権限を必要とします。 各コマンドリファレンスページには、必要な最小役割が指定されています。 例えば、具体的な要件については setup コマンドの参考文献 を参照してください。
Agent 365 CLI をインストールする
次の手順に従って、Agent 365 CLI をオペレーティング システムにグローバルにインストールします。
前提条件
.NETがインストールされている必要があります。 (.NET 8.0 をお勧めします)。
「dotnet tool install」コマンドを使用する
以下のコマンドと --prerelease パラメータを使ってAgent 365のCLIをインストールします:
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease
重要
Agent 365のCLIはまだプレビュー段階です。 Agent 365 CLIが一般公開されるまでは、常に --prerelease パラメータを使って最新の修正や機能を含む最新バージョンを取得してください。 Agent 365 CLIが一般公開されると、 --prerelease パラメータは不要になります。
最新の手順と利用可能なバージョンについては、公式の NuGet ページ (Microsoftを参照してください。Agents.A365.DevTools.Cli on NuGet.org
インストールを検証する
Agent 365 CLIをインストールした後、 --help コマンドを実行して正しくインストールされているか確認してください:
a365 -h
このコマンドはヘルプ情報を表示し、CLI が使用できる状態であることを確認します。
更新
dotnetツールのupdateコマンドと、--prereleaseパラメータを使ってエージェント365のCLIを更新します。
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli --prerelease
注意
Agent 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をご覧ください。
トラブルシューティング
このセクションでは、エージェント365 CLIでのエラーのトラブルシューティング方法についての情報を提供します。
ヒント
Agent 365トラブルシューティングガイドには、Agent 365 の開発ライフサイクルの各段階に対応した高レベルのトラブルシューティング推奨事項、ベストプラクティス、トラブルシューティングコンテンツへのリンクが含まれています。
このセクションで扱うCLI特有の問題:
Not found in NuGet feeds インストール、更新、アンインストール時のエラー
症状:microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json Agent 365 CLIのインストール、更新、アンインストール時にエラーが発生しました。
解決策:--prereleaseパラメータを使いましょう。
現在のCLIのすべてのバージョンはプレリリースバージョンです。
# For installation
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease
# For updates
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli --prerelease
最新の手順と利用可能なバージョンについては、公式の NuGet ページ (Microsoftを参照してください。Agents.A365.DevTools.Cli on NuGet.org
エージェントはTeamsに表示されません
エージェントインスタンスの作成トラブルシューティング:エージェントがTeamsに表示されません