Дата та час

Mayros за замовчуванням використовує локальний час хоста для міток транспорту та часовий пояс користувача тільки в системній підказці. Мітки провайдера зберігаються, тому інструменти зберігають свою нативну семантику (поточний час доступний через session_status).

Конверти повідомлень (локально за замовчуванням)

Вхідні повідомлення загортаються з міткою часу (точність до хвилини):

[Provider ... 2026-01-05 16:26 PST] текст повідомлення

Ця мітка часу конверта локальна для хоста за замовчуванням, незалежно від часового поясу провайдера.

Ви можете змінити цю поведінку:

json5
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | часовий пояс IANA
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" використовує UTC.
  • envelopeTimezone: "local" використовує часовий пояс хоста.
  • envelopeTimezone: "user" використовує agents.defaults.userTimezone (повертається до часового поясу хоста).
  • Використовуйте явний часовий пояс IANA (наприклад, "America/Chicago") для фіксованої зони.
  • envelopeTimestamp: "off" видаляє абсолютні мітки часу із заголовків конвертів.
  • 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] продовження

Системна підказка: Поточна дата та час

Якщо часовий пояс користувача відомий, системна підказка включає спеціальний розділ Поточна дата та час з тільки часовим поясом (без формату годинника/часу), щоб зберегти кешування підказки стабільним:

Часовий пояс: America/Chicago

Коли агенту потрібен поточний час, використовуйте інструмент session_status; картка стану включає рядок мітки часу.

Системні рядки подій (локально за замовчуванням)

Системні події в черзі, вставлені в контекст агента, мають префікс мітки часу, використовуючи той самий вибір часового поясу, що й конверти повідомлень (за замовчуванням: локально для хоста).

System: [2026-01-12 12:19:17 PST] Модель переключена.

Налаштувати часовий пояс користувача + формат

json5
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone встановлює локальний часовий пояс користувача для контексту підказки.
  • timeFormat контролює 12г/24г відображення в підказці. auto слідує за налаштуваннями ОС.

Виявлення формату часу (auto)

Коли timeFormat: "auto", Mayros перевіряє налаштування ОС (macOS/Windows) та повертається до форматування локалі. Виявлене значення кешується для кожного процесу, щоб уникнути повторних системних викликів.

Корисні дані інструментів + з'єднувачі (сирий час провайдера + нормалізовані поля)

Інструменти каналів повертають нативні мітки часу провайдера та додають нормалізовані поля для узгодженості:

  • timestampMs: мілісекунди епохи (UTC)
  • timestampUtc: рядок UTC ISO 8601

Сирі поля провайдера зберігаються, тому нічого не втрачається.

  • Slack: рядки, подібні до епохи, з API
  • Discord: мітки часу UTC ISO
  • Telegram/WhatsApp: специфічні для провайдера числові/ISO мітки часу

Якщо вам потрібен локальний час, конвертуйте його нижче за течією, використовуючи відомий часовий пояс.

Пов'язані документи