O LangSmith passou a oferecer três controles para restringir quem pode ver dados sensíveis registrados nas traces de agentes de IA: ocultação seletiva de entradas e saídas, grupos de usuários e políticas por metadados. O anúncio da LangChain foi publicado em 17 de novembro de 2026 e direciona os recursos aos planos Enterprise. A mudança é relevante porque traces de produção podem incluir mensagens de clientes, dados de saúde, pagamentos e outros registros pessoais — justamente o material que equipes técnicas precisam investigar sem necessariamente poder ler.

Resumo: o que mudou no LangSmith

  • Administradores podem impedir que determinados usuários vejam os inputs e outputs de uma trace, mantendo visíveis a árvore de execução, latência, custo e metadados.
  • Usuários podem ser organizados em grupos, com permissões específicas por workspace que se somam aos controles existentes de acesso por função e por atributo.
  • Políticas podem decidir o acesso a uma trace individual a partir dos metadados do root run, como ID do cliente, região ou ID do desenvolvedor.
  • Segundo a LangChain, os controles estão disponíveis nos planos LangSmith Enterprise.

Por que traces de agentes viraram um problema de governança

Trace é o registro estruturado do que um agente fez durante uma execução: prompt recebido, resposta do modelo, chamadas de ferramentas, documentos recuperados, tempos, erros, tokens e decisões intermediárias. Essa observabilidade é essencial para descobrir por que um agente ficou lento, repetiu uma chamada de API ou tomou uma rota inadequada.

O problema começa quando o agente sai do ambiente de demonstração. Em atendimento, saúde, finanças, jurídico ou RH, o próprio conteúdo que ajuda no diagnóstico pode conter dados pessoais, informações contratuais ou dados regulados. Dar acesso total a todas as traces simplifica a vida da engenharia, mas viola o princípio de menor privilégio. Remover as traces, por outro lado, reduz a capacidade de depurar e melhorar o sistema.

A proposta anunciada pela LangChain tenta separar essas duas necessidades: preservar sinais operacionais úteis para a equipe técnica e limitar o conteúdo sensível a quem realmente precisa vê-lo. Isso não elimina obrigações legais nem substitui uma política de retenção, mas reduz uma exposição comum em plataformas de observabilidade.

Os três novos controles, explicados

1. Restrição de entradas e saídas

O primeiro controle permite esconder os textos de entrada e resposta de uma trace para determinados perfis. Para um engenheiro, ainda podem ficar visíveis elementos como a sequência de runs, duração de cada etapa, consumo de tokens, custo e metadados. Assim, é possível identificar, por exemplo, uma ferramenta com falhas recorrentes ou uma recuperação de contexto lenta sem abrir a conversa de um cliente.

Esse desenho é útil porque o campo de texto é normalmente a parte mais sensível da telemetria. Mas a equipe precisa tratar metadados com o mesmo cuidado: IDs, nomes de arquivos, nomes de ferramentas e atributos de negócio também podem revelar informações pessoais ou confidenciais quando mal modelados.

2. Grupos com permissões por equipe

O segundo recurso adiciona grupos de usuários dentro do LangSmith. A empresa diz que as permissões podem ser definidas para cada workspace e se combinam com os mecanismos já usados pela organização, como role-based access control (RBAC) e attribute-based access control (ABAC).

Na prática, uma equipe clínica pode receber acesso ao conteúdo de traces necessário para anotação e revisão, enquanto a engenharia vê apenas indicadores de desempenho. Essa divisão também ajuda a aplicar políticas diferentes para equipes de suporte, segurança, produto e operações, em vez de transformar cada exceção em um workspace separado ou em uma cópia manual de dados.

3. Políticas por metadados no nível da trace

O controle mais granular usa metadados da execução raiz para decidir quem pode visualizar uma trace. A LangChain cita exemplos como limitar o suporte às traces dos clientes atribuídos àquela equipe ou permitir que desenvolvedores consultem somente as execuções do próprio agente de código.

Esse modelo depende de uma decisão de arquitetura anterior: definir metadados confiáveis no momento em que a trace é criada. Um campo como customer_id, region ou owner_user_id precisa ter origem clara, formato consistente e proteção contra manipulação por entradas externas. Se um agente copiar valores fornecidos pelo usuário para atributos de autorização sem validação do servidor, a política pode produzir uma falsa sensação de isolamento.

Como os controles se combinam

A arquitetura descrita pela LangChain é de camadas. A aplicação envia a trace completa, com metadados no root run. Depois, os controles definem qual grupo pode acessar uma trace, se o conteúdo textual pode ser aberto e quais restrições adicionais se aplicam ao usuário. A empresa afirma que isso evita a necessidade de manter cópias duplicadas ou versões previamente redigidas apenas para públicos diferentes.

NecessidadeControle indicadoExemplo práticoLimitação a considerar
Investigar lentidão sem ler conversasOcultar inputs e outputsEngenharia analisa latência e chamadas de ferramentaMetadados ainda exigem classificação
Separar acesso entre áreasGrupos por workspaceSuporte, segurança e engenharia com escopos distintosRequer manutenção de membros e papéis
Restringir acesso por cliente ou donoPolítica por metadadosSuporte vê somente contas atribuídasDepende de atributos confiáveis e bem governados
Os recursos resolvem problemas diferentes e funcionam melhor quando usados em conjunto.

O que uma equipe precisa fazer antes de ativar esse modelo

Os recursos de produto não substituem uma revisão do fluxo de dados. Antes de configurar permissões, uma equipe que opera agentes em produção deve mapear quais campos chegam ao provedor de observabilidade, por quanto tempo ficam armazenados, quais ambientes compartilham o mesmo workspace e quais pessoas precisam ver conteúdo textual para investigar incidentes.

  1. Classifique os dados da trace. Separe mensagens, anexos, resultados de ferramentas, IDs e metadados de negócio. Não presuma que somente o prompt contém informação sensível.
  2. Defina os atributos no backend. IDs de cliente, região e proprietário devem ser derivados de identidade autenticada ou de sistemas internos, não de um campo livre enviado ao modelo.
  3. Comece por acesso mínimo. Dê à engenharia acesso a métricas e árvores de execução; crie um fluxo auditável para liberar conteúdo quando houver necessidade real de suporte ou investigação.
  4. Teste cenários de exceção. Verifique se uma mudança de equipe, cliente ou região revoga o acesso esperado e se logs e exportações respeitam o mesmo escopo.
  5. Revise retenção e incidentes. Controles de visualização não equivalem a apagar dados. A política precisa cobrir armazenamento, exportação, retenção e resposta a vazamento.

Limitações e pontos que o anúncio não detalha

O comunicado confirma a disponibilidade dos controles para clientes Enterprise, mas não informa preço, cronograma para outros planos, prazos de retenção, criptografia específica por campo nem certificações novas associadas a esses recursos. Também não há, no anúncio, uma garantia de que ocultar entradas e saídas resolve sozinho requisitos de LGPD, HIPAA, GDPR ou CCPA. Essas leis e contratos dependem do caso de uso, das bases legais, das transferências de dados e dos acordos da organização.

Outro limite é operacional: políticas por atributos são tão boas quanto os dados que alimentam essas políticas. Empresas que não padronizaram IDs e classificação de dados podem encontrar mais valor em corrigir a instrumentação antes de adicionar regras complexas de acesso.

Análise do NoticIA: observabilidade de agentes precisa deixar de ser “tudo ou nada”

Na análise do NoticIA, o anúncio aborda uma lacuna real na adoção de agentes corporativos. Muitos times criam duas opções ruins: coletar tudo em uma ferramenta central com acesso amplo, ou reduzir a observabilidade por medo de expor dados. A combinação de métricas técnicas, grupos e políticas por trace oferece um terceiro caminho mais próximo de um modelo de produção maduro.

O ganho não é apenas de compliance. Quando acesso e contexto são desenhados de forma granular, a empresa pode manter telemetria suficiente para medir qualidade, custo e confiabilidade do agente sem normalizar o acesso indiscriminado às conversas dos clientes. A cautela continua necessária: a governança deve começar no desenho da aplicação e dos metadados, não no painel da plataforma.

Disponibilidade

A LangChain informa que os controles de acesso a traces estão disponíveis para clientes do LangSmith Enterprise. Organizações já clientes devem consultar a documentação de acesso a inputs e outputs, grupos de usuários e políticas baseadas em metadados; empresas interessadas precisam entrar em contato com a companhia para avaliar o plano Enterprise.



Descubra mais sobre noticiAI

Assine para receber nossas notícias mais recentes por e-mail.

Deixe seu comentário