Sürüm 5.0.0 ile Dokümanlar Suite öncelikle doküman API'sini yeniden oluşturuyor. En büyük değişiklik: Bir belgenin içeriği ve meta verileri artık ayrıdır. Resmi sürüm notlarına ve güncelleme talimatlarına göre, önceki içerik yolu artık çağrılıyor formatted-contentalan content normal belge yanıtından çıkarılır ve okuma ve yazma için ayrı uç noktalar eklenir. Bu, mevcut API istemcileri için büyük bir değişikliktir.
Duyurudan sonra devamını okuyun
Dokümanlar Paketi, ekip işbirliğine yönelik açık kaynaklı bir düzenleyicidir ve Notion veya Google Dokümanlar'a üstün bir alternatif olarak kabul edilir. Hedef gruplar arasında kamu kurumları ve şirketler bulunmaktadır. Projenin arkasında Alman Kamu Yönetiminde Dijital Egemenlik Merkezi (ZenDiS) ve Fransız Bakanlıklar Arası Dijital Otoritesi (DINUM) yer alıyor.
Ayrı içerik ve meta veriler
Geliştiriciler d7a186a taahhüdündeki sert kesintinin nedeninden bahsediyor. Daha önce içerik değişiklikleri, diğer belge özellikleriyle aynı güncelleme uç noktasından geçiyordu. Basit bir yeniden adlandırma işlemiyle bile sunucu, içeriğin tamamını iletiyor ve S3 depolama alanında depolanan belgenin durumuna gereksiz yere erişiyordu. Artık bunun için ayrı bir son nokta var: PATCH /api/v1.0/documents/{document_id}/content/. Güncelleme talimatları beklenen yük olarak Base64 kodlu bir alanı gösteriyor content. İletilen belgenin durumu geçersizse sunucu şu şekilde yanıt verir: 400 Bad Request ve hata mesajı invalid yjs document. Yalnızca başlıklar veya görünürlük gibi meta verileri düzenlerseniz, artık belgenin gerçek içeriğini yanınızda taşımanıza gerek kalmaz.
Okumanın da ayrı bir bitiş noktası var. GET /api/v1.0/documents/{document_id}/content/ içeriği güncelleme talimatlarına göre yayınlar text/plain. 6b3d197'yi taahhüt etmek durumun böyle olduğunu gösteriyor StreamingHttpResponse ve 8192 baytlık bloklar kullanılmaktadır. Dosya arşivde eksikse uç nokta yine de HTTP 200'e boş bir gövde sağlar. Aynı taahhütteki testler aynı zamanda erişim matrisini de belgelemektedir: anonim kullanıcıların genel belgelere erişmesine izin verilmektedir; alacağınız kamuya açık olmayan belgeler için 401. Kimliği doğrulanmış, izni olmayan kullanıcılar kısıtlı moda atanır 403. Kodda proje “ham Yjs içeriklerinden” bahsediyor. Yjs, ortak veri türlerini otomatik olarak senkronize eden gerçek zamanlı bir işbirliği kitaplığıdır. Bu nedenle uç nokta, tamamen oluşturulmuş bir değişim formatı yerine bir belgenin işbirliğine dayalı ham durumunu sağlar.
Yeniden oluşturulmuş AI dönüştürücü ve bağlantı
Kendi kendine barındırıcılar için ikinci büyük haber, dönüştürme hizmetinin DocSpec 3.0.x'e güncellenmesidir. Çekme talebi no. 2220 özellikle Docker'ın ghcr.io/docspecio/api:3.0.0 uygulama koduyla birlikte güncellenmesi gerekir. Yeni istek formatı önceki sürümlerle uyumlu değildir; Yalnızca bir sayfayı güncellerseniz belge dönüşümünde hata riskiyle karşı karşıya kalırsınız. Çekme isteğinin kendisi de teknik değişikliği açıklıyor: çok parçalı yükleme yerine, müşteri artık belge içeriğini doğrudan istek gövdesine gönderiyor ve Content-Type VE Accept açık. Kendi Compose, Helm veya Kubernetes yapılandırmalarını sürdüren herkes, dönüştürücüyü ana yükseltme planlarına dahil etmelidir.
Ayrıca yeni AI boru hattı için Mistral bağlantısı da yenidir. b6efac3 taahhüdü, yapılandırmanıza bağlı olarak bir sağlayıcı seçimi sunar. OpenAIChatModel VEYA MistralModel kullanılmış. Bunun için ortam değişkenleri belgelerine bakın OPENAI_SDK_API_KEY, OPENAI_SDK_BASE_URL, MISTRAL_SDK_API_KEY VE MISTRAL_SDK_BASE_URL AÇIK. Güncelleme ifadeleri aynı zamanda önceki değişkenleri de adlandırır AI_API_KEY VE AI_BASE_URL İçinde OPENAI_SDK_* etrafında. Yapay zeka altyapılarının yöneticileri için önemli: Mistral yolu yalnızca uvicorn ile eşzamansız modda çalışır. Başlangıçta bu son kullanıcılar için çok az değişiklik gösterir; Yenilik, yalnızca OpenAI ile uyumlu muadillerini kullanmayan kurulumları hedefliyor.
Duyurudan sonra devamını okuyun
Küçük operasyonel ve ön uç iyileştirmeleri
Sürüm 5.0.0'da ayrıca işletim ve kullanıcı arayüzüne yönelik çeşitli pratik güncellemeler bulunmaktadır. Çekme İsteği #2241, Traefik'in farklı başlık adları kullandığını söyleyerek artık yapılandırılabilir iletilen kimlik doğrulama başlığını doğruluyor; Okunacak başlık konfigürasyon yoluyla ayarlanabilir HTTP_X_FORWARDED_URI ayarlamak. PR n'ye göre. 2222'ye göre, Crisp yardım işlevi ön uçtaki yardım menüsüne taşınacaktır: önceki düğme, uygulamanın örtüşen bölümlerine sahiptir.
Daha küçük ama kullanışlı düzeltmeler de var: PR #2028'e göre, arka uç artık sabitlenmiş belgeleri sıralıyor updated_at Belge ağacındaki azalan ve geçersiz taşıma işlemleri sunucu tarafından PR #2208'e göre tanınır 400 Bad Request ile yerine 500 Internal Server Error. Sürüm notlarında ayrıca çeşitli erişilebilirlik iyileştirmeleri ve küçük ön uç düzeltmeleri de listeleniyor.
Önemli olan nokta, 5.0.0 sürümünün büyük bir özellik sürümü değil, daha ziyade API istemcileri, kendi kendine barındırıcılar ve kendi eklenti hizmetlerinin operatörleri için net sonuçları olan bir arka uç ve altyapı dönüşümü olmasıdır. Son kullanıcılar çoğunlukla küçük kullanıcı arayüzü iyileştirmelerini görecektir. Ancak entegratörler için meta veriler, biçimlendirilmiş içerik ve ham içerik akışı arasındaki yeni ayrım, bazı ayarlamaları da beraberinde getiriyor.
(fo)
Bir yanıt yazın