Microsoft 365 エージェント プレイグラウンドでエージェントをローカルでテストする

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

Microsoft 365 エージェント SDK を利用してエージェントを作成する方法は次の3つです。

  • Visual Studio または Visual Studio Code を使用して、Microsoft 365 エージェント ツールキット を C#、JavaScript、または Python で利用し、開発を始めます
  • サンプルをクローンしてIDEで開く
  • CLI の使用

ツールキットでプロジェクトを始める

Agents Toolkitを使って始めると、Agents Playgroundですぐにテストできるようすべての設定が完了しています。 エージェント プレイグラウンドでは、ローカル環境、Microsoft 365 Copilot、または Microsoft Teams のいずれかでテストを実行できます。 このシナリオについては、以下で説明します。

クローンするかCLIを使用してプロジェクトを開始する

CLIを使用してプロジェクトを開始する場合や、サンプルをクローンしてIDEで開く場合は、ローカルのエージェント プレイグラウンドを使ってテストすることができます。 エージェント プレイグラウンドはローカルコードに接続します。

次のいずれかの方法を使用して、エージェント プレイグラウンドをインストールできます。

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

winget install agentsplayground

オプション2: npmでインストールする

  • Node.jsをインストール（未インストールの場合）：最新のNode.jsをnodejs.orgからダウンロードしてインストールしてください。

  • Agents Playgroundパッケージのインストール:

    グローバルインストール（推奨）:

    npm install -g @microsoft/m365agentsplayground

    プロジェクトごとのインストール:

    npm install -D @microsoft/m365agentsplayground

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

  1. クイックスタート エージェントを作成するか、リポジトリからサンプルをクローンしたら、それをエージェント プレイグラウンドで使用できます。

  2. エージェント プレイグラウンドは匿名モードと認証モードの両方をサポートしています。 匿名テストの場合、他の設定は必要ありません。 認証付きでテストしたい場合は、エージェント プレイグラウンド（オプションについては後述）とご自身のアプリケーションの両方で、Microsoft Entra ID アプリ登録を設定してください。 詳細については、エージェント SDK で使用するAzureボットのプロビジョニングをご覧ください。

  3. アプリ内でポートを正しく設定してください。 エージェント用に利用可能なポートを選択してください（デフォルトは3978ですが、任意の利用可能なポートを使用できます）。

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

  5. エージェント プレイグラウンドを開き、エージェントのエンドポイントから始めます。

    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 アプリ Registrations の手動設定の多くを簡略化し、ユーザーが自分で行う必要がなくなります。 手動で始める場合は、これらの手動手順を自分で行う必要があります。

概要

GitHubリポジトリまたはCLIからクローンしたサンプルを使用して、Microsoft 365 エージェント プレイグラウンドでMicrosoft 365 エージェント SDKをローカルでテストしました。

  • Last updated on