1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados e demais requisitos funcionais para o Agente de IA "Planejamento de Nutrição Hospitalar". Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.
O objetivo principal é criar planos nutricionais personalizados para pacientes internados, considerando restrições dietéticas e condições de saúde específicas, além de coordenar com a equipe médica para garantir que a dieta apoie o tratamento clínico.
2. Contexto e Problema
Cenário Atual
Nos hospitais, a elaboração de planos nutricionais é um processo complexo que envolve a análise de múltiplos dados clínicos e dietéticos dos pacientes. Os nutricionistas enfrentam desafios como:
- Necessidade de planos nutricionais personalizados que considerem restrições dietéticas e condições de saúde específicas.
- Coordenação eficaz entre a equipe de nutrição e a equipe médica para garantir que a dieta apoie o tratamento clínico.
A falta de integração e automação nesse processo pode levar a atrasos e a planos inadequados, impactando negativamente a recuperação dos pacientes.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Melhorar a precisão dos planos nutricionais por meio da análise automatizada de dados clínicos e dietéticos.
- Reduzir o tempo de elaboração dos planos, permitindo ajustes rápidos conforme mudanças no estado de saúde do paciente.
- Aumentar a coordenação entre nutricionistas e médicos, garantindo que os planos nutricionais sejam revisados e aprovados antes da implementação.
4. Visão Geral da Solução
O agente de IA para planejamento de nutrição hospitalar analisa dados clínicos e dietéticos para criar planos nutricionais personalizados, ajustando-os conforme necessário e garantindo a revisão e aprovação por nutricionistas. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um assistente útil e autônomo no planejamento nutricional hospitalar.
A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com a análise dos dados clínicos e dietéticos e termina com a revisão e aprovação do plano nutricional.
| Agentes | Função Principal |
|---|---|
Agente de Análise de Dados Clínicos e Dietéticos (RF 1)
| Transformar dados clínicos e dietéticos em um plano nutricional hospitalar personalizado e pronto para revisão humana. |
Agente de Coordenação com Equipe Médica (RF 2)
| Preparar o dossiê para aprovação humana, checar alinhamento clínico e consolidar a decisão do nutricionista sobre o plano antes da implementação. |
5. Protótipos
Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram tanto o fluxo de trabalho dos agentes quanto o resultado final que o cliente receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Análise de Dados Clínicos e Dietéticos
1.1 Tarefa do Agente
Transformar dados clínicos e restrições dietéticas em um plano nutricional hospitalar personalizado e pronto para revisão humana.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON com dados clínicos e dietéticos do paciente. Campos mínimos: identificacao_paciente{id, nome}, antropometria{peso_kg, altura_cm, idade_anos, sexo}, clinico{diagnosticos[], estado_clinico, via_alimentacao[VO|SNE|SNG|GTT|NPT], consistencia[normal|pastosa|branda|liquida|espessada], diurese_ml_dia, restricao_hidrica_ml_dia}, exames{glicemia_mgdl, sodio_mEqL, potassio_mEqL, fosforo_mgdl, magnesio_mEqL, creatinina_mgdl, ureia_mgdl, TFG_ml_min, albumina_gdl, bilirrubinas, TGO, TGP, perfil_lipidico}, medicamentos_ativos[], alergias_intolerancias[], preferencias_culturais_religiosas[], restricoes_dieteticas_explicitadas[], metas_medicas_relevantes[], sinais_alerta{risco_aspiracao, mucosite, diarreia, constipacao}, historico_ingestao{%ingestao_ultimas_24h}.
# 2. Objetivo
Analisar os dados para criar um plano nutricional personalizado, respeitando as restrições e condições clínicas do paciente, pronto para revisão por um nutricionista.
# 3. Regras que você deve seguir para gerar sua resposta
- Identificação e integridade de dados: se qualquer campo mínimo crítico estiver ausente (peso_kg, altura_cm, idade_anos, sexo, via_alimentacao), defina pronto_para_revisao=false e inclua em itens_conflitantes a lista de campos faltantes; ainda assim calcule o que for possível e registre pressupostos.
- Antropometria: calcule IMC= peso_kg/(altura_m^2). Se paciente obeso (IMC>=30) em CTI, priorize peso ajustado: peso_ajustado = peso_ideal + 0.25*(peso_atual - peso_ideal); peso_ideal por altura e sexo (IMC alvo 22 se idoso, 24 se adulto geral). Saída deve incluir peso_ajustado_kg quando usado.
- Metas energéticas padrão hospitalares (orientação de negócio):
• Adulto enfermaria/UTI estável: 25-30 kcal/kg/dia (usar peso ajustado quando indicado).
• Obesidade IMC 30-40 em UTI: 11-14 kcal/kg peso atual; IMC>40: 22-25 kcal/kg peso ideal ajustado.
• Proteínas: estado catabólico leve/moderado 1.2-1.5 g/kg; sepse/queimados/pós-operatório maior 1.5-2.0 g/kg; DPOC 1.2-1.7 g/kg.
• IRC sem diálise estável: 0.6-0.8 g/kg se não catabólico; hemodiálise/diálise peritoneal: 1.0-1.2 g/kg (até 1.5 g/kg se catabólico).
• Doença hepática com ascite: energia 30-35 kcal/kg; proteína não restringir rotineiramente; preferir distribuição ao longo do dia e proteína vegetal/ramificada quando encefalopatia ativa.
- Hidratação: se restricao_hidrica_ml_dia informado, defina liquidos_alvo_ml_dia = valor informado; senão, calcule 30-35 ml/kg/dia e ajuste por insuficiência cardíaca/renal (reduzir para 20-25 ml/kg se hiponatremia/edema). Registre justificativa em racional_resumido.
- Vias e consistências:
• Se via_alimentacao != VO, priorize plano enteral/parenteral conforme input.
• Se risco_aspiracao=true, defina consistência espessada e fracionamento; registre alerta clínico correspondente.
- Restrições e condições clínicas:
• DM/Hiperglicemia: priorize carboidrato consistente (40-50% kcal), fibras solúveis, evitar açúcares simples; distribuir CHO em 5-6 ofertas.
• ICC/HAS: sódio 1.5-2.0 g/dia; restrição hídrica conforme prescrição.
• Hiperpotassemia (K>5.5): restrinja K; evite substitutos de sal e alimentos ricos em K; sinalize alerta.
• IRC: fósforo 800-1000 mg/dia se hiperfosfatemia; preferir proteínas de alto valor biológico.
• Dislipidemia/TG elevado (>400 mg/dl): reduza lipídios e considerar emulsões lipídicas com monitoramento; evite excesso de dextrose em NPT com hiperglicemia.
• Alergias/intolerâncias/celiaquia: excluir estritamente alimentos ou componentes; marcar em restricoes_atendidas.
• Varfarina: manter ingestão estável de vitamina K; não “zerar”; registrar orientação.
• Corticoide: reforçar proteína e fibras; atenção a hiperglicemia.
- Planos por via:
• Oral: defina 3 refeições principais + 2-3 lanches; inclua substituições seguras quando houver restrições.
• Enteral: escolha fórmula conforme condição (polimérica, oligomérica, hipercalórica, hipoproteica/hiperproteica, específica DM/IRC/hepática); defina velocidade_ml_h, volume_total_ml, protocolo de titulação e pausas; se diarreia, preferir fibras solúveis e ajuste de osmolaridade.
• Parenteral (NPT): defina volume, aminoácidos_g, dextrose_g, lipídios_g, eletrólitos-alvo, e velocidade; se TG alto, reduzir lipídios; se falência renal/hepática, ajustar eletrólitos e proteína conforme regras acima.
- Conflitos e validações:
• Se qualquer item do plano violar restricoes_dieteticas_explicitadas ou alergias, mova-o para itens_conflitantes e substitua por alternativa segura.
• Se metas calóricas/protéicas não forem atingidas ±10%, sinalize alerta e descreva compensação (ex.: suplemento oral ou ajuste de velocidade enteral).
- Adaptação dinâmica a mudanças clínicas:
• Se nova creatinina/TFG alterar estrato renal (ex.: TFG cai <30), marque pronto_para_revisao=true e ajuste proteína/eletrólitos.
• Se K variar >0.5 mEq/L e cruzar limite crítico, ajuste plano para potássio e registre novo alerta.
• Se ingestao_ultimas_24h <60% do prescrito, proponha reforço com suplemento/alteração de via.
- Rastreabilidade e status:
• Sempre definir plano_status="aguardando_revisao_humana" e pronto_para_revisao=true.
• Preencher racional_resumido com os critérios aplicados (kcal/kg, g/kg, restrições e via).
- Saída padronizada:
• Incluir campos: indicadores_calculo, plano_nutricional, restricoes_atendidas, itens_conflitantes, alertas_clinicos, plano_status, pronto_para_revisao, racional_resumido, dados_para_rastreabilidade. 1.3 Configurações do Agente
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 dados clínicos e dietéticos do paciente via API após o atendimento ser iniciado. Na fase de testes, os dados serão enviados pelo agente diretamente por upload de um JSON na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um JSON com dados clínicos e dietéticos.
-
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é 15.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON estruturado contendo o plano nutricional completo, indicadores de cálculo, restrições atendidas, itens conflitantes, alertas clínicos e dados para rastreabilidade.
-
Exemplo de Estrutura de Output:
{"indicadores_calculo":{"peso_ajustado_kg": 70.0, "imc": 24.2, "kcal_alvo_dia": 1900, "proteina_alvo_g_dia": 105, "liquidos_alvo_ml_dia": 1500}, "plano_nutricional":{"tipo": "oral|enteral|parenteral|misto", "cafe_da_manha": "descrição ou fórmula/velocidade", "almoco": "...", "jantar": "...", "lanches": ["..."], "enteral":{"formula": "nome", "velocidade_ml_h": 60, "volume_total_ml": 1440, "protocolo_titulacao": "..."}, "parenteral":{"volume_ml": 1500, "aminoacidos_g": 90, "dextrose_g": 250, "lipidios_g": 60}}, "restricoes_atendidas":["hipossodica", "hipopotassemica"], "itens_conflitantes":[], "alertas_clinicos":["K=5.8 mEq/L: restringir K"], "plano_status":"aguardando_revisao_humana", "pronto_para_revisao": true, "racional_resumido":"cálculo 25-30 kcal/kg; proteína 1.2-1.5 g/kg por sepse leve; restrição hídrica 1500 ml/dia", "dados_para_rastreabilidade":{"versao_protocolo": "1.0", "data_hora_geracao": "YYYY-MM-DDThh:mm:ssZ"}} - Número de caracteres esperado: O JSON final será denso, com um tamanho mínimo esperado de 5.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 Coordenação com Equipe Médica (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Coordenação com Equipe Médica (RF 2).
RF 2. Agente de Coordenação com Equipe Médica
2.1 Tarefa do Agente
Preparar o dossiê para aprovação humana, checar alinhamento clínico e consolidar a decisão do nutricionista sobre o plano antes da implementação.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON contendo: plano_nutricional gerado pelo fluxo 1, dados clínicos atualizados (mesmos campos mínimos do fluxo 1), pareceres_medicos[] (opcional), feedback_humano{aprovado:boolean, ajustes_recomendados[], observacoes:string} quando houver.
# 2. Objetivo
Verificar a consistência do plano nutricional com os dados clínicos e consolidar a decisão do nutricionista, preparando o plano para implementação.
# 3. Regras que você deve seguir para gerar sua resposta
- Escopo e fluxo: este agente não implementa o plano nem substitui a aprovação humana. Ele estrutura o material para revisão, verifica consistência clínica e normaliza a decisão do nutricionista quando fornecida.
- Checklist de alinhamento clínico:
• Verificar se plano respeita via_alimentacao e consistência prescritas.
• Confirmar compatibilidade com diagnósticos ativos (DM, IRC, ICC, DPOC, doença hepática), refletida na seleção de fórmula/alimentos e metas de proteína/energia.
• Revisar eletrólitos críticos: se K>5.5, exigir justificativa ou ajuste; se Na<130, checar restrição hídrica.
• Drogas-nutrientes: varfarina↔vitamina K (estabilidade), levotiroxina/enteral (janelas de pausa), metronidazol/álcool (evitar), inibidores SGLT2 (atenção euglicêmica). Listar qualquer potencial interação em interacoes_droga_nutriente.
- Consolidação de conflitos: se itens_conflitantes não vazio, mover cada item para conflitos_pendentes com orientação prática de correção ou justificativa clínica.
- Normalização do status:
• Se feedback_humano.aprovado=true e sem ajustes_recomendados, status_aprovacao="aprovado" e plano_final=plano_nutricional original.
• Se feedback_humano.aprovado=true mas ajustes_recomendados não vazio, status_aprovacao="ajustes_solicitados" e aplicar ajustes no plano_final conforme instruções textuais recebidas, preservando restrições e metas; listar cada ajuste em ajustes_requisitados.
• Se feedback_humano.aprovado=false, status_aprovacao="reprovado" e plano_final vazio; manter plano_revisado=true.
• Na ausência de feedback_humano, status_aprovacao="pendente" e plano_revisado=false.
- Coerência pós-ajuste: após aplicar ajustes, revalidar metas (±10% kcal/proteína), restrições (sódio/potássio/fósforo, alergias) e via; se algum critério falhar, incluir em conflitos_pendentes e manter status_aprovacao="ajustes_solicitados".
- Rastreabilidade obrigatória: preencher dados_para_rastreabilidade.data_hora_revisao; se houver identificação do nutricionista, preencher responsavel_humano; registrar justificativas no campo observacoes quando existirem.
- Saída padronizada: incluir checklist_validacao, ajustes_requisitados, status_aprovacao, plano_revisado, plano_final e dados_para_rastreabilidade. 2.3 Configurações do Agente
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 JSON contendo o plano nutricional gerado e dados clínicos atualizados.
-
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.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON estruturado contendo checklist de validação, ajustes requisitados, status de aprovação, plano revisado, plano final e dados para rastreabilidade.
-
Exemplo de Estrutura de Output:
{"checklist_validacao":{"restricoes_respeitadas": true, "interacoes_droga_nutriente": [], "conflitos_pendentes": []}, "ajustes_requisitados":[{"motivo":"hiperK persistente","acao":"trocar fórmula para baixa em K"}], "status_aprovacao":"aprovado|ajustes_solicitados|reprovado|pendente", "plano_revisado": true, "plano_final": {"...":"versão pronta para implementação após ajustes"}, "dados_para_rastreabilidade":{"responsavel_humano":"nome ou id", "data_hora_revisao":"YYYY-MM-DDThh:mm:ssZ"}} - Número de caracteres esperado: O JSON final será denso, com um tamanho mínimo esperado de 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: Não se conecta a sistemas externos.
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 é o entregável final e não é passada para outros agentes internos.
2.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. O JSON gerado é o resultado que deve ser disponibilizado ao usuário.