วันที่และเวลา

Mayros ใช้ค่าเริ่มต้นเป็น เวลาโลคัลของโฮสต์สำหรับ timestamp ของการส่ง และ เขตเวลาของผู้ใช้เฉพาะในระบบ prompt timestamp ของผู้ให้บริการถูกเก็บรักษาไว้เพื่อให้เครื่องมือรักษาความหมายดั้งเดิม (เวลาปัจจุบันพร้อมใช้งานผ่าน session_status)

ซองข้อความ (โลคัลตามค่าเริ่มต้น)

ข้อความขาเข้าถูกห่อด้วย timestamp (ความแม่นยำนาที):

[Provider ... 2026-01-05 16:26 PST] ข้อความ

timestamp ของซองนี้เป็น โลคัลของโฮสต์ตามค่าเริ่มต้น ไม่ว่าเขตเวลาของผู้ให้บริการจะเป็นอย่างไร

คุณสามารถแทนที่พฤติกรรมนี้:

json5
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" ใช้ UTC
  • envelopeTimezone: "local" ใช้เขตเวลาของโฮสต์
  • envelopeTimezone: "user" ใช้ agents.defaults.userTimezone (กลับไปใช้เขตเวลาของโฮสต์)
  • ใช้เขตเวลา IANA ที่ชัดเจน (เช่น "America/Chicago") สำหรับโซนคงที่
  • envelopeTimestamp: "off" ลบ timestamp แบบสัมบูรณ์ออกจากส่วนหัวของซอง
  • envelopeElapsed: "off" ลบส่วนต่อท้ายเวลาที่ผ่านไป (รูปแบบ +2m)

ตัวอย่าง

โลคัล (ค่าเริ่มต้น):

[WhatsApp +1555 2026-01-18 00:19 PST] สวัสดี

เขตเวลาของผู้ใช้:

[WhatsApp +1555 2026-01-18 00:19 CST] สวัสดี

เปิดใช้งานเวลาที่ผ่านไป:

[WhatsApp +1555 +30s 2026-01-18T05:19Z] ติดตาม

ระบบ prompt: วันที่และเวลาปัจจุบัน

หากทราบเขตเวลาของผู้ใช้ ระบบ prompt จะรวมส่วน วันที่และเวลาปัจจุบัน โดยเฉพาะพร้อม เขตเวลาเท่านั้น (ไม่มีรูปแบบนาฬิกา/เวลา) เพื่อรักษาความเสถียรของ prompt caching:

Time zone: America/Chicago

เมื่อ Agent ต้องการเวลาปัจจุบัน ให้ใช้เครื่องมือ session_status การ์ดสถานะ รวมบรรทัด timestamp

บรรทัดเหตุการณ์ระบบ (โลคัลตามค่าเริ่มต้น)

เหตุการณ์ระบบที่เข้าคิวแทรกเข้าไปในบริบท Agent มีคำนำหน้าด้วย timestamp โดยใช้ การเลือกเขตเวลาเดียวกับซองข้อความ (ค่าเริ่มต้น: โลคัลของโฮสต์)

System: [2026-01-12 12:19:17 PST] โมเดลสลับแล้ว

กำหนดค่าเขตเวลาผู้ใช้ + รูปแบบ

json5
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone ตั้งค่า เขตเวลาโลคัลของผู้ใช้ สำหรับบริบท prompt
  • timeFormat ควบคุม การแสดงผล 12h/24h ใน prompt auto ทำตามการตั้งค่า OS

การตรวจจับรูปแบบเวลา (อัตโนมัติ)

เมื่อ timeFormat: "auto" Mayros จะตรวจสอบการตั้งค่า OS (macOS/Windows) และกลับไปใช้การจัดรูปแบบตามโลแคล ค่าที่ตรวจพบจะถูก แคชต่อโปรเซส เพื่อหลีกเลี่ยงการเรียกระบบซ้ำๆ

เพย์โหลดเครื่องมือ + คอนเนกเตอร์ (เวลาผู้ให้บริการดิบ + ฟิลด์ที่ปรับมาตรฐาน)

เครื่องมือช่องทางส่งคืน timestamp ดั้งเดิมของผู้ให้บริการ และเพิ่มฟิลด์ที่ปรับมาตรฐานเพื่อความสอดคล้อง:

  • timestampMs: epoch มิลลิวินาที (UTC)
  • timestampUtc: สตริง ISO 8601 UTC

ฟิลด์ผู้ให้บริการดิบถูกเก็บรักษาไว้เพื่อไม่ให้สูญหาย

  • Slack: สตริงแบบ epoch จาก API
  • Discord: timestamp ISO UTC
  • Telegram/WhatsApp: timestamp ตัวเลข/ISO เฉพาะผู้ให้บริการ

หากคุณต้องการเวลาโลคัล ให้แปลงมันด้านล่างโดยใช้เขตเวลาที่ทราบ

เอกสารที่เกี่ยวข้อง