イントロダクション
automationsを使用すると、スケジュールに従って、リポジトリ内のイベントに応答して、または API を介してトリガーして、Copilot cloud agentを自動的に実行するように設定できます。 Automations は、プル要求を開いたり、問題にラベルを付けたりするなど、構成されているリポジトリ内でアクションを実行できます。
automationsは、**** のリポジトリの [GitHub] タブから作成および管理できます。
次の場所から automations を作成および管理することもできます。
- GitHub Copilot app の [ Automations ] タブ
- VS Code の [エージェント] ウィンドウ
- REST API
トリガー、ツール、可視性、セキュリティなど、 automationsの概要については、 Copilot自動化 を参照してください。
Prerequisites
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 プランで使用できます。
VS Code でクラウド automations を有効にする
クラウド VS Code を automations から使用するには、上記のリポジトリの前提条件を満たしてから、次のようにします。
- VS Code 1.144 以降に更新します。
- 設定エディターで、
chat.automations.cloud.enabledを有効にしてください。 - [エージェント] ウィンドウを開き、[Automations] タブを選択します。
作成と管理の手順については、VS Code のドキュメントを参照してください。
automation を作成する
警告
Copilot cloud agentによって開始されたautomation セッションは、リポジトリにアクセスできる他のユーザーに表示されます。 プロンプトにシークレットやその他の機密情報を含めないでください。 機密性の高い値 Copilot アクセスできるようにするには、リポジトリ シークレットを使用します。 「Copilotクラウドエージェントのシークレットと変数を設定する」を参照してください。
- GitHub で、リポジトリのメイン ページに移動します。
- リポジトリ名の下にある** エージェント**をクリックします。
- サイドバーで、[ Automations] をクリックします。
- [automationの作成] をクリックします。
- [ エージェントで作成 ] をクリックして Copilot を操作して automationsを作成するか、 手動で作成 してフォームで automations を設定します。
Copilot を使って automation を作成する
[ エージェントで作成] をクリックすると、チャット ウィンドウが表示され、Copilot が何を自動化したいかを尋ねます。
Copilotを使用してautomationを設計し、トリガー、ツール、プロンプトを設定できます。
Copilot 結果から学び、自らの改善を提案する自己改善型の automations グループを作成するのにも役立ちます。
automationを手動で作成する
-
** **のautomationを入力します。
-
種類 で、作成する automation の種類を選択します。
-
個人用: automationを見られるのはあなただけです。 AI credits が課金され、GitHub に対して行われたアクションにはあなたのIDが使用されます。
-
共有: リポジトリにアクセスできるすべてのユーザーはautomationを表示できます。 AI creditsは、リポジトリを所有する組織またはユーザーに対して課金され、Copilotに対して実行されるアクションではGitHubの ID が使用されます。
-
automationを作成した後で型を変更することはできません。 「Copilot自動化」を参照してください。
-
automationを 1 つ以上選択して、**** を実行するタイミングを決定します。 必要に応じて、トリガーの起動タイミングを制御するフィルターを構成できます。
問題と pull request トリガーの場合は、次を選択できます。
- GitHub上で実行中に更新できるリソースは何ですか。 構成済みツールで変更可能な範囲 ドロップダウンから、このリポジトリ内のすべてを選択して、GitHubツールがリポジトリ内の任意のリソースを作成および更新できるようにします。 実行をトリガーした Issue またはプルリクエスト、および実行中に作成されたリソースに対するツールの書き込みを制限するには、[ この Issue のみ ] を選択します。 この設定では、サーバー構成と資格情報によって許可されるリソースにアクセスできる MCP サーバーのツールは制限されません。 リポジトリの構成によっては、このリポジトリ内のすべてオプションを使用できない場合があります。
- クラウド内のCopilotからのアクティビティがこのautomationをトリガーできるかどうか: [トリガー可能なユーザー] ドロップダウンから[クラウド内のCopilot以外のすべてのユーザー]を選択して、automationsによってトリガーされたイベント（Copilotを含む）を無視します。 Copilotを選択すると、**** によってトリガーされるイベントを含むすべてのイベントをリッスンします。
- リポジトリへの読み取りアクセス権のみを持つユーザーがこのautomationをトリガーできるかどうか:既定では、automationsリポジトリへの書き込みアクセス権を持たないユーザーからのアクティビティは無視されます。 [このリポジトリへの書き込みアクセス権を持たないユーザーによってトリガーされたイベントを無視する] ボックスをオフにして、これらのイベントをリッスンします。 リポジトリの構成によっては、 このリポジトリへの書き込みアクセス権を持たないユーザーによってトリガーされたイベントを無視する オプションが有効な状態でロックされている可能性があります。
-
プロンプト フィールドで、Copilotが実行されるたびにautomationに実行させるタスクを記述します。
たとえば、
Label this issue as a bug, an enhancement, or other, based on its content.のように指定します。 -
必要に応じて、Copilot に使用させるモデルと推論レベルを選択します。 「GitHub Copilot クラウド エージェントの AI モデルの変更」を参照してください。
-
ツールCopilotの実行時に使用できるツールを選択します。たとえば、変更のプッシュ、Issue ラベルの更新、プル リクエストの作成などです。
GitHubツールと、リポジトリの MCP 設定で構成されている任意の MCP サーバーからツールを選択できます。 外部システムのツールを使用できるようにするには、最初にリポジトリ管理者がリポジトリ用に MCP サーバーを構成する必要があります。 「リポジトリの MCP サーバーを構成する」を参照してください。
タスクに必要なツールのみを選択します。 選択したツールは、リポジトリで実行できる Copilot アクションを制御します。 必要に応じて、[ツールの **提案** ] ボタンを使用して、プロンプトに基づいてツールを提案するように Copilot に依頼できます。 「[AUTOTITLE](/copilot/concepts/agent-capabilities/agent-powered-workflows-and-operations/about-automations#tools-and-actions)」を参照してください。
- 必要に応じて、AI クレジット制限の下で、AI creditsが消費できるautomationの数に制限を設定します。 「制限の設定AI credits」を参照してください。
- [automation] をクリックして**** を保存します。
AI credits制限の設定
automationが実行されるたびに、AI creditsが使用されます。これは、個人のautomationに対して課金されるか、共有automationの場合はリポジトリ所有者に対して課金されます。 コストを制御するには、ある**** を作成または編集するときに、[automation] セクションで制限を設定できます。
AI creditsでは、次の省略可能な制限を設定できます。 制限を設定したくない場合は、空欄のままにしてください。
- 実行ごとに: 制限に達するとすぐに実行を停止します。 最小値は 30 AI creditsです。
- 日単位: 制限に達すると、新しい実行が開始されないようにします。 毎日 00:00 UTC にリセットされます。
- 週単位: 制限に達すると、新しい実行が開始されないようにします。 毎週月曜日の 00:00 UTC にリセットされます。
- 月次: 制限に達すると、新しい実行が開始されないようにします。 毎月 1 日の UTC 00:00 にリセットされます。
日単位、週単位、月単位の制限では、既に進行中の実行は停止されません。 個々の実行のコストの上限を設定するには、実行ごとの制限を設定します。
制限を解除するには、automation を編集して値をクリアします。
automation をテストする
トリガーが起動するのを待たずに、すぐに automation を実行して、期待どおりに動作することを確認できます。
-
Automationsペインから、テストする**** を開きます。
-
[実行] ボタンをクリックします。
-
[ トリガー ] ドロップダウンから、シミュレートするトリガーを選択します。
-
手動トリガーを選択した場合は、必要に応じて、エージェントのプロンプトに含まれますコンテキストを入力します。 これを使用して、API を介して automation をトリガーする動作をシミュレートできます。
別のトリガーを選択した場合は、リソース URL に関連するリソース（たとえば、オープンされた issue の URL や作成された pull request コメントの URL）を入力します。
-
[今すぐ実行] をクリックします。
Copilot は、 Copilot cloud agent セッションを開始し、選択したツールを使用して automationのプロンプトを実行します。 セッションを開いて進行状況に従い、行った変更を確認できます。
Automations の管理
個人の automations はあなただけのものです。 共有 automations は、リポジトリへの読み取りアクセス権を持つすべてのユーザーに表示され、書き込みアクセス権を持つすべてのユーザーが編集できます。
任意のautomationから開始されたセッションは、リポジトリへの読み取りアクセス権を持つすべてのユーザーに表示されます。
リポジトリの Automations ペインから、次のことができます。
- 個人用 automations とリポジトリの共有 automations、それらが開始したセッション、および使用した AI credits を表示します。
- automationを編集して名前、プロンプト、トリガー、ツール、モデル、推論作業またはAI credits制限を変更し、automationのリビジョン履歴を追跡します。
- automations自体またはその他のautomationによって提案された、automationのツール、トリガー、またはプロンプトに対する改善案を確認します。
- automationを無効にして実行を停止するか、後で再度有効にします。
- 不要になった automation を削除します。
すべてのリポジトリのすべての automations を表示し、各リポジトリを管理するために移動するには、ユーザー レベルで Automations ビューを使用します。