Ausschließen von Inhalten von GitHub Copilot

Erfahren Sie, wie Sie verhindern können, dass Copilot auf bestimmte Inhalte zugreift.

Wer kann dieses Feature verwenden?

Repository administrators, organization owners, and enterprise owners can manage content exclusion settings. People with the "Maintain" role for a repository can view, but not edit, content exclusion settings for that repository.

Organisationen und Unternehmen mit einem Copilot Business- oder Copilot Enterprise-Plan.

In diesem Artikel

Konfigurieren des Inhaltsausschlusses für dein Repository

Sie können Ihre Repositoryeinstellungen verwenden, um Inhalte in Ihrem Repository anzugeben, die GitHub Copilot ignoriert werden sollen.

Hinweis

          GitHub Copilot-CLI, Copilot-Cloud-Agent und Agent Mode in Copilot-Chat in IDEs unterstützen keine Inhaltsausschlüsse. Weitere Informationen zu diesen Copilot Features finden Sie unter [AUTOTITLE](/copilot/concepts/agents/about-copilot-cli), [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) und [AUTOTITLE](/copilot/how-tos/chat-with-copilot/chat-in-ide).

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot eines Repositoryheaders mit den Registerkarten. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  3. Klicken Sie im Abschnitt "Code & Automatisierung" der Randleiste auf Copilot und klicken Sie dann auf Inhaltsausschluss.

    Wenn Ihr Repository Ausschlüsse von seiner übergeordneten Organisation oder von Organisationen im selben Unternehmen erbt, werden oben auf der Seite ein oder mehrere graue Kästchen angezeigt, die Einzelheiten zu diesen Ausschlüssen enthalten. Sie können diese Einstellungen nicht bearbeiten.

  4. Geben Sie im Feld "Pfade, die in diesem Repository ausgeschlossen werden sollen" die Pfade zu Dateien ein, von denen Copilot ausgeschlossen werden soll.

    Verwenden Sie das Format: - "/PATH/TO/DIRECTORY/OR/FILE", mit jedem Pfad in einer separaten Zeile. Sie können Kommentare hinzufügen, indem Sie eine Zeile mit # beginnen.

    Tipp

    Sie können die fnmatch-Mustervergleichsnotation verwenden, um Dateipfade anzugeben. Bei Mustern wird die Groß-/Kleinschreibung nicht beachtet. Weitere Informationen findest du unter Datei in der Dokumentation von „ruby-doc.org“.

Beispiel für Pfade, die in den Repositoryeinstellungen angegeben sind

YAML
- "/src/some-dir/kernel.rs"

Ignore the /src/some-dir/kernel.rs file in this repository.

- "secrets.json"

Ignore files called secrets.json anywhere in this repository.

- "secret*"

Ignore all files whose names begin with secret anywhere in this repository.

- "*.cfg"

Ignore files whose names end with .cfg anywhere in this repository.

- "/scripts/**"

Ignore all files in or below the /scripts directory of this repository.

# Ignore the `/src/some-dir/kernel.rs` file in this repository.
- "/src/some-dir/kernel.rs"

# Ignore files called `secrets.json` anywhere in this repository.
- "secrets.json"

# Ignore all files whose names begin with `secret` anywhere in this repository.
- "secret*"

# Ignore files whose names end with `.cfg` anywhere in this repository.
- "*.cfg"

# Ignore all files in or below the `/scripts` directory of this repository.
- "/scripts/**"

Konfigurieren des Inhaltsausschlusses für Ihre Organisation

Sie können Ihre Organisationseinstellungen verwenden, um Dateien anzugeben, die GitHub Copilot ignoriert werden sollen. Die Dateien können sich innerhalb eines Git-Repositorys oder an einer beliebigen Stelle im Dateisystem befinden, die nicht unter einem Git-Steuerelement liegt.

  1. Klicke in der rechten oberen Ecke von GitHub auf dein Profilbild und dann auf Your organizations.

  2. Wählen Sie eine Organisation aus, indem Sie darauf klicken.

  3. Klicke unter dem Organisationsnamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot der Registerkarten im Profil einer Organisation. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  4. Klicken Sie in der linken Randleiste auf Copilot, dann auf "Inhaltsausschluss".

  5. Geben Sie im Feld "Zu ausschließende Repositorys und Pfade" die Details der Dateien ein, von denen Copilot ausgeschlossen werden soll.

    Um Dateien auszuschließen, die sich an einem beliebigen Ort befinden (innerhalb eines Git-Repositorys oder anderswo), geben Sie "*": gefolgt vom Pfad zu der oder den Dateien ein, die Sie ausschließen möchten. Wenn Sie mehrere Dateipfadmuster angeben möchten, listen Sie jedes Muster in einer separaten Zeile auf.

    Um Dateien in einem Git-Repository Copilotauszuschließen, geben Sie einen Verweis auf das Repository in einer Zeile ein, gefolgt von Pfaden zu Speicherorten innerhalb des Repositorys, wobei sich jeder Pfad in einer separaten Zeile befindet. Verwenden Sie das folgende Format und ersetzen Sie REPOSITORY-REFERENCE durch einen Verweis auf das Repository, das die auszuschließenden Dateien enthält:

    REPOSITORY-REFERENCE:
  - "/PATH/TO/DIRECTORY/OR/FILE"
  - "/PATH/TO/DIRECTORY/OR/FILE"
  - ...

    Repositorys können mithilfe verschiedener Protokolle referenziert werden. Sie können eine der folgenden Syntaxen für REPOSITORY-REFERENCE verwenden und Copilot wird funktionieren, unabhängig davon, wie das Repository lokal geklont wurde.

    http[s]://host.xz[:port]/path/to/repo.git/

git://host.xz[:port]/path/to/repo.git/

[user@]host.xz:path/to/repo.git/

ssh://[user@]host.xz[:port]/path/to/repo.git/

    Die Teile user@ und :port der REPOSITORY-REFERENCE werden bei der Berechnung ignoriert, welche Pfade für ein Repository ignoriert werden sollen.

    Für Azure DevOps können Sie das neue Hostformat (dev.azure.com) oder das alte (visualstudio.com)-Hostformat verwenden, wenn sie REPOSITORY-REFERENCE angeben, und Copilot entspricht diesen, unabhängig davon, welcher Host zum lokalen Klonen des Repositorys verwendet wurde.

    Tipp

    Sie können die fnmatch-Mustervergleichsnotation verwenden, um Dateipfade anzugeben. Bei Mustern wird die Groß-/Kleinschreibung nicht beachtet. Weitere Informationen findest du unter Datei in der Dokumentation von „ruby-doc.org“.

Beispiel für Repositorys und Pfade in Organisationseinstellungen

YAML
"*":
  - "**/.env"

Ignore all .env files from all file system roots (Git and non-Git). For example, this excludes REPOSITORY-PATH/.env and also /.env. This could also have been written on a single line as:

"*": ["**/.env"]

octo-repo:

In the octo-repo repository in this organization:

  - "/src/some-dir/kernel.rs"

Ignore the /src/some-dir/kernel.rs file.

https://github.com/primer/react.git:

In the primer/react repository on GitHub:

  - "secrets.json"

Ignore files called secrets.json anywhere in this repository.

  - "/src/**/temp.rb"

Ignore files called temp.rb in or below the /src directory.

git@github.com:*/copilot:

In the copilot repository of any GitHub organization:

  - "/__tests__/**"

Ignore any files in or below the /__tests__ directory.

  - "/scripts/*"

Ignore any files in the /scripts directory.

git@gitlab.com:gitlab-org/gitlab-runner.git:

In the gitlab-org/gitlab-runner repository on GitLab:

  - "/main_test.go"

Ignore the /main_test.go file.

  - "{server,session}*"

Ignore any files with names beginning with server or session anywhere in this repository.

  - "*.m[dk]"

Ignore any files with names ending with .md or .mk anywhere in this repository.

  - "**/package?/*"

Ignore files directly within directories such as packages or packaged anywhere in this repository.

  - "**/security/**"

Ignore files in or below any security directories, anywhere in this repository.

# Ignore all `.env` files from all file system roots (Git and non-Git).
# For example, this excludes `REPOSITORY-PATH/.env` and also `/.env`.
# This could also have been written on a single line as:
#
# "*": ["**/.env"]
"*":
  - "**/.env"

# In the `octo-repo` repository in this organization:
octo-repo:
  # Ignore the `/src/some-dir/kernel.rs` file.
  - "/src/some-dir/kernel.rs"

# In the `primer/react` repository on GitHub:
https://github.com/primer/react.git:
  # Ignore files called `secrets.json` anywhere in this repository.
  - "secrets.json"
  # Ignore files called `temp.rb` in or below the `/src` directory.
  - "/src/**/temp.rb"

# In the `copilot` repository of any GitHub organization:
git@github.com:*/copilot:
  # Ignore any files in or below the `/__tests__` directory.
  - "/__tests__/**"
  # Ignore any files in the `/scripts` directory.
  - "/scripts/*"

# In the `gitlab-org/gitlab-runner` repository on GitLab:
git@gitlab.com:gitlab-org/gitlab-runner.git:
  # Ignore the `/main_test.go` file.
  - "/main_test.go"
  # Ignore any files with names beginning with `server` or `session` anywhere in this repository.
  - "{server,session}*"
  # Ignore any files with names ending with `.md` or `.mk` anywhere in this repository.
  - "*.m[dk]"
  # Ignore files directly within directories such as `packages` or `packaged` anywhere in this repository.
  - "**/package?/*"
  # Ignore files in or below any `security` directories, anywhere in this repository.
  - "**/security/**"

Konfigurieren des Inhaltsausschlusses für dein Unternehmen

Als Unternehmensbesitzer können Sie die Unternehmenseinstellungen verwenden, um Dateien anzugeben, die GitHub Copilot ignoriert werden sollen. Die Dateien können sich innerhalb eines Git-Repositorys oder an einer beliebigen Stelle im Dateisystem befinden, die nicht unter einem Git-Steuerelement liegt.

  1. Navigieren Sie zu Ihrem Unternehmen. Beispielsweise auf der Seite Unternehmen in GitHub.com.
  2. Klicken Sie oben auf der Seite auf AI-Steuerelemente.
  3. Klicken Sie in der Randleiste auf Copilot.
  4. Klicken Sie auf "Inhaltsausschluss".
  5. Verwenden Sie Pfade, um anzugeben, welche Inhalte ausgeschlossen werden sollen. Weitere Informationen finden Sie im vorherigen Abschnitt Konfigurieren des Inhaltsausschlusses für Ihre Organisation.

Hinweis

Der hauptunterschied zwischen dem Festlegen des Inhaltsausschlusses auf Unternehmensebene und der Organisationsebene besteht darin, dass Regeln, die auf Unternehmensebene festgelegt werden, für alle Copilot Benutzer im Unternehmen gelten, während die von Organisationsbesitzern festgelegten Regeln nur für Benutzer gelten, denen diese Organisation einen Copilot Arbeitsplatz zugewiesen hat.

Testen von Änderungen an Inhaltsausschlüssen

Sie können Ihre IDE verwenden, um zu überprüfen, ob Ihre Änderungen an den Inhaltsausschlüssen wie erwartet funktionieren.

Weitergabe von Änderungen am Inhaltsausschluss an Ihre IDE

Nachdem dem Hinzufügen oder Ändern von Inhaltsausschlüssen kann es bis zu 30 Minuten dauern, bis sie in IDEs wirksam wird, in denen die Einstellungen bereits geladen wurden. Wenn Sie nicht warten möchten, können Sie die Einstellungen zum Inhaltsausschluss mithilfe der folgenden Anweisungen manuell neu laden.

  • Laden Sie für JetBrains-IDEs und Visual Studio die Inhaltsausschlusseinstellungen neu, indem Sie die Anwendung schließen und erneut öffnen.
  • Führen Sie die Visual Studio Code folgenden Schritte aus, um die Einstellungen für den Inhaltsausschluss neu zu laden:
    1. Öffnen Sie die Befehlspalette. Beispiel: durch Drücken von Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux).
    2. Geben Sie Folgendes ein: reload.
    3. Wählen Sie Developer: Fenster erneut laden aus.
  • Bei Vim/Neovim werden Inhaltsausschlüsse bei jedem Öffnen einer Datei automatisch abgerufen GitHub .

Testen Ihrer Inhaltsausschlüsse

Sie können überprüfen, ob die von Ihnen konfigurierten Inhaltsausschlüsse wie erwartet funktionieren.

  1. Prüfen Sie zunächst, ob die Inhaltsausschließung in Dateien funktioniert, die nicht der Inhaltsausschließung unterliegen. So geht's:
    • Öffnen Sie in Ihrer IDE eine Datei, die nicht der Inhaltsausschlussklausel unterliegt.
    • Erstellen Sie eine Bearbeitung, die normalerweise einen Inlinevorschlag generiert. Ein Vorschlag sollte angezeigt werden.
  2. Öffnen Sie eine Datei, die ausgeschlossen werden soll, und nehmen Sie die gleiche Bearbeitung vor. Kein Vorschlag sollte angezeigt werden.
  3. So testen Sie den Inhaltsausschluss für Copilot-Chat:

    • Öffnen Sie in Ihrer IDE das Copilot-Chat Panel.

    • Öffne eine Datei, die ausgeschlossen werden sollte, und schließe alle anderen Dateien, die im Editor geöffnet sind.

    • Stellen Sie sicher, dass die geöffnete Datei als Kontextdatei an den Prompt angefügt ist.

    • Geben Sie die Eingabeaufforderung explain this file ein.

      Falls die Datei ausgeschlossen ist, kann Copilot-Chat die Datei nicht zum Generieren einer Antwort verwenden. Die Datei wird nicht als Verweis in Copilotder Antwort aufgeführt.

Verwalten von Inhaltsausschlüssen mit der REST-API

Organisationsbesitzer und Unternehmensbesitzer können Inhaltsausschlüsse auch programmgesteuert mithilfe der GitHub REST-API verwalten.

Weitere Informationen finden Sie unter REST-API-Endpunkte für Copilot Inhaltsausschlussverwaltung.

Weiterführende Themen