Lição 5 de 7 · 9 minutos

Guardrails

Controle quais provedores e modelos as chaves podem acessar, como os dados são tratados e o que é sinalizado, ocultado ou bloqueado.

Um guardrail é um conjunto de regras para o tráfego da API. Crie um em Configurações → Guardrails → Novo guardrail. Dê a ele um nome que diga o que ele impõe, como "eu-models-pii-redact", para poder reutilizá-lo em várias chaves. Um guardrail pode definir:

  • Modo de provedores: permitir todos os provedores, só os selecionados ou todos menos os selecionados.
  • Modo de modelos: permitir todos os modelos ou só os selecionados.
  • Tratamento de dados: só zero retenção de dados (ZDR) e se endpoints que podem treinar com as entradas continuam elegíveis.
  • Verificações de Injeção de prompt e de Informações sensíveis, como endereços de e-mail, números de telefone ou números de cartão. Cada verificação pode Sinalizar, Ocultar ou Bloquear.

Use a prévia para testar uma entrada inofensiva, uma que deveria ser barrada e um prompt real antes de salvar. Depois associe o guardrail em Aplicar para chaves, ou em Aplicar para membros para cobrir todas as chaves que esses membros criarem. Os membros não podem editar nem remover um guardrail que um proprietário ou administrador atribuiu a eles.

As regras em Configurações → Privacidade valem para todas as solicitações do espaço de trabalho, e um guardrail só pode restringi-las. Quando vários guardrails se aplicam à mesma chave, por exemplo um na chave e outro em quem a criou, todos contam e o resultado mais rígido prevalece. Um modelo precisa ser permitido por todos os guardrails, os provedores bloqueados se somam, ZDR é exigido se qualquer guardrail exigir, e a ação mais forte (Bloquear acima de Ocultar acima de Sinalizar) é a usada.

Comece pequeno: associe um guardrail novo a uma chave de baixo risco e confira Configurações → Uso → Atividade de guardrails e os registros de solicitações antes de ampliá-lo. Um guardrail desativado mantém as configurações, mas não é aplicado. Os guardrails não limitam gastos; para isso, use orçamentos e limites de chave.

Confira o que você aprendeu

O guardrail da própria chave permite os modelos A e B. O guardrail de membro de quem a criou permite só o modelo B. Quais modelos a chave pode usar?

Aplique

A sua equipe jurídica quer que endereços de e-mail e números de telefone sejam removidos dos prompts e que só sejam usados provedores com zero retenção de dados. Você não quer quebrar o bot de suporte durante a implantação. Qual é o seu plano?

Mostrar a resposta

Crie um guardrail com só ZDR e Informações sensíveis em Ocultar para e-mail e telefone. Teste-o na prévia com um prompt inofensivo, um sensível e um real. Associe-o primeiro a uma chave de staging ou de baixo risco, confira Atividade de guardrails e os registros e depois associe-o à chave do bot de suporte e às outras chaves que precisam dele.

Resumo

Os guardrails se acumulam: todos os que se aplicam contam, então crie políticas pequenas e com nomes claros e aplique-as uma chave de cada vez.

Links relacionados

O progresso fica salvo neste navegador.

Verificado em 17 de novembro de 2026