diff --git a/site/content/3.12/data-science/graphrag/web-interface.md b/site/content/3.12/data-science/graphrag/web-interface.md index 195659839a..7d05916626 100644 --- a/site/content/3.12/data-science/graphrag/web-interface.md +++ b/site/content/3.12/data-science/graphrag/web-interface.md @@ -3,8 +3,7 @@ title: How to use GraphRAG in the ArangoDB Platform web interface menuTitle: Web Interface weight: 5 description: >- - Learn how to create, configure, and run a full GraphRAG workflow in four steps - using the Platform web interface + Learn how to create, configure, and run a full GraphRAG workflow in just a few steps using the Platform web interface --- {{< tag "ArangoDB Platform" >}} @@ -19,9 +18,10 @@ the ArangoDB team. The entire process is organized into sequential steps within a **Project**: 1. Creating the importer service -2. Uploading your file and exploring the generated Knowledge Graph -3. Creating the retriever service -4. Chatting with your Knowledge Graph +2. Adding data sources +3. Exploring the generated Knowledge Graph +4. Creating the retriever service +5. Chatting with your Knowledge Graph ## Create a GraphRAG project @@ -35,12 +35,22 @@ To create a new GraphRAG project using the ArangoDB Platform web interface, foll a description for your project. 5. Click the **Create project** button to finalize the creation. +## Project Settings + +The **Project Settings** dialog allows you to configure and manage your +Importer and Retriever services. + +You can open the **Project Settings** dialog in two ways: +- In the **Data Sources** section, click **Add data source** and then click on + the **Open project settings** button. +- In the **Graph** section, click on the gear icon. + ## Configure the Importer service -Configure a service to import, parse, and retrieve all the needed data from a +Configure a service to import, parse, and extract all the needed data from a file. This service uses the LLM API provider and model of your choice. -After clicking on a project name, you are taken to a screen where you can +After opening the **Project Settings**, you are taken to a dialog where you can configure and start a new importer service job. Follow the steps below. {{< tabs "importer-service" >}} @@ -52,20 +62,20 @@ configure and start a new importer service job. Follow the steps below. 3. Enter your **OpenAI API Key**. 4. Click the **Start importer service** button. -![Configure Importer service using OpenAI](../../../images/graphrag-ui-configure-importer-openai.png) +![Configure Importer service using OpenAI](../../../images/graphrag-ui-configure-importer-openai.png) {{< /tab >}} {{< tab "OpenRouter" >}} 1. Select **OpenRouter** from the **LLM API Provider** dropdown menu. 2. Select the model you want to use from the **Model** dropdown menu. By default, - the service is using **Mistral AI - Mistral Nemo**. -1. Enter your **OpenAI API Key**. -2. Enter your **OpenRouter API Key**. -3. Click the **Start importer service** button. + the service uses **Mistral AI - Mistral Nemo**. +3. Enter your **OpenAI API Key**. +4. Enter your **OpenRouter API Key**. +5. Click the **Start importer service** button. {{< info >}} -When using the OpenRouter option, the LLM responses are served via OpenRouter -while OpenAI is used for the embedding model. +When using OpenRouter, you need both API keys because the LLM responses are served +via OpenRouter while OpenAI is used for the embedding model. {{< /info >}} ![Configure Importer service using OpenRouter](../../../images/graphrag-ui-configure-importer-openrouter.png) @@ -88,31 +98,53 @@ service automatically downloads and loads models from the MLflow registry. See also the [GraphRAG Importer](services/importer.md) service documentation. -## Upload your file +## Add data source + +To add your first data source: -1. Upload a file by dragging and dropping it in the designated upload area. - The importer service you previously launched parses and creates the - Knowledge Graph automatically. -2. Enter a file name. -3. Click the **Start import** button. +1. In the **Data Sources** section, click the **Add data source** button. +2. Upload a file by dragging and dropping it in the designated upload area. + The importer service you previously configured will automatically parse the file + and create the Knowledge Graph. +3. Enter a descriptive name for your file. +4. Click the **Start import** button. {{< info >}} -You can only import a single file, either in `.md` or `.txt` format. +Currently, you can import one file at a time in either Markdown (`.md`) or +plain text (`.txt`) format. Additional files can be added to update the Knowledge Graph. {{< /info >}} ![Upload file in GraphRAG web interface](../../../images/graphrag-ui-upload-file.png) ## Explore the Knowledge Graph -You can open and explore the Knowledge Graph that has been generated by clicking -on the **Explore in visualizer** button. +After your file is processed, you can view and explore the generated Knowledge Graph +in the **Graph** section. + +![Explore Knowledge Graph in GraphRAG web interface](../../../images/graphrag-ui-explore-knowledge-graph.png) + +For a more detailed exploration, click the **Explore** button to open the Knowledge Graph in the dedicated Graph Visualizer. For more information, see the [Graph Visualizer](../../graphs/graph-visualizer.md) documentation. +## Update the Knowledge Graph + +Once you have created your initial Knowledge Graph, you can update it by uploading +additional files using the same process described in the [Add data source](#add-data-source) section. +The importer service will automatically update the existing Knowledge Graph and +underlying collections with the new data. + +To update your Knowledge Graph: + +1. In the **Data Sources** section, click the **Add data source** button again. +2. Upload a new file by dragging and dropping it in the designated upload area. +3. The importer service will process the new file and update the existing Knowledge Graph along with the underlying collections. + ## Configure the Retriever service -Creating the retriever service allows you to extract information from -the generated Knowledge Graph. Follow the steps below to configure the service. +The retriever service enables you to query and extract information from +the generated Knowledge Graph. To configure the retriever service, open the +**Project Settings** and follow the steps below. {{< tabs "retriever-service" >}} @@ -134,8 +166,8 @@ the generated Knowledge Graph. Follow the steps below to configure the service. 4. Click the **Start retriever service** button. {{< info >}} -When using the OpenRouter option, the LLM responses are served via OpenRouter -while OpenAI is used for the embedding model. +When using OpenRouter, the LLM responses are served via OpenRouter while OpenAI +is used for the embedding model. {{< /info >}} ![Configure Retriever Service using OpenRouter](../../../images/graphrag-ui-configure-retriever-openrouter.png) diff --git a/site/content/images/graphrag-ui-configure-importer-openai.png b/site/content/images/graphrag-ui-configure-importer-openai.png index cfb29fce88..3990ffb2ba 100644 Binary files a/site/content/images/graphrag-ui-configure-importer-openai.png and b/site/content/images/graphrag-ui-configure-importer-openai.png differ diff --git a/site/content/images/graphrag-ui-configure-importer-openrouter.png b/site/content/images/graphrag-ui-configure-importer-openrouter.png index 3d01059d24..dcaa17f570 100644 Binary files a/site/content/images/graphrag-ui-configure-importer-openrouter.png and b/site/content/images/graphrag-ui-configure-importer-openrouter.png differ diff --git a/site/content/images/graphrag-ui-configure-importer-triton.png b/site/content/images/graphrag-ui-configure-importer-triton.png index 7b48f166fc..df69600760 100644 Binary files a/site/content/images/graphrag-ui-configure-importer-triton.png and b/site/content/images/graphrag-ui-configure-importer-triton.png differ diff --git a/site/content/images/graphrag-ui-configure-retriever-openai.png b/site/content/images/graphrag-ui-configure-retriever-openai.png index 9e0b892f46..bbef472e2b 100644 Binary files a/site/content/images/graphrag-ui-configure-retriever-openai.png and b/site/content/images/graphrag-ui-configure-retriever-openai.png differ diff --git a/site/content/images/graphrag-ui-configure-retriever-openrouter.png b/site/content/images/graphrag-ui-configure-retriever-openrouter.png index 7c541cb44e..76e226fb00 100644 Binary files a/site/content/images/graphrag-ui-configure-retriever-openrouter.png and b/site/content/images/graphrag-ui-configure-retriever-openrouter.png differ diff --git a/site/content/images/graphrag-ui-configure-retriever-triton.png b/site/content/images/graphrag-ui-configure-retriever-triton.png index 07fd1c757c..d95c3cf7d4 100644 Binary files a/site/content/images/graphrag-ui-configure-retriever-triton.png and b/site/content/images/graphrag-ui-configure-retriever-triton.png differ diff --git a/site/content/images/graphrag-ui-explore-knowledge-graph.png b/site/content/images/graphrag-ui-explore-knowledge-graph.png new file mode 100644 index 0000000000..4aa462ad69 Binary files /dev/null and b/site/content/images/graphrag-ui-explore-knowledge-graph.png differ diff --git a/site/content/images/graphrag-ui-upload-file.png b/site/content/images/graphrag-ui-upload-file.png index be83d73e3a..b22b2d7452 100644 Binary files a/site/content/images/graphrag-ui-upload-file.png and b/site/content/images/graphrag-ui-upload-file.png differ