Transaksi

Ikhtisar

Objek transactions mengontrol apakah catatan penggunaan token disimpan ke dalam basis data di LibreChat. Hal ini memungkinkan administrator untuk mengaktifkan atau menonaktifkan pelacakan transaksi secara independen dari sistem saldo.

Bidang di bawah transactions:

• enabled

Catatan:

• Pencatatan transaksi sangat penting untuk melacak penggunaan token historis
• Ketika balance.enabled diatur ke true, transaksi akan diaktifkan secara otomatis terlepas dari pengaturan ini
• Nilai default adalah true untuk memastikan penggunaan token dilacak secara default
• Menonaktifkan transaksi dapat mengurangi kebutuhan penyimpanan basis data tetapi akan mencegah analisis penggunaan historis

Contoh

transactions:
  enabled: false

enabled

Kunci:

Deskripsi:

Kolom enabled menentukan apakah LibreChat menyimpan catatan transaksi terperinci untuk setiap peristiwa penggunaan token. Catatan ini mencakup:

• Jumlah token untuk prompt dan penyelesaian
• Biaya dan tarif terkait
• Pengidentifikasi pengguna dan percakapan
• Stempel waktu untuk setiap transaksi

Perilaku Penting:

Saat sistem saldo diaktifkan (balance.enabled: true), pencatatan transaksi akan diaktifkan secara otomatis terlepas dari pengaturan transactions.enabled. Hal ini memastikan bahwa:

1. Fungsi pelacakan saldo berjalan dengan benar dengan jejak audit yang lengkap
2. Penggunaan token dapat dihitung secara akurat dan dipotong dari saldo pengguna
3. Data historis tersedia untuk rekonsiliasi saldo

Kasus Penggunaan:

• Aktifkan transaksi (true): Saat Anda perlu melacak pola penggunaan, membuat laporan, atau memelihara jejak audit
• Disable transactions (false): Saat Anda ingin mengurangi penyimpanan basis data dan tidak memerlukan data penggunaan historis (hanya berfungsi jika pelacakan saldo juga dinonaktifkan)

Hubungan dengan Sistem Saldo

Sistem transaksi dan saldo bekerja bersama:

# 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

Dampak Basis Data

Saat transaksi diaktifkan, setiap panggilan API yang menggunakan token akan membuat catatan dalam koleksi "Transactions" dengan informasi berikut:

• ID Pengguna dan email
• ID Percakapan
• Model yang digunakan
• Jumlah token (prompt dan completion)
• Nilai dan tarif token
• Stempel waktu
• Tipe transaksi (kredit atau debit)

Pertimbangkan implikasi penyimpanan saat mengaktifkan transaksi untuk penyebaran bervolume tinggi.