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.
7 KiB
| layout | title | parent |
|---|---|---|
| default | CLI Değişiklikleri: v1.8'den v2.1'e | Turkish (Beta) |
CLI 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
CLI (trustgraph-cli), üç tema üzerine odaklanmış önemli eklemeler içerir:
açıklanabilirlik/kaynak, gömme erişimi ve graf sorgulama.
İki eski araç kaldırıldı, biri yeniden adlandırıldı ve birkaç mevcut araç
yeni yetenekler kazandı.
--
Yeni CLI Araçları
Açıklanabilirlik ve Kaynak
| Komut | Açıklama |
|---|---|
tg-list-explain-traces |
Bir koleksiyondaki tüm açıklanabilirlik oturumlarını (GraphRAG ve Agent) listeler, oturum kimliklerini, türü, soru metnini ve zaman damgalarını gösterir. |
tg-show-explain-trace |
Bir oturum için tam açıklanabilirlik izini görüntüler. GraphRAG için: Soru, Keşif, Odak, Sentez aşamaları. Agent için: Oturum, Yinelemeler (düşünce/eylem/gözlem), Son Cevap. İz türünü otomatik olarak algılar. --show-provenance ile kaynak belgelere kadar kenarları izlemeyi destekler. |
tg-show-extraction-provenance |
Bir belge kimliği verildiğinde, kaynak zincirini izler: Belge -> Sayfalar -> Parçalar -> Kenarlar, prov:wasDerivedFrom ilişkilerini kullanarak. --show-content ve --max-content seçeneklerini destekler. |
Gömme (Embeddings)
| Komut | Açıklama |
|---|---|
tg-invoke-embeddings |
Metni, gömme hizmeti aracılığıyla bir vektör gömmesine dönüştürür. Bir veya daha fazla metin girişi alır, vektörleri kayan nokta listeleri olarak döndürür. |
tg-invoke-graph-embeddings |
Vektör gömmelerini kullanarak grafik varlıklarını metin benzerliğiyle sorgular. Eşleşen varlıkları benzerlik puanlarıyla döndürür. |
tg-invoke-document-embeddings |
Vektör gömmelerini kullanarak belge parçalarını metin benzerliğiyle sorgular. Eşleşen parça kimliklerini benzerlik puanlarıyla döndürür. |
tg-invoke-row-embeddings |
Vektör gömmelerini kullanarak dizinlenmiş alanlarda yapılandırılmış veri satırlarını metin benzerliğiyle sorgular. Eşleşen satırları, indeks değerlerini ve puanları döndürür. --schema-name gerektirir ve --index-name'yi destekler. |
Graf Sorgulama
| Komut | Açıklama |
|---|---|
tg-query-graph |
Desen tabanlı üçlü depolama sorgusu. tg-show-graph'in aksine (her şeyi dökerek), bu, herhangi bir konu, yüklem, nesne ve graf kombinasyonuyla seçici sorgular yapmayı sağlar. Değer türlerini otomatik olarak algılar: IRI'lar (http://..., urn:..., <...>), tırnak işaretli üçlüler (<<s p o>>) ve literal'lar. |
tg-get-document-content |
Belge kimliğine göre kütüphaneden belge içeriğini alır. Dosyaya veya standart çıktıya yazabilir, hem metin hem de ikili içeriği işler. |
--
Kaldırılan CLI Araçları
| Komut | Notlar |
|---|---|
tg-load-pdf |
Kaldırıldı. Belge yükleme artık kütüphane/işlem hattı aracılığıyla yapılır. |
tg-load-text |
Kaldırıldı. Belge yükleme artık kütüphane/işlem hattı aracılığıyla yapılır. |
--
Yeniden Adlandırılan CLI Araçları
| Eski Ad | Yeni Ad | Notlar |
|---|---|---|
tg-invoke-objects-query |
tg-invoke-rows-query |
Yapılandırılmış veri için "nesneler" teriminin "satırlar" terimine dönüştürülmesini yansıtır. |
--
Mevcut Araçlara Yönelik Önemli Değişiklikler
tg-invoke-graph-rag
Açıklanabilirlik desteği: Artık, yerleşik kaynak olay gösterimiyle (Question, Grounding/Exploration, Focus, Synthesis) 4 aşamalı bir açıklanabilirlik işlem hattını destekler.
Akış: Gerçek zamanlı çıktı için WebSocket akışını kullanır.
Kaynak takibi: Seçilen kenarları yeniden yapılandırma ve prov:wasDerivedFrom zincirleri aracılığıyla kaynak belgelere kadar izleyebilir.
Tam açıklanabilirlik işlem hattını barındırmak için ~30 satırdan ~760 satıra yükseldi.
tg-invoke-document-rag
Açıklanabilirlik desteği: İçerik tabanlı yanıtları (Document RAG) yerleşik kaynak olaylarıyla (Question, Grounding, Exploration, Synthesis aşamaları) akışla gönderen question_explainable() modunu ekledi.
tg-invoke-agent
Açıklanabilirlik desteği: Ajan yürütülmesi sırasında kaynak olaylarını yerleşik olarak gösteren question_explainable() modunu ekledi (Question, Analysis, Conclusion, AgentThought, AgentObservation, AgentAnswer).
Ayrıntılı mod, düşünce/gözlem akışlarını emoji ön ekleriyle gösterir.
tg-show-graph
Akış modu: Daha düşük ilk sonuç süresi ve azaltılmış bellek yükü için yapılandırılabilir toplu boyutlarla triples_query_stream()'ı kullanır.
Adlandırılmış grafik desteği: Yeni --graph filtre seçeneği. Adlandırılmış grafikleri tanır:
Varsayılan grafik (boş): Temel bilgi gerçekleri
urn:graph:source: Çıkarma kaynağı
urn:graph:retrieval: Sorgu zamanı açıklanabilirliği
Grafik sütununu göster: Her üçlü için adlandırılmış grafiği görüntülemek için yeni --show-graph bayrağı.
Yapılandırılabilir sınırlar: Yeni --limit ve --batch-size seçenekleri.
tg-graph-to-turtle
RDF-star desteği: Artık tırnaklı üçlüleri (RDF-star yeniden yapılandırması) işler.
Akış modu: Daha düşük ilk işleme süresi için akışı kullanır.
Tel formatı işleme: IRIs için {"t": "i", "i": uri}, literal'lar için {"t": "l", "v": value} ve tırnaklı üçlüler için {"t": "r", "r": {...}} kullanan yeni terim tel formatını kullanmak üzere güncellendi.
Adlandırılmış grafik desteği: Yeni --graph filtre seçeneği.
tg-set-tool
Yeni araç türü: Yapılandırılmış veri dizinlerinde semantik arama için row-embeddings-query.
Yeni seçenekler: Satır gömme sorgu araçlarını yapılandırmak için --schema-name, --index-name, --limit.
tg-show-tools
schema-name, index-name ve limit alanlarıyla yeni row-embeddings-query araç türünü görüntüler.
tg-load-knowledge
İlerleme raporlama: Her dosya ve toplamda yüklenen üçlü ve varlık bağlamlarının sayısını sayar ve raporlar.
Terim formatı güncellemesi: Varlık bağlamları artık eski Değer formatının ({"v": entity, "e": True}) yerine yeni Terim formatını ({"t": "i", "i": uri}) kullanır.
--
Uyumluluk Sorunları
Terminoloji yeniden adlandırması: Value şeması, sistem genelinde Term olarak yeniden adlandırıldı (PR #622). Bu, grafik deposuyla etkileşimde bulunan CLI araçları tarafından kullanılan tel formatını etkiler. Yeni format, eski {"v": ..., "e": ...} formatının yerini alarak IRIs için {"t": "i", "i": uri} ve literal'lar için {"t": "l", "v": value} kullanır.
tg-invoke-objects-query yeniden adlandırıldı tg-invoke-rows-query.
tg-load-pdf ve tg-load-text kaldırıldı.