Data e Hora Atual

O que é

Data e Hora Atual é a ferramenta nativa que informa ao agente qual é o instante presente no fuso horário da organização. Use-a quando a resposta depender de “agora”, como identificar o dia da semana, comparar um prazo ou verificar se uma janela de atendimento está aberta.

O resultado já vem convertido. O contrato entregue ao modelo diz para usar a data, a hora e o dia da semana locais diretamente, sem aplicar outro deslocamento. Isso evita que o agente some ou subtraia o fuso duas vezes.

A ferramenta apenas consulta o relógio. Ela não cria agendamentos, lembretes ou tarefas, não conhece feriados e não executa uma ação quando uma data chegar.

Adicionar ao agente

Você precisa poder editar o agente (agents.write). Em um agente já salvo:

1. Abra Agentes, selecione o agente e entre em Ferramentas.
2. Selecione Adicionar Ferramenta.
3. No grupo Ferramentas Nativas, escolha Data e Hora Atual.

Não há parâmetro obrigatório no vínculo. Ao abrir a ferramenta, o painel mostra o fuso efetivo, uma prévia de Agora nesse fuso e o link Alterar. Esse painel é somente leitura: o fuso não é mais escolhido separadamente em cada agente.

Definir o fuso da organização

Existe um único fuso para toda a organização. Ele também orienta janelas de Automações, campanhas, caixas de entrada e Transferir Conversa.

Para alterá-lo:

1. No menu do perfil, abra Configurações.
2. Entre em Organização.
3. Em Fuso horário, pesquise e selecione um identificador IANA, como America/Sao_Paulo, Europe/Lisbon ou UTC.
4. Confira a prévia Agora, nesse fuso e selecione Salvar Personalização.

Somente o proprietário pode editar a identidade e o fuso da organização. As outras pessoas veem o valor, mas o seletor e o salvamento ficam desabilitados. Veja o mapa completo em Configurações da Organização.

O runtime consulta organizations.timezone ao preparar a ferramenta em cada turno. Depois de salvar um novo fuso, as próximas chamadas usam o novo valor. Um timezone que ainda exista na configuração antiga da ferramenta é ignorado.

Quando o agente usa

O modelo recebe uma orientação explícita para chamar get_current_datetime quando precisa da data ou hora atual, inclusive para raciocinar sobre horário comercial, dia útil ou agenda. Exemplos:

• “Que dia é hoje?”
• “Nosso atendimento está aberto agora?”
• “Este cupom ainda está dentro da validade?”
• “Qual data cai daqui a cinco dias?”

Ativar a ferramenta não garante uma chamada em toda mensagem. O modelo decide se o instante atual é necessário. Para regras críticas, escreva no prompt quando a consulta deve acontecer, por exemplo: “Antes de afirmar que o suporte está aberto, consulte Data e Hora Atual”.

O que a chamada devolve

A ferramenta não recebe argumentos e retorna um retrato do mesmo instante:

Campo	Conteúdo
timezone	identificador IANA efetivo da organização
weekday	dia da semana em inglês, como Monday
localTime	data e hora locais no formato AAAA-MM-DD HH:mm:ss
iso	data e hora locais em ISO 8601, com o deslocamento UTC explícito
utc	o mesmo instante em UTC, apenas como referência

O modelo é instruído a usar weekday, localTime e iso como horário local. O campo utc não deve ser reconvertido para responder à pessoa.

Limites e cuidados

• Um fuso por organização. A ferramenta não detecta o fuso de cada contato nem usa o relógio do navegador de quem configurou o agente.
• Calendário não incluído. “Dia útil” exige regras de fim de semana e feriados. Forneça o calendário aplicável em uma base ou integração e valide cálculos críticos na aplicação responsável.
• Sem execução futura. Para disparar algo depois, use uma Automação ou uma integração capaz de agendar; esta ferramenta só lê o instante atual.
• Fallback atual. Se o fuso estiver ausente, inválido ou não puder ser lido, o runtime usa silenciosamente America/Sao_Paulo. Se a resposta parecer deslocada, confira Configurações → Organização e tente novamente; não compense o erro manualmente no prompt.
• Horários do prompt. Escreva as janelas no horário local da organização, como “das 9h às 17h”, e exija uma nova consulta quando a decisão depender de “agora”.