Data e Hora Atual

O que é

Ferramenta nativa que retorna a data e hora atual já no fuso horário configurado (por padrão, America/Sao_Paulo) quando o agente precisa saber “que dia/hora é agora”.

Modelos de linguagem não têm noção real de tempo presente — eles sabem até uma data de corte do treinamento. Sem essa ferramenta, o agente pode inventar a data ou usar uma referência desatualizada.

O retorno já vem no horário local do fuso escolhido, com o dia da semana junto. O agente usa esse valor direto para raciocinar sobre horário comercial, dia útil e prazos — sem precisar converter fuso, que é onde modelos costumam errar.

Quando usar

• Agendamento: agente que marca reuniões, cria lembretes ou calcula prazos.
• Atendimento que precisa dizer “hoje”, “amanhã”, “semana passada” com precisão.
• Decisões por horário comercial: transferir para um humano só dentro do expediente, por exemplo.
• Respostas que envolvem promoções com data de validade, expiração de cupom, prazos de retorno.
• Saudações contextuais (“bom dia”, “boa noite”) baseadas no horário local.

Configuração

1. Na aba Ferramentas do agente, clique em + Adicionar Ferramenta.
2. Em FERRAMENTAS NATIVAS, escolha Data e Hora Atual.
3. Clique na ferramenta para abrir as opções e escolha o Fuso horário do seu negócio (o seletor traz uma prévia “Agora nesse fuso” para você conferir). O padrão é America/Sao_Paulo.
4. Salve.

O fuso define em que horário local o agente lê a hora atual — então ajuste-o para o fuso do seu negócio, principalmente se você usa regras de horário comercial no prompt.

Como o agente invoca

O agente decide chamar essa ferramenta quando a pergunta ou tarefa depende do momento atual:

• “que dia é hoje?”
• “qual o prazo se a entrega for em 5 dias úteis?”
• “esse cupom ainda está válido?”
• “vocês estão em horário de atendimento agora?”
• “marca um lembrete pra amanhã de manhã”

O retorno traz o horário já no fuso configurado (data, hora local e dia da semana). O agente usa esse valor diretamente, sem mencionar fuso nem fazer conversão.

Limitações e notas

• Um fuso por agente. A ferramenta usa o fuso configurado, não o fuso de cada usuário. Para personalizar por usuário (ex.: “boa noite” no fuso dele), guarde o fuso em uma nota de conversa ou no perfil e oriente o agente a usar.
• Escreva os horários no fuso local. Como o horário já vem local, escreva as janelas do prompt em horário local natural (ex.: “das 9h às 17h”) — não compense fuso manualmente.
• Sem custo extra. A chamada é barata e rápida — retorna em milissegundos.
• Cuidado com aritmética de datas. O modelo não é perfeito em cálculos de calendário (dias úteis, feriados). Para casos críticos, valide do lado da sua aplicação.