GitHubs Copilot-Nutzungsmetrik-API trennt BYOK und Unternehmensmodelle: Lokales BYOK ist eine Untergrenze ohne Modellaufschlüsselung; alte Berichtstage erhalten das Kennzeichen is_custom_enterprise_model nicht rückwirkend

Am 3. November 2026 kündigte das GitHub-Changelog an, dass die Copilot-Nutzungsmetrik-API Nutzung mit eigenem Schlüssel (BYOK) jetzt getrennt ausweist, damit Administratoren sie von der Nutzung Copilot-gehosteter Modelle unterscheiden können. Bisher trugen lokale und eigene Modelle oft dieselben Namen wie Copilot-Modelle, sodass BYOK-Nutzung in den gehosteten Summen unterging. Das Update teilt BYOK in zwei Arten. Lokales BYOK richten Entwickler in ihrem eigenen Client ein. Benutzerdefinierte Unternehmensmodelle richten Administratoren in den GitHub-Einstellungen ein. Beide erscheinen in Unternehmens- und Organisationsberichten, auf Nutzer- und Aggregatebene, in 1-Tages- und 28-Tage-Berichten.

Lokales BYOK umfasst den eigenen Anbieterschlüssel eines Entwicklers und lokale Modelle, die Werkzeuge wie Ollama, Foundry Local, LM Studio und llama-server bereitstellen. Anfragen gehen von Copilot CLI oder der GitHub-Copilot-App direkt an den Anbieterschlüssel oder das lokale Modell des Entwicklers, nicht über GitHub. Die Felder sind used_local_byok, das anzeigt, ob ein Nutzer an dem Tag mindestens eine lokale BYOK-Anfrage in Copilot CLI oder der Copilot-App gestellt hat (Nutzerberichte); totals_by_local_byok mit Zahlen zu Sitzungen, Anfragen, Prompts und Token, aufgeschlüsselt nach byok_kind (local_managed, local_user, local_auto oder remote_user) und surface (copilot_cli oder copilot_app); sowie die Zahl aktiver lokaler BYOK-Nutzer pro Tag, Woche und Monat in Aggregatberichten.

Benutzerdefinierte Unternehmensmodelle richten Administratoren in den GitHub-Einstellungen ein, und Anfragen laufen über GitHub zum Anbieter. Das neue Feld is_custom_enterprise_model ist ein boolescher Wert an jedem Modelleintrag in totals_by_client und ist true, wenn die Anfrage ein für Unternehmen oder Organisation eingerichtetes eigenes Modell nutzte. GitHub beobachtet diese Anfragen serverseitig, das Feld deckt also alle Clients ab, auch IDEs. Ein Modell, das sowohl als Copilot-gehostetes als auch als eigenes Modell genutzt wird, erscheint als zwei Einträge, und Einträge eigener Modelle enthalten echte Anfrage- und Token-Zahlen.

Das hilft bei Governance und Kostenanalyse. Administratoren sehen, wer Anfragen an eigene Anbieterschlüssel, lokale Modelle oder benutzerdefinierte Unternehmensmodelle sendet, und gleichen das mit ihrer BYOK-Richtlinie ab. Sie trennen Copilot-gehostete Nutzung von Nutzung, die der eigene Anbieter abrechnet oder die auf kostenlosen lokalen Modellen läuft, sodass die Kosten pro Nutzer nur abbilden, was Copilot tatsächlich liefert. Sie sehen außerdem die Nutzung über Werkzeuge hinweg in einer Ansicht. Die Felder sind allerdings Zählwerte für Sitzungen, Anfragen, Prompts und Token; der Beitrag beschreibt kein Dollar-Feld, es ist also keine Rechnung.

In den „wichtigen Hinweisen“ stehen mehrere Grenzen. Erstens ändern sich bestehende Summen nicht: BYOK-Nutzung war schon erfasst, lokales BYOK ist eine Teilmenge von totals_by_cli und totals_by_copilot_app, und die Nutzung eigener Modelle steckt bereits in totals_by_client. Zweitens ist lokales BYOK eine Untergrenze, denn die Felder beruhen auf Client-Telemetrie und zählen bei deaktivierter Telemetrie zu wenig, und Token-Zahlen können zu niedrig sein, weil manche lokalen Anbieter keine Token melden. Die Zahlen benutzerdefinierter Unternehmensmodelle werden serverseitig beobachtet und haben diese Grenze nicht. Drittens folgen Modellnamen der bestehenden Normalisierung, nicht erkannte Namen erscheinen als unknown, und lokales BYOK wird nicht nach Modellnamen aufgeschlüsselt. Viertens gibt es keine Rückfüllung: Berichtstage vor der Veröffentlichung haben kein is_custom_enterprise_model, und der Beitrag sagt nicht, ob frühere Tage die Felder für lokales BYOK enthalten. Fünftens dürfen Unternehmensinhaber, Unternehmens-Abrechnungsverwalter, Organisationsinhaber und Inhaber einer eigenen Rolle mit der Berechtigung View Copilot Metrics zugreifen, und die Richtlinie für Copilot-Nutzungsmetriken muss aktiviert sein.

Aus der Teilmengen-Regel folgt praktisch eine Doppelzählung. Da lokales BYOK bereits in totals_by_cli und totals_by_copilot_app steckt und die Nutzung eigener Modelle bereits in totals_by_client, würde ein Dashboard, das die neuen Felder zu den alten Summen addiert, dieselben Anfragen doppelt zählen. Die neuen Felder sind Ausschnitte zum Abziehen oder Filtern, keine zusätzlichen Zeilen zum Addieren. Auch die Verlässlichkeit unterscheidet sich. Die Zahlen eigener Modelle beobachtet GitHub serverseitig, die Zahlen für lokales BYOK stammen aus Client-Telemetrie, die ein Entwickler oder eine Richtlinie abschalten kann; eine sinkende Kurve für lokales BYOK kann also weniger Nutzung oder weniger Telemetrie bedeuten, und der Bericht allein zeigt nicht, was zutrifft.

Die stützende REST-Dokumentation ist bei den Endpunkten genauer. Berichte sind NDJSON-Dateien, die über signierte Download-Links mit begrenzter Lebensdauer abgerufen werden. Die Unternehmens-Endpunkte verlangen, dass die Richtlinie „Copilot usage metrics“ für das Unternehmen auf Enabled everywhere steht. Die feingranulare Berechtigung heißt für das Unternehmen „View Enterprise Copilot Metrics“ und für Organisationen „View Organization Copilot Metrics“; die Historie reicht bis zu einem Jahr zurück, ab dem 10. Oktober 2025. Diese REST-Seite definiert die neuen BYOK-Felder nicht selbst, in den erfassten Quellen beschreibt sie nur das Changelog, und dessen Berechtigungsname „View Copilot Metrics“ stimmt mit den beiden Namen der Dokumentation nicht genau überein. Der Beitrag nennt keine Zuordnung, prüfen Sie daher die Einstellungen in Ihrem eigenen GitHub-Konto, bevor Sie Zugriff einrichten.