38 lines
1.8 KiB
Markdown
38 lines
1.8 KiB
Markdown
---
|
|
summary: "Xử lý múi giờ cho agent, phong bì tin nhắn và lời nhắc"
|
|
read_when:
|
|
- Bạn cần hiểu cách dấu thời gian được chuẩn hóa cho mô hình AI
|
|
- Cấu hình múi giờ người dùng cho lời nhắc hệ thống
|
|
---
|
|
# Múi giờ (Timezones)
|
|
|
|
Moltbot chuẩn hóa các dấu thời gian để mô hình AI luôn thấy một **thời gian tham chiếu duy nhất**.
|
|
|
|
## Phong bì tin nhắn (Message envelopes)
|
|
Các tin nhắn đến được bao bọc trong một "phong bì" chứa metadata như sau:
|
|
```
|
|
[Provider ... 2026-01-05 16:26 PST] nội dung tin nhắn
|
|
```
|
|
Dấu thời gian trong phong bì mặc định là **giờ địa phương của máy chủ Gateway**, với độ chính xác đến từng phút.
|
|
|
|
Bạn có thể tùy chỉnh qua các cài đặt:
|
|
- `envelopeTimezone`: `"local"` (máy chủ), `"utc"`, `"user"` (người dùng), hoặc tên múi giờ IANA (ví dụ: `"Asia/Ho_Chi_Minh"`).
|
|
- `envelopeTimestamp`: Bật/tắt hiển thị dấu thời gian tuyệt đối.
|
|
- `envelopeElapsed`: Bật/tắt hiển thị hậu tố thời gian trôi qua (ví dụ: `+2m`).
|
|
|
|
## Múi giờ người dùng trong lời nhắc hệ thống
|
|
Hãy thiết lập `agents.defaults.userTimezone` để cho mô hình biết múi giờ địa phương của người dùng. Nếu để trống, Moltbot sẽ tự động lấy theo múi giờ của máy chủ chạy Gateway.
|
|
|
|
```json5
|
|
{
|
|
agents: { defaults: { userTimezone: "Asia/Ho_Chi_Minh" } }
|
|
}
|
|
```
|
|
|
|
Lời nhắc hệ thống sẽ bao gồm:
|
|
- Mục `Current Date & Time`: Ngày giờ địa phương và múi giờ.
|
|
- Định dạng thời gian: 12 giờ hoặc 24 giờ (có thể chỉnh qua `timeFormat`).
|
|
|
|
---
|
|
Tài liệu liên quan: [Lời nhắc hệ thống](./system-prompt.vi.md).
|