Ngày & Giờ

Mayros mặc định sử dụng giờ local của host cho timestamp transport và múi giờ người dùng chỉ trong system prompt. Timestamp của provider được giữ nguyên để các công cụ giữ ngữ nghĩa native của chúng (giờ hiện tại có sẵn qua session_status).

Message envelope (mặc định local)

Tin nhắn đến được bao bọc với timestamp (độ chính xác phút):

[Provider ... 2026-01-05 16:26 PST] nội dung tin nhắn

Timestamp envelope này mặc định là host-local, bất kể múi giờ của provider.

Bạn có thể ghi đè hành vi này:

json5
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | múi giờ IANA
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" sử dụng UTC.
  • envelopeTimezone: "local" sử dụng múi giờ host.
  • envelopeTimezone: "user" sử dụng agents.defaults.userTimezone (quay về múi giờ host).
  • Sử dụng múi giờ IANA rõ ràng (ví dụ: "America/Chicago") cho vùng cố định.
  • envelopeTimestamp: "off" loại bỏ timestamp tuyệt đối khỏi header envelope.
  • envelopeElapsed: "off" loại bỏ hậu tố thời gian trôi qua (kiểu +2m).

Ví dụ

Local (mặc định):

[WhatsApp +1555 2026-01-18 00:19 PST] xin chào

Múi giờ người dùng:

[WhatsApp +1555 2026-01-18 00:19 CST] xin chào

Thời gian trôi qua được bật:

[WhatsApp +1555 +30s 2026-01-18T05:19Z] theo dõi

System prompt: Ngày & Giờ hiện tại

Nếu múi giờ người dùng được biết, system prompt bao gồm một phần Ngày & Giờ hiện tại riêng với chỉ múi giờ (không có định dạng đồng hồ/thời gian) để giữ prompt caching ổn định:

Time zone: America/Chicago

Khi agent cần thời gian hiện tại, sử dụng công cụ session_status; thẻ trạng thái bao gồm một dòng timestamp.

System event line (mặc định local)

Các sự kiện hệ thống được xếp hàng được chèn vào ngữ cảnh agent được tiền tố bằng timestamp sử dụng cùng lựa chọn múi giờ như message envelope (mặc định: host-local).

System: [2026-01-12 12:19:17 PST] Model switched.

Cấu hình múi giờ người dùng + định dạng

json5
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone đặt múi giờ local người dùng cho ngữ cảnh prompt.
  • timeFormat kiểm soát hiển thị 12h/24h trong prompt. auto theo tùy chọn OS.

Phát hiện định dạng thời gian (auto)

Khi timeFormat: "auto", Mayros kiểm tra tùy chọn OS (macOS/Windows) và quay về định dạng locale. Giá trị phát hiện được cached per process để tránh các lệnh gọi hệ thống lặp lại.

Tool payload + connector (thời gian provider raw + trường chuẩn hóa)

Các công cụ kênh trả về timestamp native của provider và thêm các trường chuẩn hóa để nhất quán:

  • timestampMs: epoch milliseconds (UTC)
  • timestampUtc: chuỗi ISO 8601 UTC

Các trường provider raw được giữ nguyên nên không mất gì.

  • Slack: chuỗi kiểu epoch từ API
  • Discord: timestamp ISO UTC
  • Telegram/WhatsApp: timestamp số/ISO riêng của provider

Nếu bạn cần thời gian local, chuyển đổi nó downstream sử dụng múi giờ đã biết.

Tài liệu liên quan