DocuInsight

Eventos

15 de setembro de 2025: DocuInsight foi descontinuado, mas agora está totalmente de código aberto em github.com/eandf/DocuInsight com documentação em eandf.github.io/DocuInsight. O domínio original redireciona para lá até 2027.

27 de janeiro de 2025: DocuInsight foi criado por Mehmet Yilmaz e Dylan Eck para o [DocuSign Hackathon Unlocked] de 2024‑2025. Confira www.docuinsight.ai ou nossa live demo. Esta postagem baseia‑se em nossa Devpost submission.

Sobre

DocuInsight é uma plataforma que simplifica contratos legais ao destacar cláusulas‑chave, traduzi‑las para um inglês simples e integrar‑se ao DocuSign para assinaturas eletrônicas, além de oferecer acesso a especialistas jurídicos.

DocuInsight foi criado para resolver a “Armadilha do Acordo”, onde detalhes contratuais essenciais permanecem ocultos atrás de jargões jurídicos, fazendo com que as pessoas assinem sem entender plenamente seus direitos ou obrigações. Nossa visão é ajudar ambos os lados de qualquer acordo, signatários e remetentes, a obter clareza total antes de assinar. Além disso, queríamos oferecer uma maneira simples para que os usuários se conectem com profissionais jurídicos caso precisem de aconselhamento personalizado.

Desenvolvido de dezembro de 2024 a janeiro de 2025 para o DocuSign Hackathon, o DocuInsight integra‑se à tecnologia do DocuSign para importar acordos ou modelos, utiliza a API da OpenAI para análise de texto e oferece uma interface de chat que pode responder perguntas sobre o contrato ou fornecer fontes para encontrar advogados. Acreditamos que fechar essa lacuna de conhecimento reduzirá confusões, disputas jurídicas e oportunidades perdidas para todos os envolvidos.

Demonstração

Inspiração

No início de 2024, co‑fundei uma startup com um amigo próximo. Confiando nele, assinei os contratos iniciais da empresa sem revisá‑los completamente. Depois de investir tempo e expertise significativos no desenvolvimento dos MVPs da empresa sem receber pagamento, meu amigo usou sua participação adicional para me forçar a reduzir minhas ações ou ser removido da empresa. Ao encontrar um advogado, descobri que havia, inadvertidamente, renunciado a direitos importantes e não poderia me defender nem à empresa de forma eficaz. O comportamento egoísta e imprudente desse amigo próximo gerou uma disputa que me afetou pessoalmente e custou à empresa tempo valioso. Essa experiência me ensinou a importância crítica de entender cada detalhe em acordos legais para proteger direitos pessoais e garantir a estabilidade organizacional.

O que faz

Recursos e Funcionalidades:

  1. Resumos Claros de Contratos: DocuInsight usa modelos avançados de IA para analisar documentos jurídicos e gerar resumos concisos. Esses resumos destacam cláusulas‑chave, termos incomuns, riscos potenciais e compromissos principais, proporcionando aos usuários uma visão clara e compreensível do contrato.

  2. Interface de Chat Interativa: O recurso de chat alimentado por IA permite que os usuários “conversem” com seu contrato. Eles podem fazer perguntas sobre cláusulas específicas, o propósito geral do acordo ou conceitos jurídicos relacionados. O chatbot também pode navegar na web para fornecer informações bem‑sucedidas, precisas e atualizadas, garantindo respostas confiáveis.

  3. Recomendações de Advogados: Para usuários que buscam assistência jurídica adicional, o DocuInsight gera consultas de busca otimizadas para recomendar advogados com base na localização do usuário e no tipo de contrato que está sendo revisado. Os resultados de busca incluem detalhes de contato e avaliações de profissionais jurídicos, oferecendo aos usuários uma forma prática de se conectar com especialistas.

  4. Processo de Assinatura Aprimorado: DocuInsight integra‑se perfeitamente ao fluxo de trabalho de assinatura existente do DocuSign. Usuários fazem login com seu e‑mail, conectam sua conta DocuSign para acessar modelos e enviam documentos para assinatura. Uma vez enviados, o destinatário pode revisar o documento, interagir com os insights gerados pela IA e assinar como faria na plataforma padrão do DocuSign.

  5. Acesso Pós‑Assinatura: Após a assinatura, os usuários podem revisitar seu documento através do link original para revisar o acordo assinado, acessar os insights da IA e continuar interagindo com a interface de chat para perguntas de acompanhamento. Isso garante que os signatários mantenham clareza contínua sobre seus acordos.

Esses recursos tornam o DocuInsight uma ferramenta poderosa para simplificar as complexidades dos contratos legais. Ao combinar insights impulsionados por IA, suporte interativo e integração fluida com o DocuSign, o DocuInsight capacita os signatários a tomar decisões informadas, auxilia os remetentes a construir confiança nos acordos que distribuem e oferece aos profissionais jurídicos oportunidades de se conectar com usuários que buscam assistência adicional. Nosso objetivo é promover transparência, confiança e acessibilidade no processo de acordos, tornando o texto jurídico mais fácil de entender e mais justo para todos.

Se você quiser ver um vídeo claro de nós usando o DocuInsight e demonstrando seus recursos de forma nítida, confira este vídeo adicional que fizemos do DocuInsight em ação (este NÃO é nosso vídeo de demonstração, apenas um recurso extra caso as pessoas queiram mais detalhes):

Como construímos

DocuInsight consiste em três partes principais:

  • Banco de Dados: Armazena todos os trabalhos, relatórios, dados de usuários, etc. Contém os dados necessários ao projeto.
  • Frontend: A interface do usuário do projeto, o que os usuários veem e interagem.
  • Analyzer: Um serviço backend responsável por analisar contratos legais e enviar e‑mails.

Para este projeto, foi usado um banco de dados. O banco de dados era PostgreSQL e estava hospedado no Supabase. Tanto o Frontend quanto o Analyzer acessavam o banco de dados usando a API do Supabase através de seus SDKs. A configuração do banco de dados consistia em três tabelas: uma para usuários, uma para trabalhos e uma para relatórios. A tabela de usuários é usada para autenticação e para acompanhar contas. A tabela de trabalhos acompanha os contratos que precisam ser analisados. A tabela de relatórios armazena todos os relatórios sobre contratos gerados pelo Analyzer.

O Frontend foi construído usando um framework frontend chamado Next.js. Neste framework, usamos HTML, Tailwind CSS, JavaScript, TypeScript e React. Essas tecnologias permitiram que o frontend funcionasse e exibisse conteúdo de forma dinâmica e responsiva. Além disso, utilizamos várias APIs no frontend:

  • API da OpenAI: Para hospedar e executar o chatbot em cada sessão de assinatura.
  • API do DocuSign: Especificamente, a API eSignature foi usada para lidar com todos os processos de assinatura e fornecer acesso fácil aos modelos dos usuários em suas contas DocuSign no DocuInsight.
  • API da Tavily: Uma API de motor de busca especializada para LLMs, permitindo que o chatbot navegue na web e recupere as notícias ou atualizações mais recentes.
  • API da Resend: Usada para lidar com todas as tarefas relacionadas a e‑mail, principalmente para processos de login no frontend.
  • API do Supabase: Acessa o banco de dados do projeto hospedado no Supabase para executar operações CRUD.

O frontend está totalmente hospedado na Vercel, um serviço de hospedagem desenvolvido pelos criadores do framework Next.js.

O Analyzer foi construído usando Python. Ele usa a API da OpenAI para analisar contratos legais usando um dos modelos mais avançados da OpenAI, o1-preview. Também usa a API da Resend para enviar e‑mails, principalmente para enviar um recibo ou o e‑mail necessário para assinar um contrato no DocuInsight. O Analyzer suporta webhooks do Discord, permitindo que os usuários recebam alertas se algo crítico falhar ou ocorrer enquanto o Analyzer está em execução. Como o restante do projeto, o Analyzer usou o Supabase para acessar o banco de dados do projeto.

O código do Analyzer incorpora pacotes como:

  • PyMuPDF, openpyxl, python-docx e modelo o1-preview da OpenAI: Para carregar o conteúdo de vários tipos de arquivo, incluindo PDF, DOCX, DOC, JPG e PNG.

O Analyzer está hospedado em uma instância Linode com pelo menos 4 GB de RAM, executando Ubuntu como sistema operacional.

Desafios que enfrentamos

Construir o DocuInsight foi repleto de desafios técnicos e práticos. Tivemos que descobrir como implementar autenticação segura que se conectasse perfeitamente ao nosso banco de dados enquanto garantíamos que os dados dos usuários permanecessem protegidos. Entender quais partes da API do DocuSign usar para a funcionalidade desejada exigiu muita tentativa e erro. Estruturar o frontend para proporcionar uma boa experiência ao usuário e integrar recursos avançados como funcionalidade de LLM ao processo de assinatura existente do DocuSign também foi difícil de acertar. Transmitir dados em tempo real do servidor para o cliente na interface de chat foi complicado, assim como encontrar uma forma de recomendar advogados, já que não há um conjunto de dados acessível ou acessível economicamente para profissionais jurídicos via API. Tivemos que construir lógica de navegação na web para o chatbot a fim de minimizar alucinações e tornar suas respostas mais confiáveis. Por fim, tornar o projeto pronto para produção foi a parte mais difícil. É uma coisa construir e rodar algo localmente para uma demonstração, mas é um desafio completamente diferente implantá‑lo na web com alta disponibilidade e confiabilidade para que qualquer pessoa possa acessá‑lo. Uma única falha em produção poderia deixar uma má impressão, portanto garantir estabilidade foi crítico e extremamente difícil.

Conquistas das quais nos orgulhamos

We estamos orgulhosos de ter implantado com sucesso o DocuInsight e torná‑lo acessível para qualquer pessoa usar. Construir um aplicativo pronto para produção que se integra perfeitamente ao DocuSign, lida com uso no mundo real e fornece insights confiáveis alimentados por IA foi uma conquista significativa. É uma coisa construir localmente para uma demonstração, mas garantir que tudo funcione em um ambiente ao vivo com alta disponibilidade foi um desafio que temos orgulho de ter superado.

O que aprendemos

Ao longo deste projeto, percebemos que construir uma solução como o DocuInsight era muito mais complexo do que inicialmente antecipávamos. Analisar documentos legais, garantir precisão e equilibrar as capacidades de IA com a acessibilidade exigiu reflexão cuidadosa e iteração constante. Também aprendemos a importância de uma produção de vídeo adequada. Para garantir que nossa demonstração comunicasse efetivamente o valor do projeto, começamos a trabalhar no vídeo duas semanas antes do prazo, usando equipamentos de filmagem profissionais para entregar um produto final polido. Além disso, escalar projetos como este apresentou desafios únicos. Chamar modelos avançados de IA para analisar conteúdo é computacionalmente caro, então tivemos que equilibrar cuidadosamente o uso dos modelos mais inteligentes com a necessidade de tornar a solução econômica. Por fim, realizamos uma pesquisa de mercado básica navegando na web, conversando com usuários potenciais e consultando advogados para garantir que o DocuInsight pudesse oferecer valor real. Esse processo nos ensinou que construir algo significativo requer validar seu impacto, em vez de simplesmente criar uma solução por criar.

O que vem a seguir para o DocuInsight

Planejamos expandir o DocuInsight desenvolvendo agentes de IA mais avançados para análises de contrato mais profundas, refinando conjuntos de dados vetorizados para melhores insights e criando um diretório mais abrangente de advogados para conectar assinantes e empresas a profissionais jurídicos em sua região. Recursos futuros incluem ferramentas como uma busca de casos da SEC para referenciar precedentes legais. Nosso objetivo é oferecer ainda mais valor a assinantes, remetentes e empresas, ao mesmo tempo em que promovemos confiança e transparência nos acordos.