트랜잭션

개요

transactions 객체는 LibreChat에서 토큰 사용량 기록을 데이터베이스에 저장할지 여부를 제어합니다. 이를 통해 관리자는 잔액 시스템과 독립적으로 트랜잭션 추적 기능을 활성화하거나 비활성화할 수 있습니다.

transactions 하위 필드:

• enabled

참고:

• 트랜잭션 기록은 과거 토큰 사용량을 추적하는 데 필수적입니다.
• balance.enabled가 true로 설정되면, 이 설정과 관계없이 트랜잭션이 자동으로 활성화됩니다.
• 기본값은 true이며, 기본적으로 토큰 사용량이 추적되도록 보장합니다.
• 트랜잭션을 비활성화하면 데이터베이스 저장 공간 요구 사항을 줄일 수 있지만, 과거 사용량 분석은 불가능해집니다.

예시

transactions:
  enabled: false

enabled

키:

설명:

enabled 필드는 LibreChat이 각 토큰 사용 이벤트에 대한 상세 거래 기록을 저장할지 여부를 결정합니다. 이러한 기록에는 다음이 포함됩니다:

• 프롬프트 및 완성(completion)에 대한 토큰 수
• 관련 비용 및 요금
• 사용자 및 대화 식별자
• 각 트랜잭션에 대한 타임스탬프

중요 동작:

잔액 시스템이 활성화(balance.enabled: true)되면 transactions.enabled 설정과 관계없이 트랜잭션 기록이 자동으로 활성화됩니다. 이는 다음을 보장합니다:

1. 완벽한 감사 추적(audit trail)을 통해 잔액 추적 기능이 올바르게 작동합니다.
2. 토큰 사용량을 정확하게 계산하여 사용자 잔액에서 차감할 수 있습니다.
3. 잔액 조정을 위해 과거 데이터를 사용할 수 있습니다.

사용 사례:

• Enable transactions (true): 사용 패턴을 추적하거나, 보고서를 생성하거나, 감사 추적을 유지해야 할 때 사용합니다.
• Disable transactions (false): 데이터베이스 저장 공간을 줄이고 싶고 과거 사용 데이터가 필요하지 않을 때 사용합니다 (잔액 추적 기능도 비활성화된 경우에만 작동합니다)

잔액 시스템과의 관계

트랜잭션 및 잔액 시스템은 다음과 같이 함께 작동합니다:

# 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

데이터베이스 영향

트랜잭션이 활성화되면 토큰을 소비하는 각 API 호출은 다음 정보와 함께 "Transactions" 컬렉션에 레코드를 생성합니다:

• 사용자 ID 및 이메일
• 대화 ID
• 사용된 모델
• 토큰 수 (프롬프트 및 완료)
• 토큰 값 및 요금
• 타임스탬프
• 거래 유형 (입금 또는 출금)

대규모 배포를 위해 트랜잭션을 활성화할 때는 스토리지에 미치는 영향을 고려하십시오.