diff --git a/content/docs/configuration/langfuse.mdx b/content/docs/configuration/langfuse.mdx index b3fea90aa..5952b1f97 100644 --- a/content/docs/configuration/langfuse.mdx +++ b/content/docs/configuration/langfuse.mdx @@ -131,6 +131,20 @@ langfuse: All three fields are optional and no metadata field is exported merely because it exists on a user or request. Treat email, usernames, provider identities, conversation IDs, and model selections as potentially sensitive telemetry; allowlist only fields your Langfuse retention and access policies permit. +### Temporary Chats + +[Temporary chats](/docs/features/temporary_chat) are not traced. Their prompts and responses reach no Langfuse destination, central or tenant, and rating one of their replies sends no feedback score. LibreChat deletes a temporary chat when its retention period ends, but it cannot delete a trace once Langfuse has it, so temporary chats stay out by default. + +Under `interface.retentionMode: "ephemeral"` every chat is temporary, so the deployment sends no traces at all unless it opts in. To trace temporary chats, set `temporaryChats`: + +```yaml filename="librechat.yaml" +langfuse: + trace: + temporaryChats: true +``` + +The default is `false`. Only an explicit `true` opts in. + ## Tenant Fanout (Optional) Langfuse fanout lets a multi-tenant LibreChat deployment export each eligible trace and its media to both a central Langfuse project and a tenant-specific project. The feature is opt-in and adds a gateway plus an internal OpenTelemetry collector; normal single-project tracing above is unchanged when fanout is not deployed. diff --git a/content/docs/features/temporary_chat.mdx b/content/docs/features/temporary_chat.mdx index a2b10e93b..d1d603c4e 100644 --- a/content/docs/features/temporary_chat.mdx +++ b/content/docs/features/temporary_chat.mdx @@ -42,6 +42,7 @@ To start all new chats as temporary, open **Settings > Chat** and turn on **Temp - It is excluded from search results. - It cannot be bookmarked. - It does not get an automatically generated title. +- It is not sent to [Langfuse](/docs/configuration/langfuse#temporary-chats) for tracing, and rating its replies sends no feedback score, unless your administrator has opted in. - It is kept until its retention period ends, then deleted automatically. The default period is 30 days; your administrator may set a different one. Retention applies to conversations, messages, files and shared links. [Memories](/docs/features/memory) are not deleted when a temporary chat expires. @@ -122,6 +123,7 @@ The temporary chat lifetime can also be set with `TEMP_CHAT_RETENTION_HOURS`. `i **`ephemeral`.** Every chat is temporary. This is "Temporary Chat always on" for the whole deployment. - Every chat is hidden from history and search, gets no generated title, and is deleted after `temporaryChatRetention` hours. `generalChatRetention` is ignored. + - No chat is traced to Langfuse unless `langfuse.trace.temporaryChats` is `true`. See [Temporary Chats](/docs/configuration/langfuse#temporary-chats) in the Langfuse guide. - The **Temporary Chat** toggle is locked on for everyone, including users whose role lacks the `TEMPORARY_CHAT` permission. The keyboard shortcut is disabled. - The server enforces it: a client that sends `isTemporary: false` is overridden. - Uploaded files and shared links expire with their chat. Agent resource files are kept only with `retainAgentFiles: true`.