Current Date and Time
What it is
Section titled “What it is”Simple native tool that returns the current date and time in GMT (UTC+0) when the agent needs to know “what day/hour is now”.
Language models don’t have real notion of present time — they know up to a training cutoff. Without this tool, the agent may invent the date or use a stale reference.
When to use
Section titled “When to use”- Scheduling: agent that books meetings, creates reminders, or calculates deadlines.
- Support that needs to say “today”, “tomorrow”, “last week” accurately.
- Responses involving promotions with expiration date, coupon validity, return deadlines.
- Any agent that benefits from knowing the day of week, month, current year.
- Contextual greetings (“good morning”, “good evening”) based on the hour.
Configuration
Section titled “Configuration”- In the agent’s Tools tab, click + Add Tool.
- Under NATIVE TOOLS, pick Current Date and Time.
No parameters, no configuration. The tool is active immediately.
How the agent invokes
Section titled “How the agent invokes”The agent decides to call this tool when the question or task depends on the current moment:
- “what day is today?”
- “what’s the deadline if delivery is in 5 business days?”
- “is this coupon still valid?”
- “set a reminder for tomorrow morning”
The return is a timestamp in GMT (UTC+0). The agent tells the user the time is in GMT so they can convert to local timezone when needed.
Limitations and notes
Section titled “Limitations and notes”- Fixed at GMT/UTC. The tool doesn’t detect the user’s timezone. If you need local time, guide the agent in the prompt to ask the timezone or always apply an offset (e.g., “use America/Sao_Paulo, UTC-3”).
- No automatic local time. To personalize per user (e.g., “good evening” based on their tz), store the timezone in a conversation note or in the profile and guide the agent to use it.
- No extra cost. The call is cheap and fast — returns in milliseconds.
- Watch out for date arithmetic. The model isn’t perfect at calendar math (business days, holidays). For critical cases, validate on your application side.