# Copilot クラウド エージェントを使用した自動化の作成

スケジュールに従って、またはイベントに応答してautomationsを実行するCopilot クラウドエージェントを作成および管理します。

## イントロダクション

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

automationsは、\*\*\*\* のリポジトリの \[GitHub] タブから作成および管理できます。
automationsの \[**Automations**] タブからGitHub Copilot アプリを作成および管理することもできます。

トリガー、ツール、可視性、セキュリティなど、 automationsの概要については、 [Copilot自動化について](/ja/copilot/concepts/agents/cloud-agent/about-automations) を参照してください。

## Prerequisites

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

* リポジトリは **プライベートまたは内部**である必要があります。
  Automations はパブリック リポジトリでは使用できません。
* Copilot クラウドエージェント リポジトリに対して有効にする必要があります。
  Copilot 事業またはCopilot Enterpriseがある場合、管理者はCopilot クラウドエージェント ポリシーを有効にする必要があります。 「[GitHub Copilot クラウド エージェントへのアクセスの管理](/ja/copilot/concepts/agents/cloud-agent/access-management)」を参照してください。
* 組織は、リポジトリ内の Copilot クラウドエージェント と 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 ビジネス、および GitHub Copilot Enterprise プランで使用できます。

## オートメーション を作成する

1. GitHub で、リポジトリのメイン ページに移動します。

2. リポジトリ名の下にある\*\*<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-agent" aria-label="agent" role="img"><path d="M14.5 8.9v-.052A2.956 2.956 0 0 0 11.542 5.9a.815.815 0 0 1-.751-.501l-.145-.348A3.496 3.496 0 0 0 7.421 2.9h-.206a3.754 3.754 0 0 0-3.736 4.118l.011.121a.822.822 0 0 1-.619.879A1.81 1.81 0 0 0 1.5 9.773v.14c0 1.097.89 1.987 1.987 1.987H4.5a.75.75 0 0 1 0 1.5H3.487A3.487 3.487 0 0 1 0 9.913v-.14C0 8.449.785 7.274 1.963 6.75A5.253 5.253 0 0 1 7.215 1.4h.206a4.992 4.992 0 0 1 4.586 3.024A4.455 4.455 0 0 1 16 8.848V8.9a.75.75 0 0 1-1.5 0Z"></path><path d="m8.38 7.67 2.25 2.25a.749.749 0 0 1 0 1.061L8.38 13.23a.749.749 0 1 1-1.06-1.06l1.719-1.72L7.32 8.731A.75.75 0 0 1 8.38 7.67ZM15 13.45h-3a.75.75 0 0 1 0-1.5h3a.75.75 0 0 1 0 1.5Z"></path></svg> エージェント\*\*をクリックします。

3. サイドバーで、\[ **Automations**] をクリックします。

4. \[ **新規作成**] をクリックします。

5. \*\*
   \*\*のオートメーションを入力します。

6. \*\*
   \*\*が実行されるタイミングオートメーションを 1 つ以上選択します。

   * **スケジュールに従って**: 毎時、毎日、または毎週の繰り返し間隔を選択します。
   * **問題が作成されると**、リポジトリで問題が開かれるたびに オートメーション が実行されます。
   * **pull request が開かれる**とき: オートメーション は、リポジトリでプル要求が開かれるたびに実行されます。
   * **pull request の同期時**: オートメーション は、リポジトリ内のプル要求に新しいコミットがプッシュされるたびに実行されます。

   必要に応じて、問題トリガーと pull request トリガーのフィルターを構成できます。

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

7. **プロンプト** フィールドで、オートメーションが実行されるたびにCopilotに実行させるタスクを記述します。

   たとえば、`Label this issue as a bug, an enhancement, or other, based on its content.` のように指定します。

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

8. 必要に応じて、使用する**モデル**Copilot選択します。 「[GitHub Copilot クラウド エージェントの AI モデルの変更](/ja/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model)」を参照してください。

9. **ツール**Copilotの実行時に使用できるツールを選択します。たとえば、変更のプッシュ、Issue ラベルの更新、プル リクエストの作成などです。

   タスクに必要なツールのみを選択します。 選択したツールは、リポジトリで実行できる Copilot アクションを制御します。 必要に応じて、\[ツールの **提案** ] ボタンを使用して、プロンプトに基づいてツールを提案するように Copilot に依頼できます。 「[Copilot自動化について](/ja/copilot/concepts/agents/cloud-agent/about-automations#tools-and-actions)」を参照してください。

10. \[オートメーション] をクリックして\*\*\*\* を保存します。

## オートメーション をテストする

トリガーが起動するのを待たずに、すぐに オートメーション を実行して、期待どおりに動作することを確認できます。

1. \*\*
   Automations
   \*\*ペインから、テストするオートメーションを開きます。
2. \[ **今すぐ実行** ] ボタンをクリックします。

Copilot は、 Copilot クラウドエージェント セッションを開始し、選択したツールを使用して オートメーションのプロンプトを実行します。 セッションを開いて進行状況に従い、行った変更を確認できます。

## Automations の管理

automationsはプライベートですが、自動化から開始されたセッションは、リポジトリへの読み取りアクセス権を持つすべてのユーザーに表示されます。

リポジトリの **Automations** ペインから、次のことができます。

* リポジトリの automations と、それらが開始したセッションを表示します。
* オートメーションを編集して、名前、プロンプト、トリガー、ツール、またはモデルを変更します。
* オートメーションを無効にして実行を停止するか、後で再度有効にします。
* 不要になった オートメーション を削除します。

すべてのリポジトリのすべての automations を表示し、各リポジトリを管理するために移動するには、ユーザー レベルで Automations ビューを使用します。

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

* [Copilot自動化について](/ja/copilot/concepts/agents/cloud-agent/about-automations)
* [GitHub Copilot セッションの開始](/ja/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions)
* [GitHub Copilot クラウド エージェントのリスクと軽減策](/ja/copilot/concepts/agents/cloud-agent/risks-and-mitigations)