Erste Schritte mit unternehmensverwalteten Einstellungen

Mit vom Unternehmen verwalteten Einstellungen können Sie Konfigurationseinstellungen zentral für GitHub Copilot unterstützte Clients definieren und verteilen. Dadurch wird sichergestellt, dass jeder innerhalb der von Ihnen definierten Schutzschienen arbeitet, mit der Option, einstellungen für verschiedene Teams zu spezialisieren. Sie können beispielsweise verhindern, dass Agents vertrauliche Vorgänge ausführen, genehmigte Agent-Plug-Ins installieren oder sicherstellen, dass Sitzungen in einer Sandbox ausgeführt werden.

Dieser Leitfaden zeigt Ihnen, wie Sie die Datei managed-settings.json auf GitHub erstellen, die Einstellungen für Benutzer bereitstellen und bestimmte Einstellungen für Enterprise-Teams überschreiben. Als Beispiel mit geringer Reibung stellen wir sicher, dass neue Unterhaltungen für die meisten Benutzer im automatischen Modellmodus beginnen und diese Einstellung für ein bestimmtes Unternehmensteam außer Kraft setzen. In diesem Beispiel können Sie die Bereitstellung verwalteter Einstellungen testen, ohne dass Dies zu Unterbrechungen für Benutzer führt.

Hinweis

Wenn Sie ein dediziertes Unternehmen für Copilot Business verwenden, gibt es zusätzliche Anleitungen, die Sie berücksichtigen sollten. Siehe Verwenden von unternehmensverwalteten Einstellungen ohne Organisationen.

Unterstützte Clients

Die folgenden Clients werden unterstützt, obwohl nicht jeder Client jede Eigenschaft unterstützt:

Copilot CLI
VS Code
Der GitHub Copilot app
Copilot cloud agent
JetBrains IDEs

Eine vollständige Referenz zu unterstützten Schlüsseln finden Sie unter Unternehmensverwaltete Einstellungen.

1. Erstellen eines Repositorys `.github-private`

Sie können die managed-settings.json Datei in einem .github-private Repository hosten, das einer bestimmten Organisation in Ihrem Unternehmen gehört. Auf diese Weise können Sie Ihre verwalteten Einstellungen neben Ihren benutzerdefinierten Agentprofilen an einem Ort beibehalten, den Mitglieder des Unternehmens anzeigen können.

Anweisungen zum Erstellen des Repositorys und auswählen als Quelle der Clientgovernance Ihres Unternehmens finden Sie unter Erstellen eines .github-private Repositorys.

Die Governanceeinstellungen in diesem Repository gelten für alle Benutzer, die eine Copilot Lizenz von Ihrem Unternehmen oder einer ihrer Organisationen erhalten, unabhängig davon, ob der Benutzer Zugriff auf das .github-private Repository oder die Organisation hat, die sie besitzt. Es wird empfohlen, dem Repository interne Sichtbarkeit zu geben, damit Unternehmensmitglieder die Governanceeinstellungen anzeigen und Bearbeitungen der managed-settings.json Datei auf Administratoren und KI-Manager beschränken können.

Tipp

Dies wird als "serververwaltete" Bereitstellung bezeichnet. Es gibt weitere Methoden zum Verteilen verwalteter Einstellungen an Benutzer, einschließlich der Verwaltung mobiler Geräte (Mobile Device Management, MDM) und der lokalen Dateiübermittlung. Weitere Informationen findest du unter Auswählen, wie unternehmensverwaltete Einstellungen für Benutzer bereitgestellt werden.

2. Erstellen der `managed-settings.json` Datei

In diesem Beispiel verwenden wir eine sehr einfache Konfiguration, mit der sichergestellt wird, dass die Unterhaltungen der Benutzer im automatischen Modus gestartet werden. Dies bedeutet, dass Copilot automatisch das beste Modell für die Aufgabe eines Benutzers aus den in Ihrem Unternehmen zulässigen Modellen auswählt, wodurch Rate-Limiting-Probleme für Benutzer reduziert werden.

Erstellen Sie im .github-private Repository eine Datei unter copilot/managed-settings.json.
Fügen Sie der Datei die Konfiguration hinzu. Beispiel:
JSON
```
{
  "model": "auto"
}
```
```
{
  "model": "auto"
}
```
Übernehmen Sie die Änderungen an der Standardverzweigung.

Überprüfen Sie bei einem echten Rollout die unterstützten Schlüssel und deren Abdeckung für alle Clients. Siehe Unternehmensverwaltete Einstellungen.

3. Die Einstellung für bestimmte Teams überschreiben

Sie können unterstützte Eigenschaften der managed-settings.json Datei für Unternehmensteams außer Kraft setzen. In diesem Beispiel deaktivieren wir die Standardeinstellung für das automatische Modell für ein Team, das sich an bestimmte Modelle für spezielle Aufgaben halten muss.

Nachdem Sie diesen Abschnitt abgeschlossen haben, hat Ihr .github-private Repository die folgende Struktur:

.github-private/
- copilot/

managed-settings.json **: { "model": { "overridable": "auto" } } * ** team-mappings.json **: { "no-auto.json": ["special-team"] } * teams/ * ** no-auto.json **: { "model": "unmanaged" }

Schritte

Erstellen Sie ein Team auf Unternehmensebene mit Benutzern, die die Standardvorgabe für den automatischen Modus nicht erhalten sollen. In diesem Beispiel nennen wir es special-team. Siehe Erstellen von Unternehmensteams.
Markieren Sie in Ihrer copilot/managed-settings.json-Datei den Schlüssel mithilfe der { "overridable": VALUE }-Syntax als zum Überschreiben geeignet. Der VALUE Standardwert ist, wenn Teams-Dateien keinen anderen Wert für einen bestimmten Schlüssel deklarieren.

Beispielsweise werden model wir für Unternehmensteams außer Kraft setzen, wobei auto die Standardeinstellung für alle anderen Personen bleibt:
JSON
```
{
  "model": { "overridable": "auto" }
}
```
```
{
  "model": { "overridable": "auto" }
}
```
Erstellen Sie in Ihrem .github-private Repository eine dedizierte Einstellungsdatei für das Unternehmensteam unter copilot/teams/. Beispiel: copilot/teams/no-auto.json.

Geben Sie in dieser Datei eine Konfiguration an, die Werte für überschreibbare Eigenschaften definiert.

Im folgenden Beispiel wird die Steuerung des Auto-Modellmodus entfernt. Alles andere wird von Ihrer managed-settings.json Datei gesteuert.
JSON
```
{
  "model": "unmanaged"
}
```
```
{
  "model": "unmanaged"
}
```
Erstellen Sie in Ihrem copilot/team-mappings.json-Repository .github-private. Ordnen Sie in dieser Datei den Namen des Unternehmensteams der speziellen Konfigurationsdatei zu. Der Schlüssel ist der Name der Einstellungsdatei, und der Wert ist ein Array von Team-Slugs, sodass Sie eine Datei für mehrere Teams verwenden können.
JSON
```
{
  "no-auto.json": ["special-team"]
}
```
```
{
  "no-auto.json": ["special-team"]
}
```
Committen Sie Ihre Änderungen und pushen Sie sie in den Standard-Branch.

Später können Sie unterschiedliche Überschreibungen für andere Schlüssel und andere Teams hinzufügen. Ein vollständiges Beispiel finden Sie unter Außerkraftsetzen unternehmensverwalteter Teameinstellungen.

4. Überprüfen Sie, ob die Einstellungen aktiv sind.

Überprüfen Sie, ob die von Ihnen definierten Einstellungen für Benutzer aktiv sind und für bestimmte Teams außer Kraft gesetzt werden. In diesem Beispiel sollten die meisten Benutzer Ihres Unternehmens Copilot feststellen, dass neue Unterhaltungen in ihrem Client im automatischen Modus gestartet werden. Das special-team Unternehmensteam sollte diese Erfahrung nicht haben.

Für serververwaltete Bereitstellungen sehen Benutzer auf einem unterstützten Client die angegebenen Einstellungen innerhalb von etwa einer Stunde. Dazu gehören copilot/managed-settings.json, copilot/team-mappings.jsonund Dateien in copilot/teams/. Wenn Sie den Client neu starten oder sich erneut anmelden, wird eine sofortige Aktualisierung ausgelöst.

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.

Bei MDM-verwalteten Bereitstellungen suchen die Clients stündlich nach aktualisierten Richtlinien. Starten Sie den Client für dateibasierte Bereitstellungen neu, um eine aktualisierte Datei zu laden. Diese Bereitstellungsmethoden gelten für alle Benutzer, deren Einstellungen auf ihrem Computer installiert sind, unabhängig davon, wo ihre Copilot Lizenz stammt.

Nächster Schritt

Jetzt haben Sie ein einfaches Setup für verwaltete Einstellungen erstellt, sie haben folgende Möglichkeiten:

Fügen Sie der Datei zusätzliche Governanceeigenschaften hinzu. Siehe Unternehmensverwaltete Einstellungen.
Entscheiden Sie, ob Einstellungen für Benutzer über andere Methoden bereitgestellt werden sollen. Siehe Auswählen, wie unternehmensverwaltete Einstellungen für Benutzer bereitgestellt werden.

Erste Schritte mit unternehmensverwalteten Einstellungen

Wer kann dieses Feature verwenden?

In diesem Artikel