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

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

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

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

Microsoft TeamsのGitHub統合により、Teams の会話内からすべてのCopilot cloud agentを操作できます。 Teams 内では、会話のコンテキストを使用して、 cloud agent セッションを開始して、調査、計画、コードの作成、問題の作成、および要求のプルを行うことができます。 チームの協調的な決定は、コードに結び付け、ディスカッションがどこで行われるか、実装がどこにあるかのギャップを埋めます。

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

## セキュリティに関する考慮事項

Teams で @mentionGitHub する前に、 Copilot cloud agent がスレッド全体を要求のコンテキストとしてキャプチャし、ディスカッションに基づいてソリューションを理解し、実装することを検討してください。 このコンテキストは、エージェントによって生成される成果物に格納されます。 コンテキストを制限する場合は、代わりに Teams の GitHub アプリに直接メッセージを送信できます。

## コラボレーション セッション、アクセス許可、サンドボックスについて

Copilotが使用する ID は、ダイレクト メッセージと共有コンテキストのどちらを操作するかによって異なります。

* ダイレクト メッセージで Copilot を使用すると、プル要求や問題の作成などのアクションを実行したり、質問に回答したりできます。 リンクされた GitHub 個人アカウントのアクセス許可を使用して、これらのアクションを実行します。

* グループ スレッドやチャネルなどの共有コンテキストで Copilot を使用すると、 Copilot は個人アカウントではなくアプリ ID の下に、プル要求などの成果物を作成します。

  > \[!NOTE]
  > 共有コンテキストで Copilot によって作成されたプル リクエストでは、アプリの ID が使用されます。 リポジトリルールセットを使用する場合、これらのプル要求は個人に起因しないため、リポジトリに少なくとも 1 つの承認が既に必要である限り、マージの前にもう 1 つの承認が必要です。 この機能は、既定では有効になっています。 「[ルールセットで使用できるルール](/ja/enterprise-cloud@latest/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/available-rules-for-rulesets#additional-approval-for-unattributed-copilot-pull-requests)」を参照してください。

リポジトリへの **書き込み** アクセス権を持つユーザーのみが変更を行うために Copilot をトリガーできますが、会話参加者は入力を提供できます。 ワークスペースのゲスト メンバーとリポジトリの外部コラボレーターは、Teams で Copilot とのセッションを開始したり、操作したりすることはできません。

Copilot は、会話内のすべてのメッセージを使用して作業を通知します。 スレッド全体が成果物の意思決定コンテキストになります。

タスクの実行を Copilot に依頼すると、作業リポジトリ、問題またはプル要求リンク、使用されたモデル、タスクの状態や概要など、セッションに関する詳細が表示されます。

### セキュリティで保護されたクラウド サンドボックス

Copilot cloud agent Teams からタスクの作業を開始すると、Copilot**はセキュリティで保護されたクラウド サンドボックス**で非同期的に作業を続け、準備ができたら結果を投稿します。

Teams から操作を続けたり、エージェントによって生成された成果物の作業を GitHub、ターミナル、または任意のコード エディターで続行したりできます。

## Prerequisites

* 有料のGitHub プランを通じてCopilotにアクセスできるCopilot アカウントが必要です。
* Teams アカウントが必要です。
* Microsoft Teams クライアントMicrosoftパブリック開発者プレビューが有効になっている必要があります。Microsoft Learn ドキュメントの[「Teams のパブリック開発者プレビュー](https://learn.microsoft.com/en-us/microsoftteams/platform/resources/dev-preview/developer-preview-intro)」を参照してください。
* Copilot cloud agentを使用するには、Copilot プランでクラウド サンドボックスが有効になっている必要があります。
  GitHub Copilotについては、[クラウドサンドボックスを参照](/ja/enterprise-cloud@latest/copilot/concepts/about-cloud-and-local-sandboxes#cloud-sandboxing)してください。

  > \[!NOTE]
  > クラウド サンドボックス ポリシーは、 Copilot cloud agent ポリシーと同じ構成を共有します。
  > マネージド ユーザーを含む Enterpriseを含む組織または企業のメンバーは、Teams でCopilot cloud agentを使用する前に、所有者がクラウド サンドボックスとCopilotを有効にする必要がある場合があります。 「[組織または企業のクラウド サンドボックスの有効化または無効化](/ja/enterprise-cloud@latest/copilot/how-tos/cloud-and-local-sandboxes/enabling-or-disabling-cloud-sandboxes-for-your-organization)」を参照してください。

## 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 セッションによって作成された問題とプル要求が開かれます。

作業を開始するには:

1. Teams で、「`@GitHub`」と入力して、アプリをメッセージに@mentionします。
2. プロンプトに従って GitHub アカウントに接続し、プロンプトが表示されたら、必要に応じて既定のリポジトリを設定します。
3. 他に何ができるかを確認するには、スレッドで「`@GitHub help`」と入力してアプリを@mentionします。

## チームの会話から GitHub Copilot セッションを開始する

任意の Teams チャットで `@GitHub` に続けてタスクを入力し、アプリを @Mention します。
`write`アクセス権を持つ任意のリポジトリに対してエージェントを召喚できます。 エージェントは、計画された変更の概要と、作成された成果物へのリンクで応答します。

たとえば、リポジトリ内の特定のブランチにプル要求を作成するようにエージェントに依頼するには、次のように入力します。

```text
@GitHub Create a pull request to...YOUR_PROMPT repo=OWNER/REPO_NAME branch=BRANCH_NAME
```

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

## スレッド内で作業を反復する

pull request を絞り込むには、要求された変更と同じスレッドで @mention`@GitHub` します。
Copilot には、前の @mention 以降のすべてのメッセージが組み込まれており、作業を反復処理し、ディスカッションと実装を接続したままにします。

## Copilot に関する課題を作成する

teams から直接Copilot問題を作成するようにGitHubに依頼し、会話を実用的なタスクに変えることができます。 自然言語で必要な内容を記述するだけで、問題 Copilot 自動的に作成されます。

子と親のリレーションシップでは、1 つの問題または複数の問題を一度に作成できます。

アプリを @mention すると、作成した問題のコンテキストとして完全なスレッド履歴が使用されます。 コンテキストにフォーカスを合わせるには、新しいスレッドを開始するか、直接メッセージを送信することを検討してください。

## Teams での Copilot cloud agent のカスタマイズ

`settings` パラメーターを使用して、チャネルとスレッドでのCopilot cloud agentのしくみをカスタマイズできます。 たとえば、チャネルの既定のリポジトリを設定できます。

1. チャネル設定を表示および変更するには、メッセージ内で次のように入力してアプリにメンションします:

   ```text
   @GitHub settings
   ```

2. 次に、プロンプトに従って変更を行います。

### チャネルの既定のリポジトリの設定

プライベート チャネルまたはパブリック チャネルごとに既定のリポジトリを設定できます。
Copilotを含むダイレクト メッセージの既定のリポジトリを設定することはできません。

チャネルに既定のリポジトリがない場合は、 Copilot チャネルの既定のリポジトリとして、そのチャネルの最初のセッションで使用するリポジトリを設定します。

リポジトリまたはブランチを指定しない場合、 Copilot はチャネルの既定のリポジトリとそのリポジトリの既定のブランチを使用します。

1. チャネルで、「 `@GitHub settings` 」と入力し、メッセージを送信します。
2. 画面の指示に従って、チャネルの既定のリポジトリを選択します。

## フィードバックとサポート

[ディスカッション フォーラム](https://github.com/orgs/community/discussions/205453)では、フィードバックを表示して共有できます。

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

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