クイックスタート: Teams でエージェントを作成してチャットする

このクイックスタートでは、コマンドライン開発者ツールを使用して、新しい Teams エージェントを作成します。最後に、コードがローカル開発環境で実行される Teams のエージェントとチャットします。このクイックスタートで作成したコードとエージェント登録は、完全な機能を備えた Teams エージェントの基盤として使用できます。

前提条件

このクイックスタートは 2 つのセクションに分かれています。最初のセクションでは、次のものが必要です。

Node.js 24 以降 (インストーラーのダウンロード)
Visual Studio Code (インストーラーのダウンロード)

第 2 の部分では、カスタム Teams アプリをインストールするアクセス許可を持つ Microsoft 365 の職場または学校アカウントを持つ Teams も必要です。

アカウントを持っていない場合や、アクセス許可がわからない場合でも、開始できます。このクイックスタートでは、必要に応じてこれらの要件に対処します。

エージェントランタイムのコードを作成して、Microsoft 365 Agents Playground で試す

Teams 開発者 CLI と Microsoft 365 Agents Playground をインストールします。
```
npm install -g @microsoft/teams.cli @microsoft/m365agentsplayground
```
teams project new を使用してテンプレートから新しいエージェントランタイムのコードを作成し、Visual Studio Code で開きます。
```
teams project new typescript echo-bot
cd echo-bot
code .
```
Visual Studio Code で src/index.ts を開きます。 const app = new App(); を読み取る行を見つけて、次のように変更します。
```
const app = new App({ skipAuth: true });
```
これは、Microsoft 365 Agents Playground と通信できるようにするための一時的な変更です。
エージェントランタイムを起動します。実行が完了すると、ポート 3978 で使用可能であることの確認が表示されます。
```
npm install
npm run dev
```
新しいコンソールウィンドウで、Microsoft 365 エージェントプレイグラウンドを起動します。
```
agentsplayground
```
これにより、Agents Playground がエージェントのランタイムに接続され、新しいブラウザータブでインターフェイスが開きます。
作成ボックスを使用してエージェントにメッセージを送信し、チャットで応答を確認します。エージェントがローカルで稼働しています。
ブラウザーの [エージェントプレイグラウンド] タブを閉じ、両方のコンソールウィンドウで Ctrl+C を使用して、エージェントプレイグラウンドとエージェントランタイムを停止します。エージェントランタイムコードの作成に使用したコンソールウィンドウを開いたままにしておけば、すぐに再び必要になります。
Visual Studio Code で、手順 3 で行った変更を元に戻します。これにより、次の手順で Teams との安全な接続が確保されます。
```
const app = new App();
```

ログインしてアクセス許可を確認する

注:

このクイックスタートの次の部分では、Teams が、カスタム Teams アプリをインストールする権限を持つ Microsoft 365 の職場または学校アカウントにログインしている必要があります。この手順では、そのアクセス許可をチェックします。

Microsoft 365 アカウントをお持ちでない場合は、「次の手順」に進み、コードの作業を続け、後でこのクイックスタートの残りの部分を完了することができます。 Teams でアプリを試すために使用できる開発者サンドボックスサブスクリプションを取得する方法については、「 Microsoft 365 開発者プログラム」を参照してください。

Teams 開発者 CLI から Microsoft 365 の職場または学校アカウントにログインします。

teams login

CLI は、カスタムアプリをインストールするためのアカウントのアクセス許可 ("サイドローディング") を確認し、Azure CLI インストールの存在をチェックします (このクイックスタートには必要ありません)。

✔ Logged in as user@contoso.com
✔ Sideloading: enabled

Azure CLI: installed, not logged in

このクイックスタートを続行するには、サイドローディングを有効にする必要があります。 無効になっている場合は、アカウントに対して有効にするには、organization の Microsoft 365 管理者が必要です。このアクセス許可を有効にする管理者の手順については、「ユーザーにカスタムアプリのアップロードを許可する」を参照してください。それまでの間は、「次のステップ」に進み、エージェントのコードでの作業を続行できます。

前提条件

このクイックスタートは 2 つのセクションに分かれています。最初のセクションでは、次のものが必要です。

第 2 の部分では、カスタム Teams アプリをインストールするアクセス許可を持つ Microsoft 365 の職場または学校アカウントを持つ Teams も必要です。

エージェントランタイムのコードを作成して、Microsoft 365 Agents Playground で試す

Teams 開発者 CLI と Microsoft 365 Agents Playground をインストールします。
```
npm install -g @microsoft/teams.cli @microsoft/m365agentsplayground
```
teams project new を使用してテンプレートから新しいエージェントランタイムのコードを作成し、Visual Studio Code で開きます。
```
teams project new python echo-bot
cd echo-bot
code .
```
Visual Studio Code で src/main.py を開きます。 app = App() を読み取る行を見つけて、次のように変更します。
```
app = App(skip_auth=True)
```
これは、Microsoft 365 Agents Playground と通信できるようにするための一時的な変更です。

エージェントランタイムを起動します。実行が完了すると、ポート 3978 で実行されていることを確認するメッセージが表示されます。

python -m venv .venv
source .venv/bin/activate
pip install -e .
python src/main.py

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .
python src/main.py

python -m venv .venv
.venv\Scripts\activate.bat
pip install -e .
python src/main.py

新しいコンソールウィンドウで、Microsoft 365 エージェントプレイグラウンドを起動します。
```
agentsplayground
```
これにより、Agents Playground がエージェントに接続され、新しいブラウザータブでインターフェイスが開きます。
作成ボックスを使用してエージェントにメッセージを送信し、チャットで応答を確認します。エージェントがローカルで稼働しています。
ブラウザーの [エージェントプレイグラウンド] タブを閉じ、両方のコンソールウィンドウで Ctrl+C を使用して、エージェントプレイグラウンドとエージェントランタイムを停止します。エージェントランタイムコードの作成に使用したコンソールウィンドウを開いたままにしておけば、すぐに再び必要になります。
エディターで、手順 3 で行った変更を元に戻します。これにより、次の手順で Teams との安全な接続が確保されます。
```
app = App()
```

ログインしてアクセス許可を確認する

注:

Teams 開発者 CLI から Microsoft 365 の職場または学校アカウントにログインします。

teams login

✔ Logged in as user@contoso.com
✔ Sideloading: enabled

Azure CLI: installed, not logged in

前提条件

Node.js 24 以降 (インストーラーのダウンロード)
.NET 10 以降 (インストーラーのダウンロード)
カスタム Teams アプリをインストールする権限を持つ Microsoft 365 の職場または学校アカウントを持つ Teams (これらの権限はクイックスタートの冒頭で確認します)

Microsoft 365 の職場または学校アカウントをお持ちでない場合は、「 Microsoft 365 開発者プログラム」を参照して、Teams でエージェントを試すために使用できる開発者サンドボックスサブスクリプションを取得する方法を確認してください。

ツールをインストールし、ログインしてアクセス許可を確認する

Teams 開発者 CLI をインストールし、Microsoft 365 の職場または学校アカウントでログインします。

npm install -g @microsoft/teams.cli
teams login

CLI は、ログイン、カスタムアプリをインストールするアカウントのアクセス許可 ("サイドローディング")を確認し、Azure CLI インストールの存在をチェックします (このクイックスタートには必要ありません)。

✔ Logged in as user@contoso.com
✔ Sideloading: enabled

Azure CLI: installed, not logged in

エージェントランタイムのコードを作成する

teams project new を使用して、テンプレートから新しいエージェントランタイムのコードを作成します。
```
teams project new csharp EchoBot
cd EchoBot/EchoBot
```
エージェントランタイムを起動して、実行されていることを確認します。実行が完了すると、ポート 3978 で到達可能であることの確認が表示されます。
```
dotnet run
```
コンソールウィンドウで Ctrl+C を使用してエージェントを停止します。コンソールウィンドウを開いたままにしておきます。すぐにもう一度必要になります。

開発トンネルをホストする

Teams が通信できるのは、パブリックインターネットから到達可能なエージェントランタイムのみです。この手順では、Microsoft 開発トンネルユーティリティを使用して、開発環境で実行されているエージェントランタイムをインターネットに公開するトンネルを作成します。

新しいコンソールウィンドウで、開発トンネルをインストールします。

winget install Microsoft.devtunnel

curl -sL https://aka.ms/DevTunnelCliInstall | bash

curl -sL https://aka.ms/DevTunnelCliInstall | bash

Microsoft 365 アカウントで devtunnel にログインし、新しいトンネルをホストします。

devtunnel user login
devtunnel create --allow-anonymous
devtunnel port create -p 3978
devtunnel host

次のような出力が表示されます。

Connection to host tunnel relay restored.
Hosting port: 3978
Connect via browser: https://4r9dd5xj-3978.usw2.devtunnels.ms
Inspect network activity: https://4r9dd5xj-3978-inspect.usw2.devtunnels.ms

Ready to accept connections for tunnel: joyful-dog-xgz66vp.usw2

トンネルは稼働したままにしておきます。次の手順のために、 Connect via browser URL をメモします。

Teams でのプロビジョニング、インストール、チャット

エージェントランタイムプロジェクトの作成に使用したコンソールウィンドウで、 teams app create を使用してプロビジョニングし、Teams プラットフォームに登録します。 <tunnel-host>を、前の手順で取得した完全な Connect via browser URL に置き換えます。このコマンドは、エージェントランタイムが Teams と通信するために必要な構成ファイルを作成するため、プロジェクトディレクトリから実行することが重要です。
```
teams app create --endpoint <tunnel-host>/api/messages --name echo-bot --env .env
```

エージェントランタイムプロジェクトの作成に使用したコンソールウィンドウで、 teams app create を使用してプロビジョニングし、Teams プラットフォームに登録します。 <tunnel-host>を、前の手順で取得した完全な Connect via browser URL に置き換えます。このコマンドは、エージェントランタイムが Teams と通信するために必要な構成ファイルを作成するため、プロジェクトディレクトリから実行することが重要です。
```
teams app create --endpoint <tunnel-host>/api/messages --name echo-bot --env appsettings.json
```

create コマンドが完了すると、メニューが表示されます。 [ Teams にインストール ] を選択して Teams を開き、エージェントインストーラーダイアログを表示します。

Teams で続行する前に、コンソールウィンドウに戻り、Teams 開発者 CLI メニューで [完了 ] を選択して閉じます。次に、コマンドラインを使用してエージェントランタイムを再開します。続行する前に、ポート 3978 でリッスンしていることを確認してください。
```
npm run dev
```

Teams で続行する前に、コンソールウィンドウに戻り、Teams 開発者 CLI メニューで [完了 ] を選択して閉じます。次に、コマンドラインを使用してエージェントランタイムを再開します。続行する前に、ポート 3978 でリッスンしていることを確認してください。
```
python src/main.py
```

Teams で続行する前に、コンソールウィンドウに戻り、Teams 開発者 CLI メニューで [完了 ] を選択して閉じます。次に、コマンドラインを使用してエージェントランタイムを再開します。続行する前に、ポート 3978 でリッスンしていることを確認してください。
```
dotnet run
```

Teams に戻り、手順 2 のインストーラーダイアログで [ 追加 ] を選択してエージェントをインストールします。表示される [ 今日このアプリをどのように使用しますか?] ダイアログで、[ 開く ] を選択してエージェントとの 1 対 1 のチャットを開きます。
Teams でエージェントとChatしましょう!

次の手順

このクイックスタートで作成した内容はすべて保持され、エージェントを構築するための基礎として使用できます。コードと開発トンネルが開発環境で実行されている限り、エージェントは Teams でメッセージを送受信できます。

エージェントのすべての動作はランタイムコード内にあります。ランタイムを変更して再起動することで、Teams に再登録または再インストールしなくても動作を変更できます。

Teams のエージェントの機能とベストプラクティスの詳細については、ドキュメントを参照してください。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-08-20

クイックスタート: Teams でエージェントを作成してチャットする

前提条件

エージェント ランタイムのコードを作成して、Microsoft 365 Agents Playground で試す

ログインしてアクセス許可を確認する

前提条件

エージェント ランタイムのコードを作成して、Microsoft 365 Agents Playground で試す

ログインしてアクセス許可を確認する

前提条件

ツールをインストールし、ログインしてアクセス許可を確認する

エージェント ランタイムのコードを作成する

開発トンネルをホストする

Teams でのプロビジョニング、インストール、チャット

次の手順

フィードバック

その他のリソース

エージェントランタイムのコードを作成して、Microsoft 365 Agents Playground で試す

エージェントランタイムのコードを作成して、Microsoft 365 Agents Playground で試す

エージェントランタイムのコードを作成する