1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados, busca online, consulta a documentos e demais requisitos funcionais para o Agente de IA para Gestão de Contratos com Prestadores de Saúde. 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 é revisar e organizar contratos com prestadores de saúde, garantindo conformidade e atualização de termos.
2. Contexto e Problema
A gestão de múltiplos contratos com diferentes prestadores de saúde é complexa e apresenta riscos de não conformidade devido a termos desatualizados.
Problemas Específicos
- Complexidade na gestão de múltiplos contratos com diferentes prestadores de saúde.
- Risco de não conformidade devido a termos desatualizados nos contratos.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Automatizar a revisão de contratos para garantir que estejam em conformidade com as regulamentações vigentes.
- Alertar gestores sobre a necessidade de atualização de termos contratuais.
- Organizar contratos de forma acessível para facilitar a consulta e revisão.
4. Visão Geral da Solução
O agente de IA para gestão de contratos com prestadores de saúde revisa e organiza contratos, garantindo conformidade e atualização de termos. 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 contratos com prestadores de saúde.
A solução consiste em um fluxo de automação composto por 6 agentes de IA. O processo inicia com a preparação de parâmetros regulatórios e termina com a organização e indexação dos contratos.
| Agentes | Função Principal |
|---|---|
Agente de Preparação de Parâmetros Regulatórios (RF 1)
| Derivar o escopo normativo e preparar parâmetros de busca/regra de conformidade a partir dos metadados do contrato. |
Agente de Busca Online (RF 2)
| Realizar busca online para obter normas e orientações vigentes relacionadas ao escopo do contrato. |
Agente de Extração Estruturada de Cláusulas de Contratos (RF 3)
| Extrair e normalizar cláusulas e metadados contratuais em um JSON estruturado padronizado. |
Agente de Análise de Conformidade de Contratos (RF 4)
| Comparar o contrato estruturado às exigências regulatórias vigentes e identificar lacunas, riscos e termos desatualizados. |
Agente de Alerta de Atualização de Termos (RF 5)
| Priorizar e preparar alertas aos gestores quando forem detectados gaps ou termos desatualizados. |
Agente de Organização e Indexação de Contratos (RF 6)
| Sugerir taxonomia, metadados e nomenclatura padronizada para armazenamento e consulta eficiente dos contratos. |
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 Preparação de Parâmetros Regulatórios
1.1 Tarefa do Agente
Derivar o escopo normativo e preparar parâmetros de busca/regra de conformidade a partir dos metadados do contrato.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo os metadados de um contrato com um prestador de saúde. Este documento contém informações essenciais para derivar o escopo normativo e preparar parâmetros de busca. # 2. Objetivo Derivar o escopo normativo e preparar parâmetros de busca/regra de conformidade a partir dos metadados do contrato. # 3. Regras que você deve seguir para gerar sua resposta - Se ans_aplicavel = true, incluir explicitamente termos que contemplem RNs, INs e Notas Técnicas da ANS vigentes no período de vigência do contrato. - Se lgpd_aplicavel = true, incluir termos de busca relacionados a bases legais de tratamento, operadores/controladores, DPO, incidentes e prazos de notificação. - Definir periodo_relevante começando 12 meses antes da data_vigencia_inicio para capturar normas que possam ter sido atualizadas próximo ao início da vigência. - Ajustar temas_criticos com base no tipo_prestador (ex.: laboratório -> incluir "prazo de liberação de laudos"; hospital -> incluir "tempo de espera", "UTI"; clínica -> incluir "referenciamento" e "encaminhamentos"). - Se segmento_plano incluir hospitalar, adicionar "referência e contrarreferência", "continuidade assistencial" aos temas. - Produzir termos_consulta suficientemente específicos (combinar objeto + tipo_prestador + jurisdicao) para reduzir ruído.
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 dos metadados do contrato 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 na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um conjunto de metadados do contrato.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos:
.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo os parâmetros de busca derivados.
-
Exemplo de Estrutura de Output:
{ "parametros_busca": { "termos_consulta": ["normas ANS contrato prestadores", "RN", "Resolução CFM", "LGPD saúde"], "fontes_prioritarias": ["ANS", "Ministério da Saúde", "CFM", "CFO", "CNJ", "diário oficial"], "periodo_relevante": { "inicio": "YYYY", "fim": "YYYY" }, "idiomas": ["pt-BR"], "escopo_normativo": ["contratual saúde suplementar", "proteção de dados saúde", "compliance assistencial"], "temas_criticos": ["SLA atendimento", "glosas", "auditoria médica", "reajuste", "penalidades", "rescisão", "continuidade assistencial", "LGPD"] } } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.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 Busca Online (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Busca Online (RF 2).
RF 2. Agente de Busca Online
2.1 Tarefa do Agente
Realizar busca online para obter normas e orientações vigentes relacionadas ao escopo do contrato.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo parâmetros de busca derivados dos metadados do contrato. Este documento contém os termos e fontes prioritárias para a busca online de normas vigentes. # 2. Objetivo Realizar busca online para obter normas e orientações vigentes relacionadas ao escopo do contrato. # 3. Regras que você deve seguir para gerar sua resposta - Utilize os termos de consulta e fontes prioritárias fornecidos para buscar normas e orientações vigentes. - Para cada norma encontrada, registre a fonte, título, URL, data de publicação, status de vigência e um resumo objetivo. - Classifique o status de vigência como "vigente", "revogada" ou "parcial" conforme aplicável.
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 os parâmetros de busca derivados.
-
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é 1.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo as normas e orientações encontradas.
-
Exemplo de Estrutura de Output:
{ "regulamentos_encontrados": [ { "fonte": "ANS", "titulo": "RN 363/2015 - Exemplo", "url": "https://...", "data_publicacao": "YYYY-MM-DD", "data_vigencia": { "inicio": "YYYY-MM-DD", "fim": null }, "status_vigencia": "vigente", "resumo": "síntese objetiva", "temas_cobertos": ["glosas", "reajuste"] } ] } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado 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.
- Calculadora: Não utiliza.
- Busca Online: Utiliza busca online para obter normas vigentes.
- 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 Extração Estruturada de Cláusulas de Contratos (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Extração Estruturada de Cláusulas de Contratos (RF 3).
RF 3. Agente de Extração Estruturada de Cláusulas de Contratos
3.1 Tarefa do Agente
Extrair e normalizar cláusulas e metadados contratuais em um JSON estruturado padronizado.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo o texto integral de um contrato e as normas vigentes relacionadas. Este documento contém todas as cláusulas e metadados necessários para a extração e normalização. # 2. Objetivo Extrair e normalizar cláusulas e metadados contratuais em um JSON estruturado padronizado. # 3. Regras que você deve seguir para gerar sua resposta - Manter chaves padronizadas conforme o schema de expected_output; quando informação inexistente, preencher com null ou valores padrão explicitados no schema. - Normalizar datas para formato ISO YYYY-MM-DD; valores percentuais como números decimais (0-100) e prazos em dias/horas conforme indicado na chave. - Unificar sinônimos de cláusulas (ex.: “índice de reajuste” -> clausulas.reajuste.indice). - Separar claramente obrigações de cada parte e condições de gatilho (ex.: quando aplica multa, quando aplica glosa). - Extrair apenas texto do contrato recebido; não inventar cláusulas ausentes—neste caso, deixar nulo e registrar ausência.
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: Este agente deve ser apto a receber como input o texto integral do contrato e as normas vigentes relacionadas.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos:
.txt,.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 estruturado contendo as cláusulas e metadados normalizados.
-
Exemplo de Estrutura de Output:
{ "contrato_estruturado": { "identificacao": { "titulo": "Contrato de Prestação de Serviços", "versao": "1.0", "data_assinatura": "2025-01-01", "vigencia_inicio": "2025-01-01", "vigencia_fim": "2026-01-01", "partes": [ {"nome": "Operadora"}, {"nome": "Prestador"} ] }, "clausulas": { "objeto": "Prestação de serviços de saúde", "abrangencia": "Nacional", "sla_atendimento": {"metricas": ["..."], "prazos": {"consulta": "24h", "internacao": "48h"}}, "glosas": {"motivos": ["..."], "prazo_contestacao_dias": 30, "processo_contestacao": ""}, "auditoria_medica": {"acesso_prontuario": true, "prazo_resposta_dias": 15}, "reajuste": {"indice": "IPCA", "periodicidade_meses": 12, "metodologia": "percentual"}, "penalidades": [{"evento": "", "multa_percentual": 10}], "indicadores_qualidade": [{"nome": "", "meta": ""}], "lgpd": {"bases_legais": ["..."], "papel_prestador": "operador", "dpo": "", "prazo_notificacao_incidente_horas": 72}, "rescisao": {"motivos": ["..."], "aviso_previo_dias": 60}, "continuidade_assistencial": {"prevista": true, "condicoes": ""} }, "anexos": [{"nome": "", "tipo": "tabela de preços"}] } } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres.
3.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
3.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
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 Análise de Conformidade de Contratos (RF 4).
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Análise de Conformidade de Contratos (RF 4).
RF 4. Agente de Análise de Conformidade de Contratos
4.1 Tarefa do Agente
Comparar o contrato estruturado às exigências regulatórias vigentes e identificar lacunas, riscos e termos desatualizados.
4.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um contrato estruturado e normas vigentes relacionadas. Este documento contém todas as informações necessárias para a análise de conformidade. # 2. Objetivo Comparar o contrato estruturado às exigências regulatórias vigentes e identificar lacunas, riscos e termos desatualizados. # 3. Regras que você deve seguir para gerar sua resposta - Considerar vigente uma norma quando status_vigencia = "vigente" e a data atual estiver dentro do intervalo de vigência; se "parcial", aplicar apenas os trechos indicados como vigentes. - Marcar como gap toda cláusula obrigatória ausente ou presente de forma incompleta: SLA sem métricas mensuráveis, glosa sem prazo de contestação, reajuste sem índice e periodicidade, penalidade sem percentual ou evento gatilho, ausência de regras LGPD (papéis, base legal, notificação de incidentes, compartilhamento de dados), ausência de continuidade assistencial quando aplicável. - Identificar termos desatualizados quando índice de reajuste utilizar referência obsoleta à luz de prática regulatória setorial (ex.: priorizar IPCA sobre IGPM quando política corporativa ou referência normativa assim direcionar) ou quando prazos mínimos setoriais mais recentes forem diferentes dos previstos no contrato. - Classificar severidade considerando: (a) risco regulatório (autuação/descumprimento), (b) risco assistencial ao beneficiário, (c) risco econômico (glosas/reajustes), atribuindo "alta" se afetar conformidade essencial (LGPD, continuidade assistencial, bases de reajuste, auditoria, penalidades), "média" para prazos e métricas relevantes, "baixa" para taxonomias e redações não materiais. - Sempre referenciar a norma que fundamenta cada gap/termo_desatualizado com fonte e artigo/dispositivo quando disponível. - Definir score_confianca entre 0 e 1 com base na completude dos dados (mais ausências -> menor score) e na clareza textual da cláusula.
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: Este agente deve ser apto a receber como input um contrato estruturado e normas vigentes relacionadas.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos:
.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.
4.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo o relatório de conformidade.
-
Exemplo de Estrutura de Output:
{ "relatorio_conformidade": { "conforme": true, "score_confianca": 0.8, "gaps": [ { "tema": "LGPD", "descricao": "Ausência de prazo de notificação de incidente", "severidade": "alta", "referencias": ["fonte|url|norma"], "acao_recomendada": "incluir cláusula X", "prazo_sugerido_dias": 30 } ], "termos_desatualizados": [ { "clausula": "reajuste", "problema": "IGPM substituído por IPCA", "referencias": ["norma"], "acao_recomendada": "alterar índice para IPCA" } ], "riscos": [ { "tipo": "assistencial", "descricao": "...", "impacto": "alto" } ], "recomendacoes_gerais": ["priorizar atualização de LGPD", "rever SLA de internação"] } } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 4.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.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
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 Alerta de Atualização de Termos (RF 5).
4.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Alerta de Atualização de Termos (RF 5).
RF 5. Agente de Alerta de Atualização de Termos
5.1 Tarefa do Agente
Priorizar e preparar alertas aos gestores quando forem detectados gaps ou termos desatualizados.
5.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um relatório de conformidade que contém gaps e termos desatualizados identificados no contrato. Este documento contém todas as informações necessárias para a preparação de alertas aos gestores. # 2. Objetivo Priorizar e preparar alertas aos gestores quando forem detectados gaps ou termos desatualizados. # 3. Regras que você deve seguir para gerar sua resposta - Definir existem_itens_criticos = true se houver ao menos um gap com severidade = "alta" ou termo_desatualizado que implique risco regulatório. - Calcular prioridade: alta se gaps alta > 0; média se apenas média; baixa se somente baixa. - Direcionar gestores_destinatarios conforme tema: LGPD -> compliance/jurídico; SLA/indicadores -> área de rede/operacional; reajuste/penalidades -> compras/financeiro. - Definir deadline_sugerido com base no menor prazo_sugerido_dias dentre os gaps críticos, contado da data atual. - Gerar corpo_mensagem com resumo executivo (máx. 10 linhas) e lista bullet dos itens prioritários.
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: Este agente deve ser apto a receber como input um relatório de conformidade que contém gaps e termos desatualizados.
-
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.
5.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo o alerta prioritário aos gestores.
-
Exemplo de Estrutura de Output:
{ "alerta": { "existem_itens_criticos": true, "prioridade": "alta", "gestores_destinatarios": ["email1@empresa.com"], "assunto": "Ações necessárias - Contrato Prestador X", "corpo_mensagem": "resumo dos principais gaps e prazos", "itens_prioritarios": [ { "tema": "LGPD", "severidade": "alta", "prazo_sugerido_dias": 30 } ], "canal_sugerido": "email", "deadline_sugerido": "2025-12-19" } } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.000 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.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
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 Organização e Indexação de Contratos (RF 6).
5.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Organização e Indexação de Contratos (RF 6).
RF 6. Agente de Organização e Indexação de Contratos
6.1 Tarefa do Agente
Sugerir taxonomia, metadados e nomenclatura padronizada para armazenamento e consulta eficiente dos contratos.
6.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um contrato estruturado e um relatório de conformidade. Este documento contém todas as informações necessárias para a organização e indexação dos contratos. # 2. Objetivo Sugerir taxonomia, metadados e nomenclatura padronizada para armazenamento e consulta eficiente dos contratos. # 3. Regras que você deve seguir para gerar sua resposta - Preencher uf a partir de jurisdicao quando aplicável; se múltiplas UFs, escolher a principal mencionada no contrato. - Definir tag ANS:ok se conforme = true e ans_aplicavel = true; caso contrário ANS:pendente. - Definir LGPD:ok se não houver gaps de LGPD; caso exista, LGPD:pendente. - Usar nomenclatura recebida em padroes_internos; quando variáveis não disponíveis, substituir por "NA" mantendo o padrão. - Caminho de pasta deve refletir hierarquia País/UF/Ano/TipoPrestador sempre que essas variáveis estiverem disponíveis.
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 contrato estruturado e um relatório de conformidade.
-
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é 10.000 caracteres.
6.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo a organização sugerida para o contrato.
-
Exemplo de Estrutura de Output:
{ "organizacao_sugerida": { "caminho_pasta": "\\contratos\\BR\\SP\\2025\\Prestadores", "nome_arquivo": "HospitalX_SP_2025-01_v1.pdf", "tags": ["LGPD:ok|pendente", "SLA:ok|pendente", "ANS:ok|pendente", "tipo:hospital"], "campos_indexacao": { "prestador": "", "uf": "", "vigencia_inicio": "2025-01-01", "vigencia_fim": "2026-01-01", "conformidade": "ok|pendente" } } } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.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.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
6.3.5 Memória
- Visibilidade das Instruções (Prompt): As instruções deste agente não são visíveis para agentes subsequentes.
- Visibilidade da Resposta: A resposta (organização sugerida) é 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 organização sugerida deve ser disponibilizada ao usuário.