Copilot自動化

Overview

automationsを使用すると、スケジュールに従って、リポジトリ内のイベントに応答して、または API を介してトリガーして、Copilot cloud agentを自動的に実行するように設定できます。 Automations は、プル要求を開いたり、問題にラベルを付けたりするなど、構成されているリポジトリ内でアクションを実行できます。

プロンプトを 1 回定義し、トリガーを選択して、Copilot が使用できるツールを決定します。 Copilot は、 automationのトリガーが起動するたびに自動化を自動的に実行します。

たとえば、 automations を使用して次のことができます。

バグの再現: 課題が作成されたときに報告されたバグを再現しようとします。
レビュー用のスクリーンショットをキャプチャする: 変更のスクリーンショットをキャプチャし、レビュー可能としてマークされたときに pull request に添付します。
実稼働インシデントの調査: 監視ツールで検出されたインシデントの調査を開始します。

次の場所から automations を作成および管理することもできます。

GitHub 上のリポジトリの [エージェント] タブ
GitHub Copilot app の [ Automations ] タブ
VS Code の [エージェント] ウィンドウ
REST API

automationを作成するときは、次を定義します。

**** を識別するためのautomation。
種類は個人用または共有用のいずれかで、automation を表示および編集できるユーザー、課金対象、および使用される ID を決定します。個人用と共有automationsを参照してください。
実行するタスクを説明するプロンプトCopilot。
automationによって**** が実行されるタイミングを決定します。
ツールCopilotを使用して、リポジトリで実行できるアクションを制御できます。
必要に応じて、モデルと推論レベルCopilotの使用。
オプションで、AI credits が消費できる **** の数を制御する AI credits。

コンテキストを共有するautomation groupsをautomationsに追加し、結果に基づいて自ら改善できるようにすることができます。

automationsの作成と管理の手順については、Copilot クラウドエージェントを使用した自動化の作成を参照してください。

可用性とアクセス許可

automationsをリポジトリで使用できるようにするには、次のすべてに該当する必要があります。

リポジトリは プライベートまたは内部である必要があります。 Automations はパブリックリポジトリでは使用できません。
Copilot cloud agent リポジトリに対して有効にする必要があります。 Copilot BusinessまたはCopilot Enterpriseがある場合、管理者はCopilot cloud agent ポリシーを有効にする必要があります。「企業または組織向けのクラウドでのGitHub Copilotの管理」を参照してください。
組織は、リポジトリ内の Copilot cloud agent と automations の両方を許可する必要があります (両方とも既定で有効になっています)。「組織のクラウドでのGitHub Copilotの管理」を参照してください。

Automations は、 GitHub Copilot Pro、 GitHub Copilot Pro+、 GitHub Copilot Max、 GitHub Copilot Business、および GitHub Copilot Enterprise プランで使用できます。

リポジトリへの 書き込みアクセス権 を持つユーザーは、そのリポジトリに automations を作成できます。

automationsは、次の場所から作成および管理できます。

**** 上のリポジトリにある、Automations ペインの エージェント タブ。
Automations の GitHub Copilot app タブ。
**** の [Automations] ウィンドウの VS Code タブ。

VS Codeのクラウド automationsでは、バージョン 1.144 以降であり、かつchat.automations.cloud.enabled設定が有効になっている必要があります。

個人用と共有 automations

automationを作成するときは、その種類を選択しますが、選択した種類は後で変更できません。

個人用エージェント automations は、スタンドアップのための進捗報告の準備など、自分の作業を自動化するのに役立ちます。
共有 automations により、チーム全体のワークフローを自動化するために、チームで automations を一緒に構築・維持できます。

	個人用	Shared
誰がautomationを表示できますか	あなただけ	リポジトリへの読み取りアクセス権を持つすべてのユーザー
automationの実行を確認できるのは誰ですか	リポジトリへの読み取りアクセス権を持つすべてのユーザー	リポジトリへの読み取りアクセス権を持つすべてのユーザー
automation を編集できるのは誰ですか	あなただけ	リポジトリへの書き込みアクセス権を持つすべてのユーザー
誰に課金されますか AI credits	あなた	リポジトリを所有する組織またはユーザー
GitHub 上のアクションに使用される ID	あなたの身元	Copilot の ID

共有 automation は、それを作成したユーザーではなくリポジトリに属しているため、そのユーザーがチームを離れたり、リポジトリへのアクセスを失ったりした場合に動作し続けます。

組織が所有するリポジトリで共有 automation を実行するには、組織が組織に請求される Copilot cloud agent の使用を許可する必要があります。管理者は、"組織に請求される Copilot cloud agent の使用を許可する" ポリシーを使用してこれを有効にすることができます。

トリガー

そのトリガーのいずれか1つが発動すると、automation が実行されます。次のようなさまざまなトリガーを利用可能です。

スケジュールに従って: automation は、1時間ごと、毎日、または毎週の間隔で定期的に実行されます。
問題が作成されると、リポジトリで問題が開かれるたびに automation が実行されます。
pull request が開かれるとき: automation は、リポジトリでプル要求が開かれるたびに実行されます。
pull request の同期時: automation は、リポジトリ内のプル要求に新しいコミットがプッシュされるたびに実行されます。

必要に応じて、イベントベースのトリガーのフィルターを構成できます。次に例を示します。

問題が作成されたら、検索クエリフィルターを追加します。
プルリクエストが開かれた場合と、プルリクエストが同期された場合に、検索クエリフィルターと、プルリクエストで変更されたファイル用のフィルターを追加します。

プロンプト挿入のリスクを軽減するために、 automations 既定でリポジトリへの書き込みアクセス権を持たないユーザーによってトリガーされた GitHub イベントを無視します。これは、信頼されていないユーザーが、外部の共同作成者が Issue を開いた場合などに、Copilot がアクションを実行するのを防ぐのに役立ちます。必要に応じて、これらのイベントを許可することを選択できます。詳細については、「セキュリティと安全性」を参照してください。

すべての automations は API を介してトリガーできるため、 automations を外部システムやツールに接続できます。 API を使用して automation を開始するときに、プロンプトに渡される追加のコンテキストを含めることができます。

ツールとアクション

** **の作成時に選択するautomationによって、Copilotの実行時に実行できるautomationが決まります。

たとえば、変更のプッシュ、問題ラベルの更新、プル要求の作成を Copilot に許可できます。

次の 2 種類のツールから選択できます。

GitHubツールを使用すると、CopilotがGitHub上でリポジトリを扱えるようになります。たとえば、GitHub ツールでは、Copilot が可能です:
- 添付ファイルをアップロードする
- コメントとレビューの非表示と再表示
- リアクションを追加および削除する
- ディスカッションとそのコメントを読み、ディスカッションにコメントを付ける
MCP サーバーのツールを使用すると、Copilot は外部システムと連携できます。 automation は、リポジトリの MCP 設定で構成された MCP サーバーのツールを使用できます。 automationが使用できる各サーバーのツールを選択します。「リポジトリの MCP サーバーを構成する」を参照してください。

ツールの選択は、 automationのスコープを制御する主な方法です。 Copilotが意図していないアクションを実行できないように、タスクに必要なツールのみを付与します。

有効にするツールを手動で選択するか、**** の GitHub ボタンを使用して、Copilot がプロンプトに基づいてツールを提案するようにできます。

GitHub ツールは、 automation のスコープが設定されている単一のリポジトリでのみアクションを実行できます。 MCP サーバーのツールは、そのリポジトリに限定されるわけではありません。サーバーの構成と資格情報で許可されているものにアクセスできます。これには、他のリポジトリや外部システムが含まれる場合があります。ツールを選択する前に、各 MCP サーバーがアクセスできる内容を確認します。

リポジトリから継承された構成

Automations は、適用対象のリポジトリに対して Copilot cloud agent 設定を使用します。これには次が含まれます:

カスタム命令。「GitHub Copilot用のリポジトリカスタム命令の追加」を参照してください。
エージェントのスキル。「GitHub Copilot のスキルを追加する」を参照してください。
ファイアウォール規則。「GitHub Copilotのファイアウォールのカスタマイズまたは無効化」を参照してください。
シークレットと変数。「Copilotクラウドエージェントのシークレットと変数を設定する」を参照してください。

Automations は、リポジトリの内容とは別に格納されます。これらは Git にコミットされないため、コードと共にバージョン管理されたり、プル要求によって管理されたりしません。

Billing

automationが実行されるたびに、GitHub ActionsCopilot cloud agent分を使用するGitHub AI Creditsセッションが開始されます。

個人用 automationの場合、 AI credits 使用量は、 automationを作成したユーザーに課金されます。

共有 automationの場合、 AI credits 使用量は、リポジトリを所有する組織に対して課金されます。個人アカウントがリポジトリを所有している場合は、リポジトリ所有者の Copilot サブスクリプションに対して課金されます。詳細については、「GitHub Copilot ライセンス」および「GitHub Actions の課金」を参照してください。

GitHub Actions 分は、リポジトリ所有者に個別に課金されます。

AI credits制限によるコスト管理

AI creditsが消費できるautomationの数に制限を設定できます。これにより、使用状況を制御しながら、定期的な作業を自動化できます。

AI creditsでは、次の省略可能な制限を設定できます。制限を設定したくない場合は、空欄のままにしてください。

実行ごとに: 制限に達するとすぐに実行を停止します。最小値は 30 AI creditsです。
日単位: 制限に達すると、新しい実行が開始されないようにします。毎日 00:00 UTC にリセットされます。
週単位: 制限に達すると、新しい実行が開始されないようにします。毎週月曜日の 00:00 UTC にリセットされます。
月次: 制限に達すると、新しい実行が開始されないようにします。毎月 1 日の UTC 00:00 にリセットされます。

日単位、週単位、月単位の制限では、既に進行中の実行は停止されません。個々の実行のコストの上限を設定するには、実行ごとの制限を設定します。

automationを作成または更新するときに制限を設定できます。「Copilot クラウドエージェントを使用した自動化の作成」を参照してください。

改善案

Automations は、自身のツール、トリガー、プロンプトの改善や、他の automations のツール、トリガー、プロンプトの改善を提案できます。

Automations は、不足しているツールなど、作業中に問題に直面したときに改善案を提案する場合があります。

automationsを使用してCopilotを作成する場合、Copilotは、一部のautomation groupsが作業を行い、他のautomation groupsが結果を評価し、継続的に改善を提案する自己改善するautomationsを作成するのに役立ちます。

automationに改善案がある場合は、通知を受け取り、automationを表示するときに提案が表示されます。

提案された改善の説明と、automation groupに適用する変更が表示されます。提案された改善を適用するか、無視するかを決定できます。

セキュリティと安全性

Automations は、各タスクを開始するユーザーなしで Copilot を実行するため、追加のリスクを伴います。 GitHub には、これらのリスクを軽減するための組み込みの保護が用意されています。

帰属。
- 共有GitHubによってautomationに対して実行されるアクションは、Copilotに帰属します。リポジトリで少なくとも 1 つのプルリクエストの承認が必要な場合は、共有アカウント automationによって作成されたプルリクエストに対して、既定で追加の承認が必要です。管理者はルールセットでこの追加要件を無効にできますが、ブランチ保護ルールでは無効にできません。
- 個人 automation によって実行されるアクションは、automation を作成したユーザーに帰属します。ユーザーが自身で作成するプル要求と同様に、ユーザーはこれらのプル要求を承認できないため、予想されるレビューコントロールが保持されます。
最小権限ツール。 automationで使用できるツールを正確に選択して、タスクに必要なアクションのみに制限することができます。
信頼されていない入力。 既定では、 automations リポジトリへの書き込みアクセス権を持たないユーザーによってトリガーされたイベントを無視して、信頼されていないユーザーからのプロンプト挿入のリスクを軽減します。
ワークフローの実行。 既定では、すべての Copilot cloud agent 作業と同様に、書き込みアクセス権を持つユーザーが承認するまで、 GitHub Actions ワークフローは pull request では実行されません。これにより、automation によって作成されたプルリクエストがワークフローを自動的にトリガーするリスクが軽減されます。
透過的な実行処理。 任意のCopilot cloud agent（個人用または共有）によって開始されたautomationセッションは、リポジトリへの読み取りアクセス権を持つすべてのユーザーに表示されます。これらのセッションを表示できるユーザーは誰でも、プロンプト、セッションログ、および Copilot が作成するプルリクエストやその他の変更を表示できます。

GitHub が Copilot cloud agent のリスクをどのように軽減するかの詳細については、GitHub Copilot クラウドエージェントのリスクと軽減策を参照してください。

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

Copilot クラウドエージェントを使用した自動化の作成
GitHub.com および GitHub Mobile でのGitHub Copilot
自動化をコードとして格納する方法、pull request を使用して確認する方法、別のコーディングエージェントで実行する方法については、GitHub エージェント型ワークフローを参照してください。

この機能を使用できるユーザーについて

この記事で