DocuInsight İmzalamayı Basitleştiriyor

Etkinlikler

15 Eylül 2025: DocuInsight kullanımdan kaldırıldı ancak artık tamamen açık kaynaklı olarak github.com/eandf/DocuInsight adresinde bulunuyor ve dokümantasyon eandf.github.io/DocuInsight üzerinde mevcut. Orijinal alan adı 2027 yılına kadar oraya yönlendiriyor.

27 Ocak 2025: DocuInsight, Mehmet Yilmaz ve Dylan Eck tarafından 2024-2025 DocuSign Hackathon Unlocked için oluşturuldu. www.docuinsight.ai adresine veya bizim canlı demomuza göz atabilirsiniz. Bu yazı, bizim Devpost başvurumuz temel alınarak hazırlanmıştır.

Hakkında

DocuInsight, önemli maddeleri vurgulayarak, bunları sade İngilizceye çevirerek ve e-imzalar için DocuSign ile entegre olarak sözleşmeleri basitleştiren ve ayrıca hukuk uzmanlarına erişim sunan bir platformdur.

DocuInsight, esas sözleşme ayrıntılarının hukuki jargonun arkasında gizlendiği ve insanların haklarını veya yükümlülüklerini tam olarak anlamadan imzalamasına yol açan “Sözleşme Tuzakları”nı çözmek amacıyla oluşturuldu. Vizyonda, herhangi bir sözleşmenin her iki tarafının—imzalayanlar ve gönderenler—imzalamadan önce tam netliğe ulaşmasına yardımcı olmak vardı. Ayrıca, kullanıcıların kişiselleştirilmiş danışmanlık ihtiyaçları olduğunda hukuk profesyonelleriyle kolayca bağlantı kurabilmeleri için basit bir yol sunmak istedik.

Aralık 2024’ten Ocak 2025’e kadar DocuSign Hackathon için geliştirilen DocuInsight, anlaşmaları veya şablonları içe aktarmak için DocuSign’in teknolojisiyle entegre olur, metin analizi için OpenAI API’sini kullanır ve sözleşmeyle ilgili soruları yanıtlayabilen veya avukat bulma kaynakları sağlayabilen bir sohbet arayüzü sunar. Bu bilgi boşluğunu kapatmanın, karışıklığı, hukuki anlaşmazlıkları ve tüm taraflar için kaçırılan fırsatları azaltacağına inanıyoruz.

Canlı Gösterim

İlham Kaynağı

2024’ün başlarında, yakın bir arkadaşımla bir girişim kurdum. Ona güvenerek, başlangıç şirket sözleşmelerini tam olarak incelemeden imzaladım. Şirkete ücret almadan önemli zaman ve uzmanlık yatırımı yaptıktan sonra, arkadaşım ek hissesi kullanarak hisselerimi azaltmamı ya da şirketten çıkarılmamı zorladı. Bir avukat bulduğumda fark ettim ki istemeden önemli haklarımı imzalamış ve kendimi ya da şirketi etkili bir şekilde savunamaz hale gelmiştim. Bir zamanlar yakın olan arkadaşımın bencil ve düşüncesiz davranışları nedeniyle yaşanan bu anlaşmazlık beni kişisel olarak zorladı ve şirkete değerli bir zaman kaybettirdi. Bu deneyim, hukukî anlaşmalardaki her ayrıntıyı anlamanın kişisel hakları korumak ve örgütsel istikrarı sağlamak açısından ne kadar kritik olduğunu öğretti.

Ne Yapar

DocuInsight’ın temel özellikleri ve işlevleri şunlardır:

  1. Açık Sözleşme Özetleri: DocuInsight, hukuki belgeleri analiz etmek ve özlü özetler üretmek için gelişmiş yapay zeka modelleri kullanır. Bu özetler, ana maddeleri, alışılmadık şartları, potansiyel riskleri ve büyük taahhütleri vurgulayarak kullanıcılara sözleşmenin net ve anlaşılabilir bir genel görünümünü sağlar.

  2. Etkileşimli Sohbet Arayüzü: Yapay zeka destekli sohbet özelliği, kullanıcıların sözleşmeleriyle “konuşmasına” olanak tanır. Kullanıcılar belirli maddeler, anlaşmanın genel amacı veya ilgili hukuki kavramlar hakkında soru sorabilir. Sohbet botu ayrıca web’i tarayarak iyi kaynaklı, doğru ve güncel bilgiler sağlayabilir; böylece kullanıcılar güvenilir yanıtlar alır.

  3. Avukat Önerileri: Ek hukuki yardım arayan kullanıcılar için DocuInsight, kullanıcının konumuna ve incelediği sözleşme türüne göre avukat önermek için optimize edilmiş arama sorguları üretir. Arama sonuçları, hukuk profesyonellerinin iletişim bilgilerini ve yorumlarını içerir; kullanıcılara uzmanlarla bağlantı kurmaları için eyleme geçirilebilir bir yol sunar.

  4. Geliştirilmiş İmzalama Süreci: DocuInsight, DocuSign’in mevcut imzalama iş akışıyla sorunsuz bir şekilde entegre olur. Kullanıcılar e-postalarıyla giriş yapar, DocuInsight üzerinde şablonlarına erişmek için DocuSign hesaplarını bağlar ve belgeleri imzaya gönderir. Gönderildiğinde, alıcı belgeyi gözden geçirebilir, yapay zekâ tarafından üretilen içgörülerle etkileşime girebilir ve standart DocuSign platformunda olduğu gibi imzalayabilir.

  5. İmzalama Sonrası Erişim: İmzalamadan sonra kullanıcılar, sözleşmeye ait orijinal bağlantı üzerinden imzalanmış belgeyi yeniden görüntüleyebilir, yapay zekâ içgörülerine erişebilir ve takip soruları için sohbet arayüzüyle etkileşime devam edebilir. Bu, imzalayanların sözleşmeleri hakkında sürekli netliğe sahip olmalarını sağlar.

Bu özellikler, DocuInsight’ı hukuk sözleşmelerinin karmaşıklıklarını basitleştiren güçlü bir araç haline getirir. Yapay zeka destekli içgörüleri, etkileşimli desteği ve DocuSign ile sorunsuz entegrasyonu birleştirerek DocuInsight, imzalayanların bilinçli kararlar almasını güçlendirir, gönderenlerin dağıttıkları anlaşmalara güven inşa etmelerine yardımcı olur ve hukuk profesyonellerine daha fazla yardımcı olmak isteyen 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 ederek hukuki metinleri herkes için daha anlaşılır ve adil hale getirmektir.

Eğer DocuInsight’ı kullanırken bizi açıkça gösteren bir video görmek isterseniz, daha fazla ayrıntı isteyenler için hazırladığımız ek videoya bakın (bu bizim demo videomuz DEĞİL, sadece daha fazla ayrıntı isteyenler için ek bir kaynaktır):

Nasıl İnşa Ettik

DocuInsight üç ana bölümden oluşur:

  • Veritabanı: Tüm işleri, raporları, kullanıcı verilerini vb. saklar. Projenin gereken verilerini içerir.
  • Ön Uç: Projenin kullanıcıların gördüğü ve etkileşime geçtiği kullanıcı arayüzü.
  • Analizör: Hukuki sözleşmeleri analiz etmekten ve e-posta göndermekten sorumlu arka uç servisi.

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

Ön Uç, Next.js adlı bir ön uç çerçevesi kullanılarak oluşturuldu. Bu çerçevede HTML, Tailwind CSS, JavaScript, TypeScript ve React kullandık. Bu teknolojiler, ön ucun dinamik ve duyarlı olarak çalışmasını ve içerik göstermesini sağladı. Ayrıca ön uçta birkaç API kullandık:

  • OpenAI API’si: Her imzalama oturumu için sohbet botunu barındırmak ve çalıştırmak için.
  • DocuSign API’si: Özellikle eSignature API’si, tüm imzalama süreçlerini yönetmek ve kullanıcıların DocuInsight üzerindeki DocuSign hesaplarındaki şablonlarına kolay erişim sağlamak için kullanıldı.
  • Tavily API: Sohbet botunun web’i taramasına ve en son haberleri veya güncellemeleri getirmesine olanak tanıyan, LLM’ler için tasarlanmış özel bir arama motoru API’si.
  • Resend API: Başlıca ön uçtaki giriş işlemleri için olmak üzere tüm e-posta ile ilgili görevlerin yönetimi için kullanıldı.
  • Supabase API: Supabase üzerinde barındırılan projenin veritabanına erişip CRUD işlemleri gerçekleştirmek için kullanıldı.

Ön uç tam olarak Next.js çerçevesinin geliştiricileri tarafından oluşturulan Vercel üzerinde barındırılıyor.

Analizör Python kullanılarak oluşturuldu. OpenAI API’sini, hukuki sözleşmeleri OpenAI’nin en gelişmiş modellerinden biri olan o1-preview kullanarak analiz etmek için kullanıyor. Ayrıca Resend API’sini e-postaları göndermek için kullanıyor; başlıca DocuInsight üzerinde bir sözleşme imzalamak için gereken e-postayı veya makbuzu göndermek için. Analizör, çalışırken kritik bir sorun oluştuğunda kullanıcıların uyarı alabilmesi için Discord webhook’larını destekliyor. Projenin diğer bölümleri gibi Analizör de projenin veritabanına erişmek için Supabase’i kullandı.

Analizörün kodu PyMuPDF, openpyxl, python-docx ve OpenAI’nin o1-preview modeli gibi paketleri içerir: PDF, DOCX, DOC, JPG ve PNG dahil ç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ılır ve işletim sistemi olarak Ubuntu çalıştırır.

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

DocuInsight’ı inşa etmek teknik ve pratik zorluklarla doluydu. Veritabanımıza sorunsuz bağlanan güvenli kimlik doğrulamayı nasıl uygulayacağımızı bulmamız; kullanıcı verilerinin korunmasını sağlarken önemliydi. İstediğimiz işlevsellik için DocuSign API’sinin hangi bölümlerinin kullanılacağını anlamak, çok sayıda deneme-yanılma gerektirdi. İyi bir kullanıcı deneyimi sağlamak üzere ön ucu yapılandırmak ve LLM gibi gelişmiş özellikleri mevcut DocuSign imzalama sürecine entegre etmek de doğru yapmak açısından zordu. Sohbet arayüzü için sunucudan istemciye gerçek zamanlı veri akışı sağlamak zorlu idi; ayrıca avukat önerme konusunda uygun bir API aracılığıyla kolay erişilebilen veya uygun maliyetli bir veri kümesi bulunmaması işleri zorlaştırdı. Sohbet botunun halüsinasyonlarını en aza indirmek ve yanıtlarını daha güvenilir kılmak için web tarama mantığı kurmak zorunda kaldık. Son olarak, projeyi üretim düzeyine getirmek en zor kısmıydı. Bir şeyi demo için yerelde kurup çalıştırmak bir şeydir; ancak yüksek kullanılabilirlik ve güvenilirlik ile webde dağıtmak, herkesin erişebileceği şekilde sunmak tamamen farklı bir meydan okumadır. Üretimde tek bir hata kötü bir izlenim bırakabilir, bu yüzden kararlılığı sağlamak kritik ve son derece zordu.

Gurur Duyduğumuz Başarılar

DocuInsight’i başarıyla dağıtmış olmaktan ve herkesin kullanımına sunmaktan gurur duyuyoruz. DocuSign ile sorunsuz bir şekilde bütünleşen, gerçek dünya kullanımını idare eden ve güvenilir yapay zeka destekli içgörüler sağlayan üretime hazır bir uygulama oluşturmak önemli bir başarıydı. Yerel olarak bir demo için geliştirmek başka bir şeydir; ancak her şeyin canlı bir ortamda yüksek çalışma süresiyle çalışmasını sağlamak, üstesinden gelmekten gurur duyduğumuz bir zorluktu.

Öğ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 belgelerin ayrıştırılması, doğruluğun sağlanması ve yapay zeka yeteneklerini uygun maliyetle dengelemek özenli düşünce ve sürekli yineleme gerektirdi. Ayrıca uygun video prodüksiyonunun önemini öğrendik. Demomuzun projemizin değerini etkili bir şekilde iletmesini sağlamak için son teslim tarihinden iki hafta önce videoya çalışmaya başladık ve profesyonel film ekipmanı kullanarak özenle hazırlanmış bir son ürün sunduk. Buna ek olarak, bu tür projeleri ölçeklendirmek benzersiz zorluklar ortaya koydu. İçeriği analiz etmek için gelişmiş yapay zeka modellerini çağırmak hesaplama açısından maliyetlidir, bu yüzden en zeki modelleri kullanmak ile çözümü maliyet etkin hale getirmek arasında dikkatli bir denge kurmak zorunda kaldık. Son olarak, DocuInsight’in gerçek değer sağlayabileceğinden emin olmak için webde gezinerek, potansiyel kullanıcılarla konuşarak ve avukatlarla danışarak temel piyasa araştırması yaptık. Bu süreç bize, anlamlı bir şey inşa etmenin yalnızca bir çözüm yaratmaktan ziyade etkinliğini 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ş yapay zeka ajanları geliştirerek, daha iyi içgörüler için vektörleştirilmiş veri kümelerini iyileştirerek ve imzalayanları ve işletmeleri bölgedeki hukuk profesyonelleriyle bağlamak için daha kapsamlı bir avukat dizini oluşturarak genişletmeyi planlıyoruz. Gelecekteki özellikler arasında hukuki emsallere başvurmak için bir SEC dava araması gibi araçlar yer alıyor. Amacımız, anlaşmalarda güven ve şeffaflığı teşvik ederken imzalayanlara, gönderenlere ve işletmelere daha fazla değer sunmak.