mirror of
https://github.com/trustgraph-ai/trustgraph.git
synced 2026-04-25 08:26:21 +02:00
121 lines
7 KiB
Markdown
121 lines
7 KiB
Markdown
|
---
|
|||
|
|
layout: default
|
|||
|
|
title: "CLI Değişiklikleri: v1.8'den v2.1'e"
|
|||
|
|
parent: "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ı.
|