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

Linear の Copilot 統合を使用して、コンテキストを提供し、エージェントの実行方法をカスタマイズし、すべて Linear ワークスペース内から pull request を開きます。

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

Linear の Copilot 統合により、Linear ワークスペースを離れることなく Copilot cloud agent を呼び出すことができます。 線形問題内から、問題の説明とコメントのコンテキストを使用して、 cloud agent セッションを開始したり、エージェントが使用するモデル、カスタム エージェント、ブランチをカスタマイズしたり、セッションを誘導したり、pull request を開いたりすることができます。

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

> \[!NOTE]
> 線形問題で @GitHub にメンションしたり、 Copilot を割り当てたりすると、エージェントは問題の説明とコメント全体を要求のコンテキストとしてキャプチャします。 これにより、エージェントは問題を理解し、問題のすべての情報に基づいて適切なソリューションを実装できます。 このコンテキストは pull request に格納されます。

## Prerequisites

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

## linear での Copilot アプリのインストール

> \[!NOTE]
> \*
> Copilot アプリを Linear にインストールするには、アプリをインストールする組織または企業の所有者である必要があります。 Linear のワークスペース管理者でもある必要があります。
>
> * 組織が データ所在地付き GitHub Enterprise Cloudを使用する企業の一部である場合は、 `SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-linear`で企業が利用できるアプリの一覧から統合をインストールします。 SUBDOMAIN を企業の GHE.com のサブドメインに置き換えます。

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

1. <c1>線形のページ<c0 />に行き、\[<c2>設定</c2>] をクリックします。
2. 画面の指示に従って、アプリを使用する組織または企業でアプリを構成して承認します。

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

Linear で Copilot アプリを初めて使用するときは、 GitHub アカウントに接続する必要があります。
Copilot cloud agentで使用するリポジトリも指定する必要があります。 指定したリポジトリへの **書き込み** アクセス権を持つユーザーのみが、そのリポジトリで動作する Copilot cloud agent をトリガーできます。 リポジトリへの **書き込み** アクセス権がないその issue への参加者も、issue 上のやり取りで意見を提供することで Copilot の助けになれます。その内容は、プルリクエストの作成時にコンテキストとして使用されます。

1. Linear で、 Copilot cloud agentを使用する問題を作成します。
2. \[ **割り当て** ] ドロップダウンをクリックし、 **GitHub Copilot** を選択します。
3. 使用する Copilot cloud agent 用のリポジトリをまだ指定していない場合は、ここで実行するように求められます。 ここで、 Copilot cloud agent はこの問題に関連する pull request を開きます。
4. 初めてアプリを使用する場合は、 GitHub アカウントにサインインし、アプリを承認するように求められます。 プロンプトに従って承認を完了します。
5. 線形問題の \[リンク] セクションに、 Copilot cloud agentによって作成されたリンクされた "\[WIP]" プル要求が表示されます。 リンクをクリックして、 GitHubの pull request を表示します。
6. プル要求 Copilot cloud agent 作業が完了すると、線形問題の \[アクティビティ] セクションに通知が追加されます。

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

Linear のエージェント ガイダンスを使用して、問題ごとに、またはワークスペース全体で、 Copilot cloud agent を Linear で実行する方法をカスタマイズできます。 既定のリポジトリ、優先モデル、ブランチ規則などの定期的な設定は、 [Linear エージェント ガイダンス](#using-linear-agent-guidance)を使用して 1 回設定することをお勧めします。

### Linear エージェントの使用に関するガイダンス

Linear のエージェント ガイダンスは、ワークスペースまたはチーム レベルで設定するプロンプトです。 Linear は、このガイダンスをトリガーするたびに Copilot cloud agent に自動的に渡します。

エージェント ガイダンスの一般的な用途は次のとおりです。

* pull request を開く既定のリポジトリを指定する。
* 優先モデルの指定。
* 使用するカスタム エージェントの指定。
* ブランチの名前付け規則または既定のベース ブランチを定義する。

Linear のエージェント ガイダンスの詳細については、Linear ドキュメントの [ガイド エージェント](https://linear.app/docs/agents-in-linear#guiding-agents) を参照してください。

### モデルの選択

線形問題から Copilot cloud agent をトリガーする場合は、問題の説明でモデルを指定することで、使用 Copilot モデルを選択できます。 詳細については、「[GitHub Copilot クラウド エージェントの AI モデルの変更](/ja/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model)」を参照してください。

ワークスペースまたはチーム内のすべての実行に既定のモデルを設定するには、エージェントのガイダンスに追加します。
[線形エージェントの使用に関するガイダンスを](#using-linear-agent-guidance)参照してください。

### カスタム エージェントの使用

Issue の説明で使用するエージェントを指定すると、Copilot cloud agent は Linear からプルリクエストを作成するときに、GitHub リポジトリのカスタムエージェントを使用できます。 詳細については、「[Copilot cloud agent用のカスタム エージェントの作成](/ja/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)」を参照してください。

ワークスペースまたはチーム全体で同じカスタム エージェントを常に使用するには、エージェント のガイダンスで指定します。
[線形エージェントの使用に関するガイダンスを](#using-linear-agent-guidance)参照してください。

### ベース ブランチと作業ブランチの設定

Copilot cloud agentが線形問題からのプル要求を開くと、次のオプションを選択できます。

* プル リクエストの対象となる **ベース ブランチ**。
* コミットに使用される**作業ブランチ**名Copilot cloud agent。

すべての実行で同じベース ブランチまたはブランチの名前付け規則を適用するには、エージェントのガイダンスに追加します。
[線形エージェントの使用に関するガイダンスを](#using-linear-agent-guidance)参照してください。

### セッションの管理

線形問題から Copilot cloud agent をトリガーした後は、エージェントを引き続き指示できます。 これを行うには、追加の指示を添えて Linear の issue のコメントで `@GitHub Copilot` にメンションするか、エージェントチャットパネルに追加の指示を入力してください。

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

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