1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados, consulta a documentos e demais requisitos funcionais para o Fluxo de Agentes "Preparação de Documentos de Alta Hospitalar", uma solução projetada para garantir que os documentos de alta hospitalar estejam completos, corretos e em conformidade com os protocolos exigidos. 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 é reduzir erros e omissões nos documentos de alta, padronizar as informações fornecidas e acelerar a liberação dos documentos, minimizando o impacto da carga de trabalho sobre os profissionais de saúde.
2. Contexto e Problema
Problemas Específicos
- Erros e omissões em documentos de alta hospitalar que podem levar a cuidados inadequados ou complicações pós-alta.
- Falta de padronização nas informações fornecidas, o que pode causar confusão para pacientes e cuidadores.
- Atrasos na liberação de documentos de alta devido à carga de trabalho dos profissionais de saúde.
Estes problemas podem resultar em experiências negativas para pacientes e familiares, além de aumentar o risco de reinternações e complicações médicas.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Reduzir erros e omissões nos documentos de alta hospitalar.
- Padronizar a qualidade e o formato das informações fornecidas aos pacientes e cuidadores.
- Acelerar a liberação dos documentos de alta, reduzindo o impacto da carga de trabalho sobre os profissionais de saúde.
- Aumentar a satisfação do paciente e reduzir o risco de complicações pós-alta.
4. Visão Geral da Solução
O agente de IA para preparação de documentos de alta hospitalar verifica a completude e a conformidade dos documentos, sugere correções e padronizações, e gera orientações claras para pacientes e cuidadores. 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 eficaz na preparação de documentos de alta hospitalar.
A solução consiste em um fluxo de automação composto por 6 agentes de IA. O processo se inicia com a triagem do documento de alta hospitalar e termina com a consolidação final para liberação.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Triagem e Checklist de Alta Hospitalar (RF 1)
| Ler o documento de alta hospitalar e produzir um checklist estruturado de completude. |
Agente de Preparação de Parâmetros de Consulta a Documento (RF 2)
| Gerar parâmetros de busca para protocolos hospitalares e normas legais aplicáveis ao caso. |
Agente de Execução de Consulta a Documento (RF 3)
| Realizar consulta aos documentos institucionais para obter orientações e requisitos de conformidade. |
Agente de Conformidade e Padronização de Documento de Alta (RF 4)
| Padronizar e reestruturar o documento de alta conforme modelo institucional e requisitos legais. |
Agente de Orientações ao Paciente e Cuidadores (RF 5)
| Gerar a seção de orientações pós-alta em linguagem clara e consistente. |
Agente de Verificação Final e Consolidação da Alta (RF 6)
| Consolidar todos os outputs, checar consistência cruzada e produzir pacote final para liberaçã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 paciente e a equipe médica receberão. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Triagem e Checklist de Alta Hospitalar
1.1 Tarefa do Agente
Ler o documento de alta hospitalar e produzir um checklist estruturado de completude, identificar lacunas e determinar se é necessário consultar protocolos/documentos institucionais.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um documento de alta hospitalar em texto livre. Este documento contém informações sobre o paciente, diagnóstico, procedimentos realizados e orientações para cuidados pós-alta.
# 2. Objetivo
Produzir um checklist estruturado de completude, identificar lacunas e determinar se é necessário consultar protocolos/documentos institucionais.
# 3. Regras que você deve seguir para gerar sua resposta
- Verifique se todas as informações essenciais estão presentes, como identificações, diagnóstico, procedimentos, medicações, e orientações pós-alta.
- Identifique lacunas e inclua-as em uma lista estruturada, classificando a severidade.
- Determine se é necessário consultar documentos institucionais com base nas lacunas identificadas.
# 4. Exemplo de Output que você deve produzir
{
"identificacao_paciente_ok": true,
"diagnostico_principal_ok": false,
"lista_lacunas": [
{ "secao": "diagnostico", "detalhe": "diagnóstico principal ausente", "criticidade": "alta" }
],
"precisa_consulta_documento": true
} 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 um documento de alta hospitalar em texto livre via API. Na fase de testes, o fluxo será iniciado pelo envio manual dos dados, que serão enviados para o agente diretamente por upload do documento na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: Documento de alta hospitalar em texto livre.
-
Formatos Suportados: Esse agente deve ser capaz de receber documentos nos formatos:
.txt,.docx,.pdf. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 20.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo JSON contendo o checklist estruturado de completude e as lacunas identificadas.
-
Exemplo de Estrutura de Output:
{ "identificacao_paciente_ok": true, "diagnostico_principal_ok": false, "lista_lacunas": [ { "secao": "diagnostico", "detalhe": "diagnóstico principal ausente", "criticidade": "alta" } ], "precisa_consulta_documento": true } - Número de caracteres esperado: O JSON gerado deve ser claro e objetivo, com um tamanho estimado em torno de 1.000 caracteres.
1.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
1.3.4 Ferramentas do Agente
- Documentos: Consulta a documentos institucionais conforme necessidade.
- 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 Preparação de Parâmetros de Consulta a Documento (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Preparação de Parâmetros de Consulta a Documento (RF 2).
RF 2. Agente de Preparação de Parâmetros de Consulta a Documento
2.1 Tarefa do Agente
Gerar parâmetros de busca para protocolos hospitalares e normas legais aplicáveis ao caso, quando necessário.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON contendo o checklist de completude do documento de alta hospitalar, incluindo a especialidade e as lacunas identificadas.
# 2. Objetivo
Gerar parâmetros de busca para protocolos hospitalares e normas legais aplicáveis ao caso, quando necessário.
# 3. Regras que você deve seguir para gerar sua resposta
- Analise as lacunas identificadas e a especialidade para determinar os documentos e protocolos a serem consultados.
- Gere um conjunto de parâmetros de busca estruturados para facilitar a consulta.
# 4. Exemplo de Output que você deve produzir
{
"documento_alvo": "Manual de Alta Hospitalar",
"termos_busca": ["cuidados com ferida", "restrição de atividades"],
"especialidade": "Cirurgia Geral",
"parametros_consulta_prontos": true
} 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) e quando o campo
precisa_consulta_documentofortrue. - Tipo do input: JSON contendo o checklist de completude do documento de alta hospitalar.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json(JSON). - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 1.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: JSON contendo os parâmetros de busca para consulta a documentos institucionais.
-
Exemplo de Estrutura de Output:
{ "documento_alvo": "Manual de Alta Hospitalar", "termos_busca": ["cuidados com ferida", "restrição de atividades"], "especialidade": "Cirurgia Geral", "parametros_consulta_prontos": true } - Número de caracteres esperado: O JSON gerado deve ser claro e objetivo, com um tamanho estimado em torno de 500 caracteres.
2.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
2.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
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 Execução de Consulta a Documento (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Execução de Consulta a Documento (RF 3).
RF 3. Agente de Execução de Consulta a Documento
3.1 Tarefa do Agente
Realizar consulta aos documentos institucionais para obter orientações e requisitos de conformidade aplicáveis.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo parâmetros de consulta prontos para realizar busca em documentos institucionais.
# 2. Objetivo
Realizar consulta aos documentos institucionais para obter orientações e requisitos de conformidade aplicáveis.
# 3. Regras que você deve seguir para gerar sua resposta
- Utilize os parâmetros de busca recebidos para acessar documentos institucionais relevantes.
- Extraia trechos relevantes que atendam às necessidades de conformidade identificadas.
# 4. Exemplo de Output que você deve produzir
{
"resultados_consulta_documento": [
{ "trecho": "Paciente deve evitar atividades físicas intensas por duas semanas.", "referencia": "Manual de Alta Hospitalar", "ponto_conformidade": "restrição de atividades" }
]
} 3.3 Configurações do Agente
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 2) e quando o campo
parametros_consulta_prontosfortrue. - Tipo do input: JSON contendo os parâmetros de busca para consulta a documentos institucionais.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json(JSON). - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 500 caracteres.
3.3.2 Especificação do Output
- Formato de output: JSON contendo os resultados da consulta aos documentos institucionais.
-
Exemplo de Estrutura de Output:
{ "resultados_consulta_documento": [ { "trecho": "Paciente deve evitar atividades físicas intensas por duas semanas.", "referencia": "Manual de Alta Hospitalar", "ponto_conformidade": "restrição de atividades" } ] } - Número de caracteres esperado: O JSON gerado deve ser claro e objetivo, com um tamanho estimado em torno de 800 caracteres.
3.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
3.3.4 Ferramentas do Agente
- Documentos: Realiza consulta a documentos institucionais conforme parâmetros recebidos.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não se conecta a sistemas externos.
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 Conformidade e Padronização de Documento de Alta (RF 4).
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Conformidade e Padronização de Documento de Alta (RF 4).
RF 4. Agente de Conformidade e Padronização de Documento de Alta
4.1 Tarefa do Agente
Padronizar e reestruturar o documento de alta conforme modelo institucional e requisitos legais, incorporando evidências dos protocolos quando disponíveis.
4.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo o documento de alta original, o checklist de completude e, quando disponível, os resultados da consulta a documentos institucionais.
# 2. Objetivo
Padronizar e reestruturar o documento de alta conforme modelo institucional e requisitos legais, incorporando evidências dos protocolos quando disponíveis.
# 3. Regras que você deve seguir para gerar sua resposta
- Reestruture o documento de alta para garantir a conformidade com os modelos institucionais e legais.
- Incorpore as evidências dos protocolos consultados, quando disponíveis.
- Identifique e liste os campos pendentes que necessitam de preenchimento adicional.
# 4. Exemplo de Output que você deve produzir
{
"documento_padronizado_estruturado": {
"Identificação": "Paciente: João da Silva",
"Diagnóstico Principal": "Fratura de fêmur",
"Prescrição na Alta": [{ "nome_genérico": "Paracetamol", "dose": "500mg", "via": "oral", "frequência": "8/8h", "duração": "5 dias" }],
"Campos Pendentes": ["Assinatura do médico"]
}
} 4.3 Configurações do Agente
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 3).
- Tipo do input: Documento de alta original, JSON checklist e, quando disponível, resultados da consulta a documentos institucionais.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos:
.json(JSON) e.txt(Texto Livre). - Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 25.000 caracteres.
4.3.2 Especificação do Output
- Formato de output: JSON contendo o documento de alta padronizado e estruturado.
-
Exemplo de Estrutura de Output:
{ "documento_padronizado_estruturado": { "Identificação": "Paciente: João da Silva", "Diagnóstico Principal": "Fratura de fêmur", "Prescrição na Alta": [{ "nome_genérico": "Paracetamol", "dose": "500mg", "via": "oral", "frequência": "8/8h", "duração": "5 dias" }], "Campos Pendentes": ["Assinatura do médico"] } } - Número de caracteres esperado: O JSON gerado deve ser claro e detalhado, com um tamanho estimado em torno de 2.000 caracteres.
4.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
4.3.4 Ferramentas do Agente
- Documentos: Incorpora evidências de protocolos conforme resultados de consulta.
- 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 Orientações ao Paciente e Cuidadores (RF 5).
4.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Orientações ao Paciente e Cuidadores (RF 5).
RF 5. Agente de Orientações ao Paciente e Cuidadores
5.1 Tarefa do Agente
Gerar a seção de orientações pós-alta em linguagem clara, consistente com o documento padronizado e adequada ao contexto clínico.
5.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo o documento de alta padronizado e estruturado, além do checklist de completude.
# 2. Objetivo
Gerar a seção de orientações pós-alta em linguagem clara, consistente com o documento padronizado e adequada ao contexto clínico.
# 3. Regras que você deve seguir para gerar sua resposta
- Utilize uma linguagem clara e acessível para descrever as orientações pós-alta.
- Certifique-se de que as orientações sejam consistentes com o documento padronizado e estruturado.
- Inclua informações críticas como sinais de alerta e contatos úteis.
# 4. Exemplo de Output que você deve produzir
{
"orientacoes_paciente": {
"Como tomar seus medicamentos": "Tome Paracetamol 500mg a cada 8 horas por 5 dias.",
"Cuidados gerais em casa": "Evite atividades físicas intensas por duas semanas.",
"Sinais de alerta": "Febre acima de 38°C ou dor intensa, procure assistência médica.",
"Contatos úteis": "Hospital XYZ, Tel: (11) 1234-5678"
}
} 5.3 Configurações do Agente
5.3.1 Especificação do Input
- Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
- Tipo do input: Documento de alta padronizado e estruturado, além do checklist de completude.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json(JSON). - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 2.000 caracteres.
5.3.2 Especificação do Output
- Formato de output: JSON contendo a seção de orientações pós-alta para o paciente e cuidadores.
-
Exemplo de Estrutura de Output:
{ "orientacoes_paciente": { "Como tomar seus medicamentos": "Tome Paracetamol 500mg a cada 8 horas por 5 dias.", "Cuidados gerais em casa": "Evite atividades físicas intensas por duas semanas.", "Sinais de alerta": "Febre acima de 38°C ou dor intensa, procure assistência médica.", "Contatos úteis": "Hospital XYZ, Tel: (11) 1234-5678" } } - Número de caracteres esperado: O JSON gerado deve ser claro e detalhado, com um tamanho estimado em torno de 1.500 caracteres.
5.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
5.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Não utiliza.
- 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 Verificação Final e Consolidação da Alta (RF 6).
5.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Verificação Final e Consolidação da Alta (RF 6).
RF 6. Agente de Verificação Final e Consolidação da Alta
6.1 Tarefa do Agente
Consolidar todos os outputs, checar consistência cruzada e produzir pacote final para liberação.
6.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo o documento padronizado, as orientações para o paciente e o checklist de completude.
# 2. Objetivo
Consolidar todos os outputs, checar consistência cruzada e produzir pacote final para liberação.
# 3. Regras que você deve seguir para gerar sua resposta
- Verifique a consistência entre o documento padronizado e as orientações para o paciente.
- Assegure-se de que todas as seções obrigatórias estão presentes e corretas.
- Produza um pacote final estruturado e pronto para liberação.
# 4. Exemplo de Output que você deve produzir
{
"pacote_final": {
"documento_padronizado_estruturado": { ... },
"orientacoes_paciente": { ... },
"indicadores": {
"padronizacao_realizada": "sim",
"conformidade_realizada": "sim",
"campos_pendentes": []
}
}
} 6.3 Configurações do Agente
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: Documento padronizado, orientações para o paciente e checklist de completude.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json(JSON). - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 3.000 caracteres.
6.3.2 Especificação do Output
- Formato de output: JSON contendo o pacote final estruturado para liberação.
-
Exemplo de Estrutura de Output:
{ "pacote_final": { "documento_padronizado_estruturado": { ... }, "orientacoes_paciente": { ... }, "indicadores": { "padronizacao_realizada": "sim", "conformidade_realizada": "sim", "campos_pendentes": [] } } } - Número de caracteres esperado: O JSON gerado deve ser claro e detalhado, com um tamanho estimado em torno de 2.500 caracteres.
6.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
6.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Não utiliza.
- 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 é o entregável final e não é passada para outros agentes internos.
6.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. O pacote final gerado é o resultado que deve ser disponibilizado ao usuário.