Giao dịch

Tổng quan

Đối tượng transactions kiểm soát việc liệu các bản ghi sử dụng token có được lưu vào cơ sở dữ liệu trong LibreChat hay không. Điều này cho phép quản trị viên bật hoặc tắt tính năng theo dõi giao dịch một cách độc lập với hệ thống số dư.

Các trường trong transactions:

• enabled

Ghi chú:

• Ghi lại giao dịch là điều cần thiết để theo dõi lịch sử sử dụng token
• Khi balance.enabled được đặt thành true, các giao dịch sẽ tự động được bật bất kể cài đặt này.
• Giá trị mặc định là true để đảm bảo việc sử dụng token được theo dõi theo mặc định
• Việc vô hiệu hóa các giao dịch có thể giảm yêu cầu lưu trữ cơ sở dữ liệu nhưng sẽ ngăn cản việc phân tích dữ liệu sử dụng trong quá khứ.

Ví dụ

transactions:
  enabled: false

enabled

Khóa:

Mô tả:

Trường enabled xác định xem LibreChat có lưu các bản ghi giao dịch chi tiết cho từng sự kiện sử dụng token hay không. Các bản ghi này bao gồm:

• Số lượng token cho các prompt và completion
• Các chi phí và mức giá liên quan
• Các định danh người dùng và cuộc trò chuyện
• Dấu thời gian cho mỗi giao dịch

Hành vi quan trọng:

Khi hệ thống số dư được bật (balance.enabled: true), việc ghi lại giao dịch sẽ tự động được kích hoạt bất kể cài đặt transactions.enabled. Điều này đảm bảo rằng:

1. Theo dõi số dư hoạt động chính xác với một bản ghi kiểm toán đầy đủ
2. Việc sử dụng token có thể được tính toán chính xác và khấu trừ từ số dư của người dùng
3. Dữ liệu lịch sử có sẵn để đối soát số dư

Các trường hợp sử dụng:

• Enable transactions (true): Khi bạn cần theo dõi các mô hình sử dụng, tạo báo cáo hoặc duy trì dấu vết kiểm toán
• Disable transactions (false): Khi bạn muốn giảm dung lượng lưu trữ cơ sở dữ liệu và không cần dữ liệu sử dụng lịch sử (chỉ hoạt động khi tính năng theo dõi số dư cũng bị vô hiệu hóa)

Mối quan hệ với Hệ thống Số dư

Các hệ thống giao dịch và số dư hoạt động cùng nhau:

# 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

Tác động đến cơ sở dữ liệu

Khi các giao dịch được bật, mỗi lệnh gọi API tiêu thụ token sẽ tạo một bản ghi trong bộ sưu tập "Transactions" với các thông tin sau:

• ID người dùng và email
• ID cuộc trò chuyện
• Mô hình được sử dụng
• Số lượng token (prompt và completion)
• Giá trị và tỷ lệ token
• Dấu thời gian
• Loại giao dịch (tín dụng hoặc ghi nợ)

Cân nhắc các tác động đến lưu trữ khi bật giao dịch cho các triển khai có lưu lượng truy cập cao.