Agente de IA para Relatório de Controle de Infecções

Definir, a partir do pedido do usuário, quais fontes deverão ser consultadas, quais indicadores epidemiológicos serão calculados e como os dados devem ser padronizados antes da análise.

1.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio de um JSON com escopo do relatório via API. Na fase de testes, o fluxo será iniciado pelo envio manual do JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um JSON que define o escopo do relatório.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON que define o plano de coleta e padronização dos dados.
• Exemplo de Estrutura de Output:

   {"consultas": [{"fonte_id": "api_hospital", "tipo": "api", "parametros_prontos": {"endpoint": "/dados/infeccoes", "filtros": {"periodo": "2025-01-01/2025-01-31"}}}], "dicionario_dados_canonico": {"campos_padrao": [...]}, "chaves_dedup": [{"conjunto_campos": [...]}, "regras_validacao": [{"campo": "data_evento", "regra": "data_evento >= 2025-01-01", "severidade": "crítica"}], "matriz_mapeamento_codigos": [{"sistema_origem": "SNOMED", "codigo_origem": "123456", "codigo_destino": "654321"}], "triggers_execucao": {"coleta_api_requerida": true}} 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.000 caracteres.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

1.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

1.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Execução de Chamada à API (RF 2), Agente de Execução de Consultas em Banco de Dados (RF 3), e Agente de Execução de Consulta a Documento (RF 4).

1.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API (RF 2), o Agente de Execução de Consultas em Banco de Dados (RF 3), e o Agente de Execução de Consulta a Documento (RF 4) de acordo com os triggers definidos.

Realizar chamadas às APIs das fontes definidas para obter dados de controle de infecções.

2.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 1).
• Tipo do input: Este agente deve ser apto a receber um payload pronto para realizar chamadas às APIs definidas.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos obtidos de cada fonte consultada.
• Exemplo de Estrutura de Output:

   {"resultados_api": [{"fonte_id": "api_hospital", "registros": [...], "meta": {"total": 100, "paginas": 5, "completude": "100%"}}]} 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 3.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá realizar chamadas às APIs externas conforme definido no payload recebido.

2.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Consolidação, Higienização e Padronização (RF 5).

2.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Consolidação, Higienização e Padronização (RF 5).

Executar queries nas bases transacionais/analíticas definidas no plano para recuperar dados necessários.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 1).
• Tipo do input: Este agente deve ser apto a receber parâmetros prontos para executar queries nas bases definidas.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos obtidos de cada base consultada.
• Exemplo de Estrutura de Output:

   {"resultados_db": [{"fonte_id": "db_hospital", "registros": [...], "meta": {"linhas": 500, "completude": "100%"}}]} 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 3.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá executar queries em bancos de dados externos conforme definido nos parâmetros recebidos.

3.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Consolidação, Higienização e Padronização (RF 5).

3.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Consolidação, Higienização e Padronização (RF 5).

Realizar consulta a documentos internos (planilhas/relatórios) para obter informações de controle de infecções definidas no plano.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 1).
• Tipo do input: Este agente deve ser apto a receber parâmetros prontos para realizar consulta a documentos internos.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 5.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos obtidos de cada documento consultado.
• Exemplo de Estrutura de Output:

   {"resultados_documento": [{"fonte_id": "doc_hospital", "registros": [...], "meta": {"linhas": 50, "origem_documento": "relatorio_infeccoes_2025.xlsx"}}]} 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 3.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: O agente deverá acessar e consultar documentos internos conforme definido nos parâmetros recebidos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

4.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Consolidação, Higienização e Padronização (RF 5).

4.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Consolidação, Higienização e Padronização (RF 5).

Unificar os datasets brutos das diferentes fontes, remover duplicidades, tratar ausências e padronizar os dados para o modelo canônico definido.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão dos agentes anteriores (RF 2, RF 3 e RF 4).
• Tipo do input: Este agente deve ser apto a receber um pacote com resultados das coletas de dados brutos das diferentes fontes.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 15.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o dataset canônico consolidado e um relatório de qualidade dos dados processados.
• Exemplo de Estrutura de Output:

   {"tabelas": {"eventos_infeccao": [...], "culturas_microbiologicas": [...], "dispositivos_paciente": [...], "denominadores": [{"unidade": "UTI", "periodo": "2025-W01", "patient_days": 100, "device_days_por_tipo": {"CVC": 50, "SVD": 30, "VM": 20}}], "auditorias_higiene": [...], "consumo_ABHR": [...], "uso_antimicrobianos": [...]}, "relatorio_qualidade": {"erros_criticos": [...], "correcoes_aplicadas": [...], "campos_faltantes_por_fonte": [...], "taxa_completude_por_campo%": {...}}} 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 5.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para padronização e tratamento de dados.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

5.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Cálculo de Indicadores Epidemiológicos (RF 6).

5.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Cálculo de Indicadores Epidemiológicos (RF 6).

Calcular indicadores de controle de infecções e estatísticas de tendência a partir do dataset canônico consolidado.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber um dataset canônico consolidado para cálculo de indicadores.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a matriz de indicadores por unidade e período, incluindo alertas e tendências.
• Exemplo de Estrutura de Output:

   {"indicadores": [{"nome": "Incidência DAI", "unidade": "UTI", "periodo": "2025-W01", "numerador": 5, "denominador": 1000, "taxa_por_1000": 5.0, "limite_referencia": 4.0, "classificacao_cor": "vermelho"}], "series_temporais": [{"nome": "Incidência DAI", "unidade": "UTI", "pontos": [{"periodo": "2025-W01", "valor": 5.0}]}], "alertas": [{"nome": "Surto de DAI", "unidade": "UTI", "periodo": "2025-W01", "tipo_alerta": "surto", "justificativa": "Incidência acima do limite por 2 meses consecutivos."}]} 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 4.000 caracteres.

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

6.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para cálculos estatísticos e classificação de indicadores.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

6.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Elaboração de Relatório e Insights Acionáveis (RF 7).

6.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Elaboração de Relatório e Insights Acionáveis (RF 7).

Produzir relatório detalhado e executivo, destacando áreas críticas, tendências e recomendações acionáveis para gestão hospitalar.

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: Este agente deve ser apto a receber indicadores calculados, séries temporais, alertas e um relatório de qualidade dos dados processados.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 20.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em dois formatos: markdown analítico e JSON estruturado com insights.
• Exemplo de Estrutura de Output:

   {"markdown_analitico": "# Relatório de Controle de Infecções\n## Visão Geral...", "json_estruturado_com_insights": {"sumario_executivo": [...], "destaques_por_unidade": [...], "areas_criticas": [...], "tendencias_chave": [...], "recomendacoes": [{"problema": "Alta incidência de DAI", "acao_recomendada": "Auditoria de bundle CVC diária", "responsavel_sugerido": "CCIH", "prazo_sugerido": "30 dias", "impacto_esperado": "Redução de 20% na taxa", "indicador_monitoramento": "Incidência DAI", "meta": "Conformidade > 85%", "prioridade": "alta"}], "anexos": {"tabelas_chave": [...], "notas_metodologicas": [...], "qualidade_dados": [...]}}} 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 10.000 caracteres.

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para geração de insights e recomendações.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

7.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta é o entregável final e não é passada para outros agentes internos.

7.3.6 Regras de Orquestração e Transição

A execução deste agente finaliza o fluxo. O relatório gerado é o resultado que deve ser disponibilizado ao usuário.