Agentes autônomos com memória e contexto — patente depositada no USPTO

Hospitais · Painéis e indicadores

Painéis e indicadores do hospital

O painel não é uma tela que alguém precisa lembrar de abrir. É um documento escrito, que chega pronto no começo da manhã, com a conta aberta atrás de cada número — e com o que mudou desde ontem já nomeado.

Quem escreve é um Squad — o agente orquestrador da plataforma. Ele acorda no horário, lê os sistemas do hospital pela API e publica em PDF e HTML.

Captura do painel Hal-AI com a tabela de modelos de IA disponíveis.
O entregável

Um documento que chega, não uma tela que espera

Todo hospital já tem painel. O problema raramente é falta de tela: é que a tela só existe quando alguém abre, filtra o período certo e sabe o que procurar. Às sete da manhã, com a recepção enchendo, ninguém abre.

Painel que espera ser aberto

  • Só informa quem já sabia qual filtro aplicar e em que aba olhar
  • Mostra o número, nunca as parcelas: quando não fecha, ninguém descobre onde
  • Comparar com a semana passada exige exportar duas vezes e casar as colunas na mão
  • Não diz o que mudou — diz o que existe, e cabe ao leitor perceber a diferença
  • Se um sistema estava fora do ar na madrugada, o gráfico sai igual, só mais baixo

Documento escrito pelo Squad

  • Chega por e-mail às seis da manhã, em PDF e HTML, sem ninguém pedir
  • Toda conta agregada vem com as parcelas impressas ao lado do total
  • A comparação já vem feita, contra a janela histórica que a própria consulta trouxe
  • A análise é escrita: o que subiu, o que caiu e o que depende de uma decisão humana
  • Fonte que não respondeu vira linha nomeada no documento, não buraco silencioso no gráfico

A diferença não é o gráfico ser mais bonito. É o documento ter sido escrito por alguém que leu os dados.

A análise é escrita

Cada seção do painel tem texto: o que o Squad olhou, o que encontrou e o que recomenda olhar primeiro. É a parte em que o raciocínio dele agrega — e é a única parte que ele redige.

A tabela não é digitada

Tabela e gráfico são declarados por referência: o Squad diz de qual chamada de API vêm os dados e como agrupá-los. O servidor lê o retorno, faz a aritmética e desenha. O número não passa pelo modelo.

Sai inteiro ou não sai

Documento sem conteúdo é recusado antes de publicar, e um bloco cuja conta não pôde ser feita não vira eixo bonito com nada dentro. Nada de reticências, nada de "demais itens omitidos".

Quem escreve

Como um Squad monta o painel do dia

O Squad é o agente orquestrador da plataforma: não tem canal próprio e não conversa com paciente. Ele acorda no horário, consulta as APIs do hospital, decide o que é digno de nota, escreve o documento, publica em PDF e HTML e envia para a lista de destinatários. Todo dia, sem ninguém pedir.

1

Acorda no horário

A agenda é cadastrada pelo gestor — de segunda a sexta às 05:40, por exemplo, antes de a recepção abrir. Acordar não é ordem de agir: o Squad lê o próprio contexto e decide se aquela execução exige documento.

2

Consulta os sistemas

Chama as ferramentas que recebeu — api_get_agenda_ocupacao, api_get_agendamentos, api_get_demonstrativo_operadora — e pede, na mesma chamada, a janela histórica que vai servir de comparação.

3

Decide o que é digno de nota

Nem tudo que variou merece parágrafo. Ele separa a oscilação normal do que saiu do padrão da janela e escreve sobre o segundo — nomeando a especialidade, o turno ou a operadora onde aquilo aconteceu.

4

Publica e envia

O servidor monta o documento com a folha de estilo da casa, gera o PDF, guarda o HTML e dispara o e-mail para os endereços cadastrados. A execução fica registrada com o que foi consultado, o que foi decidido e o que foi enviado.

Do lado de dentro, a execução tem log. É por ele que o gestor confere de onde veio cada bloco do documento que chegou na caixa de entrada.

Hal-AI · Squad · Painel do Dia Execução #312
Painel do Dia · rotina agendada Segunda a sexta, às 05:40 · recorte: dia anterior, grade ambulatorial completa
Em execução Painel do Dia · via agenda Etapa 7 de 9
05:40:02Acordou pela agenda — recorte: dia anterior, grade ambulatorial completa 05:40:05api_get_agenda_ocupacao(dia="anterior", janela_historica_dias=30) 05:40:111ª tentativa expirou no HIS — repetida e respondida em 6 s 05:40:19498 horários no dia e 30 dias de histórico vieram na mesma resposta 05:40:22api_get_agendamentos(dia="anterior") — 428 registros lidos 05:41:03Faltas classificadas por antecedência de marcação — 4 faixas 05:41:48Blocos declarados: 1 gráfico, 1 tabela, 1 medidor — todos apontando para chamadas deste turno 05:42:06publicar_documento(formato=["html","pdf"]) 05:42:09Enviando aos destinatários cadastrados
498 horários lidos · 428 agendamentos · 103 faltas classificadas Publicado em PDF e HTML
Ninguém pediu este painel A execução nasce da agenda do Squad, não de um clique. quando não há nada digno de nota, a execução registra isso e não publica — e continua sendo bem-sucedida

O que você está vendo

O cabeçalho declara a rotina e o recorte. No log, cada linha em fonte mono é uma chamada de ferramenta de verdade; as linhas de raciocínio contam o que o Squad concluiu daquele retorno. A tentativa que expirou no HIS não foi escondida — virou linha amarela com o tempo da segunda chamada.

O rodapé fecha com as parcelas da execução: quantos horários foram lidos, quantos agendamentos e quantas faltas entraram na classificação.

Só na Hal-AI

Uma automação agendada dispara porque o relógio bateu e entrega o que o fluxo previu. Aqui o orquestrador decide o que aquela execução exige — inclusive concluir que não há nada de novo e não publicar nada.

  • Modo simulação para ensaiar a rotina sem disparar e-mail
  • Botão de parar que interrompe a execução no meio
  • Histórico auditável de cada rodada, com o que foi consultado e o que foi enviado

Como o Squad trabalha sozinho

Conta aberta

Todo total vem com as parcelas ao lado

É a marca da casa e vale para todo documento que a plataforma publica: nenhuma conta agregada aparece sozinha. Se o número não fecha, o leitor vê exatamente onde ele deixou de fechar — sem abrir o sistema, sem pedir para alguém refazer a consulta.

Um exemplo pequeno, que se repete em toda página

Uma especialidade ofertou 159 horários na semana. O painel nunca escreve só isso. Ele escreve 159 = 118 marcados + 41 livres, e quando o leitor desce para a tabela encontra os 118 abertos por turno e os 41 abertos por dia.

Parece capricho tipográfico. Não é: é o que permite conferir o documento em dez segundos em vez de meia hora. Se a soma das parcelas não bate com o total, o erro tem endereço — uma parcela a mais, uma a menos, ou duas janelas de tempo diferentes na mesma tabela. Sem as parcelas, o número errado tem exatamente a mesma cara do número certo.

  • Total com parcelas: 498 horários ofertados aparecem como 214 na manhã + 186 na tarde + 98 na noite.
  • Percentual com base: 86% de ocupação nunca sai sozinho — sai como 428 marcados sobre 498 ofertados.
  • Gráfico com soma: a legenda da figura declara que as barras somam o total citado no texto, e mostra as parcelas.
  • Exclusão nomeada: registro que ficou de fora do agrupamento é contado e explicado, nunca descartado em silêncio.
Comparação

Ele compara com ontem sem lembrar de ontem

Este é um detalhe técnico da plataforma que vale entender, porque muda o que se pode pedir ao Squad. Ele não guarda arquivo entre execuções e não tem memória da rodada anterior. Não existe a pasta em que o painel de ontem ficou salvo esperando o de hoje.

A comparação histórica vem da própria consulta: quando o Squad chama a API da agenda, pede junto a janela dos últimos trinta dias. A base de comparação chega no mesmo retorno que o dado do dia, e é contra ela que a leitura é feita.

Se a janela não vier na resposta, não há comparação naquele documento — e o documento diz isso, em vez de inventar uma referência.

O que o agente pode ler e o que ele não guarda

Do lado do console, isso tudo é configuração de uma rotina — e a janela de comparação é um parâmetro da própria consulta, não um arquivo guardado em algum lugar.

Hal-AI · Squad · Agenda e entrega Painel do Dia
Periodicidade Diária — segunda a sexta, às 05:40 Antes de a recepção abrir. Quando acorda, o Squad lê o próprio contexto e pode concluir que não há nada de novo a relatar naquele dia.
Janela de comparação 30 dias pedida na mesma chamada O histórico chega no retorno de api_get_agenda_ocupacao, junto com o dado do dia. Não existe base de comparação guardada entre uma execução e a seguinte.
Formato de saída HTML para leitura na tela e PDF anexo no e-mail A folha de estilo é do servidor: o agente escreve conteúdo, nunca aparência.
Modo Envio real Simulação disponível
Sem disco, sem arquivo, sem memória de ontem A rotina roda limpa a cada execução. tudo o que ela compara veio na resposta desta rodada — e o documento declara qual foi a janela
159 horários de uma especialidade na semana — impressos no painel como 118 marcados + 41 livres
100% das execuções com trilha de auditoria: o que foi consultado, o que foi decidido, o que foi gravado
0 números do painel digitados por um modelo de linguagem — tabela e gráfico leem o retorno da API
A rotina

Os painéis que a operação hospitalar pede todo dia

Cada um é uma rotina própria, com a sua agenda, a sua fonte e a sua lista de destinatários. São os mesmos assuntos das outras páginas desta seção — aqui eles aparecem do lado de quem lê o resultado.

Funil do Dia

O que a grade ofertou, o que foi marcado, o que virou consulta realizada e onde a vaga se perdeu — por turno e por especialidade. É o painel que abre a manhã da coordenação de agenda.

fonte: api_get_agenda_ocupacao

Agenda, ocupação e absenteísmo

Glosa por causa raiz

Quanto foi glosado no período, agrupado pela causa que originou a glosa e não pelo código devolvido pela operadora. Traz o prazo de recurso de cada caso e o que vence primeiro.

fonte: api_get_demonstrativo_operadora

Faturamento e glosas

Status de transmissão

Lotes enviados, lotes aceitos, protocolos importados e o que travou na crítica técnica — as operadoras contratadas num painel só, sem abrir portal por portal.

fonte: api_get_lote_tiss

Transmissão TISS

Conformidade e contrato

Audita a conta contra o prontuário antes de o lote sair: item faturado sem registro que o sustente, evolução que não cobre o procedimento cobrado, item cobrado abaixo do contrato. Cada achado sai com a referência que o originou e com a evidência que está faltando.

fonte: api_get_conta_paciente

Conformidade e tabelas

Atendimento no canal

Volume no número oficial, proporção resolvida sem ninguém da equipe entrar, tempo até a primeira resposta e quanto chegou fora do horário da recepção.

fonte: api_get_conversas_canal

Atendimento no WhatsApp

Operações de agenda

Marcações, remarcações e cancelamentos feitos pelo agente na agenda oficial, com a proporção concluída na primeira tentativa e o que precisou de transbordo para a recepção.

fonte: api_post_agendamento

Marcação de consultas

Uma rotina por assunto, não um painel gigante

Seria mais simples juntar tudo num documento só. Seria também inútil: o faturamento não lê funil de agenda e a coordenação de agenda não abre glosa por causa raiz. Cada rotina tem horário próprio, fonte própria e lista de destinatários própria — e pode ser ligada sozinha, sem depender das outras.

É também o que permite começar pequeno. Um hospital costuma ligar o Funil do Dia primeiro, porque a fonte já existe e o resultado aparece na primeira semana, e só depois acrescenta as rotinas do ciclo de receita.

O painel é a leitura, não a ação

Quando a leitura pede uma conversa com o paciente — chamar a fila de espera para a vaga que sobrou, por exemplo —, quem fala é o agente de canal, no número oficial do hospital. O Squad conversa com ele em linguagem natural e recebe a resposta de volta, inclusive quando a resposta é esta pessoa já foi abordada ontem, não repeti.

Como a marcação chega à agenda oficial

São seis documentos diferentes, escritos pelo mesmo tipo de agente, lendo os sistemas que o hospital já tem.

O entregável

O painel do dia, como ele chega

Abaixo, uma representação do Funil do Dia para o hospital do exemplo — rede de médio-grande porte, 28 especialidades ambulatoriais, cerca de 2.500 horários de consulta ofertados por semana. A folha é clara e serifada de propósito: o entregável não se parece com o painel, ele se parece com um relatório.

Hal-AI · Documento publicado pelo Squad PDF · 318 KB

Funil do Dia · execução #312

O que a grade ofertou na quarta, o que virou consulta e onde a vaga se perdeu

Documento publicado pelo Squad ao fim da execução das 05:40, sobre a grade ambulatorial do dia anterior, comparado com a janela dos trinta dias que veio na mesma consulta.

período quarta · 16/09 fonte api_get_agenda_ocupacao execução #312
01Panorama do dia

A grade ofertou 498 horários na quarta — 214 na manhã, 186 na tarde e 98 na noite. 428 foram marcados, o que dá 86% de ocupação, e 304 viraram consulta realizada: 61% de conversão de horário ofertado em atendimento. Dos 428 marcados, 103 pessoas faltaram e 21 cancelaram no mesmo dia; outros 70 horários nunca chegaram a ser marcados.

Horários ofertados 498 214 manhã + 186 tarde + 98 noite
Não viraram consulta 194 70 livres + 103 faltas + 21 cancelados no dia
Ocupação da grade 86% 428 marcados sobre 498 ofertados
02Vaga livre por dia útil da janela

Nos cinco dias úteis da janela sobraram 346 horários sem marcação, uma média de 69 por dia. A quarta ficou em 70, dentro do esperado. O ponto fora da curva é a sexta anterior, com 82 — e a sexta é o dia em que a fila de espera das especialidades de maior demanda mais cresce.

Horários que ficaram sem marcação, por dia útil fonte: api_get_agenda_ocupacao · escala e desenho do servidor

Figura 1 — 74 + 82 + 62 + 58 + 70 somam os 346 horários livres dos cinco dias úteis; a média de 69 é 346 ÷ 5.

03O funil por turno

A noite é o turno com a menor ocupação e a maior proporção de falta sobre o marcado. A manhã sustenta a grade: 190 dos 428 agendamentos do dia estão nela.

Funil da grade ambulatorial por turno na execução #312: ofertados, marcados, realizados e faltas
Turno Ofertados Marcados Realizados Faltas Estado
Manhã 214 190 138 44 ocupação 89%
Tarde 186 158 112 38 ocupação 85%
Noite 98 80 54 21 ocupação 82%
Total do dia 498 428 304 103

Tabela 1 — mesma chamada de api_get_agenda_ocupacao da Figura 1, agrupada por turno. Os 21 cancelamentos do próprio dia (8 + 8 + 5) não têm coluna: em cada linha, marcados = realizados + faltas + cancelados.

04Falta por antecedência da marcação

As 103 faltas não se distribuem por igual ao longo do tempo de espera. Mais da metade — 52 de 103 — vem de horários marcados com mais de trinta dias de antecedência. Proporcionalmente ao volume de cada faixa, quem marcou com mais de trinta dias falta cerca de duas vezes mais que quem marcou para o mesmo dia. A antecedência é o preditor mais barato que esta grade tem.

Mais de 30 dias52 De 8 a 30 dias33 Até 7 dias14 No mesmo dia4

Figura 2 — 52 + 33 + 14 + 4 somam as 103 faltas da quarta, distribuídas pela antecedência com que o horário foi marcado.

05Comparação dentro da janela

Esta leitura é comparada com os trinta dias anteriores porque a janela veio no mesmo retorno de api_get_agenda_ocupacao. Contra ela, a quarta fecha acima da média em ocupação e em conversão, e a distribuição das faltas por antecedência repete o padrão do mês. Se a consulta não tivesse trazido o histórico, não haveria comparação neste documento — a rotina não guarda arquivo entre execuções e não tem como recuperar o painel de ontem.

O que a direção precisa decidirSobraram 70 horários livres na quarta e 82 na sexta anterior, enquanto a fila de espera das especialidades de maior demanda continua aberta. Chamar a fila para esses horários é decisão humana: o Squad relata a vaga ociosa, mas não remaneja grade nem marca paciente por conta própria.

O que você está vendo

Cabeçalho com o período, a chamada de API que alimentou a peça e o número da execução. Cinco seções numeradas, cada uma com o texto escrito pelo Squad antes do bloco de dados. A Figura 1 e a Tabela 1 leem o mesmo retorno — uma agrupada por dia, a outra por turno.

O bloco que fecha o documento é o único que não relata: separa o que a rotina já resolveu do que depende de uma pessoa decidir.

Nenhum número fica sozinho

498 aparece como 214 + 186 + 98. 194 aparece como 70 + 103 + 21. 86% aparece como 428 sobre 498. As cinco barras da Figura 1 somam os 346 horários livres da janela, e os quatro medidores da Figura 2 somam exatamente as 103 faltas da tabela.

Conferir a peça é olhar duas parcelas na tela — não refazer a consulta no sistema.

A vantagem

A coordenação de agenda abre a caixa de entrada às sete e já sabe onde olhar: a vaga ociosa está nomeada por turno, a falta está explicada pela antecedência e a decisão pendente está separada do resto.

Como a estrutura é a mesma toda manhã, o documento de hoje é comparável com o de ontem sem ninguém refazer conta para alinhar as duas leituras.

Ver a página de agenda e ocupação

Entrega

O e-mail que acompanha o documento

O documento é o entregável; o e-mail é só a porta de entrada dele. Por isso o corpo da mensagem é curto e obedece a uma regra dura: nenhum número aparece no e-mail se não estiver no documento anexo. Quem lê no celular a caminho do hospital recebe o essencial; quem precisa do detalhe abre o PDF.

Enviado pelo Squad · hoje 05:42
Funil do Dia — quarta, 16/09
E-mailPDF + HTML3 destinatários ativos
Bom dia. A grade ofertou 498 horários ontem; 428 foram marcados e 304 viraram consulta. Sobraram 70 horários livres e 103 pessoas faltaram — mais da metade delas vinha de marcação com mais de trinta dias de antecedência.
Há uma decisão aberta no documento: os 70 horários livres de quarta e os 82 da sexta anterior, com a fila de espera ainda em aberto.
Painel do Dia · execução #312 Entregue

O anexo volta também para o chat da execução, como arquivo clicável — é por ali que o gestor abre a peça sem sair da conversa com o orquestrador.

Funil do Dia — 16/09 PDF · funil-do-dia-1609.pdf · 318 KB · versão HTML no mesmo link Abrir documento

Balão do documento publicado, como ele aparece no chat da execução do Squad.

Lista fechada

Quem recebe é cadastro, não instrução de texto

A lista de destinatários é do hospital e fica no painel. Durante a execução o Squad escolhe dentro dela — não digita endereço novo, não edita a lista e não improvisa encaminhamento. Cada endereço é conferido antes do disparo.

direcao@hospital.exemplo agenda.ambulatorio@hospital.exemplo faturamento@hospital.exemplo auditoria@hospital.exemplo · pausado

Tirar uma pessoa da lista é uma alteração de cadastro, não uma reescrita do prompt do agente — e um endereço fora da lista é barrado antes do envio.

Controles e permissões do agente

Painel diferente, destinatário diferente. Não adianta mandar glosa para a coordenação de agenda nem funil do dia para o faturamento: cada rotina tem a sua lista.

Quem recebe cada painel da rotina hospitalar e por quê
Quem recebe Painel Por que aquele documento
Direção Funil do Dia e o consolidado da semana Precisa da leitura curta do que mudou, com a decisão pendente já separada do relato.
Coordenação de agenda Funil do Dia, com o recorte por especialidade Age no mesmo dia: chama a fila de espera para a vaga que sobrou e redistribui a grade da semana seguinte.
Faturamento Glosa por causa raiz e Status de transmissão Trabalha contra prazo contratual: precisa saber o que vence primeiro e qual lote travou na crítica.
Comercial e relacionamento Atendimento no canal Acompanha o volume no número oficial, o tempo de resposta e a reclamação que virou transbordo.
Auditoria interna Trilha das execuções, sem o documento Não precisa do indicador: precisa saber o que foi consultado, o que foi decidido e o que foi enviado.
Copiloto HAL

Quando o gestor prefere perguntar a ler

O painel responde à pergunta que se repete todo dia. Para a pergunta que nasceu agora — por que a ocupação caiu na quarta? — o caminho é outro: o Copiloto HAL, o assistente interno de quem administra.

Ele consulta os dados do próprio hospital em modo somente leitura e responde com texto, tabela e gráfico na tela. O gestor pode exportar em PDF, pedir uma verificação recorrente ou simplesmente fechar a página: a missão continua rodando no servidor e o resultado chega por notificação.

  • Pergunta em português, sem filtro, sem aba e sem saber o nome do campo no sistema.
  • A mesma conta aberta: a resposta traz as parcelas, como o documento traria.
  • Somente leitura — o Copiloto não marca consulta, não envia lote e não altera cadastro.
  • A análise profunda lê caso a caso quando a pergunta exige, em vez de devolver só o agregado.
Copiloto HAL online
Por que a ocupação caiu na quarta?07:18
Ela não caiu em relação à janela: a quarta fechou em 86%, acima da média dos últimos trinta dias. O que mudou foi onde a vaga sobrou — 70 horários livres, concentrados no turno da noite.07:18
Onde exatamente?07:19
A noite ofertou 98 horários e marcou 80, ocupação de 82% — a menor dos três turnos. Manhã ficou em 89% e tarde em 85%.07:19
Faz um gráfico disso por dia e me manda em PDF07:20
Feito. Pode fechar a página: aviso quando o arquivo estiver pronto.07:20

Mesma memória, mesmas ferramentas de leitura. Muda quem puxa o gatilho: aqui, o gestor; no painel, a agenda do Squad.

Duas formas de pedir o mesmo número

  • Agora, na conversa: o Copiloto responde ao gestor com a tabela na tela e o PDF pronto para encaminhar.
  • Sozinho, no horário: o Squad publica o documento completo e o entrega à lista cadastrada, sem ninguém pedir.

A pergunta de hoje vira rotina amanhã: quando a mesma consulta se repete toda semana, ela deixa de ser pergunta e vira painel agendado.

Limites

O que o painel não é

Um painel diário que promete ser tudo acaba não sendo usado para nada. Vale dizer com todas as letras o que esta peça não substitui — e o que a plataforma se recusa a fazer.

Não substitui o BI do hospital

O BI é onde se olha a série longa, se cruza dimensão com dimensão e se investiga a hipótese que ninguém formulou ainda. O painel diário é outra coisa: é a leitura do que mudou desde ontem, escrita para ser lida em três minutos antes de a operação começar.

Os dois convivem. Quando a pergunta do painel exige a série inteira, ela vai para o BI — ou para o Copiloto, que lê em linguagem natural.

Lê o prontuário para conferir a conta, não para opinar sobre o caso

Nenhum painel agregado carrega nome, documento, telefone ou qualquer identificador de paciente. O Squad lê agenda, conta e demonstrativo; na rotina de conformidade, lê também o prontuário — para conferir se o registro sustenta o que foi faturado e apontar, item a item, onde não sustenta. Até aí vai a leitura clínica: ele não escreve uma linha sobre conduta, diagnóstico ou orientação médica.

Entrega o achado; a execução é do hospital

O painel entrega o achado sustentado: a vaga ociosa, a glosa que vence primeiro, o lote que travou e o item que a documentação não sustenta — cada um com a causa provável e o prazo. O que ele não faz é executar: não remaneja grade, não cancela lote, não abre exceção contratual e não chama paciente por conta própria. Quem assina a correção é o hospital, num bloco à parte no fim do documento; o trabalho de achar já está feito.

  • Não inventa referência: sem janela histórica na resposta, não há comparação no documento
  • Não corta a lista: documento sai inteiro, sem reticências e sem "demais itens omitidos"
  • Não publica peça vazia: bloco sem dado é recusado antes de o documento sair
  • Não escolhe destinatário: quem não está na lista cadastrada não recebe

Falhar na entrega é ruim. Entregar um eixo bonito com nada dentro é pior, porque passa despercebido.

Integrações, LGPD e trilha de auditoria

Um painel serve para decidir. Decidir sobre número aproximado é pior do que não ter painel.

Perguntas

Perguntas frequentes

Vamos ter que abrir mais um sistema todo dia?

Não. O painel chega como documento: PDF anexo no e-mail e versão HTML no link, para quem preferir ler na tela. Não há login novo para a direção nem para a coordenação de agenda — quem quiser navegar no console tem acesso, mas ninguém precisa dele para receber a leitura da manhã.

O número da tabela passa pelo modelo de IA?

Não. Tabela e gráfico são declarados por referência: o Squad diz de qual chamada de API vêm os dados, qual lista usar e como agrupar. O servidor lê o retorno, calcula soma, percentual e escala, e desenha o bloco. O modelo escreve o texto de análise e escolhe o recorte — a aritmética não é trabalho dele.

É por isso que toda conta agregada sai com as parcelas ao lado: elas vêm do mesmo retorno que o total, e discordar entre si significaria que o dado mudou na fonte.

Se ele não guarda nada entre execuções, como compara com ontem?

A comparação vem da própria consulta. Quando o Squad chama a API da agenda, pede junto a janela histórica — os últimos trinta dias, por exemplo — e a base de comparação chega no mesmo retorno que o dado do dia. Ele não tem disco, não mantém arquivo de uma execução para a outra e não "lembra" da rodada anterior.

A consequência prática é útil de saber na hora de desenhar a rotina: se a API não devolve histórico, o documento daquele dia sai sem comparação, e diz isso. Nada é reconstruído de memória.

Quem define a lista de destinatários e quem pode mudá-la?

O hospital. A lista é cadastro no painel, mantida por quem o hospital autorizar, e cada rotina tem a sua. O agente escolhe dentro da lista durante a execução; ele não cria endereço, não edita a lista e não encaminha o documento para fora dela. Endereço fora da lista é barrado antes do disparo, e o envio fica registrado com quantos destinatários foram alcançados.

E se um sistema estiver fora do ar na hora da execução?

A tentativa que falhou vira linha no log, com o horário e o resultado da repetição. Se a fonte continuar indisponível, o bloco que dependia dela não é preenchido com estimativa: ele sai nomeado como não apurado, e o documento explica qual leitura ficou faltando naquele dia.

Uma execução que conclui não haver nada digno de nota também é um desfecho declarado, não uma falha para o supervisor investigar — ela registra a verificação e não publica documento.

Traga o relatório que a sua equipe monta à mão toda manhã

Mostramos como o Squad lê os sistemas do hospital, escreve o documento com a conta aberta e o entrega no horário — para a lista de destinatários que o hospital definir.