Atalayas

Busca instrumentos de uma usina por nome/identificacao (ex.: "PZ-01", "piezometro"). Retorna id, nome, identificacao e tipo. Use o id retornado em ultima_leitura_instrumento.

buscar_instrumentos

Lista os comentarios (historico de acompanhamento) de uma ocorrencia.

comentarios_ocorrencia

Detalha uma inspecao: perguntas respondidas, respostas, observacoes e registros fotograficos.

detalhar_inspecao

Detalha os instrumentos ativos de uma usina, paginados de 30 em 30: medidas, grandezas, limites/alertas, status e o historico recente de leituras de cada medida. Use quando precisar de dados alem de id e nome.

detalhar_instrumentos

Detalha uma ocorrencia, incluindo campos personalizados e responsaveis.

detalhar_ocorrencia

Solicita a geracao de um relatorio personalizado em nome do usuario autenticado. O relatorio e gerado em segundo plano e entregue por e-mail (e WhatsApp, quando configurado) ao usuario do Atalayas; nada e devolvido aqui alem da confirmacao. Confirme com o usuario antes de chamar. Relatorios que exigem parametros na tela ainda nao podem ser disparados por aqui, exceto scripts Python, que aceitam o mapa "parametros".

gerar_relatorio_personalizado

Dados do grafico de um instrumento no periodo (padrao: ultimos 90 dias), com as mesmas series, limites e referencias da tela do Atalayas. Por padrao devolve JSON compacto: eixos, series classificadas (papel leitura, limite ou referencia), unidade, instrumento de origem, pontos [data, valor] reduzidos a no maximo 200 por serie, ultimo valor, minimo e maximo. Desenhe o grafico com esses dados (o JSON traz instrucaoParaOAgente), analise a tendencia e compare com os limites. Graficos combinados: informe instrumentosCombinados (ate 5 ids de outros instrumentos, por exemplo um piezometro com o instrumento de nivel do reservatorio) para juntar as series de cada um, ou combinacaoId (de listar_combinacoes_grafico) para aplicar uma visualizacao salva pelo usuario. medidas e formulas (ids) restringem as series do instrumento base as escolhidas; so medidas marcadas para aparecer no grafico sao aceitas pelo Atalayas. formato=imagem devolve a imagem PNG renderizada em vez dos dados.

grafico_instrumento

Resumo estrategico por usina, calculado pelo Atalayas: instrumentos ativos, em advertencia na ultima leitura (com a lista deles), em advertencia recente, que sairam da advertencia no ultimo mes, sem leituras, leituras e inspecoes em atraso e ocorrencias abertas. Use para "como esta a usina X hoje?" e "o que esta em alerta?". Sem usinaId, devolve todas as usinas do tenant.

instrumentos_em_advertencia

Monta o link da tela do Atalayas web para um instrumento, uma ocorrencia ou um checklist do tenant, para o usuario abrir o registro no sistema (ex.: https://<cliente>.atalayas.com.br/sistema/instrumentoCadastrar.syst?infra=123). Para uma inspecao, informe o id do checklist e acrescente &id=<idInspecao> ao link retornado.

link_atalayas

Lista os checklists (roteiros de inspecao) de uma usina ou de todo o tenant.

listar_checklists