Microsoft 365 Agents Playground でエージェントをローカルでテストする

エージェントをローカルでテストする方法の詳細は、エージェントの作成方法によって異なります。

Microsoft 365 エージェント SDK を使用してエージェントを作成するには、次の 3 つの方法があります。

  • Visual Studio または Visual Studio Code を使用して、C#、JavaScript、または Python の Microsoft 365 Agents Toolkit から開始する
  • サンプルから複製し、IDE で開く
  • CLI の使用

ツールキットを使用してプロジェクトを開始する

Agents Toolkitから始めると、Agents Playgroundを使ってすぐにテストできる環境が整います。 ローカルのエージェントプレイグラウンド、またはMicrosoft CopilotやMicrosoft Teamsでテストが可能です。 このシナリオについては、次のトピックで説明します。

複製または CLI を使用してプロジェクトを開始する

CLIを使ってプロジェクトを始めるか、サンプルをクローンしてIDEで開くと、ローカルのAgents Playgroundでテストできます。 Agents Playground はローカル コードに接続します。

エージェント・プレイグラウンドは、以下のいずれかの方法でインストールできます:

オプション 1: スタンドアロン バイナリをインストールする

winget install agentsplayground

オプション 2: npm を使用してインストールする

  • Node.js をインストールします (まだインストールされていない場合): nodejs.org から最新の Node.js をダウンロードしてインストールします。

  • Agents Playground パッケージをインストールします。

    グローバル インストールの場合 (推奨):

    npm install -g @microsoft/m365agentsplayground

    プロジェクト固有のインストールの場合:

    npm install -D @microsoft/m365agentsplayground

エージェントをテストする

  1. クイックスタートエージェントを作成するかリポジトリからサンプルをクローンした後、Agents Playgroundで使ってください。

  2. Agents Playground では、匿名モードと認証済みモードの両方がサポートされています。 匿名テストの場合、他の構成は必要ありません。 認証を使用してテストする場合は、Agents Playground (以下のテキストでオプションが提供されます) とアプリケーションの両方に対して Microsoft Entra ID アプリの登録を構成する必要があります。 詳細については、「 Agents SDK で使用する Azure ボットのプロビジョニング」を参照してください。

  3. アプリでポートを正しく構成します。 エージェント用の利用可能なポートを選択してください(デフォルトは3978ですが、利用可能なポートはどのポートでも使えます)。

  4. コードを実行します。

  5. Agents Playground を開き、エージェントのエンドポイントから開始します。

    agentsplayground -e "http://localhost:<your-agent-port>/api/messages" -c "emulator"

    エージェントで必要な場合は、認証を設定します。

    agentsplayground -e "http://localhost:<your-agent-port>/api/messages" -c "emulator" --client-id "your-client-id" --client-secret "your-client-secret" --tenant-id "your-tenant-id"

    主なオプション:

    • -e, --app-endpoint: エージェントのエンドポイント URL (たとえば、 http://localhost:3978/api/messages)
    • -c, --channel-id: チャネルの種類 ( emulator、 webchat、 msteamsなど)。 各チャネルには、さまざまなユーザー エクスペリエンスとアクティビティ のプロパティが用意されています。
    • --client-id: 認証用のクライアント ID
    • --client-secret: 認証用のクライアント シークレット
    • --tenant-id: 認証用のテナント ID

    agentsplayground --helpを使用して、使用可能なオプションの完全な一覧を表示します。

    または、CLI オプションの代わりに環境変数を使用することもできます。 両方を指定すると、CLI オプションの優先度が高くなります。

    export BOT_ENDPOINT="http://localhost:<your-agent-port>/api/messages"
export DEFAULT_CHANNEL_ID="emulator"
export AUTH_CLIENT_ID="your-client-id"
export AUTH_CLIENT_SECRET="your-client-secret"
export AUTH_TENANT_ID="your-tenant-id"

    エージェントが起動すると、次の画像のように開きます。 プレイグラウンド インターフェイスで質問をしたり、エージェントをテストしたりできます。

    Microsoft 365 エージェント プレイグラウンド

可能な限り、まずはMicrosoft 365エージェントツールキットから始めましょう。 このツールキットを使用すると、作業の開始、ローカルでのテスト、デプロイ が簡単かつ迅速になります。 Azure Bot ServiceやAzure アプリの登録の手動設定の多くを抽象化してくれるので、手動で操作しなくて済みます。 手動で開始するには、これらの手動の手順を自分で実行する必要があります。

まとめ

Microsoft 365 Agents Playgroundを使ってローカルでMicrosoft 365 エージェント SDKをテストしましたね。 まずGitHubリポジトリやCLIからクローンサンプルを入手しました。

  • 最終更新: