Rollenumfang
Begrenze die Tools, die dein Agent einem Aufrufer anbietet, auf die zu seiner Rolle passenden.
Ein mit mehreren MCP-Servern verbundener Agent kann am Ende eine große Menge an Tools haben. Rollenumfang grenzt das pro Aufrufer ein: Jemand bekommt nur die für seine Rolle markierten Tools angeboten, sodass der Agent aus einer kleineren, relevanteren Menge wählt, was ihn sowohl schneller als auch weniger anfällig macht, das falsche Tool zu greifen.
Das ist eine Verbesserung von Leistung und Nutzererlebnis, keine Zugriffskontrolle. Das bedeutet nicht, dass du deine eigenen Regeln lockern kannst: Jedes Tool ruft deine API weiterhin genau so auf, wie konfiguriert, und deine API muss die Berechtigungen selbst prüfen, genau wie bei jedem anderen Aufrufer.
Wie es funktioniert
Markiere die Operationen in deinem OpenAPI-Dokument mit x-role,
siehe
Rollenverwaltung.
Rufe den Chat-Endpunkt des Agenten mit einem Authorization-Header
auf, der ein JWT trägt, Authorization: Bearer <token>, siehe
Authentifizierung.
Tuix AI Agents liest den Claim custom_roles aus diesem Token, eine
Liste von Rollen-Strings, und verwendet den ersten Eintrag als Rolle
des Aufrufers.
Filterung
Ist eine Rolle ermittelt, bietet der Agent nur Tools an, deren x-role-
Metadaten diese Rolle enthalten, passend, wenn mindestens eine der Rollen
des Tools zutrifft. Ein Tool ganz ohne x-role ist nicht eingeschränkt, es
wird jedem Aufrufer unabhängig von seiner Rolle angeboten.
Authentifizierst du dich mit einem X-Api-Key statt dem eigenen
Authorization-Token eines Nutzers, gibt es kein nutzerbezogenes Token,
aus dem eine Rolle gelesen werden könnte, also greift keine Filterung
und der Agent sieht jedes verbundene Tool.