From a1f618ac8ffeb475838741cbc9412b38dc906c45 Mon Sep 17 00:00:00 2001
From: Mendon Kissling <59585235+mendonk@users.noreply.github.com>
Date: Thu, 23 Oct 2025 21:17:21 -0400
Subject: [PATCH] quickstart
---
docs/docs/get-started/quickstart.mdx | 277 ++++------------------
docs/static/img/opensearch-agent-flow.png | Bin 1028298 -> 1081871 bytes
2 files changed, 43 insertions(+), 234 deletions(-)
diff --git a/docs/docs/get-started/quickstart.mdx b/docs/docs/get-started/quickstart.mdx
index 942433b5..80259617 100644
--- a/docs/docs/get-started/quickstart.mdx
+++ b/docs/docs/get-started/quickstart.mdx
@@ -11,33 +11,30 @@ Get started with OpenRAG by loading your knowledge, swapping out your language m
## Prerequisites
-- [Install and start OpenRAG](/install)
+- Install and start OpenRAG with the [TUI](/install) or [Docker](/get-started/docker)
-## Find your way around
+## Load and chat with your own documents
1. In OpenRAG, click **Chat**.
The chat is powered by the OpenRAG OpenSearch Agent.
For more information, see [Langflow Agents](/agents).
2. Ask `What documents are available to you?`
- The agent responds with a message summarizing the documents that OpenRAG loads by default, which are PDFs about evaluating data quality when using LLMs in health care.
+ The agent responds with a message summarizing the documents that OpenRAG loads by default.
Knowledge is stored in OpenSearch.
For more information, see [Knowledge](/knowledge).
-3. To confirm the agent is correct, click **Knowledge**.
+3. To confirm the agent is correct about the default knowledge, click **Knowledge**.
The **Knowledge** page lists the documents OpenRAG has ingested into the OpenSearch vector database.
Click on a document to display the chunks derived from splitting the default documents into the vector database.
-
-## Add your own knowledge
-
-1. To add documents to your knowledge base, click **Add Knowledge**.
- * Select **Add File** to add a single file from your local machine (mapped with the Docker volume mount).
- * Select **Process Folder** to process an entire folder of documents from your local machine (mapped with the Docker volume mount).
+4. To add documents to your knowledge base, click **Add Knowledge**.
+ * Select **Add File** to add a single file from your local machine.
+ * Select **Process Folder** to process an entire folder of documents from your local machine.
* Select your cloud storage provider to add knowledge from an OAuth-connected storage provider. For more information, see [OAuth ingestion](/knowledge#oauth-ingestion).
-2. Return to the Chat window and ask a question about your loaded data.
+5. Return to the Chat window and ask a question about your loaded data.
For example, with a manual about a PC tablet loaded, ask `How do I connect this device to WiFI?`
The agent responds with a message indicating it now has your knowledge as context for answering questions.
-3. Click the **Function Call: search_documents (tool_call)** that is printed in the Playground.
-These events log the agent's request to the tool and the tool's response, so you have direct visibility into your agent's functionality.
-If you aren't getting the results you need, you can further tune the knowledge ingestion and agent behavior in the next section.
+6. Click **Function Call: search_documents (tool_call)**.
+This log describes how the agent uses tools.
+This is helpful for troubleshooting when the agent isn't responding as expected.
## Swap out the language model to modify agent behavior {#change-components}
@@ -48,58 +45,40 @@ In this example, you'll try a different LLM to demonstrate how the Agent's respo
1. To edit the Agent's behavior, click **Edit in Langflow**.
You can more quickly access the **Language Model** and **Agent Instructions** fields in this page, but for illustration purposes, navigate to the Langflow visual builder.
2. OpenRAG warns you that you're entering Langflow. Click **Proceed**.
-
-3. The OpenRAG OpenSearch Agent flow appears.
+The OpenRAG OpenSearch Agent flow appears in a new browser window.
-4. In the **Language Model** component, under **Model**, select a different OpenAI model.
-5. Save your flow with Command+S.
-6. In OpenRAG, start a new conversation by clicking the in the **Conversations** tab.
-7. Ask the same question as before to demonstrate how a different language model changes the results.
+3. Find the **Language Model** component, and then change the **Model Name** field to a different OpenAI model.
+4. Save your flow with Command+S (Mac) or Ctrl+S (Windows).
+5. Return to the OpenRAG browser window, and start a new conversation by clicking in the **Conversations** tab.
+6. Ask the same question you asked before to see how the response differs between models.
## Integrate OpenRAG into your application
-To integrate OpenRAG into your application, use the [Langflow API](https://docs.langflow.org/api-reference-api-examples).
-Make requests with Python, TypeScript, or any HTTP client to run one of OpenRAG's default flows and get a response, and then modify the flow further to improve results. Langflow provides code snippets to help you get started.
+Langflow in OpenRAG includes pre-built flows that you can integrate into your applications using the [Langflow API](https://docs.langflow.org/api-reference-api-examples).
-1. Create a [Langflow API key](https://docs.langflow.org/api-keys-and-authentication).
-
- Create a Langflow API key
-
- A Langflow API key is a user-specific token you can use with Langflow.
- It is **only** used for sending requests to the Langflow server.
- It does **not** access to OpenRAG.
-
- To create a Langflow API key, do the following:
-
- 1. In Langflow, click your user icon, and then select **Settings**.
- 2. Click **Langflow API Keys**, and then click **Add New**.
- 3. Name your key, and then click **Create API Key**.
- 4. Copy the API key and store it securely.
- 5. To use your Langflow API key in a request, set a `LANGFLOW_API_KEY` environment variable in your terminal, and then include an `x-api-key` header or query parameter with your request.
- For example:
-
- ```bash
- # Set variable
- export LANGFLOW_API_KEY="sk..."
-
- # Send request
- curl --request POST \
- --url "http://LANGFLOW_SERVER_ADDRESS/api/v1/run/FLOW_ID" \
- --header "Content-Type: application/json" \
- --header "x-api-key: $LANGFLOW_API_KEY" \
- --data '{
- "output_type": "chat",
- "input_type": "chat",
- "input_value": "Hello"
- }'
- ```
-
-
-2. To navigate to the OpenRAG OpenSearch Agent flow, click **Settings**, and then click **Edit in Langflow** in the OpenRAG OpenSearch Agent flow.
-3. Click **Share**, and then click **API access**.
+The Langflow API accepts Python, TypeScript, or curl requests to run flows and get responses. You can use these flows as-is or modify them to better suit your needs.
- The default code in the API access pane constructs a request with the Langflow server `url`, `headers`, and a `payload` of request data. The code snippets automatically include the `LANGFLOW_SERVER_ADDRESS` and `FLOW_ID` values for the flow. Replace these values if you're using the code for a different server or flow. The default Langflow server address is http://localhost:7860.
+In this section, you'll run the OpenRAG OpenSearch Agent flow and get a response using the API.
+
+1. To navigate to the OpenRAG OpenSearch Agent flow in Langflow, click **Settings**, and then click **Edit in Langflow** in the OpenRAG OpenSearch Agent flow.
+2. Create a [Langflow API key](https://docs.langflow.org/api-keys-and-authentication).
+
+ A Langflow API key is a user-specific token you can use with Langflow.
+ It is **only** used for sending requests to the Langflow server.
+ It does **not** access OpenRAG.
+
+ To create a Langflow API key, do the following:
+
+ 1. Open Langflow, click your user icon, and then select **Settings**.
+ 2. Click **Langflow API Keys**, and then click **Add New**.
+ 3. Name your key, and then click **Create API Key**.
+ 4. Copy the API key and store it securely.
+
+3. Langflow includes code snippets for the request to the Langflow API.
+To retrieve the code snippet, click **Share**, and then click **API access**.
+
+ The default code in the API access pane constructs a request with the Langflow server `url`, `headers`, and a `payload` of request data. The code snippets automatically include the `LANGFLOW_SERVER_ADDRESS` and `FLOW_ID` values for the flow.
@@ -171,12 +150,12 @@ Make requests with Python, TypeScript, or any HTTP client to run one of OpenRAG'
curl --request POST \
--url 'http://LANGFLOW_SERVER_ADDRESS/api/v1/run/FLOW_ID?stream=false' \
--header 'Content-Type: application/json' \
- --header "x-api-key: LANGFLOW_API_KEY" \
+ --header "x-api-key: LANGFLOW_API_KEY" \
--data '{
- "output_type": "chat",
- "input_type": "chat",
- "input_value": "hello world!",
- }'
+ "output_type": "chat",
+ "input_type": "chat",
+ "input_value": "hello world!"
+ }'
```
@@ -185,176 +164,6 @@ Make requests with Python, TypeScript, or any HTTP client to run one of OpenRAG'
4. Copy the snippet, paste it in a script file, and then run the script to send the request. If you are using the curl snippet, you can run the command directly in your terminal.
If the request is successful, the response includes many details about the flow run, including the session ID, inputs, outputs, components, durations, and more.
-The following is an example of a response from running the **Simple Agent** template flow:
-
-
-Result
-
-```json
-{
- "session_id": "29deb764-af3f-4d7d-94a0-47491ed241d6",
- "outputs": [
- {
- "inputs": {
- "input_value": "hello world!"
- },
- "outputs": [
- {
- "results": {
- "message": {
- "text_key": "text",
- "data": {
- "timestamp": "2025-06-16 19:58:23 UTC",
- "sender": "Machine",
- "sender_name": "AI",
- "session_id": "29deb764-af3f-4d7d-94a0-47491ed241d6",
- "text": "Hello world! 🌍 How can I assist you today?",
- "files": [],
- "error": false,
- "edit": false,
- "properties": {
- "text_color": "",
- "background_color": "",
- "edited": false,
- "source": {
- "id": "Agent-ZOknz",
- "display_name": "Agent",
- "source": "gpt-4o-mini"
- },
- "icon": "bot",
- "allow_markdown": false,
- "positive_feedback": null,
- "state": "complete",
- "targets": []
- },
- "category": "message",
- "content_blocks": [
- {
- "title": "Agent Steps",
- "contents": [
- {
- "type": "text",
- "duration": 2,
- "header": {
- "title": "Input",
- "icon": "MessageSquare"
- },
- "text": "**Input**: hello world!"
- },
- {
- "type": "text",
- "duration": 226,
- "header": {
- "title": "Output",
- "icon": "MessageSquare"
- },
- "text": "Hello world! 🌍 How can I assist you today?"
- }
- ],
- "allow_markdown": true,
- "media_url": null
- }
- ],
- "id": "f3d85d9a-261c-4325-b004-95a1bf5de7ca",
- "flow_id": "29deb764-af3f-4d7d-94a0-47491ed241d6",
- "duration": null
- },
- "default_value": "",
- "text": "Hello world! 🌍 How can I assist you today?",
- "sender": "Machine",
- "sender_name": "AI",
- "files": [],
- "session_id": "29deb764-af3f-4d7d-94a0-47491ed241d6",
- "timestamp": "2025-06-16T19:58:23+00:00",
- "flow_id": "29deb764-af3f-4d7d-94a0-47491ed241d6",
- "error": false,
- "edit": false,
- "properties": {
- "text_color": "",
- "background_color": "",
- "edited": false,
- "source": {
- "id": "Agent-ZOknz",
- "display_name": "Agent",
- "source": "gpt-4o-mini"
- },
- "icon": "bot",
- "allow_markdown": false,
- "positive_feedback": null,
- "state": "complete",
- "targets": []
- },
- "category": "message",
- "content_blocks": [
- {
- "title": "Agent Steps",
- "contents": [
- {
- "type": "text",
- "duration": 2,
- "header": {
- "title": "Input",
- "icon": "MessageSquare"
- },
- "text": "**Input**: hello world!"
- },
- {
- "type": "text",
- "duration": 226,
- "header": {
- "title": "Output",
- "icon": "MessageSquare"
- },
- "text": "Hello world! 🌍 How can I assist you today?"
- }
- ],
- "allow_markdown": true,
- "media_url": null
- }
- ],
- "duration": null
- }
- },
- "artifacts": {
- "message": "Hello world! 🌍 How can I assist you today?",
- "sender": "Machine",
- "sender_name": "AI",
- "files": [],
- "type": "object"
- },
- "outputs": {
- "message": {
- "message": "Hello world! 🌍 How can I assist you today?",
- "type": "text"
- }
- },
- "logs": {
- "message": []
- },
- "messages": [
- {
- "message": "Hello world! 🌍 How can I assist you today?",
- "sender": "Machine",
- "sender_name": "AI",
- "session_id": "29deb764-af3f-4d7d-94a0-47491ed241d6",
- "stream_url": null,
- "component_id": "ChatOutput-aF5lw",
- "files": [],
- "type": "text"
- }
- ],
- "timedelta": null,
- "duration": null,
- "component_display_name": "Chat Output",
- "component_id": "ChatOutput-aF5lw",
- "used_frozen_result": false
- }
- ]
- }
- ]
-}
-```
-
To further explore the API, see:
diff --git a/docs/static/img/opensearch-agent-flow.png b/docs/static/img/opensearch-agent-flow.png
index 7382fcd13888b9226587f574dac56120a9d1bc1b..7027628d6b87a5f2d67bce9018b2f80c6930a6ff 100644
GIT binary patch
literal 1081871
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