trustgraph/docs/cli-changes-v1.8-to-v2.1.hi.md
Alex Jenkins 8954fa3ad7 Feat: TrustGraph i18n & Documentation Translation Updates (#781)
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.
2026-04-14 12:08:32 +01:00

14 KiB

layout title parent
default CLI में परिवर्तन: v1.8 से v2.1 Hindi (Beta)

CLI में परिवर्तन: v1.8 से v2.1

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.

सारांश

CLI (trustgraph-cli) में तीन मुख्य क्षेत्रों पर ध्यान केंद्रित किए गए महत्वपूर्ण परिवर्धन शामिल हैं: व्याख्यात्मकता/उत्पत्ति, एम्बेडिंग एक्सेस, और ग्राफ़ क्वेरी। दो पुरानी उपकरण हटा दिए गए थे, एक का नाम बदल दिया गया, और कई मौजूदा उपकरणों में नई क्षमताएं जोड़ी गईं।


नए CLI उपकरण

व्याख्यात्मकता और उत्पत्ति

कमांड विवरण
tg-list-explain-traces एक संग्रह में सभी व्याख्या सत्रों (GraphRAG और एजेंट) की सूची, जिसमें सत्र आईडी, प्रकार, प्रश्न पाठ और टाइमस्टैम्प शामिल हैं।
tg-show-explain-trace किसी सत्र के लिए पूरी व्याख्यात्मक ट्रेस प्रदर्शित करता है। GraphRAG के लिए: प्रश्न, खोज, ध्यान केंद्रित, संश्लेषण चरण। एजेंट के लिए: सत्र, पुनरावृत्तियाँ (सोच/क्रिया/अवलोकन), अंतिम उत्तर। स्वचालित रूप से ट्रेस प्रकार का पता लगाता है। --show-provenance का उपयोग करके स्रोत दस्तावेजों तक किनारों को ट्रेस करने का समर्थन करता है।
tg-show-extraction-provenance एक दस्तावेज़ आईडी दिए जाने पर, prov:wasDerivedFrom संबंधों का उपयोग करके उत्पत्ति श्रृंखला को पार करता है: दस्तावेज़ -> पृष्ठ -> खंड -> किनारे। --show-content और --max-content विकल्पों का समर्थन करता है।

एम्बेडिंग

कमांड विवरण
tg-invoke-embeddings एम्बेडिंग सेवा के माध्यम से टेक्स्ट को वेक्टर एम्बेडिंग में परिवर्तित करता है। एक या अधिक टेक्स्ट इनपुट स्वीकार करता है, और फ़्लोट की सूची के रूप में वेक्टर लौटाता है।
tg-invoke-graph-embeddings वेक्टर एम्बेडिंग का उपयोग करके ग्राफ संस्थाओं को क्वेरी करता है। मिलान संस्थाओं और समानता स्कोर लौटाता है।
tg-invoke-document-embeddings वेक्टर एम्बेडिंग का उपयोग करके दस्तावेज़ खंडों को क्वेरी करता है। मिलान खंड आईडी और समानता स्कोर लौटाता है।
tg-invoke-row-embeddings इंडेक्स किए गए फ़ील्ड पर टेक्स्ट समानता का उपयोग करके संरचित डेटा पंक्तियों को क्वेरी करता है। मिलान पंक्तियों और स्कोर लौटाता है। --schema-name और --index-name का समर्थन करता है।

ग्राफ़ क्वेरी

कमांड विवरण
tg-query-graph पैटर्न-आधारित ट्रिपल स्टोर क्वेरी। tg-show-graph (जो सब कुछdumps करता है) के विपरीत, यह किसी भी संयोजन के विषय, विधेय, वस्तु और ग्राफ़ द्वारा चयनशील क्वेरी की अनुमति देता है। स्वचालित रूप से मूल्य प्रकार का पता लगाता है: IRI (http://..., urn:..., <...>), उद्धृत ट्रिपल (<<s p o>>), और अक्षर।
tg-get-document-content लाइब्रेरी से दस्तावेज़ आईडी द्वारा दस्तावेज़ सामग्री प्राप्त करता है। फ़ाइल या stdout पर आउटपुट कर सकता है, और टेक्स्ट और बाइनरी सामग्री दोनों को संभालता है।

हटाए गए CLI उपकरण

कमांड नोट्स
tg-load-pdf हटा दिया गया। दस्तावेज़ लोडिंग अब लाइब्रेरी/प्रसंस्करण पाइपलाइन के माध्यम से संभाली जाती है।
tg-load-text हटा दिया गया। दस्तावेज़ लोडिंग अब लाइब्रेरी/प्रसंस्करण पाइपलाइन के माध्यम से संभाली जाती है।

नाम बदले गए CLI उपकरण

पुराना नाम नया नाम नोट्स
tg-invoke-objects-query tg-invoke-rows-query संरचित डेटा के लिए "ऑब्जेक्ट" से "पंक्ति" के शब्दावली में बदलाव को दर्शाता है।

मौजूदा उपकरणों में महत्वपूर्ण परिवर्तन

tg-invoke-graph-rag

  • व्याख्यात्मकता समर्थन: 4-चरण व्याख्यात्मक पाइपलाइन (प्रश्न, ग्राउंडिंग/खोज, ध्यान केंद्रित, संश्लेषण) का समर्थन करता है जिसमें इनलाइन उत्पत्ति घटना प्रदर्शन भी शामिल है।
  • स्ट्रीमिंग: वास्तविक समय के आउटपुट के लिए WebSocket स्ट्रीमिंग का उपयोग करता है।
  • उत्पत्ति ट्रेसिंग: पुनरावर्तन और prov:wasDerivedFrom श्रृंखलाओं के माध्यम से चयनित किनारों को स्रोत दस्तावेजों तक ट्रेस कर सकता है।
  • ~30 पंक्तियों से ~760 पंक्तियों तक बढ़ गया है ताकि पूरे व्याख्यात्मक पाइपलाइन को समायोजित किया जा सके।

tg-invoke-document-rag

  • व्याख्यात्मकता समर्थन: question_explainable() मोड जोड़ा गया जो दस्तावेज़ RAG प्रतिक्रियाओं को इनलाइन उत्पत्ति घटनाओं (प्रश्न, ग्राउंडिंग, खोज, संश्लेषण चरण) के साथ प्रवाहित करता है।

tg-invoke-agent

  • व्याख्यात्मकता समर्थन: question_explainable() मोड जोड़ा गया जो एजेंट निष्पादन के दौरान इनलाइन उत्पत्ति घटनाओं (प्रश्न, विश्लेषण, निष्कर्ष, एजेंटसोच, एजेंटअवलोकन, एजेंटउत्तर) को प्रदर्शित करता है।
  • वर्बोस मोड में, इमोजी उपसर्ग के साथ सोच/अवलोकन धाराओं को दिखाया जाता है।

tg-show-graph

  • स्ट्रीमिंग मोड: triples_query_stream() का उपयोग करता है जिसमें कम समय-से-पहले-परिणाम और कम मेमोरी ओवरहेड के लिए कॉन्फ़िगरेबल बैच आकार होते हैं।
  • नाम वाले ग्राफ़ समर्थन: नया --graph फ़िल्टर विकल्प। निम्नलिखित नाम वाले ग्राफ़ को पहचानता है:
    • डिफ़ॉल्ट ग्राफ़ (खाली): मुख्य ज्ञान तथ्य
    • urn:graph:source: निष्कर्षण उत्पत्ति
    • urn:graph:retrieval: क्वेरी-समय व्याख्यात्मकता
  • ग्राफ़ कॉलम दिखाना: --show-graph ध्वज जोड़ा गया।
  • कॉन्फ़िगरेबल सीमाएँ: नए --limit और --batch-size विकल्प।

tg-graph-to-turtle

  • RDF-स्टार समर्थन: उद्धृत ट्रिपल (RDF-स्टार पुनरावर्तन) को संभालता है।
  • स्ट्रीमिंग मोड: कम समय-से-पहले-प्रसंस्करण के लिए स्ट्रीमिंग का उपयोग करता है।
  • वायर फॉर्मेट हैंडलिंग: नई वायर फॉर्मेट ({"t": "i", "i": uri} के लिए IRI, {"t": "l", "v": value} के लिए अक्षर, {"t": "r", "r": {...}} के लिए उद्धृत ट्रिपल) का उपयोग करने के लिए अपडेट किया गया है।
  • नाम वाले ग्राफ़ समर्थन: नया --graph फ़िल्टर विकल्प।

tg-set-tool

  • नया उपकरण प्रकार: संरचित डेटा सूचकांकों पर अर्थपूर्ण खोज के लिए row-embeddings-query
  • नया विकल्प: संरचित डेटा क्वेरी टूल के लिए --schema-name, --index-name, --limit विकल्प जोड़े गए।

tg-show-tools

  • row-embeddings-query के नए उपकरण प्रकार और उसके schema-name, index-name और limit फ़ील्ड को प्रदर्शित करता है।

tg-load-knowledge

  • प्रगति रिपोर्टिंग: प्रत्येक फ़ाइल और कुल में लोड किए गए ट्रिपल और संस्था संदर्भों की गणना और रिपोर्ट करता है।
  • टर्म फॉर्मेट अपडेट: संस्था संदर्भ अब नए टर्म फॉर्मेट ({"t": "i", "i": uri}) का उपयोग करते हैं, जबकि पुराने मूल्य फॉर्मेट ({"v": entity, "e": True}) का उपयोग किया जाता था।

ब्रेकिंग परिवर्तन

  • शब्दावली का नाम बदलना: Value स्कीम को पूरे सिस्टम में Term नाम दिया गया है (PR #622)। यह CLI टूल के लिए जो ग्राफ स्टोर के साथ इंटरैक्ट करते हैं, उनके वायर फॉर्मेट को प्रभावित करता है। नया फॉर्मेट {"t": "i", "i": uri} IRI के लिए और {"t": "l", "v": value} अक्षर के लिए, पिछले {"v": ..., "e": ...} फॉर्मेट के स्थान पर उपयोग करता है।
  • tg-invoke-objects-query को tg-invoke-rows-query में नाम बदला गया
  • tg-load-pdf और tg-load-text हटा दिए गए