Repositorykonfiguration für die GitHub-App Copilot

Verwenden Sie .github/github-app.yml in Ihrem Repository, um zu definieren, wie sich das Verhalten für dieses GitHub Copilot App Projekt verhalten soll.

Sie können diese Projekteinstellungen auch in der App-UI bearbeiten. Falls .github/github-app.yml bereits vorhanden, werden UI-Änderungen in diese Datei zurückgeschrieben. Wenn sie noch nicht vorhanden ist, können Sie sie aus den aktuellen Projekteinstellungen in der App erstellen.

Informationen zum Speicherort der Konfigurationsdatei

Erstellen Sie die Datei unter:

.github/github-app.yml

.github/github-app.yml

Die App unterstützt auch den Legacydateinamen .github/copilot-desktop.yml aus Gründen der Abwärtskompatibilität.

Informationen zu UI-basierten Anpassungsschritten finden Sie unter Anpassen der GitHub-App Copilot.

Überprüfen und Vertrauen der Konfiguration

Wenn die App eine Konfiguration aus dem Repository erkennt, wendet sie keine Repositoryanweisungen, Skripts oder andere Einstellungen aus der Datei an, bis Sie die Konfiguration überprüfen und akzeptieren. Dadurch können Sie keine Befehle ausführen oder Einstellungen anwenden, die von einem anderen Mitwirkenden hinzugefügt wurden. Konfigurationen, die Sie über die App-UI erstellen oder aktualisieren, werden automatisch als vertrauenswürdig eingestuft.

Wenn sich die Datei außerhalb der App ändert, einschließlich Änderungen an Leerzeichen oder Kommentaren, müssen Sie die aktualisierte Konfiguration überprüfen und akzeptieren, bevor die App sie anwendet. Bis Sie die aktuelle Version akzeptieren, verwendet die App weiterhin die Projekteinstellungen, die zuvor in der App konfiguriert wurden.

Beispielkonfiguration

instructions: |
  Use bun instead of npm.

scripts:
  - name: Setup
    command: bun install
    triggers:
      - session.create
  - name: Run
    command: bun run dev
  - name: Archive cleanup
    command: rm -rf node_modules
    triggers:
      - session.archive

server_ready_pattern: '(?i)Local:\s+(https?://\S+)'
auto_open_in_browser: true

automation:
  auto_issue_session: true
  remote_control: false

instructions: |
  Use bun instead of npm.

scripts:
  - name: Setup
    command: bun install
    triggers:
      - session.create
  - name: Run
    command: bun run dev
  - name: Archive cleanup
    command: rm -rf node_modules
    triggers:
      - session.archive

server_ready_pattern: '(?i)Local:\s+(https?://\S+)'
auto_open_in_browser: true

automation:
  auto_issue_session: true
  remote_control: false

Konfigurieren von Anweisungen und Skripts

instructions

Hier können instructions Sie repositoryspezifische Anleitungen zur Systemaufforderung für Sitzungen im Projekt hinzufügen. Wenn Sie auch globale Anweisungen in der App konfigurieren, werden zuerst die globalen Anweisungen angewendet, gefolgt von den Projektanweisungen.

scripts

Hiermit definieren Sie scripts Befehle, die in der App angezeigt werden, und können manuell oder auf bestimmten Triggern ausgeführt werden.

Jedes Skriptelement unterstützt Folgendes:

• name (string): Anzeigename in der Benutzeroberfläche.
• command (string): Auszuführender Befehl.
• triggers (string[], optional): Ereignisse, die das Skript automatisch ausführen.

Skripts ohne triggers manuell.

Triggerwerte

Verwenden Sie kanonische Triggerwerte in Ihrer Datei:

• session.create
• session.archive

Die App akzeptiert auch diese Legacyalias beim Analysieren vorhandener Dateien:

• workspace.create (Alias für session.create)
• workspace.archive (Alias für session.archive)

Wenn ein ausgelöstes Skript ausgeführt wird, COPILOT_SCRIPT_TRIGGER wird auf den kanonischen Wert festgelegt:

• session.create
• session.archive

Konfigurieren der Servererkennung und des Browserverhaltens

server_ready_pattern

server_ready_pattern ist ein regulärer Ausdruck, der verwendet wird, um zu erkennen, wann ein Ausführungsskript einen Server gestartet hat.

Muster verwenden die syntax, die von Rusts regex Kasten unterstützt wird. Ausführliche Informationen zur Syntax finden Sie in der Dokumentation zur Kastenrate. Wenn das Muster ungültig ist, verwendet die App ihr Standardservererkennungsmuster.

Verwenden Sie eine erste Aufnahmegruppe für die erkannte URL oder den erkannten Port. Die App liest die Erfassungsgruppe 1:

• Wenn es sich bei der Aufnahme um eine URL (http://... oder https://...) handelt, wird die URL verwendet.
• Wenn die Aufnahme nur eine Portnummer ist (z. B 3000. ), konvertiert die App sie in http://localhost:3000.

auto_open_in_browser

Wenn auto_open_in_browser ja true, öffnet die App die erkannte Ausführungs-URL im integrierten Browser. Wenn dieses Feld nicht angegeben wird, lautet trueder effektive Standardwert .

Konfigurieren des Automatisierungsverhaltens

Festlegen von Automatisierungsoptionen unter automation:

• automation.auto_issue_session (boolean) steuert, ob die App automatisch eine Sitzung mit Problemkontext startet. Wenn nicht angegeben, lautet trueder effektive Standardwert .
• automation.remote_control (boolean) steuert, ob über die GitHub Weboberfläche oder GitHub Mobileüber die Weboberfläche auf Sitzungen zugegriffen werden kann. Wenn nicht angegeben, lautet falseder effektive Standardwert .

Wenn Ihr Copilot Arbeitsplatz von einer Organisation stammt, muss die entsprechende Richtlinie "Lokale Store-Sitzungen in der Cloud" auf "Anzeigen und Steuern" festgelegt werden, damit die Remotesteuerung verfügbar ist. Unternehmensverwaltete remoteControl Einstellungen können auch dann automation.remote_control``truedie Remotesteuerung weiter einschränken. Weitere Informationen findest du unter Informationen zur Remotesteuerung von GitHub Copilot-CLI Sitzungen und Unternehmensverwaltete Einstellungen.

Laufzeitumgebungsvariablen für Skripts

Skripts werden mit diesen von der App bereitgestellten Umgebungsvariablen ausgeführt:

Für jede COPILOT_GH_ACCOUNT_* Variable schreibt die App den Host und die Anmeldung in Kleinbuchstaben, lässt ASCII-Buchstaben und Ziffern unverändert und ersetzt jedes andere UTF-8-Byte durch seinen Hexadezimalwert in Großbuchstaben, umgeben von Unterstrichen. Der Variablename verwendet das Format COPILOT_GH_ACCOUNT_<HOST>_<LOGIN>. Das Token für alice "On github.com " lautet COPILOT_GH_ACCOUNT_github_2E_com_alicebeispielsweise , und das Token für user "Ein" ghe-example.com lautet COPILOT_GH_ACCOUNT_ghe_2D_example_2E_com_user.

Legacykompatibilität

Aus Gründen der Abwärtskompatibilität kann die App weiterhin die ältere objektbasierte scripts Form analysieren:

scripts:
  setup: bun install
  run: bun run dev
  archive: rm -rf node_modules

scripts:
  setup: bun install
  run: bun run dev
  archive: rm -rf node_modules

In diesem Legacy-Shape:

• setup ordnet einem Skript mit dem Create-Trigger zu.
• archive ordnet einem Skript mit dem Archivtrigger zu.
• run ordnet manuellen Skripteinträgen zu und kann entweder eine einzelne Befehlszeichenfolge oder eine Liste von { name, command } Objekten sein.