KI-Funktionen und autonome Agenten lizenzieren
Keyright 2.9.0 fügt erstklassige KI- und Agenten-Entitlements hinzu: Benennen Sie die Modelle, Endpoints und Tools, die ein Kunde aufrufen darf, begrenzen Sie einen autonomen Agenten mit einem Kreditbudget und einem Lease, und setzen Sie alles fail-closed und offline aus einer signierten Lizenz durch — mit einem gemessenen POST /v1/consume für laufende Nutzung. Hier sind die Form des Entitlements, das signierte JSON, die SDK-Helper in C#, Node, Python und Java sowie ein konkretes Szenario, das ein nicht lizenziertes Modell verweigert.
Eine Lizenz beantwortete früher eine einzige Frage zu KI-Funktionen: Darf dieser Kunde sie überhaupt nutzen? Das reicht nicht mehr. Ein KI-Produkt ist heute eine Menge eigenständiger, separat bepreister Fähigkeiten — welche Modelle, welche Anbieter, welche Tools ein Agent aufrufen darf — und ein autonomer Agent ist ein Prozess, der bei jedem Schritt echtes Geld ausgibt. „Lizenziert: ja” sagt nichts darüber aus, ob der Agent dieses Kunden gpt-5 aufrufen, einen Drittanbieter-Endpoint erreichen, ein Shell-Tool aufrufen oder über Nacht in einer Schleife zehntausend Credits verbrennen darf.
Keyright 2.9.0 macht all das zu dem, was eine Lizenz gewährt — erstklassig. KI- und Agenten-Entitlements benennen die Modelle, Endpoints und Tools, die ein Build berühren darf, und begrenzen einen autonomen Agenten mit einem Kreditbudget und einem Lease — alles fail-closed und offline aus der signierten Lizenz durchgesetzt, mit einem gemessenen, optionalen POST /v1/consume für laufende Nutzung über Instanzen hinweg.
Die Form des Entitlements
Sechs konventionelle Schlüssel liegen als Vorlage auf einer Lizenz-Tier; das Ausstellen einer Lizenz auf dieser Tier bettet sie in das signierte Lease ein, das der Kunde aktiviert.
ai.enabled— der Hauptschalter. Boolean. Ist erfalse, zählt nichts anderes.ai.models— eine Allow-List von Modell-Identifiern, die der Build aufrufen darf, z. B.openai/gpt-5,anthropic/claude-sonnet-4.6.ai.endpoints— die API-Hosts, die ein Build erreichen darf, z. B.api.openai.com.ai.tools— die Tool-Namen, die ein Agent aufrufen darf, z. B.web.search,code.run.agent.budget.credits— die harte Obergrenze an Credits, die ein Agent ausgeben darf.agent.lease.seconds— wie lange ein Agent laufen darf, bevor sein Lease erneuert werden muss.
Die drei listenwertigen Schlüssel sind Allow-Lists mit Wildcards. Ein * passt auf ein einzelnes Segment, also lässt openai/gpt-* sowohl openai/gpt-5 als auch openai/gpt-5-mini zu, aber nicht openai/o3; ein bloßes * lässt in dieser Dimension alles zu. Allow-Lists schlagen fail-closed fehl: Ein Modell, Endpoint oder Tool, das auf nichts in der Liste passt, wird verweigert. Sie gewähren durch Benennen; Sie müssen nie aufzählen, was verboten ist.
Eine signierte Lizenz, die KI-Entitlements trägt
So sieht eine Agenten-Lizenz der Pro-Tier nach dem Ausstellen aus. Der ent-Block ist die zum Ausstellungszeitpunkt eingebettete Entitlement-Vorlage; das gesamte Payload ist signiert, sodass jeder Wert unten manipulationssicher ist.
{
"sub": "acme-corp",
"product": "atlas-agent",
"tier": "pro",
"exp": "2027-11-12T00:00:00Z",
"ent": {
"ai.enabled": true,
"ai.models": ["openai/gpt-5", "openai/gpt-5-mini", "anthropic/claude-*"],
"ai.endpoints": ["api.openai.com", "api.anthropic.com"],
"ai.tools": ["web.search", "code.run", "file.read"],
"agent.budget.credits": 50000,
"agent.lease.seconds": 3600
},
"sig": "ed25519:9f2c…c41a"
}
Beachten Sie, was das gewährt: jedes aktuelle Claude-Modell (anthropic/claude-*), aber nur zwei bestimmte OpenAI-Modelle; zwei Anbieter-Endpoints; drei Tools; fünfzigtausend Credits pro Agent; ein Lease von einer Stunde. Ändern Sie ein einziges Zeichen — fügen Sie ein Modell hinzu, heben Sie die Obergrenze an — und die Ed25519-Signatur verifiziert nicht mehr gegen den öffentlichen Schlüssel, den die App zur Build-Zeit einbettet. Die Prüfung schlägt fail-closed fehl, statt still mehr zu gewähren.
Lesen und Durchsetzen in Ihrer App
Das SDK parst die Entitlements aus dem verifizierten Lease einmal und antwortet dann synchron ohne Netzwerkaufruf. In C# hängen die KI-Entitlements an info.Ai:
var client = KeyrightClient.Initialize(options);
var info = await client.ActivateAsync(licenseKey); // Lease lokal gecacht
// Prüfen Sie zuerst den Hauptschalter.
if (!info.Ai.Enabled)
throw new FeatureNotLicensedException("ai");
// Weiche Prüfung — verzweigt, ohne zu werfen.
if (info.Ai.AllowsModel("openai/gpt-5"))
useModel("openai/gpt-5");
// Harte Prüfung — wirft ModelNotLicensedException, wenn das Modell nicht erlaubt ist.
info.Ai.EnforceModel(requestedModel);
// Endpoints und Tools funktionieren genauso.
info.Ai.EnforceEndpoint("api.openai.com");
info.Ai.EnforceTool("code.run");
// Die Budget-Obergrenze pro Agent ist offline lesbar.
long ceiling = info.AgentBudgetCredits; // 50000, direkt aus dem signierten Lease
AllowsModel gibt einen Boolean zurück, nachdem der Identifier gegen ai.models abgeglichen wurde, Wildcards inklusive; EnforceModel ist die werfende Form, die Sie an die Grenze des Aufrufs selbst setzen. Beide schlagen fail-closed fehl: Ein unbekanntes Modell wird verweigert, und ein Lease ohne ai.models-Schlüssel gewährt nichts.
Dieselbe Oberfläche existiert in den anderen SDKs — gleiche Identifier, gleiche Wildcard-Semantik, idiomatische Schreibweise:
// Node
if (info.ai.allowsModel("anthropic/claude-sonnet-4.6")) { /* ... */ }
info.ai.enforceModel(requestedModel); // wirft, wenn nicht erlaubt
# Python
if info.ai.allows_model("anthropic/claude-sonnet-4.6"):
...
info.ai.enforce_model(requested_model) # wirft, wenn nicht erlaubt
// Java
if (info.ai().allowsModel("anthropic/claude-sonnet-4.6")) { /* ... */ }
info.ai().enforceModel(requestedModel); // wirft, wenn nicht erlaubt
Ein Kreditbudget pro Agent messen
agent.budget.credits ist die Offline-Obergrenze — ein hartes Limit, gegen das sich ein air-gapped Agent selbst begrenzt. Doch eine echte Agentenflotte teilt sich ein Budget über viele gleichzeitige Instanzen, und jede muss den laufenden Gesamtwert kennen, nicht nur die Obergrenze. Genau das misst POST /v1/consume.
Vor (oder nach) einer Arbeitseinheit meldet der Agent, was er ausgegeben hat. Der Dienst dekrementiert einen gemeinsamen, an die Lizenz gebundenen Zähler und gibt den verbleibenden Saldo zurück; würde eine Buchung den Saldo unter null drücken, wird sie abgelehnt und der Agent stoppt. Der Aufruf ist der einzige Teil der KI-Durchsetzung, der das Netzwerk berührt, und auch nur, wenn Sie sich für die gemeinsame Messung entscheiden.
// Belastet das gemeinsame Budget für einen Schritt. Schlägt fail-closed fehl, wenn erschöpft.
var result = await client.ConsumeAsync(new ConsumeRequest
{
AgentId = agentId,
Credits = step.EstimatedCredits
});
if (!result.Granted)
throw new AgentBudgetExhaustedException(result.Remaining); // Remaining == 0
logger.LogInformation("Agent {Agent} gab {Spent} aus; {Left} Credits verbleiben",
agentId, step.EstimatedCredits, result.Remaining);
Die Offline-Obergrenze und der Online-Zähler komponieren sich. Ein Agent, der den Dienst nicht erreicht, kann info.AgentBudgetCredits lokal immer noch nicht überschreiten; ein Agent, der ihn erreicht, kann zusätzlich den gemeinsamen Saldo nicht überschreiten, sodass zehn Instanzen nicht jeweils die volle Obergrenze ausgeben können. agent.lease.seconds begrenzt die andere Achse: Ein durchgehender Agent, dessen Lease abgelaufen ist, stoppt unabhängig von den verbleibenden Credits.
Ein konkretes Gating-Szenario
Setzen wir es zusammen. Ein Kunde mit der obigen Lizenz startet einen Agenten, und in Schritt drei fordert der Planer openai/o3 an — ein Modell, das nicht auf seiner Allow-List steht — und bittet anschließend um ein Paket von 40.000 Credits.
public async Task RunStep(AgentStep step)
{
// 1. Verweigere das nicht lizenzierte Modell, vor jedem Anbieteraufruf oder jeder Ausgabe.
if (!info.Ai.AllowsModel(step.Model))
throw new ModelNotLicensedException(step.Model); // "openai/o3" wird verweigert
// 2. Setze das Tool und den Endpoint durch, die der Schritt will.
info.Ai.EnforceTool(step.Tool);
info.Ai.EnforceEndpoint(step.Endpoint);
// 3. Miss die Ausgabe gegen das gemeinsame Budget pro Agent.
var charge = await client.ConsumeAsync(new ConsumeRequest
{
AgentId = step.AgentId,
Credits = step.EstimatedCredits // 40000 angefordert
});
if (!charge.Granted)
throw new AgentBudgetExhaustedException(charge.Remaining);
await Execute(step);
}
openai/o3 wird in Zeile eins abgelehnt — offline, bevor ein einziges Token gekauft wird — weil es auf nichts in ai.models passt. Hätte der Planer stattdessen openai/gpt-5-mini angefordert, würde die Modellprüfung bestehen, Tool- und Endpoint-Prüfung würden bestehen, und die Buchung über 40.000 Credits würde gegen eine frische Obergrenze von 50.000 gelingen — doch ein zweiter solcher Schritt würde mit Remaining == 10000 < 40000 abgelehnt, und der Agent würde stoppen, statt zu viel auszugeben. Kein Build-Wechsel, kein Redeploy: openai/o3 in den Plan zu verschieben oder die Obergrenze auf 100.000 anzuheben, ist eine Änderung an der Tier-Vorlage und eine neu ausgestellte Lizenz.
Fazit
Behandeln Sie KI-Fähigkeiten so, wie Sie Funktionen bereits behandeln: als benannte, signierte Entitlements, die Ihr Code lokal prüft. Lassen Sie ai.models, ai.endpoints und ai.tools sagen, was ein Agent aufrufen darf, und agent.budget.credits / agent.lease.seconds sagen, wie viel und wie lange — setzen Sie sie fail-closed mit AllowsModel / EnforceModel durch und messen Sie geteilte Ausgaben über POST /v1/consume. Die Modell-Allow-List, die Tool-Allow-List und die Budget-Obergrenze halten alle offline, direkt aus der Signatur; die Messung ist das Einzige, wofür Sie das Netzwerk berühren, und auch nur, wenn sich eine Flotte ein Budget teilt. Ihr Packaging — welche Tier welche Modelle bekommt, wie viele Credits — bleibt Konfiguration auf dem Server, keine Konstanten in Ihrem Binary.
Nebula.NET testen
Härten Sie Ihren .NET-Code in wenigen Minuten — starten Sie mit der kostenlosen Edition.