ENES
Fale com a Sigil Labs

Trabalho para cliente

Assistente jurídico no Microsoft Teams

O assistente jurídico no Microsoft Teams é um bot que classifica cada pergunta como verde, amarelo ou vermelho e responde apenas com base em uma biblioteca de documentos aprovada.

Por Sigil Labs · Publicado em · Atualizado em

← Todos os projetos

Ficha do projetoNº 09
Tecnologias utilizadas
  • Python
  • FastAPI
  • Microsoft Bot Framework
  • Microsoft Graph
  • Claude
  • Libriq
  • PostgreSQL
Status
Prova de conceito

O problema

Pessoas que não são do jurídico têm dúvidas jurídicas, e nem toda dúvida pode ser respondida por uma máquina. Responder sem fonte, ou responder sozinho um caso que pede um advogado, é o risco que este assistente existe para evitar. Ele foi desenvolvido para uma grande empresa e faz a triagem inicial das perguntas: só responde por conta própria o que a base cobre de forma explícita, e o restante segue para pessoas.

O que foi construído

O assistente funciona dentro do Microsoft Teams. Ele oferece:

  • triagem de toda pergunta em verde, amarelo ou vermelho antes de qualquer resposta;
  • respostas somente a partir de uma biblioteca de documentos aprovada, com as fontes citadas;
  • recusa e escalada automática ao time jurídico nos casos vermelhos;
  • conversa contínua, com as seis últimas trocas de mensagens como contexto;
  • registro de cada interação (pergunta, resposta, triagem e citações) para auditoria;
  • um relatório semanal anonimizado, enviado a um destinatário configurado.

Como funciona

A triagem usa três cores. Uma pergunta só recebe verde quando a regra legal é clara, o caso já foi validado na base de conhecimento e existe fonte para citar. Amarelo é um tema conhecido com uma variável que pode mudar o resultado, e a resposta traz um alerta sobre o que pode mudar o caso. Qualquer outra situação, incluindo tema fora da base ou caso incerto, recebe vermelho.

Quem decide a cor é o Claude, que consulta a biblioteca por meio do Libriq e entrega a triagem e a resposta juntas, em um único resultado estruturado. Travas feitas em código protegem o resultado:

  • uma resposta verde sem fonte é rebaixada para amarelo;
  • em vermelho, o texto escrito pelo modelo nunca chega ao usuário, só o texto institucional fixo;
  • a busca só alcança os documentos já sincronizados; sem nenhum documento sincronizado, ela não devolve nada, em vez de abrir todo o acervo da conta no Libriq;
  • qualquer inconsistência na saída do modelo é tratada como falha segura.

A biblioteca é alimentada automaticamente. A cada seis horas, por padrão, um processo consulta o SharePoint pelo Microsoft Graph, com acesso apenas ao site da biblioteca e não ao ambiente inteiro. Ele baixa o que mudou e o envia ao Libriq. Um documento com erro tem no máximo três tentativas.

O conteúdo jurídico nasce em uma planilha de autoria de um especialista jurídico, com quatro abas. O sistema a compila em um arquivo por tema e um índice mestre, usando só as linhas com validação aprovada. Uma norma marcada como revogada na planilha fica fora da base compilada e nunca é citada.

O Teams espera cerca de 15 segundos por uma resposta, e a triagem pode levar de 10 a 30 segundos. Por isso o bot confirma o recebimento na hora, mostra que está digitando e entrega a resposta depois, por mensagem proativa.

Em que estágio está

O assistente é uma prova de conceito. Começou como um bot de perguntas e respostas sobre uma biblioteca de documentos e evoluiu para o assistente de triagem de risco descrito aqui. O envio formal de e-mail ao jurídico ficou para uma etapa seguinte.

A homologação usa um conjunto de perguntas preparado por um especialista jurídico, cada uma com a cor esperada. Um caso esperado como vermelho que sair em outra cor reprova a homologação. A acurácia nas demais cores é apenas informada, sem reprovar a homologação. O registro completo de cada triagem é guardado para auditoria e homologação.

Relação com outros projetos da Sigil Labs

O assistente é construído sobre o Libriq, plataforma da Sigil Labs que transforma documentos em uma base consultável com citação de origem. Aqui o Libriq apenas recupera as passagens, sem gerar texto, e a biblioteca consultada fica restrita aos documentos aprovados.

É o mesmo critério do Libriq: a resposta chega acompanhada da fonte e vem de um acervo conhecido.

Perguntas frequentes

O que é o assistente jurídico no Microsoft Teams?

É um bot da Sigil Labs, desenvolvido para uma grande empresa, que recebe perguntas jurídicas no Microsoft Teams e as classifica em verde, amarelo ou vermelho antes de responder. Ele responde somente a partir de uma biblioteca de documentos aprovada e registra cada interação para auditoria.

O que acontece quando uma pergunta é classificada como vermelha?

O assistente não responde ao mérito. Ele devolve um texto institucional fixo de recusa e avisa o time jurídico por mensagem proativa no Teams, informando quem perguntou, o que foi perguntado e o gatilho que classificou a pergunta como vermelha.

De onde o assistente tira as respostas?

As respostas vêm de passagens recuperadas de uma biblioteca de documentos aprovada, sincronizada a partir do SharePoint, e citam as fontes encontradas. Sem fonte citável, a resposta nunca é classificada como verde.

O assistente substitui um advogado?

Não. Ele faz a triagem inicial, não emite parecer jurídico formal e nunca decide sozinho um caso sensível. Se houver incerteza, a pergunta recebe vermelho e segue para o time jurídico.

As conversas com o assistente ficam registradas?

Sim. Por decisão de projeto, a identidade do usuário e o texto das perguntas são gravados em um banco PostgreSQL, para auditoria e homologação. Os logs técnicos não guardam o conteúdo das perguntas nem das respostas, e o relatório semanal é anonimizado.

Em que estágio está o assistente?

É uma prova de conceito. O e-mail formal de escalada ficou fora desta etapa.

← Todos os projetos