1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados, ferramentas como chamadas a sistemas externos e demais requisitos funcionais para o Agente de IA "Coleta de Dados de Admissã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 é auxiliar na coleta e verificação de dados de pacientes durante o processo de admissão hospitalar, garantindo que todas as informações necessárias estejam completas e corretas, de forma a evitar complicações futuras.
2. Contexto e Problema
Problemas Identificados
- Erros e omissões na coleta de dados: Durante a admissão hospitalar, é comum ocorrerem erros e omissões na coleta de dados dos pacientes, o que pode levar a complicações futuras.
- Tempo excessivo na verificação manual: O processo manual de verificação das informações dos pacientes demanda um tempo considerável da equipe hospitalar.
- Necessidade de dados completos e corretos: É vital que todas as informações necessárias estejam completas e corretas para garantir a segurança e eficácia do atendimento.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Reduzir erros e omissões na coleta de dados dos pacientes.
- Diminuir o tempo gasto na verificação manual das informações dos pacientes.
- Garantir a completude e exatidão dos dados coletados, minimizando complicações futuras.
4. Visão Geral da Solução
O agente de IA para coleta de dados de admissão hospitalar automatiza o processo de coleta e verificação de dados, integrando-se com sistemas existentes para capturar informações relevantes, sinalizando quaisquer discrepâncias ou omissões e fornecendo alertas em tempo real para a equipe hospitalar sobre dados ausentes ou incorretos. 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 na coleta de dados de admissão hospitalar.
A solução consiste em um fluxo de automação composto por múltiplas tarefas que o agente deve realizar para garantir a eficiência e precisão na coleta de dados.
| Tarefas | Função Principal |
|---|---|
Coleta Guiada de Dados (RF 1)
| Conduzir a coleta guiada de dados de identificação do paciente e verificar a completude e exatidão das informações. |
Validação de Identidade (RF 2)
| Validar a identidade do paciente com base em documentos oficiais e dados de confirmação. |
Verificação de Elegibilidade (RF 3)
| Verificar a elegibilidade do convênio/plano e status de autorização prévia para o atendimento. |
Checagem de Duplicidade (RF 4)
| Checar duplicidade de cadastro e consolidar registros quando aplicável. |
Recebimento de Documentos (RF 5)
| Solicitar, receber e vincular imagens/documentos necessários para a admissão. |
Registro de Consentimentos (RF 6)
| Coletar e registrar consentimentos, termos e autorizações necessários. |
Geração de Alertas (RF 7)
| Gerar alertas operacionais imediatos para a equipe quando houver discrepâncias críticas. |
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 do agente quanto o resultado final que a equipe hospitalar receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Coleta Guiada de Dados
1.1 Tarefa do Agente
Conduzir a coleta guiada de dados de identificação do paciente e verificar a completude e exatidão das informações.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo as informações básicas do paciente coletadas durante o processo de admissão hospitalar. # 2. Objetivo Conduzir a coleta guiada de dados de identificação do paciente e verificar a completude e exatidão das informações fornecidas. # 3. Regras que você deve seguir para gerar sua resposta - Garanta que todos os campos obrigatórios estejam preenchidos e corretos. - Sinalize quaisquer campos ausentes ou incorretos e forneça orientações para correção. - Utilize validações em tempo real para assegurar a precisão dos dados coletados. # 4. Exemplo de Output que você deve produzir **Nome do Paciente:** João Silva **CPF:** 123.456.789-00 **Data de Nascimento:** 01/01/1980 **Telefone:** +55 11 91234-5678 **Endereço:** Rua Exemplo, 123, São Paulo, SP, 01234-567
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 de identificação do paciente via API. Na fase de testes, os dados serão enviados manualmente por upload na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: Dados estruturados de identificação do paciente.
-
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.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown** com as informações do paciente e alertas sobre dados ausentes ou incorretos.
-
Exemplo de Estrutura de Output:
**Nome do Paciente:** João Silva **CPF:** 123.456.789-00 **Data de Nascimento:** 01/01/1980 **Telefone:** +55 11 91234-5678 **Endereço:** Rua Exemplo, 123, São Paulo, SP, 01234-567 ### Alertas - CPF inválido: 123.456.789-00 - Telefone ausente
- Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 1.000 caracteres, podendo variar conforme a complexidade dos dados.
1.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
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 Validação de Identidade (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Validação de Identidade (RF 2).
RF 2. Validação de Identidade
2.1 Tarefa do Agente
Validar a identidade do paciente com base em documentos oficiais e dados de confirmação.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados de identificação do paciente, incluindo CPF e data de nascimento, para validação de identidade. # 2. Objetivo Validar a identidade do paciente com base em documentos oficiais e dados de confirmação fornecidos. # 3. Regras que você deve seguir para gerar sua resposta - Verifique a validade do CPF e da data de nascimento. - Confirme a identidade utilizando uma fonte confiável ou sistema de cadastro existente. - Sinalize qualquer discrepância encontrada durante a validação. # 4. Exemplo de Output que você deve produzir **Validação de Identidade:** Sucesso **CPF:** 123.456.789-00 **Data de Nascimento:** 01/01/1980
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: Dados de identificação do paciente para validação.
-
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é 2.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown** com o resultado da validação de identidade.
-
Exemplo de Estrutura de Output:
**Validação de Identidade:** Sucesso **CPF:** 123.456.789-00 **Data de Nascimento:** 01/01/1980
- Número de caracteres esperado: O texto final deve ser conciso, 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 documentos externos.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Integra-se com sistemas de cadastro para validação de identidade.
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 Verificação de Elegibilidade (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Verificação de Elegibilidade (RF 3).
RF 3. Verificação de Elegibilidade
3.1 Tarefa do Agente
Verificar a elegibilidade do convênio/plano e status de autorização prévia para o atendimento.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados de convênio/plano do paciente para verificação de elegibilidade. # 2. Objetivo Verificar a elegibilidade do convênio/plano e status de autorização prévia para o atendimento. # 3. Regras que você deve seguir para gerar sua resposta - Consulte o sistema de convênio para verificar a elegibilidade e status de autorização. - Informe qualquer pendência ou necessidade de autorização adicional. - Sinalize discrepâncias entre os dados fornecidos e os registros do sistema. # 4. Exemplo de Output que você deve produzir **Elegibilidade:** Confirmada **Convênio:** Saúde Exemplar **Número da Carteirinha:** 987654321 **Status de Autorização:** Autorizado
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).
- Tipo do input: Dados de convênio/plano do paciente.
-
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é 2.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown** com o resultado da verificação de elegibilidade.
-
Exemplo de Estrutura de Output:
**Elegibilidade:** Confirmada **Convênio:** Saúde Exemplar **Número da Carteirinha:** 987654321 **Status de Autorização:** Autorizado
- Número de caracteres esperado: O texto final deve ser conciso, com um tamanho estimado em torno de 500 caracteres.
3.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
3.3.4 Ferramentas do Agente
- Documentos: Não consulta documentos externos.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Consulta sistemas de convênio para verificar a elegibilidade e status de autorização.
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 Checagem de Duplicidade (RF 4).
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Checagem de Duplicidade (RF 4).
RF 4. Checagem de Duplicidade
4.1 Tarefa do Agente
Checar duplicidade de cadastro e consolidar registros quando aplicável.
4.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados de identificação do paciente para checagem de duplicidade de cadastro. # 2. Objetivo Checar duplicidade de cadastro e consolidar registros quando aplicável. # 3. Regras que você deve seguir para gerar sua resposta - Compare os dados do paciente com registros existentes para identificar possíveis duplicidades. - Consolide registros quando for confirmado que se tratam do mesmo paciente. - Informe qualquer necessidade de revisão manual por parte da equipe.
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: Dados de identificação do paciente para checagem de duplicidade.
-
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é 2.000 caracteres.
4.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown** com o resultado da checagem de duplicidade.
-
Exemplo de Estrutura de Output:
**Checagem de Duplicidade:** Nenhuma duplicidade encontrada **Ação Requerida:** Nenhuma
- Número de caracteres esperado: O texto final deve ser conciso, com um tamanho estimado em torno de 500 caracteres.
4.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
4.3.4 Ferramentas do Agente
- Documentos: Não consulta documentos externos.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Consulta sistemas de cadastro para checar duplicidade de registros.
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 Recebimento de Documentos (RF 5).
4.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Recebimento de Documentos (RF 5).
RF 5. Recebimento de Documentos
5.1 Tarefa do Agente
Solicitar, receber e vincular imagens/documentos necessários para a admissão.
5.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo uma solicitação para recebimento de documentos necessários para a admissão do paciente. # 2. Objetivo Solicitar, receber e vincular imagens/documentos necessários para a admissão do paciente. # 3. Regras que você deve seguir para gerar sua resposta - Solicite os documentos necessários de forma clara e objetiva. - Receba e vincule os documentos ao cadastro do paciente. - Informe qualquer documento pendente ou problema no recebimento.
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: Solicitação para recebimento de documentos do paciente.
-
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é 2.000 caracteres.
5.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown** com o status do recebimento de documentos.
-
Exemplo de Estrutura de Output:
**Documentos Recebidos:** RG, Comprovante de Endereço **Pendências:** Carteira do Convênio
- Número de caracteres esperado: O texto final deve ser conciso, com um tamanho estimado em torno de 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 documentos externos.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Integra-se com sistemas de armazenamento para vincular documentos recebidos.
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 Registro de Consentimentos (RF 6).
5.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Registro de Consentimentos (RF 6).
RF 6. Registro de Consentimentos
6.1 Tarefa do Agente
Coletar e registrar consentimentos, termos e autorizações necessários.
6.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo uma solicitação para registro de consentimentos e autorizações do paciente. # 2. Objetivo Coletar e registrar consentimentos, termos e autorizações necessários para o processo de admissão. # 3. Regras que você deve seguir para gerar sua resposta - Solicite os consentimentos necessários de forma clara e objetiva. - Registre o consentimento de cada item solicitado, com data e hora. - Informe qualquer pendência ou problema na obtenção dos consentimentos.
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: Solicitação para registro de consentimentos do paciente.
-
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é 2.000 caracteres.
6.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown** com o status do registro de consentimentos.
-
Exemplo de Estrutura de Output:
**Consentimentos Registrados:** Atendimento, LGPD **Pendências:** Financeiro
- Número de caracteres esperado: O texto final deve ser conciso, com um tamanho estimado em torno de 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 documentos externos.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Registra consentimentos no sistema de cadastro.
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 Geração de Alertas (RF 7).
6.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Geração de Alertas (RF 7).
RF 7. Geração de Alertas
7.1 Tarefa do Agente
Gerar alertas operacionais imediatos para a equipe quando houver discrepâncias críticas.
7.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados sobre discrepâncias críticas encontradas durante o processo de admissão. # 2. Objetivo Gerar alertas operacionais imediatos para a equipe quando houver discrepâncias críticas nos dados do paciente. # 3. Regras que você deve seguir para gerar sua resposta - Identifique discrepâncias críticas nos dados do paciente. - Gere alertas claros e objetivos para a equipe hospitalar. - Informe qualquer ação necessária para correção das discrepâncias.
7.3 Configurações do Agente
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: Dados sobre discrepâncias críticas encontradas.
-
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é 2.000 caracteres.
7.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown** com o alerta gerado para a equipe hospitalar.
-
Exemplo de Estrutura de Output:
**Alerta de Discrepância:** CPF inválido detectado **Ação Necessária:** Corrigir CPF no cadastro do paciente
- Número de caracteres esperado: O texto final deve ser conciso, com um tamanho estimado em torno de 500 caracteres.
7.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
7.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.
7.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.
7.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. Os alertas gerados são o resultado que deve ser disponibilizado à equipe hospitalar.