Agent 365 CLIで単一のエージェントをオンボーディングします

Agent 365のCLIを使って、エージェント用のMicrosoft Entraアイデンティティオブジェクトを作成し、エージェントをAgent 365に登録します。 まず、運用環境以外のエージェントを 1 つから開始し、エージェントを一括でオンボーディング前に、ID、アクセス許可、同意、登録内容を確認できるようにしてください。

この記事では、サインインした従業員のために経費報告書を確認する標準的なエージェントの基本名として Expense Review を使用しています。 この機能は on-behalf-of (OBO) 認証を採用しており、独自の Microsoft Entra ユーザー アカウント、メールボックス、または Teams のプレゼンスは必要ありません。

設定不要のワークフローは以下を実現します:

• 経費レビューの Blueprint という名前のエージェント ID のブループリントです。
• 経費レビューのエージェントという名前のエージェント IDです。
• OBO 認証に使用する委任されたアクセス許可の付与。
• エージェントが使用する Agent 365 の登録。
• 生成された識別子とセットアップ状況を記録する a365.generated.config.json ファイルです。

エージェントの Agent 365 登録。ID オブジェクトの説明については、Agent 365 の ID を参照してください。

Prerequisites

始める前に、以下のことを確認してください:

• Agent 365を有効にしたMicrosoftテナントです。 このウォークスルーでは、非本番環境のテナントまたはテスト環境を使用してください。
• 同じテナント内のAzureサブスクリプション。
• AzureサブスクリプションのContributorの役割です。
• 少なくとも、Microsoft Entra ID の エージェント ID 開発者 のロールが必要です。これにより、ブループリントとエージェント ID を作成できます。
• OAuth のアクセス許可を付与できるグローバル管理者。 この役割を担当すれば、1回のセッションでワークフローを完了できます。 それ以外の場合は、CLIはグローバル管理者に送信するための同意URLを提供します。
• シナリオをサービス間 (S2S) 認証を使用するように変更する場合は、アプリケーション管理者またはグローバル管理者のロールが必要です。
• .NET 8.0以降。
• Azure CLI (使用するテナントとサブスクリプションにサインイン済みのもの)。
• Agent 365 CLI。

Agent 365のセットアップは、テナントで利用可能なMicrosoft管理のAgent 365 CLIエンタープライズアプリケーションを使用します。 そのアプリケーション(クライアント)IDは f54280f4-395e-4ea8-9e48-bf2d4952aa14です。 アプリケーションが利用できない場合、CLIは Agent 365 CLIというテナント所有のアプリケーションを探します。 グローバル管理者はCLIプロンプトからテナント所有アプリケーションを作成・設定できます。 フォールバックの詳細については、 Agent 365 CLIのカスタムクライアントアプリ登録をご覧ください。

Agent 365 CLI をインストールする

CLIをグローバル.NETツールとしてインストールします:

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

もしCLIがすでにインストールされている場合は、次の方法で更新してください:

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

インストールを確認します。

a365 --version

インストールのトラブルシューティングやサポートされているファイルの場所については、「Agent 365 CLIのインストールおよび使用」をご覧ください。

テナントとサブスクリプションを選択してください

Azure にサインインします。

az login

アカウントで利用可能なサブスクリプションを一覧表示してください：

az account list --output table

エージェントをオンボーディングしたいテナントでサブスクリプションを選択してください:

az account set --subscription "<subscription-id-or-name>"

アクティブなテナントとサブスクリプションを確認してください:

az account show --query "{tenantId:tenantId, subscriptionId:id, subscriptionName:name}" --output table

入居者IDを記録してください。 CLIはアクティブなAzure CLIアカウントからそれを検出します。 --tenant-idを使うことで明示的に提供することもできます。

前提条件を確認する

任意のディレクトリから要件チェックを実行してください:

a365 setup requirements

このコマンドは認証、Azureアクセス、テナント登録、ロール、クライアントアプリケーションをチェックします。 チェック失敗後も続き、検出されたすべての問題を一緒に確認できます。

失敗した必須チェックをすべて解消してから続ける。 Microsoft管理のエンタープライズアプリケーションが利用できない場合は、テナント所有のクライアントアプリケーションを選択するか作成するプロンプトに従い、コマンドを再度実行してください。

オンボーディングの変更点をプレビューしてください

生成された構成のために空のワーキングディレクトリを作成し、そのディレクトリに移動します:

New-Item -ItemType Directory -Path .\expense-review-agent
Set-Location .\expense-review-agent

テナントオブジェクトを作成せずに変更をプレビューする:

a365 setup all `
    --agent-name "Expense Review" `
    --aiteammate false `
    --dry-run

テナントID、派生オブジェクト名、選択したクライアントアプリケーション、権限、認証モードを確認しましょう。 このシナリオでは、エージェントがサインインした従業員の代わりに行動するため、デフォルトの obo 認証モードを使用します。

検出されたテナントが正しくない場合は、明示的に次のように指定してください。

a365 setup all `
    --agent-name "Expense Review" `
    --tenant-id "<tenant-id>" `
    --aiteammate false `
    --dry-run

エージェントをオンボードする

同じコマンドを --dry-runなしで実行してください:

a365 setup all `
    --agent-name "Expense Review" `
    --aiteammate false

CLIは再度要件を検証し、ブループリントとエージェント ID を作成し、委任権限を設定し、エージェントを登録し、a365.generated.config.jsonを書き込みます。

グローバル管理者としてサインインする場合は、セットアップ中に表示される同意を求めるプロンプトにすべて応じてください。 代わりにAgent ID DeveloperまたはAgent ID Administratorの役割を使うと、CLIはあなたの役割で許可された手順を完了し、グローバル管理者の同意アクションを印刷します。 生成された同意URLをグローバル管理者に送り、すべての許可付与を完了するよう依頼してください。

オンボーディング結果を確認してください

セットアップの概要を見直してください。 必要な各ステップは完了したと表示されるべきです。 グローバル管理者がまだ同意を付与する必要がある場合は、オンボーディング完了とみなす前にその引き継ぎを完了してください。

生成された構成を確認してください:

Get-Content .\a365.generated.config.json | ConvertFrom-Json

出力に以下が含まれているか確認してください:

• エージェントのブループリント ID。
• 完了した設定状態で、未解決の同意アクションはありません。

セットアップサマリーでエージェントIDの作成と登録の成功を報告しているか確認してください。

その後、Microsoft 365 管理センターで登録を確認しましょう:

1. Microsoft 365管理センターに移動します。
2. エージェント>すべてのエージェントを選択します。
3. 費用レビューエージェントを探す。
4. エージェントを開き、その身元と登録情報が生成された設定と一致しているか確認します。

オンボーディングのトラブルシューティング

CLI固有の解決方法については、Agent 365 のトラブルシューティングをご覧ください。

次のステップ

• PowerShellで複数のエージェントをオンボードします。
• Agent 365との統合を検証してください。
• Agent 365のCLIセットアップコマンドを確認してください。