Guardrails

O TsgcAIGuardrails fica entre o seu aplicativo e o modelo de linguagem. Os dados pessoais são trocados por marcadores antes de a requisição sair do aplicativo e restaurados na resposta, as ferramentas são permitidas, negadas ou enviadas para aprovação pelo nome, e as respostas estruturadas são validadas contra um JSON schema.

TsgcAIGuardrails

Um componente para as regras de que um recurso de IA precisa antes de ir para produção. Atribua-o a TsgcAIChat.Guardrails e toda requisição do chat, e toda execução de um agente nesse chat, segue as mesmas regras, seja qual for o provedor que responde.

Classe do componente

TsgcAIGuardrails

Finalidade

Mascaramento de PII, regras de ferramentas e validação de respostas

Família

Chat e agentes

Plataformas

Windows, macOS, Linux, iOS e Android

Edições. O TsgcAIGuardrails vem no sgcAI, no sgcWebSockets Enterprise e no All-Access, as mesmas edições do TsgcAIChat. Novidade da versão 2026.11.0. O sgcAI é autossuficiente: inclui o runtime sgcWebSockets Core sobre o qual o componente foi construído. Disponível para Delphi 7 a Delphi 13 e C++ Builder.

Mantenha dados pessoais e ferramentas de risco sob controle

Ligue o mascaramento, liste as ferramentas permitidas e negadas, defina o schema, atribua os guardrails ao chat.

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;

Principais propriedades & métodos

Os membros que você usa com mais frequência.

Mascaramento de PII

Com PII.Enabled, endereços de e-mail, números de telefone, números de cartão (verificados por Luhn), IBANs (verificados por mod 97) e endereços IPv4 e IPv6 são trocados por marcadores como [EMAIL_1] antes de a requisição ser enviada, e restaurados na resposta enquanto PII.RestoreInAnswers estiver ligado. PII.Kinds seleciona os tipos.

Padrões personalizados

PII.CustomPatterns adiciona seus próprios identificadores como Name=Pattern, onde # é um dígito, @ uma letra, ? qualquer caractere e * o resto de uma palavra, por exemplo EmployeeId=EMP-#### gera [EMPLOYEEID_1].

Regras de ferramentas

AllowedTools e DeniedTools recebem nomes de ferramentas com curingas *, comparados sem diferenciar maiúsculas de minúsculas, e um nome negado sempre vence. Uma ferramenta recusada não é oferecida ao modelo e é recusada de novo se o modelo ainda assim a chamar. OnToolBlocked reporta cada recusa com o seu motivo.

Aprovação

ToolApproval decide quais ferramentas pedem TsgcAIAgent.OnToolApproval antes de executar: aigaNone, aigaNotReadOnly (o padrão) ou aigaAll.

Validação de schema

Com Schema.Enabled, as respostas estruturadas são validadas contra Schema.JSONSchema: type, required, properties, additionalProperties, enum, const, minimum, maximum, comprimentos e quantidade de itens. Uma violação dispara OnSchemaViolation com um caminho como $.price: expected number, e o chat reporta um erro em vez de guardar a resposta.

Métodos

Redact, Restore, ValidateJSON e IsToolAllowed também funcionam sozinhos, sem um chat. ClearRedactions esquece o mapeamento dos marcadores.

Especificações & referências

Fontes oficiais dos serviços e protocolos que este componente usa.

Continue explorando

Ajuda onlineReferência completa da API e guia de uso dos componentes sgcAI.
Todos os componentes sgcAIExplore a matriz de recursos de todos os componentes sgcAI.
Baixar avaliação gratuitaExperimente com suas próprias chaves de API.
PreçosLicenças Single, Team e Site, código-fonte completo.
Melhor custo-benefício: All-AccessTodos os produtos da eSeGeCe, com Suporte Premium incluído, a partir de €1,059/ano.
Ver preços do All-Access

Pronto para começar?

Baixe a avaliação gratuita e ponha regras em volta do modelo de linguagem antes que ele chegue aos seus usuários.