Skip to main content
LibreChat is joining ClickHouse to power the open-source Agentic Data Stack 🎉 Learn more
LibreChat

Transacties

Configureer transactieregistratie voor tokengebruik in LibreChat

Overzicht

Het transactions object bepaalt of tokengebruiksgegevens worden opgeslagen in de database in LibreChat. Hiermee kunnen beheerders het bijhouden van transacties in- of uitschakelen, onafhankelijk van het saldosysteem.

Velden onder transactions:

  • enabled

Opmerkingen:

  • Het vastleggen van transacties is essentieel voor het bijhouden van historisch tokengebruik
  • Wanneer balance.enabled is ingesteld op true, worden transacties automatisch ingeschakeld, ongeacht deze instelling.
  • De standaardwaarde is true om ervoor te zorgen dat tokengebruik standaard wordt bijgehouden
  • Het uitschakelen van transacties kan de opslagvereisten van de database verminderen, maar zal historische gebruiksanalyses verhinderen.

Voorbeeld

transactions:
  enabled: false

enabled

Sleutel:

KeyTypeDescriptionExample
enabledBooleanBepaalt of transactierecords in de database worden opgeslagen.Default: true. Set to false to disable transaction recording (unless balance.enabled is true).

Beschrijving:

Het enabled veld bepaalt of LibreChat gedetailleerde transactierecords opslaat voor elke gebeurtenis van tokengebruik. Deze records bevatten:

  • Tokenaantallen voor prompts en completions
  • Bijbehorende kosten en tarieven
  • Gebruikers- en gespreks-id's
  • Tijdstempels voor elke transactie

Belangrijk gedrag:

Wanneer het balanssysteem is ingeschakeld (balance.enabled: true), wordt het vastleggen van transacties automatisch ingeschakeld, ongeacht de instelling transactions.enabled. Dit zorgt ervoor dat:

  1. Balancering volgt correct met een volledig audit-spoor
  2. Tokengebruik kan nauwkeurig worden berekend en in mindering worden gebracht op gebruikerssaldi
  3. Historische gegevens zijn beschikbaar voor balansafstemming

Use Cases:

  • Transacties inschakelen (true): Wanneer u gebruikspatronen moet bijhouden, rapporten wilt genereren of een audit-trail wilt bijhouden
  • Transacties uitschakelen (false): Wanneer u databaseopslag wilt verminderen en geen historische gebruiksgegevens nodig heeft (werkt alleen wanneer het bijhouden van het saldo ook is uitgeschakeld)

Relatie met het Balance System

De transactie- en saldosystemen werken samen:

# 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

Database-impact

Wanneer transacties zijn ingeschakeld, creëert elke API-aanroep die tokens verbruikt een record in de "Transactions" collectie met de volgende informatie:

  • Gebruikers-ID en e-mail
  • Gespreks-ID
  • Gebruikt model
  • Token-aantallen (prompt en completion)
  • Tokenwaarden en tarieven
  • Tijdstempel
  • Transactietype (credit of debit)

Houd rekening met de gevolgen voor opslag bij het inschakelen van transacties voor implementaties met een hoog volume.

Hoe is deze gids?