Agente de IA para Extração de Dados de Registros Administrativos

Definir o esquema padronizado de dados administrativos de hospitais/clínicas e preparar os parâmetros de consulta aos documentos para extração.

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 documentos de registros administrativos digitalizados via API. Na fase de testes, os documentos serão enviados diretamente por upload na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo são documentos digitalizados em formatos PDF, DOCX, ou texto extraído de imagens.
• Formatos Suportados: Esse agente deve ser capaz de receber documentos nos formatos: .pdf, .docx, .txt.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo o schema_padrao, mapeamento_sinonimos e parametros_consulta.
• Exemplo de Estrutura de Output:

   {"schema_padrao":{"campos_obrigatorios":["paciente_nome","documento_identificacao","data_admissao","unidade_saude","tipo_registro"],"campos_opcionais":["numero_prontuario","data_alta","convenio","numero_autorizacao","setor","responsavel_registro","valor_total","moeda","status","cid10","codigo_procedimento","lote_faturamento","contato","endereco"]},"mapeamento_sinonimos":{"paciente_nome":["nome do paciente","paciente"],"documento_identificacao":["CPF","RG","Documento"],"numero_prontuario":["prontuario","nº prontuário"],"data_admissao":["data de admissão","entrada"],"data_alta":["alta","data de alta"],"convenio":["plano","operadora"],"numero_autorizacao":["autorizacao","nº autorização"],"unidade_saude":["hospital","clínica","unidade"],"setor":["ala","enfermaria","unidade de internação"],"valor_total":["total","valor final"]},"parametros_consulta":{"consultas_textuais_por_campo":[{"campo":"paciente_nome","pistas":["nome","paciente"]},{"campo":"documento_identificacao","pistas":["CPF","RG","Doc."]},{"campo":"data_admissao","pistas":["admissão","entrada"]},{"campo":"data_alta","pistas":["alta"]},{"campo":"numero_prontuario","pistas":["prontuário","pront"]},{"campo":"convenio","pistas":["convênio","plano"]},{"campo":"numero_autorizacao","pistas":["autorização","aut."]},{"campo":"valor_total","pistas":["total","valor"]}],"tolerancia_erros_ortograficos":true},"prioridades_extracao":{"ordem":["campos_obrigatorios","campos_opcionais"]}} 

• Número de caracteres esperado: O JSON estruturado deve ter um tamanho aproximado de 5.000 caracteres.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.7

1.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos durante a preparação do esquema.
• 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 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 Execução de Consulta a Documento (RF 2).

Realizar consulta aos documentos fornecidos para obter blocos de texto, trechos e tabelas relevantes aos campos do esquema definido.

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 como input um conjunto de parâmetros de consulta e documentos digitalizados.
• Formatos Suportados: Esse agente deve ser capaz de receber parâmetros no formato: .json e documentos nos formatos: .pdf, .docx, .txt.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 150.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as extrações por campo, evidências e artefatos relevantes.
• Exemplo de Estrutura de Output:

   {"extracoes_por_campo":[{"campo":"paciente_nome","trechos":[{"texto":"Paciente: João da Silva","posicao":{"pagina":1,"linha":3},"confianca":0.92}],"status":"encontrado"},{"campo":"numero_prontuario","trechos":[{"texto":"Prontuário: 123456","posicao":{"pagina":1,"linha":4},"confianca":0.88}],"status":"encontrado"}],"artefatos":{"tabelas":[{"pagina":2,"cabecalhos":["Item","Descrição","Valor"],"linhas":[["1","Taxa administrativa","R$ 30,00"]]}]}} 

• Número de caracteres esperado: O JSON de output deve ter um tamanho aproximado de 10.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.7

2.3.4 Ferramentas do Agente

• Documentos: Consulta documentos fornecidos para extração de dados.
• 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 deve ser visível para o Agente de Normalização e Estruturação de Dados (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Normalização e Estruturação de Dados (RF 3).

Transformar os trechos extraídos em um JSON administrativo padronizado, com validações, normalizações e evidências de origem por campo.

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: Este agente deve ser apto a receber como input o schema, parâmetros e dados brutos de extraçã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 combinado de até 50.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON administrativo padronizado contendo os dados estruturados, evidências, confiança por campo, inconsistências e metadados.
• Exemplo de Estrutura de Output:

   {"dados_estruturados":{"paciente_nome":"Joao da Silva","documento_identificacao":{"tipo":"CPF","valor":"12345678909","valido":true},"numero_prontuario":"123456","data_admissao":"2025-12-07","data_alta":null,"unidade_saude":"Hospital Exemplo","setor":"Clínica Médica","convenio":"Exemplo Saúde","numero_autorizacao":"A123456","valor_total":30.00,"moeda":"BRL","status":"aberto","tipo_registro":"internacao"},"evidencias":{"paciente_nome":{"amostra":"Paciente: João da Silva","pagina":1,"linha":3},"numero_prontuario":{"amostra":"Prontuário: 123456","pagina":1,"linha":4}},"confianca_por_campo":{"paciente_nome":0.90,"numero_prontuario":0.85,"data_admissao":0.80},"inconsistencias":[{"campo":"data_alta","tipo":"ausente_obrigatorio_condicional","descricao":"Data de alta ausente para status 'encerrado'"}],"metadados":{"versao_schema":"1.0","origem_documento":"upload","timestamp_processamento":"2025-12-07T14:38:00Z"}} 

• Número de caracteres esperado: O JSON final deve ter um tamanho aproximado de 15.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.7

3.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para validação e normalização de dados.
• 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 Checagem de Qualidade e Consolidação (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Checagem de Qualidade e Consolidação (RF 4).

Aplicar checagens finais de completude e coerência, consolidar o JSON e definir o status de prontidão para uso administrativo/faturamento.

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: Este agente deve ser apto a receber como input um JSON estruturado com dados, evidências, confiança por campo e inconsistências.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON consolidado contendo dados estruturados, indicadores de qualidade e status de prontidão.
• Exemplo de Estrutura de Output:

   {"json_final":{"dados_estruturados":{...},"evidencias":{...},"confianca_por_campo":{...},"inconsistencias":[...]},"indicadores_qualidade":{"completude_obrigatorios":0.95,"erros_criticos":0,"avisos":2},"prontidao_para_uso":true,"criterios":{"min_confianca_campo":0.75,"max_erros_criticos":0}} 

• Número de caracteres esperado: O JSON final deve ter um tamanho aproximado de 8.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.7

4.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para calcular indicadores de qualidade.
• 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 é o produto final e não precisa ser passada para outros agentes internos.

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

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