TsgcAIGuardrails sitzt zwischen deiner Anwendung und dem Sprachmodell. Personenbezogene Daten werden durch Platzhalter ersetzt, bevor eine Anfrage die Anwendung verlässt, und in der Antwort wiederhergestellt, Tools werden nach Namen erlaubt, verboten oder zur Freigabe vorgelegt, und strukturierte Antworten werden gegen ein JSON Schema validiert.
Eine Komponente für die Regeln, die eine KI-Funktion vor dem Produktivbetrieb braucht. Weise sie TsgcAIChat.Guardrails zu, und jede Anfrage des Chats und jeder Lauf eines Agenten auf diesem Chat folgt denselben Regeln, egal welcher Anbieter antwortet.
TsgcAIGuardrails
PII-Schwärzung, Tool-Regeln und Antwortvalidierung
Windows, macOS, Linux, iOS und Android
Editionen. TsgcAIGuardrails ist in sgcAI, in sgcWebSockets Enterprise und in All-Access enthalten, in denselben Editionen wie TsgcAIChat. Neu in 2026.11.0. sgcAI ist eigenständig: Es enthält die sgcWebSockets Core Runtime, auf der die Komponente aufbaut. Verfügbar für Delphi 7 bis Delphi 13 und C++ Builder.
Schalte die Schwärzung ein, liste die erlaubten und verbotenen Tools auf, setze das Schema und weise die Guardrails dem Chat zu.
uses
sgcAI, sgcAI_Chat, sgcAI_Guardrails;
procedure TForm1.ProtectChat;
var
vText, vError: string;
begin
// personal data never leaves the application
sgcAIGuardrails1.PII.Enabled := True;
sgcAIGuardrails1.PII.CustomPatterns.Add('EmployeeId=EMP-####');
// read and search tools are allowed, deleting never is
sgcAIGuardrails1.AllowedTools.Add('read_*');
sgcAIGuardrails1.AllowedTools.Add('search_*');
sgcAIGuardrails1.DeniedTools.Add('*delete*');
sgcAIGuardrails1.ToolApproval := aigaNotReadOnly;
// structured answers must match the schema
sgcAIGuardrails1.Schema.Enabled := True;
sgcAIGuardrails1.Schema.JSONSchema := '{"type":"object","properties":' +
'{"price":{"type":"number","minimum":0}},"required":["price"]}';
sgcAIChat1.Guardrails := sgcAIGuardrails1;
sgcAIAgent1.Chat := sgcAIChat1; // the agent follows the same tool rules
vText := sgcAIGuardrails1.Redact('Mail bob@example.com, call +34 600 111 222');
Memo1.Lines.Add(vText); // Mail [EMAIL_1], call [PHONE_1]
Memo1.Lines.Add(sgcAIGuardrails1.Restore(vText)); // the original text
if not sgcAIGuardrails1.ValidateJSON('{"price":"cheap"}',
sgcAIGuardrails1.Schema.JSONSchema, vError) then
Memo1.Lines.Add(vError); // $.price: expected number
end;Die Member, zu denen du am häufigsten greifst.
Mit PII.Enabled werden E-Mail-Adressen, Telefonnummern, Kartennummern (Luhn geprüft), IBANs (mod 97 geprüft) sowie IPv4- und IPv6-Adressen vor dem Senden einer Anfrage durch Platzhalter wie [EMAIL_1] ersetzt und in der Antwort wiederhergestellt, solange PII.RestoreInAnswers aktiv ist. PII.Kinds wählt die Arten aus.
PII.CustomPatterns fügt eigene Kennungen als Name=Pattern hinzu, wobei # eine Ziffer, @ ein Buchstabe, ? ein beliebiges Zeichen und * der Rest eines Wortes ist, zum Beispiel ergibt EmployeeId=EMP-#### den Platzhalter [EMPLOYEEID_1].
AllowedTools und DeniedTools nehmen Tool-Namen mit *-Platzhaltern, verglichen ohne Beachtung der Groß- und Kleinschreibung, und ein verbotener Name gewinnt immer. Ein abgelehntes Tool wird dem Modell nicht angeboten und erneut abgelehnt, falls das Modell es dennoch aufruft. OnToolBlocked meldet jede Ablehnung mit ihrem Grund.
ToolApproval bestimmt, welche Tools vor der Ausführung TsgcAIAgent.OnToolApproval fragen: aigaNone, aigaNotReadOnly (Standard) oder aigaAll.
Mit Schema.Enabled werden strukturierte Antworten gegen Schema.JSONSchema validiert: type, required, properties, additionalProperties, enum, const, minimum, maximum, Längen und Elementanzahlen. Eine Verletzung löst OnSchemaViolation mit einem Pfad wie $.price: expected number aus, und der Chat meldet einen Fehler, statt die Antwort zu speichern.
Redact, Restore, ValidateJSON und IsToolAllowed funktionieren auch allein, ohne Chat. ClearRedactions vergisst die Zuordnung der Platzhalter.
Maßgebliche Quellen zu den Diensten und Protokollen, die diese Komponente nutzt.
| Online-HilfeVollständige API-Referenz und Anwendungsleitfaden für die sgcAI-Komponenten. | Öffnen | |
| Alle sgcAI-KomponentenDurchstöbere die vollständige Funktionsmatrix aller sgcAI-Komponenten. | Öffnen | |
| Kostenlose Testversion herunterladenProbiere sie mit deinen eigenen API-Schlüsseln aus. | Öffnen | |
| PreiseSingle-, Team- und Site-Lizenzen, vollständiger Quellcode. | Öffnen |