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.enabledis ingesteld optrue, worden transacties automatisch ingeschakeld, ongeacht deze instelling. - De standaardwaarde is
trueom 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: falseenabled
Sleutel:
| Key | Type | Description | Example |
|---|---|---|---|
| enabled | Boolean | Bepaalt 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:
- Balancering volgt correct met een volledig audit-spoor
- Tokengebruik kan nauwkeurig worden berekend en in mindering worden gebracht op gebruikerssaldi
- 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 limitsDatabase-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?