次の方法で共有

Agent 365 CLI

重要

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

Agent 365 CLI は、Azure に Agent 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 をインストールした後、次を実行して正しくインストールされていることを確認します:

a365 -h

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

Update

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 リファレンス を参照してください

重要な更新

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

CLIを使ってエージェント365エージェントを設定する完全な手順については、 Agent 365開発ライフサイクル をご覧ください。

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

このセクションでは、Agent 365 CLI でエラーをトラブルシューティングする方法について説明します。

CLIのインストール、更新、アンインストールが失敗すると、 Not found in NuGet feeds

microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.jsonエラーが出た場合は、--prereleaseパラメータを使用していることを確認してください。 現在のCLIのすべてのバージョンはプレリリースバージョンです。

Solution:

# 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 コマンドが見つからない

現象:

Error: Command 'create-instance' not found

原因：create-instanceコマンドはCLIから削除されました。 これにより、エージェントの機能を制限するために必要な登録手順を回避しました。 このコマンドは推奨ワークフローと同等になった後期バージョンで再導入される可能性があります。

Solution:

更新されたワークフローを活用してください:

  1. エージェントを公開する:

    a365 publish

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

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

  3. Deploy to Azure(任意):

    # Only if hosting on Azure Web App
a365 deploy

  4. Microsoft Teamsでエージェントインスタンスを作成する:

    • Open Microsoft Teams
    • アプリへのナビゲーション
    • 代理店を探しましょう
    • エージェントインスタンスを作成するには「追加」をクリックしてください

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

エージェントがTeamsに現れない

症状： コマンドを実行した後、Microsoft Teamsにエージェントが表示されません。

原因：publishステップを飛ばしたか、削除されたcreate-instanceコマンドを使おうとした可能性があります。

Solution:

  1. 成功裏に実行したか確認a365 publish
  2. 伝達されるまで 5 ～ 10 分待ちます
  3. Microsoft 365管理センターをチェックしてください: https://admin.cloud.microsoft/#/agents/all
  4. Teams Appsセクションからエージェントインスタンスを作成する

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

症状： エージェントはTeamsに表示されますが、エージェントインスタンスを作成できません(エージェントを追加できません)。

原因： 「Microsoft Agent 365 Frontier」ライセンスはユーザーアカウントに割り当てられていません。

  • Last updated on