ESPAÇO PUBLICITÁRIO DISPONÍVEL · FALE CONOSCO

Como configurar privacidade, retenção de histórico e tokens de API do Hugging Face no HuggingChat

365Finds Editorial
11.430 artigos Wiki catalogados

Use o 365 Wiki com sua IA

Copie o prompt abaixo, cole na IA que você já usa e faça sua pergunta.

Baixar o Skill completo

Experimente primeiro com o prompt. Se você usa o 365 Wiki com frequência, instale o Skill completo do 365Wiki para não precisar colá-lo novamente. Se não usa uma IA específica, as versões web do Gemini ou Microsoft Copilot também servem.

Para usuários e desenvolvedores que priorizam a segurança de dados e a conformidade regulatória, o HuggingChat surge como uma das principais alternativas abertas frente aos assistentes de IA comerciais e fechados. Baseado no mecanismo de código aberto chat-ui, o serviço oficial em huggingface.co/chat adota por padrão o princípio de «privacidade por design» (privacy by design): as mensagens dos usuários não são comercializadas e não são compartilhadas com os criadores dos modelos para fins de treinamento.

Seja para conduzir pesquisas diárias sob sigilo ou para implantar uma interface privada para sua equipe, compreender como configurar o compartilhamento de dados, o ciclo de retenção das conversas e os tokens de acesso de API do Hugging Face é essencial para proteger seus prompts e desbloquear modelos abertos de acesso restrito (gated models).


1. Política de compartilhamento de dados e arquitetura de privacidade

Para avaliar o nível de segurança do HuggingChat, é indispensável diferenciar o ambiente web público das instâncias auto-hospedadas.

Linha de base da privacidade padrão

A Hugging Face adota regras estritas sobre o fluxo de dados no HuggingChat:

Controle do compartilhamento de dados

Em implantações auto-hospedadas do chat-ui e em versões experimentais, os administradores podem disponibilizar um botão de adesão explícita por meio da variável de ambiente PUBLIC_APP_DATA_SHARING=1. Caso essa variável esteja ausente ou definida como 0, qualquer canal de compartilhamento externo é suprimido, mantendo todos os dados confinados exclusivamente à sessão e ao banco de dados local.

Cuidados de privacidade ao utilizar a pesquisa na web

O HuggingChat dispõe de um recurso opcional de busca na internet (Web Search) na barra de entrada. Quando ativado, o sistema sintetiza palavras-chave a partir do seu prompt e as encaminha a mecanismos de busca externos (como Serper ou Exa) para coletar dados em tempo real. Se o seu comando contiver código confidencial, IPs de redes internas ou informações de negócios protegidas por sigilo, desative a pesquisa na web antes de enviar a mensagem para evitar o envio inadvertido de termos a indexadores de terceiros.

Cuidados com links de compartilhamento público

O HuggingChat permite criar links públicos com capturas estáticas de conversas por meio do botão «Share». Qualquer pessoa com esse endereço poderá visualizar o conteúdo. Em fluxos de trabalho confidenciais, deve-se adotar como norma nunca gerar esses links. Se um link for gerado por engano, a exclusão da conversa original na barra lateral desativa imediatamente a página pública correspondente.


2. Gestão e ciclo de retenção do histórico de conversas

O HuggingChat oferece controle minucioso sobre o tempo de permanência das suas informações, desde o uso sem cadastro até a exclusão física definitiva no banco de dados.

Modo convidado (Sessão anônima sem cadastro)

É possível utilizar o HuggingChat sem efetuar login em uma conta Hugging Face:

Exclusão de conversas individuais

Ao utilizar uma conta conectada, o histórico de conversas é exibido na barra lateral esquerda:

  1. Posicione o cursor sobre o título do chat que deseja apagar.
  2. Clique no ícone de três pontos (...) ou no ícone da lixeira.
  3. Confirme a exclusão no diálogo apresentado.

O HuggingChat processa uma exclusão física direta (Hard Delete): o documento correspondente é removido em definitivo do MongoDB, sem retenção em lixeira temporária ou marcações lógicas reversíveis.

Limpeza total do histórico da conta

Caso queira apagar de forma definitiva todo o histórico acumulado:

  1. Clique no ícone de engrenagem (Settings) no canto inferior esquerdo.
  2. Acesse a seção de controles de dados (Data Controls).
  3. Selecione Delete all conversations (Excluir todas as conversas) e confirme.

Essa ação executa a remoção imediata no banco de dados de todas as conversas, saídas de ferramentas e assistentes vinculados ao seu identificador de usuário.


3. Configuração de tokens de API do Hugging Face e acesso a modelos restritos

A utilização de tokens de API permite que desenvolvedores acessem repositórios protegidos no Hugging Face Hub e configurem integrações avançadas via MCP (Model Context Protocol).

Acesso a modelos restritos (Gated Models) na interface web

Modelos abertos de grande porte (como a família Meta Llama 3) são distribuídos no Hub sob o formato «Gated Model», exigindo a concordância com termos de uso comunitário:

  1. Acesse sua conta no Hugging Face.
  2. Vá até a página oficial do repositório do modelo restrito (por exemplo, meta-llama/Meta-Llama-3-70B-Instruct).
  3. Preencha o formulário de aprovação e concorde com os termos da licença.
  4. Volte ao HuggingChat. Como a sessão é compartilhada com sua conta, o modelo restrito ficará disponível automaticamente no seletor de modelos, sem que seja necessário inserir chaves de API manualmente no navegador.

Encaminhamento de tokens de usuário para servidores MCP

O HuggingChat suporta o protocolo MCP para execução de ferramentas e leitura de ativos:

  1. Abra Settings e selecione MCP Servers.
  2. Adicione a URL do servidor MCP desejado.
  3. Em fluxos corporativos, ative a opção MCP_FORWARD_HF_USER_TOKEN=true. Isso repassa de maneira segura o token do usuário autenticado para as ferramentas MCP autorizadas, permitindo o acesso a Datasets e repositórios privados da organização sem a necessidade de expor credenciais mestras de administrador.

Implantação de uma instância privada do chat-ui com HF_TOKEN

Para organizações que demandam total isolamento e soberania operacional sobre seus dados:

Passo 1: Criar um token de acesso com privilégios mínimos

  1. Acesse Hugging Face Settings > Access Tokens.
  2. Clique em Create new token.
  3. Escolha o tipo Read (ou configure um token Fine-grained com permissão restrita a repositórios de inferência). Nunca utilize tokens de escrita ou de administração em frontends de bate-papo.
  4. Copie o token iniciado por hf_.

Passo 2: Configurar as variáveis no arquivo .env.local

No diretório do projeto chat-ui, defina os parâmetros locais:

# Roteador de inferência compatível com o padrão OpenAI
OPENAI_BASE_URL=https://router.huggingface.co/v1

# Chave de autenticação primária para inferência
OPENAI_API_KEY=hf_seu_token_de_leitura_aqui

# Com login OpenID ativo, repassa o token individual de cada usuário autenticado
USE_USER_TOKEN=true

# Conexão MongoDB local dedicada para retenção controlada de mensagens
MONGODB_URL=mongodb://localhost:27017
MONGODB_DB_NAME=chat-ui-privado

# Desabilita formalmente qualquer opção de compartilhamento externo
PUBLIC_APP_DATA_SHARING=0

Passo 3: Iniciar a aplicação privada

docker run -d -p 27017:27017 --name mongo-chatui mongo:latest
npm install
npm run dev

4. Comparativo de privacidade e cenários de implantação

Modalidade de usoNível de privacidadePolítica de retençãoNecessidade de token Hugging FacePrincipal indicação de uso
Sessão web anônimaAlto (Sem registro)Somente cookies de sessão; descartados ao fechar a abaNãoPerguntas confidenciais esporádicas sem histórico
Sessão web logadaEquilibradoPersistência em MongoDB na nuvem; exclusão manual disponívelNão (Herdado da conta Hugging Face)Uso diário produtivo com sincronização de conversas
Acesso a modelos restritosEquilibradoArmazenamento em MongoDB; regido pelos termos do modeloRequer adesão aos termos no HubAvaliação de modelos como Llama 3 sob licença comunitária
Instância privada chat-uiMáximo (Suporta rede fechada)Banco de dados próprio com suporte a expiração TTLToken hf_ de leitura ou endpoint localAmbientes com exigência de sigilo bancário, médico ou LGPD

5. Boas práticas para garantir a máxima privacidade

  1. Avaliar os termos dos modelos restritos: A aprovação de termos para modelos com acesso controlado estabelece compromissos com o desenvolvedor do modelo; verifique as cláusulas antes de submeter dados proprietários.
  2. Utilizar somente tokens de leitura: Configure sempre credenciais com permissão Read para inferência, evitando riscos de modificação não autorizada de repositórios em caso de vazamento.
  3. Programar a exclusão automática no banco: Em instalações auto-hospedadas, crie índices TTL no MongoDB para eliminar automaticamente conversas antigas após 14 ou 30 dias.
  4. Desativar a busca na web para dados sensíveis: Mantenha a funcionalidade de pesquisa desativada sempre que os prompts envolverem segredos industriais ou informações pessoais identificáveis.

Referências