Skip to main content

Starting GitHub Copilot sessions

You can start Copilot-Cloud-Agent from many places, including the agents tab or panel on GitHub, GitHub Issues, Copilot-Chat, and IDEs like Visual Studio Code.

Wer kann dieses Feature verwenden?

Copilot-Cloud-Agent ist mit den GitHub-Copilot Pro, GitHub-Copilot Pro+, GitHub Copilot Business und GitHub Copilot Enterprise Plänen verfügbar. Der Agent ist in allen Repositorys verfügbar, die auf GitHub gespeichert sind, mit Ausnahme von Repositorys, die im Besitz von verwaltete Benutzerkonten sind und wo er explizit deaktiviert wurde.
Sign up for Copilot

Hinweis

For an overview of Copilot-Cloud-Agent, see Informationen zu GitHub Copilot Cloud-Agent.

Introduction

You can start Copilot-Cloud-Agent from:

Copilot will start working on the task in the background. Some entry points open a pull request automatically. In other cases, you can prompt Copilot to open a pull request, or create a pull request when Copilot finishes work, from the session logs.

For more information, see Informationen zu GitHub Copilot Cloud-Agent.

Assigning an issue to Copilot

You can ask Copilot to start working on an issue by assigning the issue to Copilot.

Copilot will start working on the task, raise a pull request, then request a review from you when it's finished working

You can assign an issue to Copilot:

Assigning an issue to Copilot on GitHub.com

Hinweis

This feature is in öffentliche Vorschau and subject to change.

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke unter dem Repositorynamen auf Issues.

    Screenshot der Hauptseite eines Repositorys. In der horizontalen Navigationsleiste ist eine Registerkarte mit der Bezeichnung „Issues“ dunkelorange umrandet.

  3. Open the issue that you want to assign to Copilot.

  4. In the right side menu, click Assignees.

    Screenshot of the right sidebar of an issue. A header, labeled "Assignees", is outlined in dark orange.

  5. Click Copilot from assignees list.

    Screenshot of "Assignees" window on an issue. Copilot is available in the list.

    Additional options are displayed.

    Screenshot of "Assign to Copilot" dialog showing options for target repository, starting branch, Benutzerdefinierter Agent, and additional instructions.

  6. In the Optional prompt field you can add specific guidance for Copilot. Add any context, constraints, or specific requirements that will help Copilot to understand and complete the task.

    For example, you might include instructions about specific coding patterns or frameworks to use, testing requirements, code style preferences, files or directories that should or shouldn't be modified.

    In addition to the details you supply here, Copilot will use any custom instructions that have been configured for the target repository. See Hinzufügen von benutzerdefinierten Repositoryanweisungen für GitHub Copilot.

  7. You can use the dropdown menus in the dialog to change the repository that Copilot will work in and the branch that it will branch off from.

    All repositories where you have at least read access will be displayed in the repository dropdown menu. However, you can only select a repository if you have write access to it, and if Copilot-Cloud-Agent is enabled for that repository.

    If you select a repository in a different organization than the issue's source organization, or if you select a public repository when the issue is in a private repository, a warning will be displayed.

    If you don't specify a repository, Copilot will work in the same repository as the issue. If you don't specify a branch, Copilot will work from the default branch of the selected repository.

    Tipp

    When you assign an issue to Copilot, it gets sent the issue title, description, any comments that currently exist, and any additional instructions you provide. After assigning the issue, Copilot will not be aware of, and therefore won't react to, any further comments that are added to the issue. If you have more information, or changes to the original requirement, add this as a comment in the pull request that Copilot raises.

  8. Optionalerweise können Sie auf klicken, um das Dropdownmenü des Agenten zu öffnen, wenn Sie einen Agenten oder ein Benutzerdefinierter Agent mit spezialisiertem Verhalten und Werkzeugen zuweisen möchten. Sie können ein vorhandenes Benutzerdefinierter Agent Aus ihrem Repository, Ihrer Organisation oder Ihrem Unternehmen auswählen. Sie können auch auf Agent erstellen klicken, um ein neues Agentprofil in Ihrem ausgewählten Repository und Branch zu erstellen. Weitere Informationen finden Sie unter Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent.

    Hinweis

    Codierungs-Agents von Drittanbietern sind in den GitHub-Copilot Pro+- und Copilot Enterprise-Plänen verfügbar.

  9. Optional können Sie das Dropdownmenü verwenden, um das zu verwendende Modell Copilot auszuwählen. Weitere Informationen findest du unter Ändern des KI-Modells für GitHub Copilot Cloud-Agent.

You can also assign issues to Copilot from other places on GitHub.com:

  • From the list of issues on a repository's Issues page.
  • When viewing an issue in GitHub Projekte.

Assigning an issue to Copilot on GitHub Mobile

  1. In GitHub Mobile, navigate to the repository that contains the issue you want to assign to Copilot.
  2. Click Issues.
  3. Open the issue that you want to assign to Copilot.
  4. Tap the icon.
  5. Beside "Assignees", tap Edit.
  6. Beside "Copilot", click the plus sign.
  7. Click Done.

Assigning an issue to Copilot via the GitHub API

Hinweis

This feature is in öffentliche Vorschau and subject to change.

You can assign issues to Copilot using either the GraphQL API or the REST API. Both APIs support an optional Agent Assignment input to customize the task:

GraphQL parameterREST parameterDescription
targetRepositoryIdtarget_repoThe repository where Copilot will work
baseRefbase_branchThe branch that Copilot will branch from
customInstructionscustom_instructionsAdditional instructions for Copilot
customAgentcustom_agentA Benutzerdefinierter Agent to use for the task
modelmodelThe model for Copilot to use

Using the GraphQL API

Hinweis

You must include the GraphQL-Features header with the values issues_copilot_assignment_api_support and coding_agent_model_selection.

You can use the following GraphQL mutations to assign issues to Copilot:

Creating and assigning a new issue
  1. Make sure you're authenticating with the API using a user token, for example a personal access token or a GitHub App user-to-server token.

    Hinweis

    If using a fine-grained personal access token, it needs the following permissions to assign Copilot to an issue:

    • Read access to metadata
    • Read and write access to actions, contents, issues and pull requests

    If using a personal access token (classic), it needs the repo scope to assign Copilot to an issue.

  2. Verify that Copilot-Cloud-Agent is enabled in the repository by checking if the repository's suggestedActors in the GraphQL API includes Copilot. Replace octo-org with the repository owner, and octo-repo with the repository name.

    GraphQL
    query {
      repository(owner: "octo-org", name: "octo-repo") {
        suggestedActors(capabilities: [CAN_BE_ASSIGNED], first: 100) {
          nodes {
            login
            __typename
    
            ... on Bot {
              id
            }
    
            ... on User {
              id
            }
          }
        }
      }
    }
    

    If Copilot-Cloud-Agent is enabled for the user and in the repository, the first node returned from the query will have the login value copilot-swe-agent.

  3. Make a note of the id value of this login.

  4. Fetch the GraphQL global ID of the repository you want to create the issue in, replacing octo-org with the repository owner, and octo-repo with the repository name.

    GraphQL
    query {
      repository(owner: "octo-org", name: "octo-repo") {
        id
      }
    }
    
  5. Create the issue with the createIssue mutation. Replace REPOSITORY_ID with the ID returned from the previous step, and BOT_ID with the ID returned from the step before that. You can optionally include the agentAssignment input to customize the task.

    Shell
    gh api graphql -f query='mutation {
      createIssue(input: {
        repositoryId: "REPOSITORY_ID",
        title: "Implement comprehensive unit tests",
        body: "DETAILS",
        assigneeIds: ["BOT_ID"],
        agentAssignment: {
          targetRepositoryId: "REPOSITORY_ID",
          baseRef: "main",
          customInstructions: "Add comprehensive test coverage",
          customAgent: "",
          model: ""
        }
      }) {
        issue {
          id
          title
          assignees(first: 10) {
            nodes {
              login
            }
          }
        }
      }
    }' -H 'GraphQL-Features: issues_copilot_assignment_api_support,coding_agent_model_selection'
    
Assigning an existing issue
  1. Make sure you're authenticating with the API using a user token, for example a personal access token or a GitHub App user-to-server token.

  2. Verify that Copilot-Cloud-Agent is enabled in the repository by checking if the repository's suggestedActors in the GraphQL API includes Copilot. Replace octo-org with the repository owner, and octo-repo with the repository name.

    GraphQL
    query {
      repository(owner: "monalisa", name: "octocat") {
        suggestedActors(capabilities: [CAN_BE_ASSIGNED], first: 100) {
          nodes {
            login
            __typename
    
            ... on Bot {
              id
            }
    
            ... on User {
              id
            }
          }
        }
      }
    }
    

    If Copilot-Cloud-Agent is enabled for the user and in the repository, the first node returned from the query will have the login value copilot-swe-agent.

  3. Fetch the GraphQL global ID of the issue you want to assign to Copilot, replacing monalisa with the repository owner, octocat with the name and 9000 with the issue number.

    GraphQL
    query {
      repository(owner: "monalisa", name: "octocat") {
        issue(number: 9000) {
          id
          title
        }
      }
    }
    
  4. Assign the existing issue to Copilot using the replaceActorsForAssignable mutation. Replace ISSUE_ID with the ID returned from the previous step, BOT_ID with the ID returned from the step before that, and REPOSITORY_ID with the repository ID. You can optionally include the agentAssignment input to customize the task.

    Shell
    gh api graphql -f query='mutation {
      replaceActorsForAssignable(input: {
        assignableId: "ISSUE_ID",
        actorIds: ["BOT_ID"],
        agentAssignment: {
          targetRepositoryId: "REPOSITORY_ID",
          baseRef: "main",
          customInstructions: "Fix the reported bug",
          customAgent: "",
          model: ""
        }
      }) {
        assignable {
          ... on Issue {
            id
            title
            assignees(first: 10) {
              nodes {
                login
              }
            }
          }
        }
      }
    }' -H 'GraphQL-Features: issues_copilot_assignment_api_support,coding_agent_model_selection'
    
  5. Alternatively, you can use the updateIssue mutation to update an existing issue and assign it to Copilot. Replace ISSUE_ID with the issue ID and BOT_ID with the bot ID.

    Shell
    gh api graphql -f query='mutation {
      updateIssue(input: {
        id: "ISSUE_ID",
        assigneeIds: ["BOT_ID"],
        agentAssignment: {
          targetRepositoryId: "REPOSITORY_ID",
          baseRef: "main",
          customInstructions: "Update feature implementation",
          customAgent: "",
          model: ""
        }
      }) {
        issue {
          id
          title
          assignees(first: 10) {
            nodes {
              login
            }
          }
        }
      }
    }' -H 'GraphQL-Features: issues_copilot_assignment_api_support,coding_agent_model_selection'
    
  6. You can also use the addAssigneesToAssignable mutation to add Copilot to an existing issue while keeping other assignees. Replace ISSUE_ID with the issue ID and BOT_ID with the bot ID.

    Shell
    gh api graphql -f query='mutation {
      addAssigneesToAssignable(input: {
        assignableId: "ISSUE_ID",
        assigneeIds: ["BOT_ID"],
        agentAssignment: {
          targetRepositoryId: "REPOSITORY_ID",
          baseRef: "main",
          customInstructions: "Collaborate on this task",
          customAgent: "",
          model: ""
        }
      }) {
        assignable {
          ... on Issue {
            id
            title
            assignees(first: 10) {
              nodes {
                login
              }
            }
          }
        }
      }
    }' -H 'GraphQL-Features: issues_copilot_assignment_api_support,coding_agent_model_selection'
    

Using the REST API

You can use the following REST API endpoints to assign issues to Copilot:

Adding assignees to an existing issue
Shell
gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /repos/OWNER/REPO/issues/ISSUE_NUMBER/assignees \
  --input - <<< '{
  "assignees": ["copilot-swe-agent[bot]"],
  "agent_assignment": {
    "target_repo": "OWNER/REPO",
    "base_branch": "main",
    "custom_instructions": "",
    "custom_agent": "",
    "model": ""
  }
}'
Creating a new issue
Shell
gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /repos/OWNER/REPO/issues \
  --input - <<< '{
  "title": "Issue title",
  "body": "Issue description.",
  "assignees": ["copilot-swe-agent[bot]"],
  "agent_assignment": {
    "target_repo": "OWNER/REPO",
    "base_branch": "main",
    "custom_instructions": "",
    "custom_agent": "",
    "model": ""
  }
}'
Updating an existing issue
Shell
gh api \
  --method PATCH \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /repos/OWNER/REPO/issues/ISSUE_NUMBER \
  --input - <<< '{
  "assignees": ["copilot-swe-agent[bot]"],
  "agent_assignment": {
    "target_repo": "OWNER/REPO",
    "base_branch": "main",
    "custom_instructions": "",
    "custom_agent": "",
    "model": ""
  }
}'

Assigning an issue to Copilot from Raycast

Raycast ist ein erweiterbares Startprogramm für Windows und macOS. Mit der GitHub Copilot Erweiterung für Raycast können Sie Aufgaben starten und nachverfolgen Copilot-Cloud-Agent und Sitzungsprotokolle live ansehen, wo immer Sie sich auf Ihrem Computer befinden.

  1. Installiere Raycast von der Raycast-Website.

  2. Installieren Sie die GitHub Copilot Erweiterung für Raycast, indem Sie auf der Seite der Erweiterung auf die Schaltfläche "Erweiterung installieren" klicken.

  3. Open Raycast, search for "Copilot," find the Assign Issues to Copilot command, then press Enter.

  4. Click Sign in with GitHub, then complete the authentication flow. Raycast will re-open.

  5. Select the repository you want Copilot to work in.

  6. Select the issue you want to assign to Copilot.

  7. Optionally, select a base branch for Copilot's pull request. Copilot will create a new branch based on this branch, then push the changes to a pull request targeting that branch.

  8. Wählen Sie optional ein Benutzerdefinierter Agent mit speziellem Verhalten und speziellen Tools aus dem Dropdownmenü. Weitere Informationen finden Sie unter Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent.

  9. Optional können Sie das Dropdownmenü verwenden, um das zu verwendende Modell Copilot auszuwählen. Weitere Informationen findest du unter Ändern des KI-Modells für GitHub Copilot Cloud-Agent.

  10. Optionally, provide additional instructions. These will be passed to Copilot alongside your issue contents.

  11. Press Command+Enter (macOS) or Ctrl+Enter (Windows) to assign the issue.

    Copilot will start a new session. Copilot will work on the task and push changes to its pull request, then add you as a reviewer when it has finished, triggering a notification.

Hinweis

Wenn Sie beim Starten einer Aufgabe kein bestimmtes Repository auswählen können, hat die Organisation, die das Repository besitzt, möglicherweise Zugriffsbeschränkungen aktiviert OAuth app . Informationen zum Anfordern der Genehmigung für „GitHub Copilot für Raycast” OAuth app finden Sie unter Von einer Organisation die Genehmigung für OAuth-Apps anfordern.

Asking Copilot to start work from the agents tab or panel

You can ask start sessions from the agents tab and the agents panel. The only difference is the entry point - once you see the "New agent task" form, the steps are the same.

  1. Öffnen des Agenten-Panels oder der Registerkarte:

    • Öffnen Sie die Registerkarte Agents in einem Repository.
    •           **Navigieren zur Seite „Agents“**: Wechsle zu [github.com/copilot/agents](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text). Alternativ kannst du zu dieser Seite navigieren, indem du das Panel „Agents“ öffnest und dann auf **View all** klickst.
      
    •           **Öffnen des Panels „Agents“**: Klicke auf der Navigationsleiste oben rechts auf GitHub auf <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-agent" aria-label="The Agents icon" 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>.
      
  2. Wählen Sie im Eingabeaufforderungsfeld mithilfe des Dropdownmenüs das Repository aus, in dem Copilot arbeiten soll.

  3. Gib einen Prompt ein, der deine Anfrage beschreibt. Sie können auch visuelle Eingaben wie Screenshots oder UI-Modelle hinzufügen, indem Sie ein Bild einfügen, ziehen oder hochladen. Unterstützte Dateien: image/png, image/jpeg, image/gif, image/webp.

    Beispiel: Create a pull request to implement a user friendly message for common errors.

  4. Wählen Sie optional einen Basiszweig für den Pull-Request von Copilot aus. Copilot erstellt eine neue Verzweigung basierend auf dieser Verzweigung und verschiebt dann die Änderungen an eine Pullanforderung für diese Verzweigung.

  5. Optionalerweise können Sie auf klicken, um das Dropdownmenü des Agenten zu öffnen, wenn Sie einen Agenten oder ein Benutzerdefinierter Agent mit spezialisiertem Verhalten und Werkzeugen zuweisen möchten. Sie können ein vorhandenes Benutzerdefinierter Agent Aus ihrem Repository, Ihrer Organisation oder Ihrem Unternehmen auswählen. Sie können auch auf Agent erstellen klicken, um ein neues Agentprofil in Ihrem ausgewählten Repository und Branch zu erstellen. Weitere Informationen finden Sie unter Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent.

    Hinweis

    Codierungs-Agents von Drittanbietern sind in den GitHub-Copilot Pro+- und Copilot Enterprise-Plänen verfügbar.

  6. Optional können Sie das Dropdownmenü verwenden, um das zu verwendende Modell Copilot auszuwählen. Weitere Informationen findest du unter Ändern des KI-Modells für GitHub Copilot Cloud-Agent.

  7. Klicken Sie auf oder drücken Sie die EINGABETASTE.

           Copilot startet eine neue Sitzung, die in der Liste unterhalb des Eingabeaufforderungsfelds angezeigt wird. 
           Copilot arbeitet an der Aufgabe und pusht Änderungen an der Pull-Anforderung und fügt Sie dann als Prüfer hinzu, wenn sie abgeschlossen ist, wodurch eine Benachrichtigung ausgelöst wird.
    

Asking Copilot to start work from the dashboard

You can ask Copilot to open a pull request from the Copilot prompt box in the dashboard. The dashboard is your personalized overview of your activity on GitHub, seen when you visit https://github.com while logged in.

  1. Navigate to the dashboard at https://github.com.

  2. Click the Task button.

  3. Using the dropdown menu in the prompt field, select the repository you want Copilot to work in.

  4. Type a prompt describing your request.

    For example, Implement a user friendly message for common errors.

    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.

  5. Optionally, select a base branch for Copilot's pull request. Copilot will create a new branch based on this branch.

  6. Optionalerweise können Sie auf klicken, um das Dropdownmenü des Agenten zu öffnen, wenn Sie einen Agenten oder ein Benutzerdefinierter Agent mit spezialisiertem Verhalten und Werkzeugen zuweisen möchten. Sie können ein vorhandenes Benutzerdefinierter Agent Aus ihrem Repository, Ihrer Organisation oder Ihrem Unternehmen auswählen. Sie können auch auf Agent erstellen klicken, um ein neues Agentprofil in Ihrem ausgewählten Repository und Branch zu erstellen. Weitere Informationen finden Sie unter Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent.

    Hinweis

    Codierungs-Agents von Drittanbietern sind in den GitHub-Copilot Pro+- und Copilot Enterprise-Plänen verfügbar.

  7. Click Send now or press Return.

    You will be taken to the agents tab, and Copilot will start a new session, which will appear in the "Recent sessions" list below the prompt box. Copilot will work on the task and push any code changes.

    Hinweis

    If you have enabled the New Dashboard Experience in feature preview, the new session will appear in "Agent sessions" under the prompt box in your dashboard. For more information, see Persönliches Dashboard.

Asking Copilot to create a pull request from Copilot-Chat in Visual Studio Code

  1. Install the GitHub Pull Requests extension for Visual Studio Code.

  2. Open GitHub Copilot Gespräch in Visual Studio Code.

  3. Type a prompt explaining what you want Copilot to do.

    For example, Put backticks around file names and variables in output

    Tipp

    To help Copilot, you can select the relevant line(s) of code before submitting your prompt.

  4. Submit your prompt by clicking the Delegate this task to the GitHub Copilot cloud agent button, next to the Send button

  5. If you have local changes, a dialog will be displayed asking if you want to push those changes so Copilot can start from your current state. Click Include changes to push your changes, or Ignore changes to ask Copilot to start its work from your repository's default branch.

    Copilot will start a new session and respond with a link to the pull request it creates. It will work on the task and push changes to the pull request, and then add you as a reviewer when it has finished, triggering a notification.

Asking Copilot to create a pull request from Copilot-Chat in JetBrains IDEs

Hinweis

Copilot-Cloud-Agent in JetBrains IDEs is in öffentliche Vorschau, and subject to change.

  1. Open GitHub Copilot Gespräch in your JetBrains IDE.

  2. Type a prompt explaining what you want Copilot to do

    For example, Put backticks around file names and variables in output

  3. Click the Delegate to Cloud Agent button next to the Send button.

    Copilot will start a new session and respond with a link to the pull request it creates. It will work on the task and push changes to the pull request, and then add you as a reviewer when it has finished, triggering a notification from GitHub and in the IDE.

Asking Copilot to create a pull request from Copilot-Chat in Eclipse

Hinweis

Copilot-Cloud-Agent in Eclipse is in öffentliche Vorschau, and subject to change.

  1. Open GitHub Copilot Gespräch in Eclipse.

  2. Type a prompt explaining what you want Copilot to do.

    For example, Put backticks around file names and variables in output

  3. Click next to the Send button.

  4. In the dialog box that opens, select the repository you want Copilot to work in, then click Continue.

    Copilot will start a new session and respond with a link to the pull request it creates. It will work on the task and push changes to the pull request, and then add you as a reviewer when it has finished, triggering a notification from GitHub and in the IDE.

Asking Copilot to create a pull request from Copilot-Chat in Visual Studio 2026

Hinweis

To use Copilot-Cloud-Agent in Visual Studio, you'll need to be running at least December Update 18.1.0 of Visual Studio 2026.

  1. Enable Copilot-Cloud-Agent support in Visual Studio.

    1. Open the Tools menu, then click Options.
    2. In the sidebar, select GitHub.
    3. Check the Enable Copilot Cloud agent (preview) box.
    4. Restart Visual Studio.
  2. Open GitHub Copilot Gespräch in Visual Studio.

  3. Enter a prompt, giving details of what you want Copilot to change.

    For example, Put backticks around file names and variables in log output.

  4. Submit your prompt by clicking the Delegate this task to the GitHub Copilot cloud agent button, next to the Send button.

    Copilot asks you to confirm that you want to use the cloud agent to create a pull request.

  5. Click Confirm.

    Copilot will start a new session and respond with a link to the pull request it creates. It will work on the task and push changes to the pull request, and then add you as a reviewer when it has finished, triggering a notification.

Asking Copilot to create a pull request from Copilot-Chat in GitHub.com

  1. Open GitHub Copilot Gespräch on GitHub.com.

  2. Type /task to ask Copilot to create a pull request, and give details of what you want Copilot to change.

    For example, /task Create a pull request to put backticks around file names and variables in output.

  3. Optionally, select a base branch for Copilot's pull request. Copilot will create a new branch based on this branch, then push the changes to a pull request targeting that branch.

  4. Optionalerweise können Sie auf klicken, um das Dropdownmenü des Agenten zu öffnen, wenn Sie einen Agenten oder ein Benutzerdefinierter Agent mit spezialisiertem Verhalten und Werkzeugen zuweisen möchten. Sie können ein vorhandenes Benutzerdefinierter Agent Aus ihrem Repository, Ihrer Organisation oder Ihrem Unternehmen auswählen. Sie können auch auf Agent erstellen klicken, um ein neues Agentprofil in Ihrem ausgewählten Repository und Branch zu erstellen. Weitere Informationen finden Sie unter Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent.

    Hinweis

    Codierungs-Agents von Drittanbietern sind in den GitHub-Copilot Pro+- und Copilot Enterprise-Plänen verfügbar.

  5. Click or press Enter.

    Copilot will start a new session, which will appear in the list below the prompt box. Copilot will work on the task and push changes to its pull request, then add you as a reviewer when it has finished, triggering a notification.

Asking Copilot to start work from GitHub Mobile

  1. In GitHub Mobile, tap the icon in the bottom right corner of the screen, then tap New Session.

  2. Using the dropdown menu in the prompt field, select the repository you want Copilot to work in.

  3. Enter a prompt describing your request.

    For example: Implement a user friendly message for common errors..

    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.

  4. Optionally, select a base branch for Copilot's changes. Copilot will create a new branch based on this branch.

  5. Wählen Sie optional ein Benutzerdefinierter Agent mit speziellem Verhalten und speziellen Tools aus dem Dropdownmenü. Weitere Informationen finden Sie unter Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent.

  6. Optional können Sie das Dropdownmenü verwenden, um das zu verwendende Modell Copilot auszuwählen. Weitere Informationen findest du unter Ändern des KI-Modells für GitHub Copilot Cloud-Agent.

  7. Click the submit button.

    Copilot will start a new session, work on the task and push any code changes.

    You can track Copilot's work and open a pull request in one click from the session logs. For more information, see Nachverfolgung der GitHub-Copilot-Sitzungen.

Asking Copilot to create a pull request from the GitHub CLI

Hinweis

The agent-task command set is only available in v2.80.0 or later of the GitHub CLI. This command set is a öffentliche Vorschau and is subject to change.

You can start a new Copilot-Cloud-Agent session with the gh agent-task create command in the GitHub CLI.

When you run the command without any arguments, you are asked to enter a prompt. Copilot-Cloud-Agent acts on the prompt and opens a pull request in the current repository.

You can use command line options to:

  • Provide the prompt (gh agent-task create "Example prompt")
  • Choose a base branch, instead of using the repository's default branch (--base)
  • Select a repository, instead of targeting the current repository (--repo)
  • Follow the session log in real time (--follow)

To see all of the available options, run gh agent-task create --help.

Asking Copilot to create a pull request from the GitHub MCP server

Hinweis

  • This capability is only available on the remote GitHub MCP server and host applications where remote MCP servers are supported.
  1. Install the GitHub MCP server in your preferred IDE or agentic coding tool. See Verwenden des GitHub MCP-Servers in Ihrer IDE.

  2. Ensure the create_pull_request_with_copilot tool is enabled.

  3. Open chat.

  4. Type a prompt asking Copilot to create a pull request, with the details of what you want to change.

    For example, Open a PR in my repository to expand unit test coverage.

    Tipp

    • You can ask Copilot to open a pull request using a specific branch as the base branch by including it in your prompt.
  5. Submit your prompt.

    Copilot will start a new session, open a draft pull request and work on the task in the background. As it works, it will push changes to the pull request, and once it has finished, it will add you as a reviewer. In most cases, the MCP host will show you the URL of the created pull request.

Asking Copilot to create a pull request from Raycast

Raycast ist ein erweiterbares Startprogramm für Windows und macOS. Mit der GitHub Copilot Erweiterung für Raycast können Sie Aufgaben starten und nachverfolgen Copilot-Cloud-Agent und Sitzungsprotokolle live ansehen, wo immer Sie sich auf Ihrem Computer befinden.

  1. Installiere Raycast von der Raycast-Website.

  2. Installieren Sie die GitHub Copilot Erweiterung für Raycast, indem Sie auf der Seite der Erweiterung auf die Schaltfläche "Erweiterung installieren" klicken.

  3. Open Raycast, search for "Copilot," find the Create Task command, then press Enter.

  4. Click Sign in with GitHub, then complete the authentication flow. Raycast will re-open.

  5. Type a prompt describing what you want Copilot to do.

    For example, Implement a user friendly message for common errors.

  6. Select the repository you want Copilot to work in.

  7. Optionally, select a base branch for Copilot's pull request. Copilot will create a new branch based on this branch, then push the changes to a pull request targeting that branch.

  8. Wählen Sie optional ein Benutzerdefinierter Agent mit speziellem Verhalten und speziellen Tools aus dem Dropdownmenü. Weitere Informationen finden Sie unter Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent.

  9. Optional können Sie das Dropdownmenü verwenden, um das zu verwendende Modell Copilot auszuwählen. Weitere Informationen findest du unter Ändern des KI-Modells für GitHub Copilot Cloud-Agent.

  10. Press Command+Enter (macOS) or Ctrl+Enter (Windows) to start the task.

    Copilot will start a new session. Copilot will work on the task and push changes to its pull request, then add you as a reviewer when it has finished, triggering a notification.

Hinweis

Wenn Sie beim Starten einer Aufgabe kein bestimmtes Repository auswählen können, hat die Organisation, die das Repository besitzt, möglicherweise Zugriffsbeschränkungen aktiviert OAuth app . Informationen zum Anfordern der Genehmigung für „GitHub Copilot für Raycast” OAuth app finden Sie unter Von einer Organisation die Genehmigung für OAuth-Apps anfordern.

Asking Copilot to create a pull request from the "New repository" page

When creating a new repository, you can ask Copilot to seed the new repository by entering a prompt.

  1. Wähle in der rechten oberen Ecke einer beliebigen Seite , und klicke dann auf Neues Repository.

    Screenshot eines GitHub-Dropdownmenüs mit Optionen zum Erstellen neuer Elemente. Das Menüelement „Neues Repository“ ist in dunklem Orange eingerahmt.

  2. Verwende das Dropdownmenü Besitzer, um das Besitzerkonto für das Repository auszuwählen.

    Screenshot des Besitzermenüs für ein neues GitHub-Repository. Das Menü zeigt zwei Optionen, octocat und github.

  3. In the Prompt field, enter a prompt describing what you want Copilot to build.

    For example, Create a Rust CLI for converting CSV spreadsheets to Markdown

  4. Klicke auf Repository erstellen.

    Copilot will immediately open a draft pull request. Copilot will work on the task and push changes to its pull request, then add you as a reviewer when it has finished, triggering a notification.

Überwachen des Fortschritts

Sie können Ihre aktuellen und früheren Copilot Sitzungen über das Agents-Panel, die Seite "AgentsVisual Studio Code" und vieles mehr anzeigen. Siehe Nachverfolgung der GitHub-Copilot-Sitzungen.

Further reading