8954fa3ad7
Native CLI i18n: The TrustGraph CLI has built-in translation support that dynamically loads language strings. You can test and use different languages by simply passing the --lang flag (e.g., --lang es for Spanish, --lang ru for Russian) or by configuring your environment's LANG variable. Automated Docs Translations: This PR introduces autonomously translated Markdown documentation into several target languages, including Spanish, Swahili, Portuguese, Turkish, Hindi, Hebrew, Arabic, Simplified Chinese, and Russian.
5 KiB
| layout | title | parent |
|---|---|---|
| default | API Ağ Geçidi Değişiklikleri: v1.8'den v2.1'e | Turkish (Beta) |
API Ağ Geçidi Değişiklikleri: v1.8'den v2.1'e
Beta Translation: This document was translated via Machine Learning and as such may not be 100% accurate. All non-English languages are currently classified as Beta.
Özet
API ağ geçidi, gömülü sorgular için yeni WebSocket hizmet yönlendiricileri, belge içeriği için yeni bir REST akış uç noktası kazandı ve ⟦CODE_0⟧'dan ⟦CODE_1⟧'e önemli bir veri formatı değişikliğine uğradı. "objects" hizmeti "rows" olarak yeniden adlandırıldı.
sorguları, belge içeriği için yeni bir REST akış uç noktası ve aşağıdaki değişiklikleri içerdi:
önemli bir tel format değişikliği, Value'dan Term'e geçiş. "Nesneler"
--
Yeni WebSocket Hizmet Yönlendiricileri
Bunlar, WebSocket üzerinden sunulan yeni istek/yanıt servisleridir.
/api/v1/socket adresindeki çoklayıcı (akış kapsamlı):
| Servis Anahtarı | Açıklama |
|---|---|
document-embeddings |
Metin benzerliği ile belge parçalarını sorgular. İstek/yanıt, DocumentEmbeddingsRequest/DocumentEmbeddingsResponse şemalarını kullanır. |
row-embeddings |
İndekslenmiş alanlarda metin benzerliği ile yapılandırılmış veri satırlarını sorgular. İstek/yanıt, RowEmbeddingsRequest/RowEmbeddingsResponse şemalarını kullanır. |
Bunlar, mevcut graph-embeddings dağıtım aracına (v1.8'de zaten
bulunan ancak güncellenmiş olabilecek) eklenir.
WebSocket akış hizmeti dağıtım araçlarının tam listesi (v2.1)
İstek/yanıt hizmetleri (/api/v1/flow/{flow}/service/{kind} veya
WebSocket çoklayıcısı aracılığıyla):
agent, text-completion, prompt, mcp-tool
graph-rag, document-rag
embeddings, graph-embeddings, document-embeddings
triples, rows, nlp-query, structured-query, structured-diag
row-embeddings
--
Yeni REST Uç Noktası
| Yöntem | Yol | Açıklama |
|---|---|---|
GET |
/api/v1/document-stream |
Kütüphaneden belge içeriğini ham baytlar olarak aktarır. Sorgu parametreleri: user (gerekli), document-id (gerekli), chunk-size (isteğe bağlı, varsayılan 1MB). Belge içeriğini, dahili olarak base64'ten çözülmüş olarak, parçalı aktarım kodlamasıyla döndürür. |
--
Yeniden Adlandırılan Hizmet: "objects" -> "rows"
| v1.8 | v2.1 | Notlar |
|---|---|---|
objects_query.py / ObjectsQueryRequestor |
rows_query.py / RowsQueryRequestor |
Şema, ObjectsQueryRequest/ObjectsQueryResponse'den RowsQueryRequest/RowsQueryResponse'ye dönüştürüldü. |
objects_import.py / ObjectsImport |
rows_import.py / RowsImport |
Yapılandırılmış veri için import yöneticisi. |
WebSocket hizmet anahtarı "objects"'dan "rows"'e değişti ve
import yöneticisi anahtarı da benzer şekilde "objects"'dan "rows"'e değişti.
--
Kablo Formatındaki Değişiklik: Değerden Terime
Seri hale getirme katmanı (serialize.py), yeni Term'i kullanmak üzere yeniden yazıldı.
eski Value türünün yerine bu türü kullanın.
Eski format (v1.8 — Value)
{"v": "http://example.org/entity", "e": true}
v: değer (string)
e: değerin bir URI olup olmadığını gösteren boolean işaretleyici
Yeni format (v2.1 — Term)
IRIs:
{"t": "i", "i": "http://example.org/entity"}
Sabitler:
{"t": "l", "v": "some text", "d": "datatype-uri", "l": "en"}
Tırnak içinde belirtilen üçlüler (RDF-star):
{"t": "r", "r": {"s": {...}, "p": {...}, "o": {...}}}
t: tür belirleyici — "i" (IRI), "l" (literal), "r" (tırnak içinde belirtilmiş üçlü), "b" (boş düğüm)
Serileştirme artık trustgraph.messaging.translators.primitives'den TermTranslator ve TripleTranslator'e devrediliyor.
Diğer serileştirme değişiklikleri
| Alan | v1.8 | v2.1 |
|---|---|---|
| Meta veri | metadata.metadata (alt grafik) |
metadata.root (basit değer) |
| Grafik gömme varlığı | entity.vectors (çoğul) |
entity.vector (tekil) |
| Belge gömme parçası | chunk.vectors + chunk.chunk (metin) |
chunk.vector + chunk.chunk_id (ID referansı) |
--
Uyumsuz Değişiklikler
Value'dan Term'e kablo formatı: Ağ geçidi üzerinden üçlü, gömme veya varlık bağlamı gönderen/alan tüm istemcilerin, yeni Terim formatına güncellenmesi gerekir.
objects'dan rows'e yeniden adlandırma: WebSocket hizmet anahtarı ve içe aktarma anahtarı değiştirildi.
Meta veri alanı değişikliği: metadata.metadata (serileştirilmiş bir alt grafik), metadata.root (basit bir değer) ile değiştirildi.
Gömme alanı değişiklikleri: vectors (çoğul), vector (tekil) haline geldi; belge gömmeleri artık iç içe chunk metni yerine chunk_id'yi referans alıyor.
Yeni /api/v1/document-stream uç noktası: Uyumsuz değil, eklemeli.