次の方法で共有

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 を使用する

以下のコマンドを使用して、Agent 365 CLI をインストールします:

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli

microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.jsonエラーが出た場合は、--prereleaseパラメータを使用してください。このパッケージはまだプレリリースとしてタグ付けされている可能性があります。

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

最新の手順と利用可能なバージョンについては、公式の NuGet ページを参照してください: NuGet.org 上の Microsoft.Agents.A365.DevTools.Cli

インストールを検証する

Agent 365 CLI をインストールした後、次を実行して正しくインストールされていることを確認します:

a365 -h

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

Update

dotnet tool update コマンドを使用して、Agent 365 CLI を更新します:

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

注意

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

代わりに、次のワークフローを使用します。

  1. a365 publish - Microsoft 365管理センターへの公開エージェント
  2. 開発者ポータルでエージェントブループリントの設定 - 開発者 ポータルでエージェントブループリントの設定
  3. a365 deploy - Azureへのデプロイ(Azureホスティングを使用している場合のみ任意)
  4. Microsoft Teamsを使用してエージェント インスタンスを作成する

完全な手順は 「オンボードエージェント 」をご覧ください。

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

このセクションでは、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パラメータを使用してください。このパッケージはまだプレリリースとしてタグ付けされている可能性があります。

最新の手順と利用可能なバージョンについては、公式の 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でエージェントブループリントを設定する:

    詳細な手順は開発者 ポータルの「エージェントブループリントの設定 」をご覧ください。

  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