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 "Autorizações Automáticas de Benefícios". 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 é analisar pedidos de autorização de benefícios, verificar conformidade com regras e aprovar ou sugerir ajustes automaticamente, reduzindo o tempo e os erros associados ao processamento manual.
2. Contexto e Problema
Cenário Atual
Atualmente, o processamento de autorizações de benefícios é feito manualmente, o que leva a um tempo de resposta elevado e está sujeito a erros. Com a diversidade de regras e políticas que variam entre diferentes administradoras, a conformidade torna-se complexa e propensa a falhas.
Problemas Identificados
- Demora no processamento: O processamento manual das autorizações é demorado.
- Erros frequentes: A possibilidade de erros é alta devido à complexidade das regras.
- Conformidade complexa: As múltiplas regras e políticas tornam a conformidade um desafio.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Reduzir o tempo de processamento de autorizações.
- Aumentar a precisão na verificação de conformidade.
- Automatizar sugestões de ajustes para não conformidades, facilitando a revisão manual.
4. Visão Geral da Solução
O agente de IA para autorizações automáticas de benefícios analisa pedidos de autorização, verifica sua conformidade com regras estabelecidas e aprova ou sugere ajustes automaticamente. 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 gestão de autorizações de benefícios.
A solução consiste em um fluxo de automação composto por 6 agentes de IA. O processo inicia com a validação e normalização dos pedidos de autorização e termina com a geração de decisões finais e notificações.
| Agentes | Função Principal |
|---|---|
Agente de Validação e Normalização do Pedido (RF 1)
| Validar campos obrigatórios e normalizar o payload do pedido de autorização. |
Agente de Preparação de Parâmetros de Consulta de Regras (RF 2)
| Construir parâmetros precisos para consulta das regras de cobertura e autorização. |
Agente de Execução de Consulta a Documento (RF 3)
| Realizar consulta ao repositório de normas/políticas para obter regras aplicáveis. |
Agente de Interpretação de Regras e Avaliação de Conformidade (RF 4)
| Avaliar o pedido frente às regras e determinar conformidade. |
Agente de Geração de Ajustes Sugeridos (RF 5)
| Sugerir ajustes para tornar o pedido conforme quando possível. |
Agente de Síntese de Decisão e Mensagens (RF 6)
| Gerar a decisão final estruturada e mensagens para notificaçã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 Validação e Normalização do Pedido
1.1 Tarefa do Agente
Validar campos obrigatórios e normalizar o payload do pedido de autorização para um formato único padronizado.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um pedido de autorização de benefícios em formato JSON. Este pedido pode conter campos heterogêneos dependendo da administradora.
# 2. Objetivo
Validar os campos obrigatórios e normalizar o pedido para um formato padrão, identificando possíveis erros ou alertas.
# 3. Regras que você deve seguir para gerar sua resposta
- Converta datas para ISO (YYYY-MM-DD). Se inválida, inclua em erros_bloqueantes: data_pedido_invalida.
- Exija os campos: pedido_id, administradora_id, plano_id, beneficiario.id, procedimento.codigo, procedimento.quantidade. Se ausentes, liste cada ausência em erros_bloqueantes.
- Padronize enums: solicitante.tipo ∈ {MEDICO, CLINICA, HOSPITAL}; prestador.tipo ∈ {CREDENCIADO, NÃO_CREDENCIADO}; procedimento.tabela ∈ {TUSS, CBHPM, OUTRA}.
- Se procedimento.quantidade <= 0, adicione erro_bloqueante: quantidade_invalida.
- Trate espaços, maiúsculas/minúsculas e caracteres especiais em códigos (trim e uppercase onde aplicável).
- Se houver múltiplos campos equivalentes (ex.: codigo_tuss, codigo), mapeie para procedimento.codigo priorizando TUSS; registre origem em alertas.
- Calcule idade se vier apenas data_nascimento; se não for possível, adicione alerta: idade_nao_informada.
- Valide carencia_cumprida_dias como número >=0; se ausente, defina como null e registre alerta.
- Valide urgência: se data_pedido == data_prevista e marcado como urgência ausente, defina urgencia = false por padrão e registre alerta.
- Defina pedido_valido = (erros_bloqueantes.length == 0). 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 pedido de autorização em formato JSON 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 arquivo JSON na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um arquivo JSON contendo os detalhes do pedido de autorizaçã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 texto com até 10.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON estruturado que inclui o pedido normalizado, erros bloqueantes e alertas.
-
Exemplo de Estrutura de Output:
{ "pedido_normalizado": { ... }, "erros_bloqueantes": ["string"], "alertas": ["string"], "pedido_valido": boolean } - Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 3.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 Preparação de Parâmetros de Consulta de Regras (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 de Regras (RF 2).
RF 2. Agente de Preparação de Parâmetros de Consulta de Regras
2.1 Tarefa do Agente
Construir parâmetros precisos para consulta das regras de cobertura e autorização da administradora/plano.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um pedido de autorização normalizado e validado. Sua tarefa é preparar os parâmetros para consulta das regras de cobertura e autorização. # 2. Objetivo Construir parâmetros precisos para consulta das regras de cobertura e autorização, garantindo que todos os campos necessários estejam presentes e corretos. # 3. Regras que você deve seguir para gerar sua resposta - Se pedido_valido = false, defina consulta_pronta = false e inclua motivos_nao_pronto: pedido_invalido. - Copie administradora_id, plano_id, procedimento.codigo, procedimento.tabela, quantidade, urgencia do pedido_normalizado. - Defina idade a partir de beneficiario.idade quando disponível, caso contrário null. - Defina prestador_credenciado = (prestador.tipo == CREDENCIADO). - Repasse preexistencias e carencia_cumprida_dias do pedido; se ausentes, null. - Defina consulta_pronta = true se todos: administradora_id, plano_id, codigo_procedimento e quantidade estiverem preenchidos.
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 bem-sucedida do agente anterior (RF 1).
- Tipo do input: Este agente deve ser apto a receber como input um JSON contendo o pedido normalizado e seu status de validade.
-
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é 5.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo os parâmetros de consulta e o status de prontidão para consulta.
-
Exemplo de Estrutura de Output:
{ "params_consulta_regras": { ... }, "consulta_pronta": boolean, "motivos_nao_pronto": ["string"] } - Número de caracteres esperado: O JSON final deve ser claro e direto, com um tamanho estimado em torno de 2.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 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 ao repositório de normas/políticas da administradora para obter regras aplicáveis ao procedimento solicitado.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo parâmetros para consulta das regras de cobertura e autorização. Sua tarefa é realizar a consulta ao repositório de normas da administradora. # 2. Objetivo Realizar consulta ao repositório de normas/políticas da administradora para obter regras aplicáveis ao procedimento solicitado. # 3. Regras que você deve seguir para gerar sua resposta - Utilize os parâmetros recebidos para consultar o documento de regras. - Retorne os dados recuperados sem aplicar regras de LLM.
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 bem-sucedida do agente anterior (RF 2).
- Tipo do input: Este agente deve ser apto a receber como input um JSON contendo os parâmetros de consulta.
-
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é 3.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo as regras recuperadas e a fonte das regras.
-
Exemplo de Estrutura de Output:
{ "regras_recuperadas": { ... }, "fonte_regras": { ... } } - Número de caracteres esperado: O JSON final deve ser claro e direto, com um tamanho estimado em torno de 2.500 caracteres.
3.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
3.3.4 Ferramentas do Agente
- Documentos: Consulta o repositório de normas/políticas da administradora.
- 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 Interpretação de Regras e Avaliação de Conformidade (RF 4).
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Interpretação de Regras e Avaliação de Conformidade (RF 4).
RF 4. Agente de Interpretação de Regras e Avaliação de Conformidade
4.1 Tarefa do Agente
Avaliar o pedido frente às regras recuperadas e determinar conformidade, motivos e requisitos pendentes.
4.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um pedido de autorização normalizado e as regras recuperadas. Sua tarefa é avaliar a conformidade do pedido com base nessas regras. # 2. Objetivo Avaliar o pedido frente às regras recuperadas e determinar conformidade, motivos e requisitos pendentes. # 3. Regras que você deve seguir para gerar sua resposta - Se regras_recuperadas.cobertura == NAO_COBERTA, defina decisao_preliminar = NEGAR, conforme = false e inclua motivo: procedimento_sem_cobertura. - Se regras_recuperadas.cobertura == CONDICIONAL, verifique documentos_obrigatorios e carencia_min_dias: - Pendência documental: compare documentos_obrigatorios com documentos_anexos.tipo; liste faltantes em pendencias_documentais. - Carência: se carencia_min_dias > carencia_cumprida_dias (ou carencia_cumprida_dias for null), inclua motivo: carencia_nao_cumprida. - Idade: se restricoes_idade.min/max violadas pela idade do beneficiario (quando conhecida), inclua motivo: restricao_idade. - Rede: se restricoes_rede == APENAS_CREDENCIADA e prestador_credenciado == false, inclua motivo: rede_nao_credenciada e ajuste mínimo sugerido: alterar prestador para credenciado. - Quantidade: se limite_quantidade existir e quantidade > limite, defina quantidade_aprovavel = limite e decisao_preliminar = APROVAR_PARCIAL com motivo: acima_do_limite_quantitativo. - Urgência: se urgencia == true e regras exigem autorizacao_previa == true, mantenha avaliação normal mas inclua observação em restricoes_aplicadas: urgencia_exige_prioridade_sem_flexibilizar_regra. - Coparticipação: se coparticipacao_percentual presente, retorne em coparticipacao_percentual. - Pendências documentais não impedem aprovação se regras permitirem autorização condicionada; caso contrário, definem decisao_preliminar = NEGAR e conforme = false. - Defina conforme = true somente quando: cobertura != NAO_COBERTA, carência atendida (ou não requerida), idade dentro do intervalo (ou desconhecida), rede atendida conforme restricao, e pendencias_documentais == [] ou permitidas como condicionais pela política. - Se conforme = true e quantidade_aprovavel for null, defina quantidade_aprovavel = quantidade solicitada. - Defina gatilho_pedido_nao_conforme = (conforme == false).
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 bem-sucedida do agente anterior (RF 3).
- Tipo do input: Este agente deve ser apto a receber como input um JSON contendo o pedido normalizado e as regras recuperadas.
-
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é 6.000 caracteres.
4.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo a avaliação de conformidade do pedido e sugestões de ajustes mínimos.
-
Exemplo de Estrutura de Output:
{ "pedido_id": "string", "conforme": boolean, "decisao_preliminar": "APROVAR_TOTAL|APROVAR_PARCIAL|NEGAR", "motivos": ["string"], "pendencias_documentais": ["string"], "ajustes_minimos_requeridos": [{"campo":"string","valor_sugerido":"string|number|boolean","justificativa":"string"}], "quantidade_aprovavel": number|null, "coparticipacao_percentual": number|null, "prazo_validade_autorizacao_dias": number|null, "restricoes_aplicadas": ["string"], "fonte_regras": {...}, "gatilho_pedido_nao_conforme": boolean } - Número de caracteres esperado: O JSON final deve ser claro e direto, com um tamanho estimado em torno de 3.000 caracteres.
4.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
4.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.
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 Geração de Ajustes Sugeridos (RF 5).
4.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Geração de Ajustes Sugeridos (RF 5).
RF 5. Agente de Geração de Ajustes Sugeridos
5.1 Tarefa do Agente
Sugerir ajustes práticos e objetivos para tornar o pedido conforme quando possível.
5.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo a avaliação de conformidade do pedido. Sua tarefa é sugerir ajustes para tornar o pedido conforme se possível. # 2. Objetivo Sugerir ajustes práticos e objetivos para tornar o pedido conforme quando possível. # 3. Regras que você deve seguir para gerar sua resposta - Se houver pendencias_documentais != [], sugira ANEXAR_DOCUMENTO para cada pendência com justificativa baseada em documentos_obrigatorios da regra. - Se motivo incluir rede_nao_credenciada, sugira ALTERAR_PRESTADOR para credenciado com impacto RESOLVE_TOTAL. - Se motivo incluir acima_do_limite_quantitativo e quantidade_aprovavel existir, sugira REDUZIR_QUANTIDADE para quantidade_aprovavel. - Se motivo incluir procedimento_sem_cobertura mas houver código alternativo similar coberto conforme observacoes das regras (quando presentes), sugira AJUSTAR_CODIGO com justificativa. - Se motivo incluir carencia_nao_cumprida, sugira AGUARDAR_CARENCIA com valor_sugerido = dias_restantes e impacto RESOLVE_TOTAL. - Se motivo incluir restricao_idade e houver alternativa descrita em observacoes (ex.: via auditoria clínica), marque OUTRO com instrução clara e impacto RESOLVE_PARCIAL. - Consolide resumo_efeito indicando se os ajustes propostos permitem aprovação total ou parcial após implementação.
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), caso o pedido não esteja conforme.
- Tipo do input: Este agente deve ser apto a receber como input um JSON contendo a avaliação de conformidade do pedido.
-
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é 4.000 caracteres.
5.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo os ajustes sugeridos para cada inconformidade identificada.
-
Exemplo de Estrutura de Output:
{ "pedido_id": "string", "ajustes_sugeridos": [{ "acao_tipo": "ANEXAR_DOCUMENTO|ALTERAR_PRESTADOR|REDUZIR_QUANTIDADE|AJUSTAR_CODIGO|AGUARDAR_CARENCIA|ADEQUAR_FAIXA_ETARIA|OUTRO", "campo_alvo": "string", "valor_sugerido": "string|number|boolean|null", "justificativa": "string", "impacto_conformidade": "RESOLVE_TOTAL|RESOLVE_PARCIAL|NAO_RESOLVE" }], "resumo_efeito": "string" } - Número de caracteres esperado: O JSON final deve ser claro e direto, com um tamanho estimado em torno de 2.500 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: 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 Síntese de Decisão e Mensagens (RF 6).
5.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Síntese de Decisão e Mensagens (RF 6).
RF 6. Agente de Síntese de Decisão e Mensagens
6.1 Tarefa do Agente
Gerar a decisão final estruturada e mensagens claras para notificação e/ou registro.
6.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo a avaliação do pedido e os ajustes sugeridos. Sua tarefa é gerar a decisão final e as mensagens para notificação. # 2. Objetivo Gerar a decisão final estruturada e mensagens claras para notificação e/ou registro. # 3. Regras que você deve seguir para gerar sua resposta - Se avaliacao.conforme == true e decisao_preliminar == APROVAR_TOTAL, defina decisao_final = APROVADO. - Se conforme == true e decisao_preliminar == APROVAR_PARCIAL, defina decisao_final = APROVADO_PARCIAL e quantidade_aprovada = quantidade_aprovavel. - Se conforme == false e houver ajustes_sugeridos não vazios, defina decisao_final = PENDENTE_AJUSTES e inclua condicionantes descrevendo os ajustes críticos. - Se conforme == false e sem ajustes viáveis (ex.: cobertura == NAO_COBERTA sem alternativa), defina decisao_final = NEGADO. - Sempre inclua coparticipacao_percentual e prazo_validade_autorizacao_dias quando informados nas regras. - Monte mensagens em linguagem clara: para_solicitante com detalhes técnicos (códigos, limites, documentos); para_beneficiario em linguagem acessível sem jargão. - Em artefato_registro.fonte_regras, replique o identificador do documento/versão e vigência recebidos.
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: Este agente deve ser apto a receber como input um JSON contendo a avaliação do pedido e os ajustes sugeridos.
-
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é 5.000 caracteres.
6.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo a decisão final do pedido e as mensagens de notificação.
-
Exemplo de Estrutura de Output:
{ "pedido_id": "string", "decisao_final": "APROVADO|APROVADO_PARCIAL|NEGADO|PENDENTE_AJUSTES", "detalhe_decisao": { "quantidade_aprovada": number|null, "coparticipacao_percentual": number|null, "prazo_validade_autorizacao_dias": number|null, "condicionantes": ["string"] }, "mensagens": { "para_solicitante": "string", "para_beneficiario": "string" }, "artefato_registro": { "status": "string", "motivos": ["string"], "fonte_regras": {...} } } - Número de caracteres esperado: O JSON final deve ser claro e direto, com um tamanho estimado em torno de 3.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: 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. A decisão e as mensagens geradas devem ser disponibilizadas para os usuários finais.