Data e Ora

Mayros utilizza per impostazione predefinita l'ora locale dell'host per i timestamp di trasporto e il fuso orario dell'utente solo nel prompt di sistema. I timestamp del provider vengono preservati in modo che gli strumenti mantengano la loro semantica nativa (l'ora corrente è disponibile tramite session_status).

Envelope dei messaggi (locale per impostazione predefinita)

I messaggi in arrivo sono avvolti con un timestamp (precisione al minuto):

[Provider ... 2026-01-05 16:26 PST] testo del messaggio

Questo timestamp dell'envelope è locale dell'host per impostazione predefinita, indipendentemente dal fuso orario del provider.

Puoi sovrascrivere questo comportamento:

json5
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | fuso orario IANA
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" utilizza UTC.
  • envelopeTimezone: "local" utilizza il fuso orario dell'host.
  • envelopeTimezone: "user" utilizza agents.defaults.userTimezone (fallback al fuso orario dell'host).
  • Usa un fuso orario IANA esplicito (es. "America/Chicago") per una zona fissa.
  • envelopeTimestamp: "off" rimuove i timestamp assoluti dalle intestazioni degli envelope.
  • envelopeElapsed: "off" rimuove i suffissi di tempo trascorso (lo stile +2m).

Esempi

Locale (predefinito):

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

Fuso orario utente:

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

Tempo trascorso abilitato:

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

Prompt di sistema: Data e Ora Corrente

Se il fuso orario dell'utente è noto, il prompt di sistema include una sezione dedicata Data e Ora Corrente con solo il fuso orario (nessun formato orologio/ora) per mantenere stabile la cache del prompt:

Fuso orario: America/Chicago

Quando l'agente ha bisogno dell'ora corrente, usa lo strumento session_status; la scheda di stato include una riga timestamp.

Righe eventi di sistema (locale per impostazione predefinita)

Gli eventi di sistema in coda inseriti nel contesto dell'agente sono preceduti da un timestamp che utilizza la stessa selezione del fuso orario degli envelope dei messaggi (predefinito: locale dell'host).

System: [2026-01-12 12:19:17 PST] Modello cambiato.

Configura fuso orario utente + formato

json5
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone imposta il fuso orario locale dell'utente per il contesto del prompt.
  • timeFormat controlla la visualizzazione 12h/24h nel prompt. auto segue le preferenze del sistema operativo.

Rilevamento formato ora (auto)

Quando timeFormat: "auto", Mayros ispeziona la preferenza del sistema operativo (macOS/Windows) e fallback alla formattazione locale. Il valore rilevato è messo in cache per processo per evitare chiamate di sistema ripetute.

Payload strumenti + connettori (tempo provider grezzo + campi normalizzati)

Gli strumenti dei canali restituiscono timestamp nativi del provider e aggiungono campi normalizzati per coerenza:

  • timestampMs: millisecondi epoch (UTC)
  • timestampUtc: stringa UTC ISO 8601

I campi grezzi del provider vengono preservati in modo che nulla vada perso.

  • Slack: stringhe simili a epoch dall'API
  • Discord: timestamp UTC ISO
  • Telegram/WhatsApp: timestamp numerici/ISO specifici del provider

Se hai bisogno dell'ora locale, convertila a valle usando il fuso orario noto.

Documentazione correlata