Sexta-feira, às 21:00, era a hora de levar o telescópio para fora. Na previsão para observar o céu em Varsóvia, a cobertura de nuvens ficou em 100% nos dois horários livres da quinta-feira. Na sexta, a cobertura prevista caiu de 57% às 20:00 para 2% às 21:00, com vento de 9,3 km/h. Se você tivesse consultado a previsão só na hora do jantar, talvez tivesse deixado o telescópio no estojo.
Você vai montar o Clear Slot, um assistente da Quickchat AI que pergunta onde e quando você pode observar, consulta a previsão horária do Open-Meteo e mostra os dados que embasam a escolha. Veja a resposta para duas noites de novembro de 2026. O seu resultado vai variar conforme a previsão.
A conversa ocorreu na Quickchat AI com uma previsão salva. O horário escolhido atendeu aos dois limites definidos pelo observador. Dados meteorológicos do Open-Meteo.
Baixe o kit inicial do Clear Slot para acompanhar o exemplo com a mesma previsão e os mesmos resultados de busca de local. Você também pode ir direto aos quatro horários da previsão. As capturas de tela mostram a interface em inglês.
1. O que comparar na previsão para observar o céu?
Informe ao assistente a cidade, duas datas e os horários de início e fim. Escolhemos Varsóvia, na Polônia, das 20:00 às 22:00 nos dias 19 e 20 de novembro. Nossas preferências eram cobertura total de nuvens abaixo de 30% e vento sustentado abaixo de 15 km/h. Você pode ajustar esses limites para a sua sessão de observação.
- Crie uma conta na Quickchat AI ou entre na sua conta. Use um agente ainda sem configuração ou selecione Add new AI Agent → Set up manually. Dê a ele o nome de Clear Slot. Você vai precisar de créditos para gerar respostas e rodar testes.
- Abra Identity → Main Prompt e cole o prompt principal do kit. Ele orienta o assistente a confirmar o local, comparar apenas os horários em que você está livre, manter o fuso horário da previsão e mostrar os valores usados para escolher o horário.
- Use AI Preview para conversar. Duas ações do tipo API Actions fornecem os dados do local e da previsão do tempo. Você pode configurar as duas com os campos abaixo. Cada uma envia uma requisição GET com o cabeçalho
Acceptdefinido comoapplication/jsone o corpo vazio.
Na seção Identity, você define as regras de observação. Com as duas ações, o assistente consegue localizar uma cidade e consultar a previsão do tempo.
Você pode usar as URLs públicas abaixo para fins pessoais e não comerciais, desde que atenda às condições de uso. Se você usar o serviço hospedado da Open-Meteo para fins comerciais, configure seu próprio servidor para adicionar o parâmetro de consulta apikey às requisições enviadas aos endpoints da API para clientes incluídos na sua assinatura. Mantenha a chave de API fora do prompt do Agent e dos detalhes da requisição que os usuários podem ver. Para o exemplo publicado neste artigo, executamos os serviços de código aberto com os dados abertos que eles disponibilizam. Termos de uso da Open-Meteo · Planos do serviço hospedado · Guia de hospedagem em servidor próprio
2. Qual Varsóvia entrou na previsão?
A consulta à previsão precisa de coordenadas. Uma busca por Warsaw retorna resultados na Polônia e em vários estados dos EUA. Peça à pessoa que informe a cidade e o país. Depois, passe apenas as coordenadas do resultado escolhido para a consulta meteorológica.
- Abra Actions & MCPs → Add Action → API Action → Create manually. Dê à ação o nome
Resolve observing location. Em When to run, selecione AI decides. - Em What to ask the user first, adicione um parâmetro obrigatório do tipo Text chamado
place. Preencha o parâmetro só com o nome da cidade. A região ou o país ajuda o assistente a escolher o resultado depois da busca. - Selecione o método GET e informe a URL
https://geocoding-api.open-meteo.com/v1/search. Em Query Params, adicionenamee insira o parâmetroplacecom Add AI Data. Definacountcomo5,languagecomoeneformatcomojson. - Cole a descrição da ação de busca de local que vem no kit, salve e ative a ação. No AI Preview, pergunte “Qual Warsaw fica na Polônia e qual fica em Indiana?”. Confira o país, a região e o fuso horário no resultado. Documentação de geocodificação do Open-Meteo
O resultado da cidade polonesa trouxe as coordenadas 52.22977, 21.01178 e o fuso Europe/Warsaw. O de Indiana trouxe uma longitude negativa e um fuso horário dos EUA. Dados de localização do GeoNames via Open-Meteo.
3. Como consultar nebulosidade, umidade e vento por hora?
Crie uma segunda ação de API chamada Read observing weather. Adicione dois parâmetros obrigatórios do tipo Decimal Number, latitude e longitude, com as coordenadas do local selecionado. Use GET na URL https://api.open-meteo.com/v1/forecast e mantenha When to run em AI decides.
| Parâmetro de consulta | Valor a inserir |
|---|---|
latitude, longitude | Use duas linhas, uma para cada parâmetro. Insira o parâmetro correspondente em cada uma com Add AI Data. |
forecast_days | 3 |
timezone | auto |
wind_speed_unit | kmh |
daily | sunset,sunrise |
hourly | Cole em um único campo o valor abaixo, com os itens separados por vírgulas. |
cloud_cover,cloud_cover_low,cloud_cover_mid,cloud_cover_high,relative_humidity_2m,wind_speed_10m,wind_gusts_10m
A cidade varia de uma consulta para outra. O período de três dias, o uso do fuso local e as unidades ficam fixos na ação.
Cole a descrição da ação de previsão do tempo que vem no kit, salve a ação e ative-a. Abra a ação novamente com Edit Action, selecione Test Response, informe as duas coordenadas de Varsóvia e execute um teste. Na resposta, procure timezone, hourly_units, hourly.time e hourly.cloud_cover. Cada horário e o valor de cobertura de nuvens correspondente ocupam a mesma posição em suas respectivas listas. Use o mesmo índice em todos os campos de dados horários para obter os valores daquela mesma hora. Referência da API de previsão do tempo
Se você usa a conexão da sua conta da Quickchat AI no ChatGPT ou no Claude, pode enviar o kit e pedir que crie as duas ações no Clear Slot com essas mesmas configurações. Confira as URLs, os parâmetros e as unidades salvas antes de rodar um teste. O guia de criação de ações de API mostra o editor em mais detalhes.
4. Em qual das duas noites há um horário com menos nuvens?
Em AI Preview, envie a pergunta abaixo com datas dentro do período de três dias da previsão atual. No exemplo de novembro, usamos de novo a previsão salva por meio das mesmas duas ações. Abra a conversa em Inbox e confira a ação executada para comparar a resposta com os dados de origem.
Compare quinta e sexta-feira em Varsóvia, na Polônia. Estou livre das 20:00 às 22:00 nas duas noites. Quero cobertura total de nuvens abaixo de 30% e vento abaixo de 15 km/h. Quando devo levar o telescópio para fora?
| Início (hora local) | Cobertura total de nuvens | Velocidade do vento | Umidade relativa |
|---|---|---|---|
| Qui., 19, às 20:00 | 100% | 8,6 km/h | 93% |
| Qui., 19, às 21:00 | 100% | 9,4 km/h | 92% |
| Sex., 20, às 20:00 | 57% | 10,7 km/h | 82% |
| Sex., 20, às 21:00 | 2% | 9,3 km/h | 84% |
Horário local de Varsóvia (Europe/Warsaw, UTC+1). Esta previsão do Open-Meteo foi consultada em 18 de novembro de 2026 às 13:10 UTC. As quatro linhas usam os valores previstos no início de cada intervalo disponível. Um intervalo que começa às 22:00 fica fora de uma sessão que termina às 22:00.
Na previsão de sexta-feira, a cobertura de nuvens cai abaixo do limite de 30% do observador às 21:00. O valor das 22:00 só pode mudar a resposta se você puder ficar até mais tarde. Dados meteorológicos do Open-Meteo.
Para quinta-feira às 20:00, a previsão indicava 0% de cobertura de nuvens baixas e 100% de cobertura total. A camada alta, sozinha, cobria todo o céu, e a camada média estava em 62%. Para sexta-feira às 21:00, a previsão indicava 2% de nuvens baixas e 0% nas camadas média e alta. As camadas podem se sobrepor. Ao aplicar um limite de cobertura total, use o valor total do provedor.
Se você olhasse só para as nuvens baixas, a quinta-feira pareceria ter céu mais limpo do que a sexta. A cobertura de nuvens altas mostra por que essa impressão engana. Dados meteorológicos do Open-Meteo.
Confira à parte as condições para usar o tripé. Às 21:00 de sexta-feira, o vento previsto era de 9,3 km/h. Para saber a rajada máxima das 21:00 às 22:00, consulte o valor no horário de fim do intervalo, às 22:00. A previsão indicava 16,2 km/h. O campo de rajadas de vento do Open-Meteo se refere à hora anterior. A umidade relativa prevista chegou a 84% às 21:00. Esse valor, por si só, não indica se vai se formar orvalho na lente. Definições de vento e rajadas
No primeiro teste, pedimos a rajada máxima entre 21h e 22h. O Clear Slot escolheu o valor das 21h, de 19,4 km/h. Acrescentamos ao Main Prompt a orientação de usar o horário de término do intervalo e repetimos a pergunta. Dessa vez, o assistente respondeu 16,2 km/h e indicou o dado das 22h. O kit já inclui essa correção.
Para avaliar as condições do tripé durante uma hora, consulte dois horários da previsão. Dados meteorológicos do Open-Meteo.
5. O que muda se você puder observar por mais uma hora?
Na mesma conversa, diga “Posso ficar até as 23h de sexta-feira. O que muda?” Mais um horário de início entra na comparação. Para sexta-feira, às 22h, a previsão indicava 0% de cobertura de nuvens, vento de 7,5 km/h e umidade relativa de 86%. Você ganha mais uma hora com condições promissoras para observar o céu e umidade relativa ligeiramente mais alta.
A hora acrescentada começa às 22:00. A previsão indica explicitamente 0% de cobertura de nuvens nesse horário. Dados meteorológicos do Open-Meteo.
Experimente uma última mudança. Mantenha o horário estendido e peça vento abaixo de 8 km/h. Só a sexta-feira às 22:00 atende aos dois limites. Reduza o limite para abaixo de 7 km/h e nenhum dos cinco horários atende às suas preferências. Nesse caso, a resposta deve dizer que nenhum horário atende aos critérios e indicar que 7,5 km/h é o valor previsto mais próximo do limite de vento.
Altere apenas um limite e peça a velocidade do vento prevista para o horário que mais se aproxima do critério. Se um campo da previsão vier em branco, trate o valor como desconhecido. Dados meteorológicos do Open-Meteo.
Na previsão salva, o pôr do sol aparecia às 15:38 na quinta-feira e às 15:37 na sexta. Para observar uma galáxia de pouco brilho, confira também o fim do crepúsculo astronômico, a posição da Lua e se você tem uma visão desobstruída na direção certa. Antes de arrumar o equipamento, consulte de novo a previsão para o seu local e os seus horários. Se a data estiver fora do período de três dias coberto pela consulta ou se a requisição falhar, tente novamente quando houver dados atualizados. Definições de pôr do sol e crepúsculo do Observatório Naval dos EUA
As figuras mostram valores selecionados da previsão do Open-Meteo, distribuída sob a licença CC BY 4.0. A ilustração de abertura retrata uma montagem para observar o céu no quintal. Os números ao lado vêm da previsão salva.
Perguntas frequentes
Qual cobertura de nuvens é boa para observar o céu?
Para esta sessão no quintal, pedimos cobertura total de nuvens abaixo de 30%. Quanto menor a cobertura total, maior a parte do céu que pode estar livre, mas a porcentagem por si só não diz se uma nuvem vai encobrir o objeto que você quer ver. Escolha um limite adequado à sua sessão e confira o céu de novo antes de montar o telescópio.
Céu limpo significa bom seeing astronômico?
O seeing astronômico descreve o quanto a turbulência atmosférica borra ou distorce a imagem. A previsão de nebulosidade por hora pode ajudar você a encontrar uma abertura entre as nuvens. Medir o seeing ou prever a nitidez da imagem de um planeta exige outros dados.
Quanto tempo depois do pôr do sol dá para observar?
Esse intervalo varia com a latitude e a data. O crepúsculo astronômico da tarde termina quando o centro do Sol chega a 18° abaixo do horizonte, nos locais e datas em que isso ocorre. Esta configuração consulta os horários do pôr e do nascer do sol. Para saber quando termina o crepúsculo astronômico no seu local de observação, use uma calculadora de crepúsculo.
A previsão diz se vou conseguir ver a Lua ou Saturno?
Para saber se um objeto específico estará visível, você precisa da altitude e da direção dele no seu local e horário de observação. Se o alvo tiver pouco brilho, também importam a luz da Lua, a poluição luminosa e os obstáculos à visão. Consulte uma carta celeste ou efemérides junto com a previsão do tempo.
Preciso de uma chave de API do Open-Meteo?
O Open-Meteo oferece acesso ao serviço hospedado sem chave de API para usos não comerciais elegíveis. Para usar o serviço hospedado comercialmente, você precisa da assinatura adequada, dos endpoints para clientes e de uma chave de API. Você também pode manter sua própria instância com os dados abertos.
Qual fuso horário a previsão usa?
A consulta à previsão define timezone como auto para as coordenadas selecionadas. O Clear Slot usa o fuso informado junto com os dados horários. Informe sua disponibilidade no horário local de onde você vai observar.
O assistente avisa quando o céu abre?
O Clear Slot consulta a previsão quando você pede. Para atualizar a comparação, envie outra mensagem antes de levar o telescópio para fora. Para receber notificações automáticas, seria preciso configurar um agendador e um canal de envio.