# Copilot自動化について

Automations を使用すると、スケジュールに従って、またはリポジトリ内のイベントに応答して、 Copilot cloud agent を自動的に実行できます。

## 概要

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

Copilot cloud agentセッションを手動で開始すると、作業を行うたびにCopilotにタスクを与えます。
automationsでは、タスクを 1 回定義し、Copilotautomationのトリガーが起動するたびに自動的に実行されます。

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

* **受信した問題をトリアージ**する: 新しい問題を、その内容に基づいてバグ、拡張機能、またはその他として自動的にラベル付けします。
* **失敗したテストを夜間に修正**する: 毎晩、 `main` ブランチで失敗したテストを確認し、修正を試み、下書きの pull request を開きます。
* **毎週のリリース ノートを準備**する: ドラフト リリース ノートを作成し、スケジュールに従って pull request を開きます。

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

* \*\*\*\* を識別するためのautomation。
* 実行するタスクを説明する**プロンプト**Copilot。
* \*\*\*\*が実行されるタイミングを決定する 1 つ以上のautomation。
* **モデル**Copilotの用途。
* **ツール**Copilotを使用して、リポジトリで実行できるアクションを制御できます。

automationsの作成と管理の手順については、[Copilot クラウド エージェントを使用した自動化の作成](/ja/copilot/how-tos/use-copilot-agents/cloud-agent/create-automations) を参照してください。

## 可用性とアクセス許可

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

* リポジトリは **プライベートまたは内部**である必要があります。
  Automations はパブリック リポジトリでは使用できません。
* Copilot cloud agent リポジトリに対して有効にする必要があります。
  Copilot BusinessまたはCopilot Enterpriseがある場合、管理者はCopilot cloud agent ポリシーを有効にする必要があります。 「[GitHub Copilot クラウド エージェントへのアクセスの管理](/ja/copilot/concepts/agents/cloud-agent/access-management)」を参照してください。
* 組織は、リポジトリ内の Copilot cloud agent と automations の両方を許可する必要があります (両方とも既定で有効になっています)。 「[GitHub Copilotクラウド エージェントを組織に追加する](/ja/copilot/how-tos/administer-copilot/manage-for-organization/add-copilot-cloud-agent)」を参照してください。

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

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

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

* \*\*\*\* 上のリポジトリにある、GitHub ペインの Automations タブ。
* Automations の \*\*\*\* タブ。

## トリガー

そのトリガーのいずれか1つが発動すると、automation が実行されます。 次のトリガーを使用できます。

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

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

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

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

## ツールとアクション

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

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

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

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

automationは、スコープが設定されている単一のリポジトリでのみアクションを実行できます。

automationが問題を変更すると、各変更を説明し、信頼度を評価し、信頼度の高い変更を自動的に適用し、レビューのために他のユーザーに提案することができます。 「[問題の根拠、信頼、承認について](/ja/copilot/concepts/agents/cloud-agent/about-automation-rationale-and-approvals)」を参照してください。

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

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

* **カスタム命令**。 「[GitHub Copilot用のリポジトリカスタム命令の追加](/ja/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions)」を参照してください。
* **エージェントのスキル**。 「[GitHub Copilot のスキルを追加する](/ja/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/add-skills)」を参照してください。
* **ファイアウォール規則**。 「[GitHub Copilotのファイアウォールのカスタマイズまたは無効化](/ja/copilot/how-tos/copilot-on-github/customize-copilot/customize-the-firewall)」を参照してください。
* **シークレットと変数**。 「[Copilotクラウドエージェントのシークレットと変数を設定する](/ja/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/configure-secrets-and-variables)」を参照してください。

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

## 視認性

automationは、**作成したユーザーに対してプライベートです**。 リポジトリ管理者を含む他のユーザーには、 automationsが表示されません。

ただし、Copilot cloud agentが\*\*\*\* セッションは、他のautomation セッションと同様に、リポジトリにアクセスできる他のユーザーにも表示されます。 これらのセッションを表示できるユーザーは誰でも、プロンプト、セッション ログ、および Copilot が作成するプル リクエストやその他の変更を表示できます。

セッションとそのログは他のユーザーに表示されるため、シークレットやその他の機密情報を automationのプロンプトに直接含めてはいけません。 機密性の高い値 Copilot アクセスできるようにするには、代わりにリポジトリ シークレットを使用します。 「[Copilotクラウドエージェントのシークレットと変数を設定する](/ja/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/configure-secrets-and-variables)」を参照してください。

## Billing

automation が実行されるたびに、Copilot cloud agent 分と GitHub Actions を消費する GitHub AI Credits セッションが開始されます。 この使用量は、 automationを作成したユーザーに課金されます。 詳細については、「[GitHub Copilot ライセンス](/ja/billing/concepts/product-billing/github-copilot-licenses)」を参照してください。

## セキュリティと安全性

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

* **帰属。** 開かれたプル要求と automation によってプッシュされたコードは、 automationを作成したユーザーに属性付けされます。 ユーザーが自身で作成するプル要求と同様に、ユーザーはこれらのプル要求を承認できないため、予想されるレビュー コントロールが保持されます。
* **最小権限ツール。**
  automationで使用できるツールを正確に選択して、タスクに必要なアクションのみに制限することができます。
* **信頼されていない入力。** 既定では、 automations リポジトリへの書き込みアクセス権を持たないユーザーによってトリガーされたイベントを無視して、信頼されていないユーザーからのプロンプト挿入のリスクを軽減します。
* **ワークフローの実行。** すべての Copilot cloud agent 作業と同様に、 GitHub Actions ワークフローは、書き込みアクセス権を持つユーザーがプル要求を承認するまで実行されません。 これにより、automation によって作成されたプルリクエストがワークフローを自動的にトリガーするリスクが軽減されます。

GitHub が Copilot cloud agent のリスクをどのように軽減するかの詳細については、[GitHub Copilot クラウド エージェントのリスクと軽減策](/ja/copilot/concepts/agents/cloud-agent/risks-and-mitigations) を参照してください。

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

* [Copilot クラウド エージェントを使用した自動化の作成](/ja/copilot/how-tos/use-copilot-agents/cloud-agent/create-automations)
* [クラウド エージェントGitHub Copilotについて](/ja/copilot/concepts/agents/cloud-agent/about-cloud-agent)
* 自動化をコードとして格納する方法、pull request を使用して確認する方法、別のコーディング エージェントで実行する方法については、[GitHub のエージェント型ワークフローについて](/ja/copilot/concepts/agents/about-github-agentic-workflows) を参照してください。