trustgraph/docs/tech-specs/query-time-explainability.hi.md

layout	title	parent
default	क्वेरी-टाइम एक्सप्लेनेबिलिटी (Query-Time Explainability)	Hindi (Beta)

क्वेरी-टाइम एक्सप्लेनेबिलिटी (Query-Time Explainability)

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.

स्थिति (Status)

कार्यान्वित (Implemented)

अवलोकन (Overview)

यह विनिर्देश बताता है कि GraphRAG क्वेरी निष्पादन के दौरान एक्सप्लेनेबिलिटी डेटा को कैसे रिकॉर्ड और संचारित करता है। इसका लक्ष्य पूर्ण पता लगाने की क्षमता है: अंतिम उत्तर से लेकर चयनित किनारों तक और फिर स्रोत दस्तावेजों तक।

क्वेरी-टाइम एक्सप्लेनेबिलिटी यह कैप्चर करती है कि GraphRAG पाइपलाइन तर्क के दौरान क्या करती है। यह निष्कर्षण-समय के प्रमाण से जुड़ा है, जो रिकॉर्ड करता है कि ज्ञान ग्राफ तथ्यों की उत्पत्ति कहाँ से हुई।

शब्दावली (Terminology)

शब्द	परिभाषा
एक्सप्लेनेबिलिटी (Explainability)	यह रिकॉर्ड है कि एक परिणाम कैसे प्राप्त किया गया
सेशन (Session)	एक एकल GraphRAG क्वेरी निष्पादन
एज सिलेक्शन (Edge Selection)	तर्क के साथ प्रासंगिक किनारों का LLM-संचालित चयन
प्रूवेनेंस चेन (Provenance Chain)	किनारे → चंक → पृष्ठ → दस्तावेज़ से पथ

आर्किटेक्चर (Architecture)

एक्सप्लेनेबिलिटी फ्लो (Explainability Flow)

GraphRAG Query
    │
    ├─► Session Activity
    │       └─► Query text, timestamp
    │
    ├─► Retrieval Entity
    │       └─► All edges retrieved from subgraph
    │
    ├─► Selection Entity
    │       └─► Selected edges with LLM reasoning
    │           └─► Each edge links to extraction provenance
    │
    └─► Answer Entity
            └─► Reference to synthesized response (in librarian)

दो-चरणीय ग्राफआरएजी पाइपलाइन

1. एज चयन: एलएलएम सबग्राफ से प्रासंगिक किनारों का चयन करता है, प्रत्येक के लिए तर्क प्रदान करता है।
2. संश्लेषण: एलएलएम केवल चयनित किनारों से उत्तर उत्पन्न करता है।

यह अलगाव व्याख्यात्मकता को सक्षम बनाता है - हमें ठीक से पता है कि किन किनारों ने योगदान दिया।

भंडारण

व्याख्यात्मकता ट्रिपल कॉन्फ़िगर करने योग्य संग्रह में संग्रहीत हैं (डिफ़ॉल्ट: explainability)। यह स्रोत संबंधों के लिए प्रोवी-ओ ऑन्टोलॉजी का उपयोग करता है। किनारे संदर्भों के लिए आरडीएफ-स्टार रीफिकेशन। उत्तर सामग्री लाइब्रेरियन सेवा में संग्रहीत है (इनलाइन नहीं - बहुत बड़ा)।

वास्तविक समय स्ट्रीमिंग

व्याख्यात्मकता घटनाएँ क्लाइंट को क्वेरी निष्पादित होने के दौरान स्ट्रीम की जाती हैं:

1. सत्र बनाया गया → घटना उत्सर्जित।
2. किनारे पुनर्प्राप्त किए गए → घटना उत्सर्जित।
3. तर्क के साथ किनारे चुने गए → घटना उत्सर्जित।
4. उत्तर संश्लेषित → घटना उत्सर्जित।

क्लाइंट को explain_id और explain_collection प्राप्त होते हैं ताकि पूर्ण विवरण प्राप्त किए जा सकें।

यूआरआई संरचना

सभी यूआरआई urn:trustgraph: नेमस्पेस का उपयोग करते हैं जिसमें यूयूआईडी शामिल हैं:

इकाई	यूआरआई पैटर्न
सत्र	urn:trustgraph:session:{uuid}
पुनर्प्राप्ति	urn:trustgraph:prov:retrieval:{uuid}
चयन	urn:trustgraph:prov:selection:{uuid}
उत्तर	urn:trustgraph:prov:answer:{uuid}
किनारे का चयन	urn:trustgraph:prov:edge:{uuid}:{index}

आरडीएफ मॉडल (प्रोवी-ओ)

सत्र गतिविधि

<session-uri> a prov:Activity ;
    rdfs:label "GraphRAG query session" ;
    prov:startedAtTime "2024-01-15T10:30:00Z" ;
    tg:query "What was the War on Terror?" .

पुनर्प्राप्ति इकाई

<retrieval-uri> a prov:Entity ;
    rdfs:label "Retrieved edges" ;
    prov:wasGeneratedBy <session-uri> ;
    tg:edgeCount 50 .

चयन इकाई

<selection-uri> a prov:Entity ;
    rdfs:label "Selected edges" ;
    prov:wasDerivedFrom <retrieval-uri> ;
    tg:selectedEdge <edge-sel-0> ;
    tg:selectedEdge <edge-sel-1> .

<edge-sel-0> tg:edge << <s> <p> <o> >> ;
    tg:reasoning "This edge establishes the key relationship..." .

उत्तर इकाई

<answer-uri> a prov:Entity ;
    rdfs:label "GraphRAG answer" ;
    prov:wasDerivedFrom <selection-uri> ;
    tg:document <urn:trustgraph:answer:{uuid}> .

tg:document संदर्भ लाइब्रेरियन सेवा में संग्रहीत उत्तर को दर्शाता है।

नेमस्पेस स्थिरांक

trustgraph-base/trustgraph/provenance/namespaces.py में परिभाषित:

स्थिरांक	यूआरआई
TG_QUERY	https://trustgraph.ai/ns/query
TG_EDGE_COUNT	https://trustgraph.ai/ns/edgeCount
TG_SELECTED_EDGE	https://trustgraph.ai/ns/selectedEdge
TG_EDGE	https://trustgraph.ai/ns/edge
TG_REASONING	https://trustgraph.ai/ns/reasoning
TG_CONTENT	https://trustgraph.ai/ns/content
TG_DOCUMENT	https://trustgraph.ai/ns/document

GraphRagResponse स्कीमा

@dataclass
class GraphRagResponse:
    error: Error | None = None
    response: str = ""
    end_of_stream: bool = False
    explain_id: str | None = None
    explain_collection: str | None = None
    message_type: str = ""  # "chunk" or "explain"
    end_of_session: bool = False

संदेश प्रकार

संदेश_प्रकार	उद्देश्य
chunk	प्रतिक्रिया पाठ (स्ट्रीमिंग या अंतिम)
explain	आईआरआई संदर्भ के साथ व्याख्यात्मक घटना

सत्र जीवनचक्र

1. कई explain संदेश (सत्र, पुनर्प्राप्ति, चयन, उत्तर)
2. कई chunk संदेश (स्ट्रीमिंग प्रतिक्रिया)
3. end_of_session=True के साथ अंतिम chunk

एज चयन प्रारूप

एलएलएम चयनित किनारों के साथ JSONL लौटाता है:

{"id": "edge-hash-1", "reasoning": "This edge shows the key relationship..."}
{"id": "edge-hash-2", "reasoning": "Provides supporting evidence..."}

id, (labeled_s, labeled_p, labeled_o) का एक हैश है, जिसकी गणना edge_id() द्वारा की जाती है।

यूआरआई का संरक्षण

समस्या

GraphRAG, एलएलएम को समझने योग्य लेबल प्रदर्शित करता है, लेकिन स्पष्टीकरण के लिए मूल यूआरआई की आवश्यकता होती है ताकि स्रोत का पता लगाया जा सके।

समाधान

get_labelgraph() दोनों लौटाता है: labeled_edges: एलएलएम के लिए (label_s, label_p, label_o) की सूची uri_map: एक डिक्शनरी जो edge_id(labels) को (uri_s, uri_p, uri_o) से जोड़ती है।

जब व्याख्यात्मक डेटा संग्रहीत किया जाता है, तो uri_map से यूआरआई का उपयोग किया जाता है।

उत्पत्ति अनुरेखण

किनारे से स्रोत तक

चयनित किनारों को मूल दस्तावेजों तक वापस ट्रेस किया जा सकता है:

1. समाहित उपग्राफ के लिए क्वेरी करें: ?subgraph tg:contains <<s p o>>
2. मूल दस्तावेज़ तक prov:wasDerivedFrom श्रृंखला का पालन करें
3. श्रृंखला में प्रत्येक चरण: खंड → पृष्ठ → दस्तावेज़

कैसेंड्रा उद्धृत त्रिक समर्थन

कैसेंड्रा क्वेरी सेवा उद्धृत त्रिकों के मिलान का समर्थन करती है:

# In get_term_value():
elif term.type == TRIPLE:
    return serialize_triple(term.triple)

यह इस तरह के प्रश्नों को सक्षम करता है:

?subgraph tg:contains <<http://example.org/s http://example.org/p "value">>

कमांड लाइन इंटरफेस (CLI) का उपयोग

tg-invoke-graph-rag --explainable -q "What was the War on Terror?"

आउटपुट प्रारूप

[session] urn:trustgraph:session:abc123

[retrieval] urn:trustgraph:prov:retrieval:abc123

[selection] urn:trustgraph:prov:selection:abc123
    Selected 12 edge(s)
      Edge: (Guantanamo, definition, A detention facility...)
        Reason: Directly connects Guantanamo to the War on Terror
        Source: Chunk 1 → Page 2 → Beyond the Vigilant State

[answer] urn:trustgraph:prov:answer:abc123

Based on the provided knowledge statements...

विशेषताएं

क्वेरी के दौरान वास्तविक समय में व्याख्यात्मक घटनाएं। rdfs:label के माध्यम से एज घटकों के लिए लेबल समाधान। prov:wasDerivedFrom के माध्यम से स्रोत श्रृंखला का पता लगाना। बार-बार क्वेरी से बचने के लिए लेबल कैशिंग।

कार्यान्वित फाइलें

फ़ाइल	उद्देश्य
trustgraph-base/trustgraph/provenance/uris.py	यूआरआई जनरेटर
trustgraph-base/trustgraph/provenance/namespaces.py	आरडीएफ नेमस्पेस स्थिरांक
trustgraph-base/trustgraph/provenance/triples.py	ट्रिपल बिल्डर
trustgraph-base/trustgraph/schema/services/retrieval.py	GraphRagResponse स्कीमा
trustgraph-flow/trustgraph/retrieval/graph_rag/graph_rag.py	यूआरआई संरक्षण के साथ मुख्य GraphRAG
trustgraph-flow/trustgraph/retrieval/graph_rag/rag.py	लाइब्रेरियन एकीकरण के साथ सेवा
trustgraph-flow/trustgraph/query/triples/cassandra/service.py	उद्धृत ट्रिपल क्वेरी समर्थन
trustgraph-cli/trustgraph/cli/invoke_graph_rag.py	व्याख्यात्मक प्रदर्शन के साथ सीएलआई

संदर्भ

PROV-O (डब्ल्यू3सी प्रोवेनेंस ऑन्टोलॉजी): https://www.w3.org/TR/prov-o/ RDF-star: https://w3c.github.io/rdf-star/ निष्कर्षण-समय प्रोवेनेंस: docs/tech-specs/extraction-time-provenance.md