Agent 365 CLI
Important
エージェント 365 をMicrosoftするには、Frontier プレビュー プログラムearly アクセスの一部である必要があります。 フロンティアは、Microsoftの最新の AI イノベーションと直接接続します。 Frontierプレビューは既存の顧客契約のプレビュー条件の対象となります。 これらの機能はまだ開発段階であるため、利用可能性や機能は時間とともに変化する可能性があります。
エージェント ID とエージェント ユーザーを作成し、ID とライセンスにアクセス許可をユーザーに追加します。
create-instance コマンドは、ID、ライセンス、および必要なアクセス許可を持つエージェント インスタンスを作成します。 このコマンドを使用して、エージェント ID の作成、必要なライセンスの割り当て、ID へのアクセス許可の付与など、完全なエージェント インスタンスを設定します。
create-instance コマンドは、次の操作を実行します。
- Creates Agent Identity - Graph APIを介してエージェント ID サービス プリンシパルをMicrosoft Entraに登録します。
- エージェント ユーザーの作成 - ID に関連付けられているエージェント ユーザー アカウントを作成します。
- マネージャーとスポンサーの割り当て - 現在のユーザーを、エージェント ユーザーと ID のマネージャーおよびスポンサーとして設定します。
- ライセンスの割り当て - エージェント ユーザーに必要なエージェント 365 ライセンスを割り当てます。
最低限必要なロール: グローバル管理者
注
必要なエージェント 365 ライセンスをまだ割り当てていない場合は、引き続き create-instance identity を使用し、後で create-instance licenses を使用してライセンスを割り当てることができます。
構文
次に、 create-instance コマンドの構文とそのオプションのサブコマンドを示します。
a365 create-instance [command] [options]
サブコマンドを指定せずに create-instance を実行すると、エージェント ID とエージェント ユーザーが作成され、ライセンスが割り当てられるという、両方の手順が順番に実行されます。
オプション
これらのオプションは、 create-instance コマンド、または create-instance identity および create-instance licenses サブコマンドと共に使用します。
| Option | Description |
|---|---|
-c、--config <config> |
構成ファイルのパス (既定値: a365.config.json) |
-v、--verbose |
詳細な出力を表示する |
--dry-run |
実行せずに何が行われるかを表示する |
-?、-h、--help |
ヘルプと使用状況の情報を表示する |
前提条件
create-instanceを実行する前に、次のことを確認してください。
-
セットアップ エージェントのブループリント ステップ (
a365 setup) を完了しました。 -
a365 publishを使用してエージェントを発行しました。 - 作業ディレクトリに有効な
a365.config.jsonとa365.generated.config.jsonがあります。 - グローバル管理者のアクセス許可を持つアカウントでサインインします。
create-instance の例
以下の例は、サブコマンドなしで create-instance コマンドを使用する方法を示しています。
完全なエージェント インスタンスを作成する
オプションなしで create-instance を実行し、既定の構成を使用して完全なエージェント インスタンスを作成します。
a365 create-instance
特定の構成ファイルを使用して作成する
--config オプションを使用して、カスタム構成ファイルのパスを指定します。
a365 create-instance --config path/to/a365.config.json
変更をプレビューする
--dry-run オプションを使用して、変更を加えずに何create-instanceが行われるかを確認します。
a365 create-instance --dry-run
create-instance identity
エージェント ID とエージェント ユーザーを作成しますが、ライセンスは割り当てないでください。
ID の作成時にライセンスをスキップするには、このコマンドを使用します。
注
ライセンスをまだ使用できない場合は、このコマンドを使用してブロックされないようにします。 ライセンスがある場合は、 create-instance licenses を実行できます。
a365 create-instance identity
create-instance licenses
既存のエージェント ユーザーにライセンスを追加します。
ID が既に存在する場合は、このコマンドを使用してライセンスを作成します。
注
前 create-instance identity 使用した場合は、ライセンスが使用可能な場合にこのコマンドを使用します。
a365 create-instance licenses
関連エージェント 365 CLI コマンド
これらのコマンドを create-instance と共に使用して、エージェントの完全なライフサイクルを管理します。
-
a365 setup- エージェントのブループリントとアクセス許可を設定する -
a365 publish- エージェントを Microsoft 365 admin center に発行する -
a365 cleanup instance- エージェント インスタンスを削除する - エージェント インスタンスの作成 - エージェント インスタンス の作成とテストに関する完全なガイド