Konfigurieren von unternehmensverwalteten Einstellungen

Mit zentral verwalteten Unternehmenseinstellungen können Unternehmensinhaber Konfigurationseinstellungen für Benutzer im Copilot CLI-Tarif Ihres Unternehmens zentral definieren und an VS Code und Copilot verteilen, sodass jedes Mitglied innerhalb derselben Leitplanken arbeitet. Weitere Clientunterstützung wird folgen. managed-settings.json hat Vorrang vor der dateibasierten Konfiguration, die von Benutzern in ihren Clients für die unterstützten Schlüssel festgelegt wurde.

Konsolidierte Schemareferenz

Die managed-settings.json Datei unterstützt die folgenden Eigenschaften der obersten Ebene. Sie können eine beliebige Kombination dieser Eigenschaften einschließen, basierend auf den Einstellungen, die Sie erzwingen möchten.

{
  "extraKnownMarketplaces": {
    "agent-skills": {
      "source": {
        "source": "github",
        "repo": "OWNER/REPO"
      }
    }
  },
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "OWNER/REPO"
    }
  ],
  "enabledPlugins": {
    "PLUGIN-NAME@MARKETPLACE-NAME": true
  },
  "permissions": {
    "disableBypassPermissionsMode": "disable",
    "model": "auto"
  }
}

{
  "extraKnownMarketplaces": {
    "agent-skills": {
      "source": {
        "source": "github",
        "repo": "OWNER/REPO"
      }
    }
  },
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "OWNER/REPO"
    }
  ],
  "enabledPlugins": {
    "PLUGIN-NAME@MARKETPLACE-NAME": true
  },
  "permissions": {
    "disableBypassPermissionsMode": "disable",
    "model": "auto"
  }
}

• extraKnownMarketplaces: Definiert zusätzliche Plug-In-Marketplaces, die benutzern zur Verfügung stehen. Jeder Eintrag ist ein benanntes Marketplace-Objekt, das eine source Eigenschaft enthält, die den Anbieter ("github") und das Repository im OWNER/REPO Format angibt.
• strictKnownMarketplaces: Beschränkt die Plug-In-Installation auf nur die vom Unternehmen explizit definierten Marketplaces. Jeder Eintrag ist ein Marketplace-Objekt, das eine source Eigenschaft enthält. Das source gibt den Anbieter entweder als "github" mit einem repo im Format OWNER/REPO oder als "git" mit einem url an, das auf ein Git-Repository verweist.
• enabledPlugins: Definiert Plug-Ins, die automatisch für alle Unternehmensbenutzer installiert werden. Jeder Eintrag verwendet das Format PLUGIN-NAME@MARKETPLACE-NAME als Schlüssel mit einem booleschen Wert true, um das Plug-in zu aktivieren.
• permissions: Steuert, ob Benutzer die Befehlsgenehmigung umgehen können.
  • Legen Sie model auf "auto" fest, damit neue Unterhaltungen standardmäßig mit automatischer Modellauswahl durch Copilot beginnen. Benutzer können weiterhin für jede Konversation einzeln zu einem anderen Modell wechseln.
  • Legen Sie disableBypassPermissionsMode auf "disable" fest, um zu verhindern, dass Benutzer den Umgehungsmodus aktivieren. Weitere Informationen finden Sie unter Deaktivieren des Umgehungsmodus für Ihr Unternehmen weiter in diesem Artikel.

Konfigurieren von Enterprise-Plug-In-Standards

Sie können Einstellungen anwenden, um die verfügbaren Plug-In-Marketplaces der Benutzer und die standardmäßig installierten Plug-Ins zu steuern. Siehe Informationen zu unternehmensverwalteten Plug-In-Standards.

1. Erstellen Sie im .github-private Repository Ihres Unternehmens die Datei für verwaltete Einstellungen unter copilot/managed-settings.json. Wenn Sie kein .github-private Repository als Quelle für die Agent-Konfiguration Ihres Unternehmens festgelegt haben, siehe Erstellen eines .github-private Repositorys.

   Der veraltete Pfad (.github/copilot/settings.json) wird ebenfalls unterstützt.

2. Fügen Sie die Plug-in-Richtlinienkonfiguration der Datei hinzu, wobei Sie die in Konsolidierte Schemareferenz beschriebenen Eigenschaften extraKnownMarketplaces, strictKnownMarketplaces und enabledPlugins verwenden.

   JSON

   {
     "extraKnownMarketplaces": {
       "agent-skills": {
         "source": {
           "source": "github",
           "repo": "OWNER/REPO"
         }
       }
     },
     "strictKnownMarketplaces": [
       {
         "source": "github",
         "repo": "OWNER/REPO"
       }
     ],
     "enabledPlugins": {
       "PLUGIN-NAME@MARKETPLACE-NAME": true
     }
   }
   

3. Commit übergeben und Ihre Änderungen an die Standardverzweigung des .github-private Repository übertragen.

Die automatische Modellauswahl von Copilot als Standard festlegen

Sie können die automatische Modellauswahl in Copilot CLI und VS Code als Standardmodell für neue Konversationen festlegen. Weitere Informationen finden Sie unter Über CopilotAutomatische Modellauswahl. Indem Sie sie als Standardeinstellung für Ihr Unternehmen festlegen, stellen Sie sicher, dass neue Unterhaltungen mit dem ausgewählten automatischen Modell beginnen.

Was das Festlegen des Modells „Auto“ als Standard bewirkt

Wenn Sie model unter permissions auf "auto" festlegen, beginnen neue Konversationen in beiden Clients mit ausgewähltem Auto-Modell:

• In Copilot CLI, neue Sitzungen verwenden Auto-Modell, es sei denn, der Benutzer gibt ein anderes Modell an.
• In VS Code ist die Modellauswahl standardmäßig auf „Automatisches Modell“ eingestellt, wenn ein Benutzer eine neue Unterhaltung beginnt.

Benutzer können weiterhin für jede Unterhaltung einzeln zu einem anderen Modell wechseln.

Deaktivieren des Umgehungsmodus für Ihr Unternehmen

Sie können verhindern, dass Benutzer den Umgehungsmodus (auch als "YOLO-Modus" bezeichnet) in Copilot CLI und VS Codeaktivieren. Mit dem Umgehungsmodus kann ein Agent Befehle ausführen, auf Dateien zugreifen und URLs abrufen, ohne um Genehmigung zu bitten. Indem Sie sie für Ihr Unternehmen deaktivieren, stellen Sie sicher, dass eine Person jede dieser Aktionen überprüft.

Was das Deaktivieren des Umgehungsmodus verhindert

Wenn Sie disableBypassPermissionsMode auf "disable" festlegen, können Benutzer den Bypassmodus in beiden Clients nicht aktivieren:

• In Copilot CLI sind die Befehlszeilenoptionen --yolo, --allow-all, --allow-all-tools, --allow-all-paths und --allow-all-urls sowie die Slash-Befehle /yolo und /allow-all gesperrt.
• In VS Code, die globale Einstellung für die automatische Genehmigung (chat.tools.global.autoApprove), die auch als "YOLO-Modus" bezeichnet wird, ist deaktiviert und kann nicht erneut aktiviert werden.

Konfigurieren der Einstellung

1. Erstellen Sie im .github-private Repository Ihres Unternehmens die Datei für verwaltete Einstellungen unter copilot/managed-settings.json. Wenn Sie kein .github-private Repository als Quelle für die Agent-Konfiguration Ihres Unternehmens festgelegt haben, siehe Erstellen eines .github-private Repositorys.

   Der veraltete Pfad (.github/copilot/settings.json) wird ebenfalls unterstützt.

2. Fügen Sie der Datei die Eigenschaft permissions hinzu und legen Sie disableBypassPermissionsMode auf "disable" fest.

   JSON

   {
     "permissions": {
       "disableBypassPermissionsMode": "disable"
     }
   }
   

3. Commit übergeben und Ihre Änderungen an die Standardverzweigung des .github-private Repository übertragen.

Überprüfen, ob die Konfiguration angewendet wurde

Sobald die Konfiguration zugesichert wurde, werden den Benutzern die angegebenen Einstellungen angezeigt, wenn sie sich das nächste Mal von einem unterstützten Client authentifizieren. Clients rufen die neueste Konfiguration einmal pro Stunde ab.

Wenn ein Benutzer diese Einstellungen nicht sieht, stellen Sie sicher, dass er über Ihr Unternehmen oder eine seiner Organisationen Zugriff auf Copilot erhält. Wenn ein Benutzer eine Lizenz von mehreren Abrechnungsentitäten erhält, stellen Sie sicher, dass er Ihr Unternehmen in den persönlichen Copilot Einstellungen in der Dropdownliste "Nutzung in Rechnung gestellt" ausgewählt hat.