DocuInsight İmza Sürecini Kolaylaştırıyor

Etkinlikler

15 Eylül 2025: DocuInsight emekliye ayrıldı ancak artık tamamen açık kaynak olarak github.com/eandf/DocuInsight adresinde mevcut ve belgeleri eandf.github.io/DocuInsight adresinde bulunmaktadır. Orijinal alan adı 2027 yılına kadar buraya yönlendirilmektedir.

27 Ocak 2025: DocuInsight, Mehmet Yilmaz ve Dylan Eck tarafından 2024-2025 DocuSign Hackathon Unlocked için oluşturulmuştur. www.docuinsight.ai adresini veya canlı demomuzu kontrol edin. Bu gönderi, Devpost başvurumuz temel alınarak hazırlanmıştır.

Hakkında

DocuInsight, anahtar maddeleri vurgulayarak, bunları sade İngilizceye çevirerek ve e-imzalar için DocuSign ile entegre olarak yasal sözleşmeleri basitleştiren bir platformdur, ayrıca yasal uzmanlara erişim sunar.

DocuInsight, önemli sözleşme detaylarının yasal jargonun arkasında gizli kaldığı ve insanların haklarını veya yükümlülüklerini tam olarak anlamadan imza attığı “Anlaşma Tuzağı"nı çözmek için oluşturulmuştur. Vizyonumuz, herhangi bir anlaşmanın her iki tarafının, imzalayanlar ve gönderenler, imza atmadan önce tam bir netlik kazanmasına yardımcı olmaktır. Ayrıca, kullanıcıların kişisel danışmanlık alması gerektiğinde yasal profesyonellerle bağlantı kurmalarını sağlayacak basit bir yol sunmak istedik.

Aralık 2024 ile Ocak 2025 arasında DocuSign Hackathon için geliştirilen DocuInsight, DocuSign’ın teknolojisi ile entegre olarak anlaşmaları veya şablonları içe aktarmakta, metin analizi için OpenAI API’sini kullanmakta ve sözleşme hakkında soruları yanıtlayabilen bir sohbet arayüzü sunmaktadır. Bu bilgi boşluğunu kapatmanın, herkesin karışıklığını, yasal anlaşmazlıklarını ve kaçırılan fırsatlarını azaltacağına inanıyoruz.

Demo

İlham

2024’ün başlarında, yakın bir arkadaşım ile bir girişim kurdum. Ona güvenerek, başlangıçta şirket sözleşmelerini tam olarak incelemeden imzaladım. Şirketin MVP’lerini geliştirmek için önemli zaman ve uzmanlık harcadıktan sonra, arkadaşım ek hisse senetlerini kullanarak ya hisselerimi azaltmamı ya da şirketten çıkarılmamı zorladı. Bir avukat bulduktan sonra, istemeden önemli hakları imzaladığımı ve kendimi veya şirketi etkili bir şekilde savunamayacağımı öğrendim. Bir zamanlar yakın olan arkadaşımın bencil ve dikkatsiz davranışları nedeniyle, anlaşmazlık kişisel olarak beni zorladı ve şirkete değerli zaman kaybettirdi. Bu deneyim, yasal anlaşmalardaki her detayı anlamanın kişisel hakları korumak ve organizasyonel istikrarı sağlamak için kritik önemini öğretti.

Ne yapar

Özellikler ve İşlevsellik:

  1. Açık Sözleşme Özeti: DocuInsight, yasal belgeleri analiz etmek ve özlü özetler oluşturmak için gelişmiş AI modellerini kullanır. Bu özetler, anahtar maddeleri, alışılmadık terimleri, potansiyel riskleri ve büyük taahhütleri vurgulayarak kullanıcılara sözleşmenin net ve anlaşılır bir genel görünümünü sağlar.

  2. Etkileşimli Sohbet Arayüzü: AI destekli sohbet özelliği, kullanıcıların sözleşmeleriyle “konuşmalarını” sağlar. Belirli maddeler, anlaşmanın genel amacı veya ilgili yasal kavramlar hakkında sorular sorabilirler. Sohbet botu ayrıca, güvenilir ve güncel bilgiler sağlamak için web’de tarama yapabilir.

  3. Avukat Önerileri: Ek yasal yardım arayan kullanıcılar için, DocuInsight, kullanıcının konumu ve incelediği sözleşme türüne göre avukatları önermek için optimize edilmiş arama sorguları oluşturur. Arama sonuçları, yasal profesyonellerin iletişim bilgilerini ve incelemelerini içerir, bu da kullanıcılara uzmanlarla bağlantı kurma konusunda eyleme geçirilebilir bir yol sunar.

  4. Geliştirilmiş İmza Süreci: DocuInsight, DocuSign’ın mevcut imza iş akışı ile sorunsuz bir şekilde entegre olur. Kullanıcılar e-posta ile giriş yapar, DocuSign hesaplarını şablonlara erişmek için bağlar ve imzalamak için belgeleri gönderir. Gönderildikten sonra, alıcı belgeyi gözden geçirebilir, AI tarafından üretilen içgörülerle etkileşimde bulunabilir ve standart DocuSign platformunda olduğu gibi imza atabilir.

  5. İmza Sonrası Erişim: İmzaladıktan sonra, kullanıcılar imzalanmış anlaşmayı gözden geçirmek, AI içgörülerine erişmek ve takip soruları için sohbet arayüzü ile etkileşimde bulunmak üzere orijinal bağlantıyı tekrar ziyaret edebilirler. Bu, imzalayanların anlaşmaları hakkında sürekli netlik sağlamasını garanti eder.

Bu özellikler, DocuInsight’i yasal sözleşmelerin karmaşıklıklarını basitleştiren güçlü bir araç haline getirir. AI destekli içgörüleri, etkileşimli desteği ve DocuSign ile sorunsuz entegrasyonu birleştirerek, DocuInsight imzalayanların bilinçli kararlar vermesini sağlar, gönderenlerin dağıttıkları anlaşmalara güven inşa etmelerine yardımcı olur ve yasal profesyonellere daha fazla yardım arayan kullanıcılarla bağlantı kurma fırsatları sunar. Amacımız, anlaşma sürecinde şeffaflık, güven ve erişilebilirliği teşvik etmek, yasal metni daha anlaşılır ve herkes için daha adil hale getirmektir.

DocuInsight’i kullanarak özelliklerini net bir şekilde gösteren bir video görmek isterseniz, bu ek videoya göz atın (bu bizim demo videomuz değil, sadece daha fazla ayrıntı isteyenler için ek bir kaynak):

Nasıl inşa ettik

DocuInsight üç ana bölümden oluşmaktadır:

  • Veritabanı: Tüm işleri, raporları, kullanıcı verilerini vb. depolar. Projenin gerekli verilerini içerir.
  • Frontend: Projenin kullanıcı arayüzü, kullanıcıların gördüğü ve etkileşimde bulunduğu kısımdır.
  • Analizör: Yasal sözleşmeleri analiz etmek ve e-posta göndermekten sorumlu bir arka uç hizmetidir.

Bu proje için bir veritabanı kullanıldı. Veritabanı PostgreSQL’di ve Supabase üzerinde barındırıldı. Hem Frontend hem de Analizör, Supabase’in API’sini SDK’ları aracılığıyla kullanarak veritabanına erişti. Veritabanı kurulumu üç tablodan oluşuyordu: biri kullanıcılar için, biri işler için ve biri raporlar için. Kullanıcılar tablosu, kimlik doğrulama için ve hesapları takip etmek için kullanılır. İşler tablosu, analiz edilmesi gereken sözleşmeleri takip eder. Raporlar tablosu, Analizör tarafından üretilen sözleşmelere dair tüm raporları depolar.

Frontend, Next.js adlı bir frontend çerçevesi kullanılarak inşa edildi. Bu çerçevede HTML, Tailwind CSS, JavaScript, TypeScript ve React kullandık. Bu teknolojiler, frontend’in dinamik ve duyarlı bir şekilde çalışmasını ve içerik göstermesini sağladı. Ayrıca, frontend’de birkaç API kullandık:

  • OpenAI’nin API’si: Her imza oturumu için sohbet botunu barındırmak ve çalıştırmak için.
  • DocuSign’ın API’si: Özellikle, eSignature API’si tüm imza süreçlerini yönetmek ve kullanıcıların DocuSign hesaplarından DocuInsight’te şablonlarına kolay erişim sağlamak için kullanıldı.
  • Tavily API: LLM’ler için tasarlanmış özel bir arama motoru API’si, sohbet botunun web’de tarama yapmasına ve en son haberleri veya güncellemeleri almasına olanak tanır.
  • Resend API: Öncelikle frontend’deki giriş süreçleri için tüm e-posta ile ilgili görevleri yönetmek için kullanıldı.
  • Supabase API: Projenin veritabanına CRUD işlemleri gerçekleştirmek için Supabase üzerinde erişildi.

Frontend tamamen Vercel’de barındırılmaktadır, bu hizmet Next.js çerçevesinin yaratıcıları tarafından geliştirilmiştir.

Analizör Python kullanılarak inşa edildi. Yasal sözleşmeleri analiz etmek için OpenAI’nin API’sini, OpenAI’nin en gelişmiş modellerinden biri olan o1-preview kullanarak çalıştırır. Ayrıca, DocuInsight’te bir sözleşmeyi imzalamak için gereken e-posta veya makbuzu göndermek amacıyla e-postaları göndermek için Resend API’sini kullanır. Analizör, kullanıcıların kritik bir şeyin bozulması veya gerçekleşmesi durumunda uyarılar almasını sağlamak için Discord webhook’larını destekler. Projenin geri kalanında olduğu gibi, Analizör de projenin veritabanına erişmek için Supabase’i kullanır.

Analizör için kod, aşağıdaki paketleri içerir:

  • PyMuPDF, openpyxl, python-docx ve OpenAI’nin o1-preview modeli: PDF, DOCX, DOC, JPG ve PNG gibi çeşitli dosya türlerinin içeriğini yüklemek için.

Analizör, en az 4 GB RAM’e sahip bir Linode örneğinde barındırılmakta ve işletim sistemi olarak Ubuntu çalıştırmaktadır.

Karşılaştığımız zorluklar

DocuInsight’i inşa etmek, teknik ve pratik zorluklarla doluydu. Kullanıcı verilerinin korunmasını sağlarken veritabanımıza sorunsuz bir şekilde bağlanan güvenli kimlik doğrulamanın nasıl uygulanacağını bulmamız gerekiyordu. İstediğimiz işlevsellik için DocuSign API’sinin hangi bölümlerini kullanacağımızı anlamak çok fazla deneme yanılma gerektirdi. Frontend’i iyi bir kullanıcı deneyimi sağlamak için yapılandırmak ve mevcut DocuSign imza sürecine LLM işlevselliği gibi gelişmiş özellikleri entegre etmek de doğru bir şekilde yapmak için zordu. Sohbet arayüzü için sunucudan istemciye gerçek zamanlı veri akışı sağlamak zordu, ayrıca avukatları önermek için bir yol bulmak da zordu çünkü yasal profesyoneller için API aracılığıyla kolayca erişilebilir veya uygun fiyatlı bir veri seti yoktu. Sohbet botunun yanıltmalarını en aza indirmek ve yanıtlarını daha güvenilir hale getirmek için web tarama mantığı inşa etmemiz gerekti. Son olarak, projeyi üretim için hazır hale getirmek en zor kısımdı. Bir şeyi yerel olarak bir demo için inşa etmek ve çalıştırmak bir şeydir, ancak bunu web’de yüksek çalışma süresi ve güvenilirlikle dağıtmak tamamen farklı bir zorluktur, böylece herkes erişebilir. Üretimdeki tek bir hata kötü bir izlenim bırakabilir, bu nedenle istikrar sağlamak kritik ve son derece zordu.

Gurur duyduğumuz başarılar

DocuInsight’i başarıyla dağıttığımız ve herkesin kullanımına sunulduğu için gururluyuz. DocuSign ile sorunsuz bir şekilde entegre olan, gerçek dünya kullanımını yöneten ve güvenilir AI destekli içgörüler sunan üretime hazır bir uygulama oluşturmak önemli bir başarıydı. Bir demo için yerel olarak inşa etmek bir şeydir, ancak her şeyin yüksek çalışma süresi ile canlı bir ortamda çalıştığından emin olmak, üstesinden geldiğimiz bir zorluktu ve bununla gurur duyuyoruz.

Öğrendiklerimiz

Bu proje boyunca, DocuInsight gibi bir çözüm oluşturmanın başlangıçta tahmin ettiğimizden çok daha karmaşık olduğunu fark ettik. Hukuki belgeleri ayrıştırmak, doğruluğu sağlamak ve AI yeteneklerini uygun fiyatlarla dengelemek dikkatli düşünme ve sürekli yineleme gerektiriyordu. Ayrıca, doğru video prodüksiyonunun önemini de öğrendik. Demomuzun projemizin değerini etkili bir şekilde iletmesini sağlamak için, son tarihten iki hafta önce videoya çalışmaya başladık ve cilalı bir nihai ürün sunmak için profesyonel film ekipmanları kullandık. Ayrıca, bu tür projeleri ölçeklendirmenin benzersiz zorluklar sunduğunu gördük. İçeriği analiz etmek için gelişmiş AI modellerini çağırmak hesaplama açısından maliyetli olduğundan, en zeki modelleri kullanmak ile çözümün maliyet etkinliğini sağlamak arasında dikkatli bir denge kurmamız gerekiyordu. Son olarak, DocuInsight’in gerçek değer sağlayabileceğinden emin olmak için web taraması yaparak, potansiyel kullanıcılarla konuşarak ve avukatlarla danışarak temel pazar araştırması yaptık. Bu süreç, anlamlı bir şey inşa etmenin, sadece bir çözüm yaratmak için değil, etkisini doğrulamayı gerektirdiğini öğretti.

DocuInsight için sırada ne var

DocuInsight’i daha derin sözleşme analizi için daha gelişmiş AI ajanları geliştirerek, daha iyi içgörüler için vektörleştirilmiş veri setlerini rafine ederek ve imzacıları ve işletmeleri kendi bölgelerindeki hukuk profesyonelleriyle bağlamak için daha kapsamlı bir avukat dizini oluşturarak genişletmeyi planlıyoruz. Gelecek özellikler arasında hukuki emsal referansı için bir SEC dava arama aracı gibi araçlar yer alıyor. Amacımız, imzacıların, gönderenlerin ve işletmelerin daha fazla değer elde etmesini sağlarken, anlaşmalarda güven ve şeffaflığı teşvik etmektir.