buscar_instrumentos
ChatGPTBusca 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.
comentarios_ocorrencia
ChatGPTLista os comentarios (historico de acompanhamento) de uma ocorrencia.
consultar_programacoes
ChatGPTConsulta as programacoes de leitura de um instrumento ou de uma usina em um periodo (padrao: 90 dias atras ate 30 dias a frente; com status=ATRASADA o padrao passa a 365 dias atras): data planejada, data tolerada, data de execucao, atraso e status FEITA, ATRASADA, PROGRAMADA ou FUTURA. Use para responder "quando foi/sera lido", "esta atrasado?" e "quais leituras estao pendentes".
detalhar_inspecao
ChatGPTDetalha uma inspecao: perguntas respondidas, respostas, observacoes e registros fotograficos.
detalhar_instrumentos
ChatGPTDetalha 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_ocorrencia
ChatGPTDetalha uma ocorrencia, incluindo campos personalizados e responsaveis.
gerar_relatorio_personalizado
ChatGPTSolicita 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".
grafico_instrumento
ChatGPTDados 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.
instrumentos_em_advertencia
ChatGPTResumo 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.
link_atalayas
ChatGPTMonta 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.
listar_checklists
ChatGPTLista os checklists (roteiros de inspecao) de uma usina ou de todo o tenant.
listar_combinacoes_grafico
ChatGPTLista as visualizacoes (combinacoes) de grafico salvas pelos usuarios do Atalayas para um instrumento: id, nome, instrumentos combinados, formulas e medidas selecionadas e periodo salvo. Use antes de montar um grafico combinado: se existir uma visualizacao com o que o usuario pediu (por exemplo piezometro x nivel do reservatorio), chame grafico_instrumento com combinacaoId; se nao existir, monte a combinacao na hora com instrumentosCombinados.
listar_inspecoes
ChatGPTLista inspecoes filtrando por usina e/ou checklist. Informe ao menos um filtro para evitar listas extensas.
listar_ocorrencias
ChatGPTLista ocorrencias (anomalias, nao conformidades, acoes) de uma usina, paginadas. Por padrao traz somente ocorrencias ativas. Retorna id, descricao, tipo, categoria, prioridade, datas e responsaveis.
listar_planejamentos_usina
ChatGPTLista os planejamentos de leituras (e de inspecoes, se o usuario puder ve-las) vigentes em uma usina na data de referencia, com contagens de programacoes feitas, atrasadas e programadas e o detalhe das programacoes pendentes (atrasadas e programadas) da janela atual, limitado a 40 por planejamento. Para historico, itens ja feitos ou datas futuras use consultar_programacoes.
listar_relatorios_personalizados
ChatGPTLista os relatorios personalizados que o usuario pode gerar para uma usina (os mesmos da tela de relatorios do Atalayas): id, nome, descricao, tipo de disparo, se entra na fila e se exige parametros.
listar_tenants
ChatGPTLista os tenants (clientes Atalayas, ex.: cesp, edp, alianca) aos quais o usuario autenticado tem acesso. Chame primeiro; toda outra tool exige o parametro tenant escolhido desta lista.
listar_usinas
ChatGPTLista as usinas/barragens ativas do tenant, com id e nome, para uso nas demais consultas.
meu_usuario
ChatGPTInforma quem e o usuario autenticado: identidade no Exiti ID (nome, e-mail, login) e, para cada tenant a que tem acesso, o usuario do Atalayas (id, login, nome), o grupo e as permissoes. Use para saber em nome de quem as consultas sao feitas e o que o usuario pode ou nao ver em cada cliente.
ultima_leitura_instrumento
ChatGPTRetorna a ultima leitura registrada de um instrumento: data, leiturista, observacao e, para cada medida, o valor lido, o resultado calculado e os valores anteriores. Nao e uma serie historica completa. Ausencia de leitura nao significa valor zero.
ultimas_inspecoes_usina
ChatGPTRetorna as inspecoes mais recentes de uma usina, com status, datas, responsavel e checklist.