Introduction
With automations, you can set up agente en la nube de Copilot to run automatically, either on a schedule or in response to an event in a repository. Automations can take action within the repository where they are configured, such as opening a pull request or labeling an issue.
You can create and manage automations from the Agents tab of a repository on GitHub. You can also create and manage automations from the Automations tab in the aplicación Copilot de GitHub.
For an overview of automations, including triggers, tools, visibility, and security, see About Copilot automations.
Prerequisites
For automations to be available in a repository, all of the following must be true:
- The repository must be private or internal. Automations are not available in public repositories.
- agente en la nube de Copilot must be enabled for the repository. If you have Copilot Business or Copilot Enterprise, an administrator must enable the agente en la nube de Copilot policy. See Administración del acceso al agente de nube de GitHub Copilot.
- The organization must allow both agente en la nube de Copilot and automations in the repository (both are enabled by default). See Adición de GitHub Copilot agente en la nube a su organización.
Automations are available with the Copilot Pro de GitHub, GitHub Copilot Pro+, GitHub Copilot Max, GitHub Copilot para empresas, and GitHub Copilot para grandes empresas plans.
Creating an automation
-
En GitHub, navegue hasta la página principal del repositorio.
-
Under your repository name, click Agents.
-
In the sidebar, click Automations.
-
Click Create new.
-
Enter a name for the automation.
-
Select one or more triggers that determine when the automation runs:
- On a schedule: choose a recurring interval, either hourly, daily, or weekly.
- When an issue is created: the automation runs each time an issue is opened in the repository.
- When a pull request is opened: the automation runs each time a pull request is opened in the repository.
- When a pull request is synchronized: the automation runs each time new commits are pushed to a pull request in the repository.
You can optionally configure filters for issue and pull request triggers:
- For when an issue is created, add a search query filter.
- For when a pull request is opened and when a pull request is synchronized, add a search query filter and a filter for files changed in the pull request.
-
In the prompt field, describe the task you want Copilot to perform each time the automation runs.
For example,
Label this issue as a bug, an enhancement, or other, based on its content.Advertencia
The agente en la nube de Copilot sessions started by an automation are visible to others with access to the repository. Don't include secrets or other sensitive information in your prompt. To give Copilot access to sensitive values, use repository secrets. See Configurar secretos y variables para el agente de Copilot en la nube.
-
Optionally, select the model you want Copilot to use. See Cambio del modelo de IA para GitHub Copilot agente en la nube.
-
Select the tools Copilot can use when the automation runs, such as pushing changes, updating issue labels, or creating a pull request.
Select only the tools the task requires. The tools you select control what actions Copilot can take in your repository. Optionally, you can use the Suggest tools button to ask Copilot to suggest tools based on your prompt. See About Copilot automations.
-
Save the automation by clicking Create automation.
Testing an automation
You can run an automation immediately, without waiting for its trigger to fire, to check that it behaves as you expect.
- Open the automation you want to test from the Automations pane.
- Click the Run now button. Copilot starts a agente en la nube de Copilot session and runs the automation's prompt with the tools you selected. You can open the session to follow its progress and review any changes it makes.
Managing your Automations
Your automations are private to you, but the sessions started from your automations will be visible to everyone with read access to the repository.
From the Automations pane in a repository, you can:
- View your automations for the repository and the sessions they have started.
- Edit an automation to change its name, prompt, triggers, tools, or model.
- Disable an automation to stop it running, or enable it again later.
- Delete an automation you no longer need.
To see all of your automations across every repository, and navigate to manage each one, use the Automations view at the user level.