{"meta":{"title":"Creating automations with Copilot cloud agent","intro":"Create and manage automations to run Copilot cloud agent on a schedule or in response to events.","product":"GitHub Copilot","breadcrumbs":[{"href":"/en/copilot","title":"GitHub Copilot"},{"href":"/en/copilot/how-tos","title":"How-tos"},{"href":"/en/copilot/how-tos/use-copilot-agents","title":"Use Copilot agents"},{"href":"/en/copilot/how-tos/use-copilot-agents/cloud-agent","title":"Cloud agent"},{"href":"/en/copilot/how-tos/use-copilot-agents/cloud-agent/create-automations","title":"Create cloud automations"}],"documentType":"article"},"body":"# Creating automations with Copilot cloud agent\n\nCreate and manage automations to run Copilot cloud agent on a schedule or in response to events.\n\n## Introduction\n\nWith automations, you can set up Copilot cloud agent 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.\n\nYou 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 GitHub Copilot app.\n\nFor an overview of automations, including triggers, tools, visibility, and security, see [About Copilot automations](/en/copilot/concepts/agents/cloud-agent/about-automations).\n\n## Prerequisites\n\nFor automations to be available in a repository, all of the following must be true:\n\n* The repository must be **private or internal**. Automations are not available in public repositories.\n* Copilot cloud agent must be enabled for the repository. If you have Copilot Business or Copilot Enterprise, an administrator must enable the Copilot cloud agent policy. See [Managing access to GitHub Copilot cloud agent](/en/copilot/concepts/agents/cloud-agent/access-management).\n* The organization must allow both Copilot cloud agent and automations in the repository (both are enabled by default). See [Adding GitHub Copilot cloud agent to your organization](/en/copilot/how-tos/administer-copilot/manage-for-organization/add-copilot-cloud-agent).\n\nAutomations are available with the GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Max, GitHub Copilot Business, and GitHub Copilot Enterprise plans.\n\n## Creating an automation\n\n1. On GitHub, navigate to the main page of the repository.\n\n2. Under your repository name, click ** Agents**.\n\n3. In the sidebar, click **Automations**.\n\n4. Click **Create new**.\n\n5. Enter a **name** for the automation.\n\n6. Select one or more **triggers** that determine when the automation runs:\n\n * **On a schedule**: choose a recurring interval, either hourly, daily, or weekly.\n * **When an issue is created**: the automation runs each time an issue is opened in the repository.\n * **When a pull request is opened**: the automation runs each time a pull request is opened in the repository.\n * **When a pull request is synchronized**: the automation runs each time new commits are pushed to a pull request in the repository.\n\n You can optionally configure filters for issue and pull request triggers:\n\n * For when **an issue is created**, add a search query filter.\n * 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.\n\n7. In the **prompt** field, describe the task you want Copilot to perform each time the automation runs.\n\n For example, `Label this issue as a bug, an enhancement, or other, based on its content.`\n\n > \\[!WARNING]\n > The Copilot cloud agent 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 [Configure secrets and variables for Copilot cloud agent](/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/configure-secrets-and-variables).\n\n8. Optionally, select the **model** you want Copilot to use. See [Changing the AI model for GitHub Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model).\n\n9. Select the **tools** Copilot can use when the automation runs, such as pushing changes, updating issue labels, or creating a pull request.\n\n 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](/en/copilot/concepts/agents/cloud-agent/about-automations#tools-and-actions).\n\n10. Save the automation by clicking **Create automation**.\n\n## Testing an automation\n\nYou can run an automation immediately, without waiting for its trigger to fire, to check that it behaves as you expect.\n\n1. Open the automation you want to test from the **Automations** pane.\n2. Click the **Run now** button.\n Copilot starts a Copilot cloud agent 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.\n\n## Managing your Automations\n\nYour automations are private to you, but the sessions started from your automations will be visible to everyone with read access to the repository.\n\nFrom the **Automations** pane in a repository, you can:\n\n* View your automations for the repository and the sessions they have started.\n* Edit an automation to change its name, prompt, triggers, tools, or model.\n* Disable an automation to stop it running, or enable it again later.\n* Delete an automation you no longer need.\n\nTo see all of your automations across every repository, and navigate to manage each one, use the Automations view at the user level.\n\n## Further reading\n\n* [About Copilot automations](/en/copilot/concepts/agents/cloud-agent/about-automations)\n* [Starting GitHub Copilot sessions](/en/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions)\n* [Risks and mitigations for GitHub Copilot cloud agent](/en/copilot/concepts/agents/cloud-agent/risks-and-mitigations)"}