날짜 및 시간

Mayros는 전송 타임스탬프에 대해 호스트 로컬 시간을 기본값으로 사용하고 시스템 프롬프트에만 사용자 시간대를 사용합니다. 공급자 타임스탬프는 보존되므로 도구는 네이티브 의미를 유지합니다(현재 시간은 session_status를 통해 사용 가능).

메시지 봉투 (기본적으로 로컬)

인바운드 메시지는 타임스탬프(분 정밀도)로 래핑됩니다:

[Provider ... 2026-01-05 16:26 PST] 메시지 텍스트

이 봉투 타임스탬프는 공급자 시간대에 관계없이 기본적으로 호스트 로컬입니다.

이 동작을 재정의할 수 있습니다:

json5Copy
{
  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] hello

사용자 시간대:

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

경과 시간 활성화:

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

시스템 프롬프트: 현재 날짜 및 시간

사용자 시간대를 알고 있는 경우 시스템 프롬프트에는 프롬프트 캐싱을 안정적으로 유지하기 위해 시간대만 포함된 전용 현재 날짜 및 시간 섹션이 포함됩니다(시계/시간 형식 없음):

Time zone: America/Chicago

에이전트가 현재 시간이 필요할 때 session_status 도구를 사용하세요. 상태 카드에는 타임스탬프 줄이 포함됩니다.

시스템 이벤트 줄 (기본적으로 로컬)

에이전트 컨텍스트에 삽입된 대기 중인 시스템 이벤트는 메시지 봉투와 동일한 시간대 선택을 사용하는 타임스탬프로 접두사가 붙습니다(기본값: 호스트 로컬).

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

사용자 시간대 + 형식 구성

json5Copy
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}

• userTimezone은 프롬프트 컨텍스트에 대한 사용자 로컬 시간대를 설정합니다.
• timeFormat은 프롬프트의 12h/24h 표시를 제어합니다. auto는 OS 기본 설정을 따릅니다.

시간 형식 감지 (auto)

timeFormat: "auto"일 때 Mayros는 OS 기본 설정(macOS/Windows)을 검사하고 로케일 형식으로 폴백합니다. 감지된 값은 반복적인 시스템 호출을 피하기 위해 프로세스당 캐시됩니다.

도구 페이로드 + 커넥터 (원시 공급자 시간 + 정규화된 필드)

채널 도구는 공급자 네이티브 타임스탬프를 반환하고 일관성을 위해 정규화된 필드를 추가합니다:

• timestampMs: 에포크 밀리초 (UTC)
• timestampUtc: ISO 8601 UTC 문자열

원시 공급자 필드는 보존되므로 아무것도 손실되지 않습니다.

• Slack: API의 에포크 유사 문자열
• Discord: UTC ISO 타임스탬프
• Telegram/WhatsApp: 공급자별 숫자/ISO 타임스탬프

로컬 시간이 필요한 경우 알려진 시간대를 사용하여 다운스트림에서 변환하세요.

관련 문서

• 시스템 프롬프트
• 시간대
• 메시지