# Copilot クラウド エージェントと Teams の統合

Teams の GitHub 統合を使用して、コンテキストを提供し、Teams チャネル内からプル要求を開くことができます。

> \[!NOTE]
>
> * この機能は現在 パブリック プレビュー であり、変更される可能性があります。
> *

GitHub Copilot は AI を使用します。 間違いがないか確認してください。 「[アプリケーション カード: GitHub Copilot エージェント](/ja/copilot/responsible-use/agents)」を参照してください。

Microsoft Teams の GitHub 統合を使用すると、Teams チャネル内から Copilot cloud agent とやり取りできます。 Teams スレッド内から、会話のコンテキストを使用して、 cloud agent セッションを開始し、pull request を開くことができます。

その他の Copilot 統合については、 [Copilot統合について](/ja/copilot/concepts/tools/about-copilot-integrations) を参照してください。

> \[!NOTE]
> Teams スレッドで @GitHub に言及すると、エージェントはスレッド全体を要求のコンテキストとしてキャプチャし、ディスカッションに基づいてソリューションを理解し、実装します。 このコンテキストは pull request に格納されます。

## Prerequisites

* 有料のGitHub プランを通じてCopilotにアクセスできるCopilot アカウントが必要です。
* Teams アカウントを持ち、チャネルのメンバーである必要があります。

## Teams での GitHub アプリのインストール

GitHub アプリは、チームに 1 回だけインストールする必要があります。 アプリがインストールされると、チームのメンバーは、 GitHub アカウントをアプリに接続して使用を開始できます。

1. Web ブラウザーで [GitHub 統合インストール リンク](https://teams.microsoft.com/l/app/836ecc9e-6dca-4696-a2e9-15e252cd3f31) を開き、Teams とインストール ダイアログを起動します。
2. **\[Add]** をクリックしてアプリをチームに追加します。
3. 画面の指示に従ってアプリの認証と認可を行います。

## GitHub アプリをGitHub アカウントに接続する

Teams で GitHub アプリを初めて使用するときは、 GitHub アカウントに接続し、既定のリポジトリを設定する必要があります。 既定のリポジトリは、 Copilot プロンプトに応答するときに使用するコンテキストを提供します。また、プロンプトでリポジトリを指定しない限り、 Copilot cloud agent セッションによって作成されたプル要求が開かれます。

開始するには、どの Teams スレッドでも `@GitHub <YOUR_TASK>` をメンションします。 アプリにより、サインインと既定のリポジトリの設定手順が案内されます。 または、次の手順に従って、 GitHub アカウントに接続し、既定のリポジトリを手動で設定することもできます。

1. Teams で、「`@GitHub`」と入力して、スレッド内のアプリをメンションします。
2. 提案一覧から **\[signin]** をクリックします。
3. プロンプトに従って、 GitHub アカウントにサインインします。
4. スレッドで、「`@GitHub`」と入力してアプリをメンションします。
5. **\[settings]** をクリックして既定のリポジトリを設定します。

## Teams での Copilot アプリの使用

スレッドでメンションすることで、Teams で GitHub アプリを操作できます。 エージェントはユーザーのメッセージに応答し、ユーザーのリクエストに基づいてタスクを実行します。 既定のリポジトリ (またはプロンプトで指定されたリポジトリ) への **書き込み** アクセス権を持つユーザーのみが、 Copilot cloud agent の動作をトリガーできます。
**書き込み**アクセス権のないスレッドの共同作成者は、会話に入力を提供することでCopilotをガイドするのに役立ちます。これは、プル要求を変更するときにコンテキストとして使用されます。

1. Teams で、「@GitHub」と入力して、スレッド内のアプリをメンションします。

2. メッセージまたはリクエストを入力して送信します。 必要に応じて、次の構文を使ってリポジトリまたはブランチを指定できます。

   ```text
   @GitHub Add "Hello World" to the README in repo=REPO_OWNER/REPO_NAME branch=BRANCH_NAME
   ```

`repo` パラメーターは、要求に使用するリポジトリをCopilot cloud agentに指示し、`branch` パラメーターは、プル要求のベース ブランチとして使用するリポジトリの既存のブランチを指定します。 既定では、 Copilot は構成済みの既定のリポジトリとリポジトリの既定のブランチを使用します。

Copilot では、 cloud agent セッションが開始され、リポジトリに作成された pull request へのリンクなど、予定されている変更の概要が返されます。

同じ Teams スレッド内で pull request の反復処理を継続できます。 @GitHub に変更を提案すると、 Copilot cloud agent は、前のメンション以降のスレッド内のすべてのメッセージを使用して、既存のプル要求を反復処理します。

## 詳細については、次を参照してください。

* [クラウド エージェントGitHub Copilotについて](/ja/copilot/concepts/agents/cloud-agent/about-cloud-agent)
* [GitHub Copilot クラウド エージェントへのアクセスの管理](/ja/copilot/concepts/agents/cloud-agent/access-management)