Date & Time

Mayros default ke waktu lokal host untuk timestamp transport dan timezone pengguna hanya di system prompt. Timestamp provider dipertahankan sehingga tool menjaga semantik asli mereka (waktu saat ini tersedia melalui session_status).

Message envelope (lokal secara default)

Pesan masuk dibungkus dengan timestamp (presisi menit):

[Provider ... 2026-01-05 16:26 PST] message text

Timestamp envelope ini adalah lokal host secara default, terlepas dari timezone provider.

Anda dapat mengganti perilaku ini:

json5
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" menggunakan UTC.
  • envelopeTimezone: "local" menggunakan timezone host.
  • envelopeTimezone: "user" menggunakan agents.defaults.userTimezone (fallback ke timezone host).
  • Gunakan timezone IANA eksplisit (misalnya, "America/Chicago") untuk zona tetap.
  • envelopeTimestamp: "off" menghapus timestamp absolut dari header envelope.
  • envelopeElapsed: "off" menghapus sufiks waktu yang telah berlalu (gaya +2m).

Contoh

Lokal (default):

[WhatsApp +1555 2026-01-18 00:19 PST] hello

Timezone pengguna:

[WhatsApp +1555 2026-01-18 00:19 CST] hello

Elapsed time diaktifkan:

[WhatsApp +1555 +30s 2026-01-18T05:19Z] follow-up

System prompt: Current Date & Time

Jika timezone pengguna diketahui, system prompt menyertakan bagian Current Date & Time khusus dengan time zone saja (tidak ada format jam/waktu) untuk menjaga stabilitas caching prompt:

Time zone: America/Chicago

Ketika agen membutuhkan waktu saat ini, gunakan tool session_status; kartu status menyertakan baris timestamp.

Baris event sistem (lokal secara default)

Event sistem yang diantrekan dimasukkan ke dalam konteks agen diawali dengan timestamp menggunakan pemilihan timezone yang sama dengan envelope pesan (default: host-lokal).

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

Konfigurasi timezone + format pengguna

json5
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone mengatur timezone lokal pengguna untuk konteks prompt.
  • timeFormat mengontrol tampilan 12j/24j di prompt. auto mengikuti preferensi OS.

Deteksi format waktu (auto)

Ketika timeFormat: "auto", Mayros memeriksa preferensi OS (macOS/Windows) dan fallback ke formatting lokal. Nilai yang terdeteksi di-cache per proses untuk menghindari panggilan sistem berulang.

Payload tool + konektor (waktu provider raw + field normalized)

Tool channel mengembalikan timestamp provider-native dan menambahkan field normalized untuk konsistensi:

  • timestampMs: milidetik epoch (UTC)
  • timestampUtc: string UTC ISO 8601

Field provider raw dipertahankan sehingga tidak ada yang hilang.

  • Slack: string seperti epoch dari API
  • Discord: timestamp UTC ISO
  • Telegram/WhatsApp: timestamp numerik/ISO spesifik provider

Jika Anda memerlukan waktu lokal, konversi downstream menggunakan timezone yang diketahui.

Dokumen terkait