DocuInsight | Mehmet Yilmaz

Події

September 15, 2025: DocuInsight було припинено, але тепер повністю відкрито з відкритим кодом за адресою github.com/eandf/DocuInsight з документацією на eandf.github.io/DocuInsight. Оригінальний домен перенаправляє туди до 2027 року.

January 27, 2025: DocuInsight був створений Mehmet Yilmaz та Dylan Eck для хакатону 2024-2025 DocuSign Hackathon Unlocked. Перегляньте www.docuinsight.ai або нашу live demo. Цей пост базується на нашій Devpost submission.

Про

DocuInsight — це платформа, яка спрощує юридичні контракти, виділяючи ключові положення, перекладаючи їх простою англійською та інтегруючи з DocuSign для електронних підписів, а також надає доступ до юридичних експертів.

DocuInsight був створений для вирішення проблеми «ловушки угоди», коли важливі деталі контракту залишаються прихованими за юридичним жаргоном, змушуючи людей підписувати, не розуміючи повністю своїх прав чи зобов’язань. Наше бачення — допомогти обом сторонам будь-якої угоди, підписантам і відправникам, отримати повну ясність перед підписанням. Крім того, ми хотіли надати простий спосіб користувачам зв’язатися з юридичними професіоналами, якщо їм потрібна персональна консультація.

Розроблений у грудні 2024 – січні 2025 року для хакатону DocuSign, DocuInsight інтегрується з технологією DocuSign для імпорту угод або шаблонів, використовує API OpenAI для аналізу тексту та пропонує чат‑інтерфейс, який може відповідати на питання щодо контракту або надавати джерела для пошуку юристів. Ми віримо, що подолання цього розриву в знаннях зменшить плутанину, юридичні спори та втрачені можливості для всіх учасників.

Демонстрація

Натхнення

На початку 2024 року я співавзаснував стартап з близьким другом. Довіряючи йому, я підписав початкові контракти компанії, не переглянувши їх ретельно. Після того, як я вклав значний час і експертизу у розробку MVP компанії без оплати, мій друг використав свою додаткову частку, щоб змусити мене або зменшити мої акції, або виключити мене з компанії. Знайшовши юриста, я виявив, що випадково відмовився від важливих прав і не міг ефективно захищати себе чи компанію. Через егоїстичну та безвідповідальну поведінку колишнього близького друга, конфлікт сильно вразив мене особисто і коштував компанії цінний час. Цей досвід навчив мене критичної важливості розуміння кожної деталі юридичних угод для захисту особистих прав і забезпечення стабільності організації.

Що воно робить

Функції та можливості:

Clear Contract Summaries: DocuInsight використовує передові AI‑моделі для аналізу юридичних документів і створення стислих резюме. Ці резюме виділяють ключові положення, незвичні умови, потенційні ризики та основні зобов’язання, надаючи користувачам чіткий і зрозумілий огляд контракту.
Interactive Chat Interface: Функція чату, підкріплена ШІ, дозволяє користувачам «розмовляти» зі своїм контрактом. Вони можуть ставити питання про конкретні положення, загальну мету угоди або пов’язані юридичні концепції. Чат‑бот також може переглядати веб‑сторінки, щоб надавати добре підкріплену, точну та актуальну інформацію, забезпечуючи надійні відповіді.
Lawyer Recommendations: Для користувачів, які шукають додаткову юридичну допомогу, DocuInsight генерує оптимізовані запити пошуку, щоб рекомендувати юристів на основі місцезнаходження користувача та типу контракту, який вони переглядають. Результати пошуку включають контактні дані та відгуки про юридичних професіоналів, даючи користувачам практичний спосіб зв’язатися з експертами.
Enhanced Signing Process: DocuInsight безшовно інтегрується з існуючим робочим процесом підписання DocuSign. Користувачі входять у систему за допомогою електронної пошти, підключають свій обліковий запис DocuSign для доступу до шаблонів і надсилають документи на підписання. Після надсилання одержувач може переглянути документ, взаємодіяти з AI‑згенерованими інсайтами та підписати його так, як у стандартній платформі DocuSign.
Post-Signing Access: Після підписання користувачі можуть повернутися до свого документа за оригінальним посиланням, щоб переглянути підписану угоду, отримати AI‑інсайти та продовжити спілкування в чат‑інтерфейсі для подальших питань. Це забезпечує підписантам постійну ясність щодо їхніх угод.

Ці функції роблять DocuInsight потужним інструментом для спрощення складності юридичних контрактів. Поєднуючи AI‑запроваджені інсайти, інтерактивну підтримку та безшовну інтеграцію з DocuSign, DocuInsight дає підписантам можливість приймати обґрунтовані рішення, допомагає відправникам будувати довіру до розповсюджуваних угод і надає юридичним професіоналам можливості зв’язатися з користувачами, які шукають додаткову допомогу. Наша мета — сприяти прозорості, довірі та доступності в процесі укладання угод, роблячи юридичний текст легшим для розуміння та справедливішим для всіх.

Якщо ви хочете побачити чітке відео, де ми використовуємо DocuInsight і демонструємо його функції, перегляньте це додаткове відео, яке ми створили (це НЕ наше демо‑відео, а лише додатковий ресурс, якщо людям потрібні детальніші відомості):

Як ми це створили

DocuInsight складається з трьох основних частин:

Database: Зберігає всі завдання, звіти, дані користувачів тощо. Містить необхідні дані про проєкт.
Frontend: UI проєкту, те, що бачать і з чим взаємодіють користувачі.
Analyzer: Бекенд‑служба, відповідальна за аналіз юридичних контрактів та надсилання електронних листів.

Для цього проєкту використано базу даних. База даних була PostgreSQL і розміщувалась на Supabase. Як Frontend, так і Analyzer отримували доступ до бази даних через API Supabase за допомогою їх SDK. Налаштування бази даних включало три таблиці: одну для користувачів, одну для завдань і одну для звітів. Таблиця користувачів використовується для автентифікації та відстеження облікових записів. Таблиця завдань відстежує контракти, які потрібно проаналізувати. Таблиця звітів зберігає всі звіти про контракти, згенеровані Analyzer‑ом.

Frontend був створений за допомогою фреймворку Next.js. У цьому фреймворку ми використовували HTML, Tailwind CSS, JavaScript, TypeScript та React. Ці технології дозволили фронтенду функціонувати та динамічно, адаптивно відображати контент. Крім того, у фронтенді ми використали кілька API:

OpenAI’s API: Для розгортання та запуску чат‑бота для кожної сесії підписання.
DocuSign’s API: Зокрема, eSignature API використовувався для обробки всіх процесів підписання та забезпечення легкого доступу користувачів до їх шаблонів DocuSign у DocuInsight.
Tavily API: Спеціалізований API пошукової системи, розроблений для LLM, що дозволяє чат‑боту переглядати веб‑сторінки та отримувати останні новини чи оновлення.
Resend API: Використовується для обробки всіх завдань, пов’язаних з електронною поштою, головним чином для процесів входу у фронтенді.
Supabase API: Доступ до бази даних проєкту, розміщеної на Supabase, для виконання CRUD‑операцій.

Frontend повністю розміщений на Vercel, хостинг‑сервісі, розробленому творцями фреймворку Next.js.

Analyzer був створений за допомогою Python. Він використовує OpenAI’s API для аналізу юридичних контрактів за допомогою однієї з найпросунутіших моделей OpenAI, o1-preview. Також він використовує Resend API для надсилання електронних листів, головним чином для надсилання квитанції або листа, необхідного для підписання контракту в DocuInsight. Analyzer підтримує Discord‑webhooks, дозволяючи користувачам отримувати сповіщення, якщо під час роботи Analyzer‑а виникає критична помилка. Як і решта проєкту, Analyzer використовував Supabase для доступу до бази даних проєкту.

Код Analyzer‑а включає пакети, такі як:

PyMuPDF, openpyxl, python-docx та OpenAI’s o1-preview model: Для завантаження вмісту різних типів файлів, включаючи PDF, DOCX, DOC, JPG та PNG.

Analyzer розміщений на інстанції Linode з мінімум 4 ГБ ОЗУ, працюючи під управлінням Ubuntu.

Виклики, з якими ми зіткнулися

Створення DocuInsight було сповнене технічних і практичних викликів. Нам довелося розібратися, як реалізувати безпечну автентифікацію, що безшовно підключається до нашої бази даних, забезпечуючи захист даних користувачів. Розуміння, які саме частини API DocuSign потрібні для потрібної функціональності, вимагало багато проб і помилок. Структурування фронтенду для забезпечення хорошого користувацького досвіду та інтеграція передових функцій, таких як LLM, у існуючий процес підписання DocuSign, також були складними. Потокове передавання даних у реальному часі з сервера до клієнта для чат‑інтерфейсу було складним, як і пошук способу рекомендації юристів, оскільки немає легко доступного чи доступного набору даних про юридичних професіоналів через API. Нам довелося створити логіку веб‑перегляду для чат‑бота, щоб мінімізувати галюцинації та підвищити надійність відповідей. Нарешті, підготовка проєкту до продакшн‑випуску була найскладнішою частиною. Локальна розробка та демонстрація — це одне, а розгортання в інтернеті з високою доступністю та надійністю, щоб будь-хто міг отримати доступ, — зовсім інший виклик. Одна помилка в продакшн може залишити погане враження, тому забезпечення стабільності було критично важливим і надзвичайно складним.

Досягнення, якими ми пишаємося

We are proud of successfully deploying DocuInsight and making it accessible for anyone to use. Building a production-ready application that integrates seamlessly with DocuSign, handles real-world usage, and delivers reliable AI-powered insights was a significant achievement. It is one thing to build locally for a demo, but ensuring everything works in a live environment with high uptime was a challenge we are proud to have overcome.

Чого ми навчилися

Throughout this project, we realized that building a solution like DocuInsight was far more complex than we initially anticipated. Parsing legal documents, ensuring accuracy, and balancing AI capabilities with affordability required careful thought and constant iteration. We also learned the importance of proper video production. To ensure our demo effectively communicated our project’s value, we started working on the video two weeks before the deadline, using professional film equipment to deliver a polished final product. Additionally, scaling projects like this presented unique challenges. Calling advanced AI models to analyze content is computationally expensive, so we had to carefully balance using the most intelligent models with making the solution cost-effective. Finally, we conducted basic market research by browsing the web, speaking with potential users, and consulting lawyers to ensure DocuInsight could provide real value. This process taught us that building something meaningful requires validating its impact rather than simply creating a solution for the sake of it.

Що далі для DocuInsight

We plan to expand DocuInsight by developing more advanced AI agents for deeper contract analysis, refining vectorized datasets for better insights, and creating a more comprehensive directory of lawyers to connect signers and businesses with legal professionals in their area. Future features include tools like an SEC case search to reference legal precedents. Our goal is to deliver even more value to signers, senders, and businesses while fostering trust and transparency in agreements.