Transacciones

Descripción general

El objeto transactions controla si los registros de uso de tokens se guardan en la base de datos en LibreChat. Esto permite a los administradores habilitar o deshabilitar el seguimiento de transacciones independientemente del sistema de saldo.

Campos bajo transactions:

• enabled

Notas:

• El registro de transacciones es esencial para realizar un seguimiento del uso histórico de tokens.
• Cuando balance.enabled está configurado en true, las transacciones se habilitan automáticamente independientemente de este ajuste.
• El valor predeterminado es true para asegurar que el uso de tokens se rastree de forma predeterminada
• Deshabilitar las transacciones puede reducir los requisitos de almacenamiento de la base de datos, pero impedirá el análisis del uso histórico.

Ejemplo

transactions:
  enabled: false

enabled

Clave:

Descripción:

El campo enabled determina si LibreChat guarda registros detallados de transacciones para cada evento de uso de tokens. Estos registros incluyen:

• Recuento de tokens para prompts y completions
• Costos y tarifas asociados
• Identificadores de usuario y conversación
• Marcas de tiempo para cada transacción

Comportamiento importante:

Cuando el sistema de balance está habilitado (balance.enabled: true), el registro de transacciones se activa automáticamente independientemente de la configuración de transactions.enabled. Esto asegura que:

1. Las funciones de seguimiento de saldo funcionan correctamente con una pista de auditoría completa
2. El uso de tokens puede calcularse con precisión y deducirse de los saldos de los usuarios
3. Los datos históricos están disponibles para la conciliación de saldos

Casos de uso:

• Habilitar transacciones (true): Cuando necesite realizar un seguimiento de los patrones de uso, generar informes o mantener un registro de auditoría
• Deshabilitar transacciones (false): Cuando desee reducir el almacenamiento de la base de datos y no necesite datos históricos de uso (solo funciona cuando el seguimiento de saldo también está deshabilitado)

Relación con el Balance System

Los sistemas de transacciones y saldo funcionan en conjunto:

# 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

Impacto en la base de datos

Cuando las transacciones están habilitadas, cada llamada a la API que consume tokens crea un registro en la colección "Transactions" con la siguiente información:

• ID de usuario y correo electrónico
• ID de conversación
• Modelo utilizado
• Recuentos de tokens (prompt y completion)
• Valores y tasas de tokens
• Marca de tiempo
• Tipo de transacción (crédito o débito)

Considere las implicaciones de almacenamiento al habilitar transacciones para implementaciones de alto volumen.