# クラウド エージェントGitHub Copilotについて

Copilot では、リポジトリの調査、実装計画の作成、ブランチでのコード変更を行うことができます。 準備ができたら、差分を確認し、反復処理し、プル要求を作成できます。

## Copilot cloud agent の概要

Copilot cloud agentを使用すると、GitHub Copilotはバックグラウンドで独立して作業し、人間の開発者と同じようにタスクを完了できます。

Copilot cloud agent できます：

* リポジトリを調査する
* 実装計画を作成する
* バグを修正する
* 増分型の新機能を実装する
* テストのカバレッジを向上させる
* ドキュメントを更新する
* 技術的負債に対処する
* マージ競合を解決する

タスクを Copilot cloud agentに委任すると、次のことができます。

* GitHub.comのエージェント パネルまたはその他のエージェント エントリ ポイントを使用して、ブランチでCopilot調査、計画、およびコード変更を行い、プル要求を作成する前に反復処理します。 プロンプトで、プル要求をすぐに作成するように指定することもできます。 「[Copilot cloud agentを使用してコードの変更を調査し、計画し、反復します。](/ja/copilot/how-tos/copilot-on-github/use-copilot-agents/research-plan-iterate)」を参照してください。
* CopilotやGitHub Issuesなど、他のエントリ ポイントから新しいプル要求を開くようにVisual Studio Codeに依頼します。 「[GitHub Copilot セッションの開始](/ja/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions)」を参照してください。
* 既存の pull request に対するコメントに `@copilot` メンションして、変更を依頼します。 「[GitHubでのクラウド エージェントCopilot使用](/ja/copilot/how-tos/use-copilot-agents/cloud-agent/use-cloud-agent-on-github)」を参照してください。
* スケジュールに従って、または問題が開かれているなどのイベントに応答して、automationを自動的に実行するようにCopilotを設定します。 「[Copilot自動化について](/ja/copilot/concepts/agents/cloud-agent/about-automations)」を参照してください。

\*セキュリティキャンペーンから Copilot にセキュリティアラートを割り当てます。
[「AUTOTITLE」を](/ja/code-security/how-tos/manage-security-alerts/remediate-alerts-at-scale/fixing-alerts-in-security-campaign#assigning-alerts-to-copilot-cloud-agent)参照してください。

Copilot cloud agent は、指定したプロンプトに基づいて、割り当てられたタスクを評価します。

コーディング タスクに取り組んでいる間、 Copilot cloud agent は独自のエフェメラル開発環境にアクセスでき、 GitHub Actionsを利用して、コードの探索、変更、自動テストやリンターの実行などを行うことができます。

> \[!NOTE] pull request を作成する前のコード変更に関する綿密な調査、計画、反復的な改善は、Copilot cloud agent 上の GitHub.com と、Microsoft Teams および Slack の統合における パブリック プレビュー でのみ利用できます。 その他のcloud agent統合 (Azure Boards、JIRA、Linear など) では、プル要求の直接作成のみがサポートされます。

### 従来の AI ワークフローと比べた場合の利点

Copilot cloud agentを効果的に使用すると、IDE の従来の AI アシスタントよりも生産性の利点が得られます。

* **IDE の AI アシスタント**を使うと、コーディングは**ローカル**で行われます。 個々の開発者は AI アシスタントと**同期**セッションで協力します。 セッション中に下された決定は**追跡されません**。また、コミットされない限り、時間の経過と共に失われます。 アシスタントはコードの記述に役立ちますが、開発者にはまだ多くの**手動のステップ**があります。ブランチを作成し、コミットメッセージを書き、変更をプッシュし、PRを開いて説明文を書き、レビューを受け、IDEで反復処理を行い、それを繰り返す必要があります。 このような手順には時間と労力がかかるため、単純な issue や日常的な issue に対しては負担が見合わない場合があります。

* **Copilot cloud agent**では、すべてのコーディングと反復処理が**GitHubで**行われます。 プル要求を開く前に、リポジトリのCopilot、**計画の作成**、ブランチでの**コード変更**の実行を\*\*\*\* に依頼できます。 さまざまな種類のタスクに特化した複数の custom agents を作成できます。 Copilot**では、ブランチの** 作成、コミット メッセージの書き込み、プッシュが自動化されます。 開発者はエージェントを **バックグラウンドで動作** させ、準備ができたら **pull request を作成** することを選択します。 GitHubに取り組むと、コミットで発生するすべてのステップがログに表示され、チーム全体の**コラボレーション**の機会が広がり、**透明性**が向上します。

### Copilot Chat セッションとCopilot cloud agent セッション間のコンテキストの共有

Copilot cloud agent 上の Copilot Chat から GitHub セッションを開始すると、チャットのコンテキストがそのセッションに引き継がれます。 セッションの実行中にチャットを続け、同じ会話の進行状況に関するフォローアップの質問を行うことができます。 詳細については、「[エージェント セッションの管理](/ja/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents)」を参照してください。

## Copilot cloud agent 対 エージェント モード

Copilot cloud agent は、IDE で使用できる "エージェント モード" 機能とは異なります。
Copilot cloud agent は、 GitHub Actionsを利用した環境で自律的に動作し、 GitHub の問題または GitHub Copilot Chat プロンプトによって割り当てられた開発タスクを完了します。 リポジトリの調査、プランの作成、ブランチでのコード変更、必要に応じてプル要求のオープンを行うことができます。 これに対し、IDE のエージェント モードでは、ローカル開発環境で自律的な編集が直接行われます。 エージェント モードの詳細については、「[GitHub CopilotにIDEで質問を行う](/ja/copilot/how-tos/chat-with-copilot/chat-in-ide)」を参照してください。

## ソフトウェア開発を合理化する Copilot cloud agent

タスクを Copilot cloud agent に割り当てることで、ソフトウェア開発ワークフローを強化できます。

たとえば、 Copilot cloud agent を割り当て先として \[Copilot] を選択することで、バックログの単純な問題に割り当てることができます。 これにより、これらの問題に費やす時間を減らし、より複雑な作業や興味深い作業、または高度な創造的思考を必要とする作業に多くの時間を費やすことができます。
Copilot cloud agent は、コードベースや製品の品質を向上させる「あれば便利な」課題に取り組むことができますが、多くの場合、より緊急な作業に集中している間はバックログに残されます。

追加のコーディング リソースとして Copilot cloud agent すると、リソースが不足しているために開始していない可能性のあるタスクを開始することもできます。 たとえば、コードをリファクタリングしたり、ログ記録を追加したりするための問題を作成し、すぐに Copilotに割り当てることができます。

Copilot cloud agentを使用してリポジトリを調査し、コードを記述する前にプランを作成することもできます。変更をコミットする前に、コードベースがどのように機能するか、またはアプローチに同意するかを理解するのに役立ちます。 「[Copilot cloud agentを使用してコードの変更を調査し、計画し、反復します。](/ja/copilot/how-tos/copilot-on-github/use-copilot-agents/research-plan-iterate)」を参照してください。

Copilot cloud agent はタスクを開始し、その後は自分で作業を続けることができます。 最初の作業を Copilotに割り当てることで、新しいプロジェクトのスキャフォールディングの設定など、繰り返し行う作業に費やした時間を解放できます。

さまざまなタスクに特化した custom agents を作成できます。 たとえば、React コンポーネントとスタイル設定に重点を置いたフロントエンド開発に特化した custom agent 、技術ドキュメントの作成と更新に優れたドキュメント エージェント、包括的な単体テストの生成に特化したテスト エージェントを作成できます。 各 custom agent は、特定のタスクに適した特定のプロンプトとツールで調整できます。

## プルリクエストの成果を測定するCopilot cloud agent

エンタープライズ管理者と組織の所有者は、 Copilot 使用状況メトリックを使用して、 Copilot cloud agentによって作成されたプル要求のプル要求の結果を分析できます。

Copilot使用状況メトリック API には、次のような pull request ライフサイクル メトリックが含まれます。

* 作成およびマージされたプル要求の合計数
* マージされた Copilot cloud agent によって作成されたプル要求の数
* マージされたプルリクエストのマージ時間の中央値 (Copilot cloud agent によって作成されたプルリクエストを含む)

これらのメトリックは、 Copilot cloud agent の導入を追跡し、プル要求のスループットと時間の経過と同時にマージする時間の変化を監視するのに役立ちます。 「[GitHub Copilot 使用状況メトリクス](/ja/copilot/concepts/copilot-usage-metrics/copilot-metrics)」を参照してください。

## Copilot cloud agentとサード パーティ製ツールの統合

外部ツールから Copilot cloud agent を呼び出すことができます。これにより、タスクを Copilotに割り当て、コンテキストを提供し、ワークフローを離れることなく pull request を開くことができます。

Microsoft Teamsと Slack のCopilot cloud agentを使用して、エージェント支援型の作業についてチームと共同作業を行います。 チャネル、スレッド、ダイレクト メッセージを @mentionGitHub して、チーム メンバーと一緒に作業したり、調査、計画、コーディングのタスクに Copilot したりできます。 チームメイトは、コンテキストの追加、セッション Copilot 操作、進行状況の監視、結果の成果物の確認を行うことができます。

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

## Copilot cloud agentを使用できるようにする

Copilot cloud agentにタスクを割り当てる前に、タスクを有効にする必要があります。
Copilot cloud agent は、すべての有料 Copilot プランで使用できます。

GitHub Copilot BusinessまたはGitHub Copilot Enterpriseサブスクライバーの場合は、エージェントを使用する前に、管理者が関連するポリシーを有効にする必要があります。

リポジトリの所有者は、 Copilot cloud agentから一部またはすべてのリポジトリをオプトアウトすることを選択できます。

「[GitHub Copilot クラウド エージェントへのアクセスの管理](/ja/copilot/concepts/agents/cloud-agent/access-management)」を参照してください。

## Copilot cloud agent 用のAIモデル

Copilot cloud agent タスクの開始方法によっては、Copilot cloud agentで使用されるモデルを選択できる場合があります。
Copilotに与えるタスクの種類によっては、さまざまなモデルのパフォーマンスが向上したり、より有用な応答を提供したりする場合があります。

「[GitHub Copilot クラウド エージェントの AI モデルの変更](/ja/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model)」を参照してください。

## リポジトリに関する Copilot cloud agentの知識を強化する

リポジトリ内のコード、使用するツール、コーディングの標準とプラクティスについて知っている Copilot cloud agent が多いほど、より効果的になります。 リポジトリに関する Copilot cloud agentの知識を強化する方法は 2 つあります。

* **カスタム手順**

  これらは、リポジトリに 1 つ以上のファイルとして書き込んで格納する、短い自然言語ステートメントです。
  GitHubの組織の所有者である場合は、組織の設定でカスタム指示を定義することもできます。 「[GitHub Copilotの応答をカスタマイズする方法](/ja/copilot/concepts/prompting/response-customization?tool=webui#about-repository-custom-instructions)」を参照してください。

* **Copilot Memory** (パブリック プレビュー)

Copilot Pro、Copilot Pro+、またはCopilot Maxプランがある場合は、Copilot Memoryを有効にすることができます。 これにより、 Copilot はリポジトリに関してそれ自体で解決した有用な詳細を格納できます。
Copilot cloud agent は、そのリポジトリで作業しているときにこの情報を使用できます。 「[GitHub Copilot Memory について](/ja/copilot/concepts/agents/copilot-memory)」を参照してください。

## Copilot cloud agent 使用コスト

Copilot cloud agent は GitHub Actions 分と AI credits を使用します。 使用される AI credits は、使用されるモデルと、セッション中に処理されたトークンの数によって異なります。

含まれる GitHub Actions 分と AI credits内で、追加コストを発生させずに Copilot cloud agent を使用できます。 「[Usage-based billing for organizations and enterprises](/ja/copilot/concepts/billing/usage-based-billing-for-organizations-and-enterprises)」を参照してください。

Copilot コード レビューでは、プライベート リポジトリでも GitHub Actions 分が消費されます。 「[GitHub Actions の課金](/ja/billing/concepts/product-billing/github-actions#copilot-code-review-and-github-actions-minutes)」を参照してください。

## カスタマイズ Copilot cloud agent

Copilot cloud agentは、さまざまな方法でカスタマイズできます。

* **カスタム手順**: カスタム命令を使用すると、プロジェクト Copilot 追加のコンテキストと、その変更をビルド、テスト、検証する方法を指定できます。 「[GitHub Copilot用のリポジトリカスタム命令の追加](/ja/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions)」を参照してください。
* **モデル コンテキスト プロトコル (MCP) サーバー**: MCP サーバーを使用すると、さまざまなデータ ソースとツールに Copilot アクセスできます。
  GitHubのリポジトリ MCP 設定は、Copilot cloud agentとCopilot code reviewの両方に適用されます。
  GitHub MCP サーバーと Playwright MCP サーバーは、両方の機能に対して既定で有効になっています。 「[リポジトリの MCP サーバーを構成する](/ja/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers)」を参照してください。
* **Custom agents**: Custom agents 、タスクごとに異なる特殊なバージョンの Copilot を作成できます。 たとえば、チームのガイドラインに従って、 Copilot をカスタマイズして、専門家のフロントエンド エンジニアにすることができます。 「[カスタム エージェントについて](/ja/copilot/concepts/agents/cloud-agent/about-custom-agents)」を参照してください。
* **フック**: フックを使用すると、エージェントの実行中にキー ポイントでカスタム シェル コマンドを実行できるため、検証、ログ記録、セキュリティ スキャン、またはワークフローの自動化を追加できます。 「[フックについて GitHub Copilot](/ja/copilot/concepts/agents/hooks)」を参照してください。
* **スキル**: スキルを使用すると、命令、スクリプト、リソースを使用して特殊なタスクを実行する Copilot の能力を高めることができます。 「[エージェントのスキルについて](/ja/copilot/concepts/agents/about-agent-skills)」を参照してください。

## Copilot cloud agent の制限事項

Copilot cloud agent には、ソフトウェア開発ワークフローと他の機能との互換性に一定の制限があります。

### Copilot cloud agentのソフトウェア開発ワークフローの制限事項

* **Copilot は、タスクの開始時に指定されたリポジトリにのみ変更を加えることができます**。 Copilot では、1 回の実行で複数のリポジトリ間で変更を加えることはできません。
* **既定では、 Copilot は、タスクの開始時に指定されたリポジトリ内のコンテキストにのみアクセスできます**。
  Copilot MCP サーバーは、Copilotが動作しているリポジトリ内のコンテキスト (問題や履歴プル要求など) にアクセスできるように、既定で構成されます。 ただし、リポジトリの MCP 設定を使用して、より広範なアクセスを構成できます。 「[リポジトリの MCP サーバーを構成する](/ja/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers)」を参照してください。
* **Copilot は、一度に 1 つのブランチでのみ作業** でき、割り当てられている各タスクに対処するために、1 つの pull request を正確に開くことができます。
* **各 Copilot cloud agent セッションの最大実行時間は 59 分です**。 これは、拡張またはバイパスできないハード制限です。 タスクがこの制限を超えると、セッションはタイムアウトして停止します。 より多くの時間を必要とする可能性がある複雑なタスクの場合は、作業をより小さく、より集中したタスクに分割することを検討してください。
  `timeout-minutes` ファイルの`copilot-setup-steps.yml`設定を使用して、短いタイムアウトを構成できます。 「[開発環境を構成する](/ja/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/customize-the-agent-environment)」を参照してください。

### Copilot cloud agentの他の機能との互換性に関する制限事項

* **Copilot は、リポジトリ用に構成できる特定の規則に準拠できません**。 Copilot cloud agentと互換性のないルール セットまたはブランチ保護規則を構成した場合、エージェントへのアクセスはブロックされます。 たとえば、特定のコミット作成者のみを許可するルールでは、 Copilot cloud agent がプル要求を作成または更新できないようにすることができます。 ルールセットを使用してルールが構成されている場合は、 Copilot をバイパス アクターとして追加してアクセスを有効にすることができます。 「[リポジトリのルールセットの作成](/ja/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/creating-rulesets-for-a-repository#granting-bypass-permissions-for-your-branch-or-tag-ruleset)」を参照してください。
* **Copilot cloud agentは、GitHubでホストされているリポジトリでのみ機能**します。 リポジトリが別のコード ホスティング プラットフォームを使用して格納されている場合、 Copilot は作業できません。

## ハンズオン プラクティス

[
Copilot cloud agent
](https://github.com/skills/expand-your-team-with-copilot/?ref_product=copilot\&ref_type=engagement\&ref_style=text)スキルを用いてチームを拡張する演習を試し、Copilot cloud agentで実践的な経験を積んでください。

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

* [クラウド エージェントGitHub Copilot](/ja/copilot/how-tos/use-copilot-agents/cloud-agent)ハウツー記事
* [カスタム エージェントについて](/ja/copilot/concepts/agents/cloud-agent/about-custom-agents)
* [アプリケーション カード: GitHub Copilot エージェント](/ja/copilot/responsible-use/agents)