From 85c1d79d3e6a43d6aa00f60357882ebc7b3d0190 Mon Sep 17 00:00:00 2001
From: Mendon Kissling <59585235+mendonk@users.noreply.github.com>
Date: Sun, 23 Jun 2024 10:07:52 -0400
Subject: [PATCH] memories
---
docs/docs/administration/memories.mdx | 34 ++++++++++++++++++++++
docs/docs/administration/settings.mdx | 1 +
docs/docs/components/text-and-record.mdx | 2 +-
docs/docs/getting-started/workspace.mdx | 3 +-
docs/sidebars.js | 1 +
docs/static/img/chat-memory-component.png | Bin 0 -> 109650 bytes
docs/static/img/playground-memories.png | Bin 0 -> 427260 bytes
7 files changed, 39 insertions(+), 2 deletions(-)
create mode 100644 docs/docs/administration/memories.mdx
create mode 100644 docs/static/img/chat-memory-component.png
create mode 100644 docs/static/img/playground-memories.png
diff --git a/docs/docs/administration/memories.mdx b/docs/docs/administration/memories.mdx
new file mode 100644
index 000000000..e0679afc7
--- /dev/null
+++ b/docs/docs/administration/memories.mdx
@@ -0,0 +1,34 @@
+import ThemedImage from "@theme/ThemedImage";
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import ZoomableImage from "/src/theme/ZoomableImage.js";
+import Admonition from "@theme/Admonition";
+
+# Chat Memory
+
+Langflow allows every chat message to be stored, and a single flow can have multiple memory sessions. This enables you to create multiple “memories” for agents to store and recall specific information as needed. You can edit and remove previous messages to inspect and validate a model’s response behavior. Control, explore, and manage conversation histories to get your models acting just right.
+
+The **Chat Memory** component retrieves message histories by session ID. Users can change the session ID in the advanced settings, with the default session ID set to match the flow ID. These memories are accessible and manageable directly from the Playground; modifications to them directly affect the behavior of chatbot responses. Users can remove or edit previous messages to manipulate and explore model responses further.
+
+
+
+By default, chat conversations store Message objects categorized by session ID. A a single flow can host multiple session IDs, and different flows can also share the same session ID.
+
+Memories can be visualized and managed directly from the Playground. Modifying these memories will influence the behavior of the chatbot responses, as long as an agent uses them. Here you have the ability to remove or edit previous messages, allowing them to manipulate and explore how these changes affect model responses.
+
+
+
+You can also display all messages stored across every flow in your workspace by going to **Settings** > **Messages**.
\ No newline at end of file
diff --git a/docs/docs/administration/settings.mdx b/docs/docs/administration/settings.mdx
index 39c6081c7..3599e967e 100644
--- a/docs/docs/administration/settings.mdx
+++ b/docs/docs/administration/settings.mdx
@@ -1,5 +1,6 @@
# Settings
+Change the **Project Settings** or **General Settings** for Langflow.
## Project Settings
diff --git a/docs/docs/components/text-and-record.mdx b/docs/docs/components/text-and-record.mdx
index fe2e61644..e1ece5069 100644
--- a/docs/docs/components/text-and-record.mdx
+++ b/docs/docs/components/text-and-record.mdx
@@ -1,6 +1,6 @@
# Text and Data
-In Langflow 1.0, we added two main input and output types: `Text` and `Data`.
+There are two main input and output types: `Text` and `Data`.
`Text` is a simple string input and output type, while `Data` is a structure very similar to a dictionary in Python. It is a key-value pair data structure.
diff --git a/docs/docs/getting-started/workspace.mdx b/docs/docs/getting-started/workspace.mdx
index eef951494..2372d8420 100644
--- a/docs/docs/getting-started/workspace.mdx
+++ b/docs/docs/getting-started/workspace.mdx
@@ -123,6 +123,7 @@ will see orange o and purple{" "}
/>
+
In the top right corner of the component, you'll find the component status icon ().
Build the flow by clicking the **Playground** at the bottom right of the workspace.
@@ -255,7 +256,7 @@ The **curl** tab displays sample code for posting a query to your flow.
Modify the `input_value` to change your input message.
Copy the code and run it to post a query to your flow and get the result.
-```curl
+```bash
curl -X POST \
http://127.0.0.1:7863/api/v1/run/f2eefd80-bb91-4190-9279-0d6ffafeaac4\?stream\=false \
-H 'Content-Type: application/json'\
diff --git a/docs/sidebars.js b/docs/sidebars.js
index 491b1ce6e..fb3bfd788 100644
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -40,6 +40,7 @@ module.exports = {
"administration/login",
"administration/cli",
"administration/playground",
+ "administration/memories",
"administration/collections-projects",
"administration/settings",
"administration/global-env",
diff --git a/docs/static/img/chat-memory-component.png b/docs/static/img/chat-memory-component.png
new file mode 100644
index 0000000000000000000000000000000000000000..3c9c7c92d857a4f588e6652c43d95d5f8aada2a3
GIT binary patch
literal 109650
zcmeFZXH-+&);1iPprT+wqzEXY0s;a8(ouRxP
b@c
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