次の方法で共有

エージェント 365 CLI

重要

Microsoft Agent 365 の早期アクセスを利用するには、フロンティア プレビュープログラムに参加する必要があります。 フロンティアは、Microsoft の最新の AI イノベーションと直接接続します。 Frontier のプレビューは、お客様の契約書に記載されている既存のプレビュー利用規約に従います。 これらの機能は現在開発中であるため、提供状況や機能は今後変更される可能性があります。

Agent 365 CLI は、Azureにエージェント 365 アプリケーションをデプロイおよび管理するためのクロスプラットフォーム のコマンド ライン ツールです。

前提条件

開始する前に、以下の前提条件を確認してください。

注意

インストール後の 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 ページを参照してください: NuGet.org 上の Microsoft.Agents.A365.DevTools.Cli

インストールを検証する

Agent 365 CLIをインストールした後、 --help コマンドを実行して正しくインストールされているか確認してください:

a365 -h

このコマンドはヘルプ情報を表示し、CLI が使用できる状態であることを確認します。

更新

dotnetツールのupdateコマンドと、--prereleaseパラメータを使ってエージェント365のCLIを更新します。

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

注意

エージェント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は create-instance コマンドを削除しました。 これにより、エージェントの機能を制限するために必要な登録手順を回避しました。 このコマンドは推奨ワークフローに合った後、後期バージョンで再導入される可能性があります。

CLIを使ってAgent 365エージェントを設定する完全な手順については、「 Agent 365 Development Lifecycle」をご覧ください。

トラブルシューティング​​

このセクションでは、エージェント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 ページを参照してください: NuGet.org 上の Microsoft.Agents.A365.DevTools.Cli

create-instance コマンドが見つからない

症状：Command 'create-instance' not foundエラーが見えます。

原因: CLIは create-instance コマンドを削除しました。 これにより、エージェントの機能を制限するために必要な登録手順を回避しました。 開発チームは推奨されるワークフローに合った後、このコマンドを再導入するかもしれません。

解決策: 代わりに以下の手順をご利用ください。

  1. エージェントを公開する:a365のpublishコマンドを使ってください。

    a365 publish

  2. Developer Portalでエージェントブループリントを設定する:

    Teams開発者ポータルでエージェントブループリントの設定方法を学びましょう。

  3. deploy to Azure (省略可能):a365 deploy コマンドを使用します。

    # Only if hosting on Azure Web App
a365 deploy

  4. Microsoft Teams:

    1. Microsoft Teamsを開きます。
    2. アプリに移動します。
    3. エージェントを探しましょう。
    4. エージェントインスタンスを作成するには 「追加 」を選択してください。

詳細な指示は 「オンボードエージェント」をご覧ください。

エージェントはTeamsに表示されません

エージェントインスタンスの作成トラブルシューティング:エージェントがTeamsに表示されません

Teamsでエージェントインスタンスを作成できません

エージェントインスタンス作成のトラブルシューティング:Teamsでエージェントインスタンスを作成できません

  • Last updated on