RAI_TRANSPARENCY.md
GraphRAG is an AI-based content interpretation and search capability. Using LLMs, it parses data to create a knowledge graph and answer user questions about a user-provided private dataset.
GraphRAG can connect information across large volumes of data and use these connections to answer questions that are difficult or impossible to answer using keyword- and vector-based search mechanisms. This enables a system using GraphRAG to answer questions whose answers span many documents, as well as thematic questions such as “What are the top themes in this dataset?”
GraphRAG has been evaluated in multiple ways. The primary concerns are 1) accurate representation of the dataset, 2) transparency and groundedness of responses, 3) resilience to prompt and data corpus injection attacks, and 4) low hallucination rates. Details on how each concern was evaluated are outlined below.
Accurate representation of the dataset has been tested through both manual inspection and automated testing against a “gold answer” created from randomly selected subsets of a test corpus.
Transparency and groundedness of responses are tested through automated answer coverage evaluation and human inspection of the returned context.
We test both user prompt injection attacks (“jailbreaks”) and cross-prompt injection attacks (“data attacks”) using manual and semi-automated techniques.
Hallucination rates are evaluated using claim coverage metrics, manual inspection of answers and sources, and attempts to force hallucinations through adversarial and exceptionally challenging datasets.
GraphRAG depends on well-constructed indexing prompts. For general applications (for example, content about people, places, organizations, or things), we provide example prompts. For unique datasets, effective indexing can depend on properly identifying domain-specific concepts.
Indexing is a relatively expensive operation. To mitigate its cost, create a small test dataset in the target domain to evaluate indexer performance before running large indexing operations.
GraphRAG is designed for users with domain expertise and experience working through difficult information challenges. While the approach is generally robust to injection attacks and can identify conflicting sources of information, the system is designed for trusted users. Human analysis of responses is important for generating reliable insights, and information provenance should be traced to verify the inferences made during answer generation.
GraphRAG yields the most effective results on natural-language text data focused on an overall topic or theme and rich in identifiable entities such as people, places, or objects.
While GraphRAG has been evaluated for resilience to prompt and data corpus injection attacks and probed for specific types of harm, the configured LLM may produce inappropriate or offensive content. This may make GraphRAG unsuitable for sensitive contexts without additional mitigations specific to the use case and model. Developers should assess outputs for their context and use available safety classifiers, model-specific safety filters and features (such as Azure AI Content Safety), or custom solutions appropriate for their use case.