CLI में परिवर्तन: v1.8 से v2.1
सारांश
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 हटा दिए गए।
