{"meta":{"title":"Kick off a task with Copilot agents on GitHub","intro":"Decide whether Copilot cloud agent creates a pull request immediately or works on a branch you review and iterate on first.","product":"GitHub Copilot","breadcrumbs":[{"href":"/en/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/en/enterprise-cloud@latest/copilot/how-tos","title":"How-tos"},{"href":"/en/enterprise-cloud@latest/copilot/how-tos/copilot-on-github","title":"Copilot on GitHub"},{"href":"/en/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/use-copilot-agents","title":"Use Copilot agents"},{"href":"/en/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/use-copilot-agents/kick-off-a-task","title":"Kick off a task"}],"documentType":"article"},"body":"# Kick off a task with Copilot agents on GitHub\n\nDecide whether Copilot cloud agent creates a pull request immediately or works on a branch you review and iterate on first.\n\nYou can start a Copilot cloud agent task in several ways. **Assigning an issue** always creates a pull request. **Starting with a prompt** works on a branch by default, giving you a chance to review, steer, and iterate before you open a pull request. **Seeding a repository** creates a draft pull request with scaffolded code.\n\n## Assign an issue to Copilot\n\nAssigning an issue always creates a pull request. Copilot works on the task and requests your review when it finishes.\n\n1. In the right sidebar of the issue, click **Assignees**.\n\n2. Click **Copilot** from the assignees list.\n\n3. Optionally, add context in the **Optional prompt** field—for example, coding patterns, files to modify, or testing requirements.\n\n4. Optionally, change the target repository or base branch using the dropdown menus.\n\n5. Optionally, you can click to open the agent dropdown menu, if you want to assign an agent or a custom agent with specialized behavior and tools. You can select an existing custom agent from your repository, organization, or enterprise. You can also click ** Create an agent** to create a new agent profile in your selected repository and branch. For more information, see [Creating custom agents for Copilot cloud agent](/en/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents).\n > \\[!NOTE] Third-party coding agents are available for all paid [Copilot plans](/en/enterprise-cloud@latest/copilot/get-started/plans).\n\n6. Optionally, you can use the dropdown menu to select the model that Copilot will use. If the selected model supports configurable reasoning, you can also use the dropdown menu to select the reasoning level. For more information, see [Changing the AI model for GitHub Copilot cloud agent](/en/enterprise-cloud@latest/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model).\n\nCopilot receives the issue title, description, and existing comments at assignment time. It does not see comments added after assignment, so post follow-up information on the pull request instead.\n\n## Start a task with a prompt\n\nCloud agent works on a branch by default. You can review the diff, iterate with follow-up prompts, and create a pull request when you're ready.\n\n1. Open the agents panel or tab:\n\n * Open the ** Agents** tab in a repository.\n * **Navigate to the agents page**: Go to [github.com/copilot/agents](https://github.com/copilot/agents?ref_product=copilot\\&ref_type=engagement\\&ref_style=text). You can also get here by opening the agents panel, then clicking **View all**.\n * **Open the agents panel**: Click in the navigation bar at the top right of GitHub.\n\n2. Using the dropdown menu in the prompt field, select the repository you want Copilot to work in.\n\n3. Type a prompt describing your request. You can also add visual inputs like screenshots or UI mockups by pasting, dragging, or uploading an image. Files supported: image/png, image/jpeg, image/gif, image/webp.\n\n For example, `Implement a user friendly message for common errors.`\n\n If you want Copilot to open a pull request, you can ask in your prompt, for example `Open a pull request to implement a user friendly message for common errors.`\n\n4. Optionally, select a base branch for Copilot's changes. Copilot will create a new branch based on this branch.\n\n5. Optionally, you can click to open the agent dropdown menu, if you want to assign an agent or a custom agent with specialized behavior and tools. You can select an existing custom agent from your repository, organization, or enterprise. You can also click ** Create an agent** to create a new agent profile in your selected repository and branch. For more information, see [Creating custom agents for Copilot cloud agent](/en/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents).\n > \\[!NOTE] Third-party coding agents are available for all paid [Copilot plans](/en/enterprise-cloud@latest/copilot/get-started/plans).\n\n6. Optionally, you can use the dropdown menu to select the model that Copilot will use. If the selected model supports configurable reasoning, you can also use the dropdown menu to select the reasoning level. For more information, see [Changing the AI model for GitHub Copilot cloud agent](/en/enterprise-cloud@latest/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model).\n\n7. Click **** or press Enter.\n\n Copilot will start a new session, which will appear in the list below the prompt box. Copilot will work on the task and push any code changes.\n\n You can track Copilot's work and open a pull request in one click from the session logs. For more information, see [Managing agent sessions](/en/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents).\n\nThe same prompt box is available on your [dashboard](https://github.com) and in Copilot Chat (type `/task`).\n\nFor the full workflow of researching, planning, and iterating before creating a pull request, see [Research, plan, and iterate on code changes with Copilot cloud agent](/en/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/use-copilot-agents/research-plan-iterate).\n\n## Seed a new repository\n\nWhen you create a new repository, you can have Copilot generate starter code.\n\n1. In the upper-right corner of any page, select , then click **New repository**.\n\n \n2. In the **Prompt** field, describe what you want Copilot to build — for example, `Create a Rust CLI for converting CSV spreadsheets to Markdown`.\n3. Click **Create repository**.\n\nCopilot opens a draft pull request with the scaffolded code.\n\n## Further reading\n\n* [Best practices for using GitHub Copilot to work on tasks](/en/enterprise-cloud@latest/copilot/tutorials/cloud-agent/get-the-best-results)\n* [Managing agent sessions](/en/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents)"}