Transazioni

Panoramica

L'oggetto transactions controlla se i record di utilizzo dei token vengono salvati nel database in LibreChat. Ciò consente agli amministratori di abilitare o disabilitare il tracciamento delle transazioni indipendentemente dal sistema di bilancio.

Campi sotto transactions:

• enabled

Note:

• La registrazione delle transazioni è essenziale per monitorare lo storico dell'utilizzo dei token
• Quando balance.enabled è impostato su true, le transazioni vengono abilitate automaticamente indipendentemente da questa impostazione.
• Il valore predefinito è true per garantire che l'utilizzo dei token venga tracciato per impostazione predefinita
• Disabilitare le transazioni può ridurre i requisiti di archiviazione del database, ma impedirà l'analisi dell'utilizzo storico.

Esempio

transactions:
  enabled: false

enabled

Chiave:

Descrizione:

Il campo enabled determina se LibreChat salva record di transazione dettagliati per ogni evento di utilizzo dei token. Questi record includono:

• Conteggi dei token per prompt e completamenti
• Costi e tariffe associati
• Identificatori di utente e conversazione
• Timestamp per ogni transazione

Comportamento importante:

Quando il sistema di bilancio è abilitato (balance.enabled: true), la registrazione delle transazioni viene attivata automaticamente indipendentemente dall'impostazione transactions.enabled. Questo garantisce che:

1. Il monitoraggio del saldo funziona correttamente con un audit trail completo
2. L'utilizzo dei token può essere calcolato accuratamente e detratto dai saldi degli utenti
3. I dati storici sono disponibili per la riconciliazione del saldo

Casi d'uso:

• Abilita transazioni (true): Quando hai bisogno di tracciare i modelli di utilizzo, generare report o mantenere una traccia di controllo (audit trail)
• Disable transactions (false): Quando desideri ridurre l'archiviazione del database e non hai bisogno dei dati storici di utilizzo (funziona solo quando anche il monitoraggio del saldo è disabilitato)

Relazione con il Balance System

I sistemi di transazioni e di saldo lavorano insieme:

# When balance is enabled, transactions are always enabled
balance:
  enabled: true
  startBalance: 20000

transactions:
  enabled: false  # This will be overridden to true because balance.enabled is true

# Track transactions without balance management
balance:
  enabled: false

transactions:
  enabled: true  # Records all token usage without enforcing balance limits

Impatto sul database

Quando le transazioni sono abilitate, ogni chiamata API che consuma token crea un record nella collezione "Transactions" con le seguenti informazioni:

• ID utente ed email
• ID conversazione
• Modello utilizzato
• Conteggio dei token (prompt e completamento)
• Valori e tariffe dei token
• Timestamp
• Tipo di transazione (credito o debito)

Considera le implicazioni di archiviazione quando abiliti le transazioni per distribuzioni ad alto volume.