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 "Codificação Automática de Procedimentos Médicos", uma solução destinada a transformar descrições de procedimentos médicos em códigos padronizados, auxiliando na precisão e velocidade do faturamento 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 é automatizar o processo de codificação, reduzindo erros e inconsistências na aplicação de códigos padronizados que afetam o faturamento.
2. Contexto e Problema
Cenário Atual
O processo de codificação manual de procedimentos médicos é frequentemente lento e propenso a erros, o que pode levar a inconsistências na aplicação dos códigos padronizados. Essas inconsistências têm um impacto direto no faturamento hospitalar, resultando em perdas financeiras e atrasos nos pagamentos.
Problemas Identificados
- Lentidão na codificação manual: A codificação manual é um processo demorado que consome recursos significativos.
- Erros frequentes: A natureza manual do processo leva a erros que podem afetar negativamente o faturamento.
- Inconsistência na aplicação de códigos: A falta de padronização resulta em inconsistências que afetam a precisão do faturamento.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Reduzir o tempo de codificação em pelo menos 70%.
- Aumentar a precisão dos códigos aplicados, minimizando erros.
- Padronizar a aplicação de códigos para garantir consistência no faturamento.
4. Visão Geral da Solução
O agente de IA para codificação automática de procedimentos médicos analisa descrições de procedimentos e mapeia para códigos padronizados, assegurando precisão e consistência. 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 codificação de procedimentos médicos.
A solução é composta por um único agente de IA, que recebe descrições de procedimentos médicos e retorna os códigos padronizados corretos.
| Agentes | Função Principal |
|---|---|
Agente de Codificação de Procedimentos Médicos (RF 1)
| Analisar descrições de procedimentos médicos e mapear para os códigos padronizados corretos. |
5. Protótipos
Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram o fluxo de trabalho do agente e 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 Codificação de Procedimentos Médicos
1.1 Tarefa do Agente
Analisar descrições de procedimentos médicos e mapear para os códigos padronizados corretos, assegurando precisão e consistência na aplicação dos códigos.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo descrições de procedimentos médicos em texto livre. Este texto detalha os procedimentos realizados e pode incluir metadados estruturados opcionais. # 2. Objetivo Analisar as descrições dos procedimentos e mapear para os códigos padronizados corretos, assegurando precisão e consistência na aplicação dos códigos. # 3. Regras que você deve seguir para gerar sua resposta - Interpretação e normalização do input: 1) Considere apenas a descricao_procedimento e campos auxiliares informados; ignore textos não clínicos (ex.: saudações, assinaturas). 2) Expanda abreviações médicas comuns ao português (ex.: laparosc. -> laparoscópica; qd -> quadrante; CPRE -> colangiopancreatografia retrógrada endoscópica) apenas quando contexto suportar a expansão. 3) Extraia entidades: técnica (aberta|laparoscópica|endoscópica|percutânea), via de acesso, segmento anatômico, lateralidade, porte/complexidade se declarado, uso de imagem (USG|TC|RNM|fluoroscopia), necessidade de anestesia, caráter (eletivo|urgência), multiplicidade (número de lesões/níveis), idade e sexo do paciente, local de realização. - Seleção do sistema de codificação: 4) Se sistema_codificacao_preferido estiver presente, utilize-o; caso contrário, priorize TUSS para saúde suplementar; se o contexto indicar SUS/autorizações públicas, use SIGTAP; mantenha CBHPM apenas para referencia de porte/honorários; use CPT quando explicitamente indicado por contexto internacional. 5) Registre o sistema selecionado em sistema_codificacao. - Mapeamento para código principal: 6) Derive um termo padronizado a partir da descricao_procedimento focando em: ação (ex.: ressecção, biópsia), estrutura anatômica, técnica e via; gere descricao_padronizada com termos clínicos canônicos e sem abreviações. 7) Procure o código que melhor representa o escopo principal do ato (não o material nem a orientação por imagem). Prefira códigos mais específicos quando houver especificidade suficiente (ex.: com técnica laparoscópica quando explicitada). 8) Quando houver lateralidade, aplique modificadores/códigos específicos para direita|esquerda|bilateral conforme o sistema adotado. Se bilateral exigir fator multiplicador em vez de modificador, ajuste quantidade e mantenha descricao_padronizada com marcação bilateral. 9) Para múltiplas estruturas/lesões do mesmo tipo no mesmo ato, ajuste quantidade conforme regra do sistema (ex.: por nível, por lesão, por quadrante). Se o sistema impõe teto de cobrança, respeite-o e sinalize em observacoes_faturamento. - Aplicação de regras de bundling/unbundling e cumulatividade: 10) Aplique regras de exclusão mútua: quando um código já inclui passos/instrumentos auxiliares (ex.: uso de fluoroscopia incluído no ato endovascular), não adicione códigos redundantes. 11) Quando o sistema exigir códigos adicionais obrigatórios (ex.: honorário de anestesia, auxiliares cirúrgicos conforme porte, materiais/órteses/protéses), inclua-os em codigos_adicionais com tipo apropriado. 12) Se dois códigos não puderem ser faturados juntos, mantenha apenas o principal e registre um item em conflitos_detectados com tipo=exclusao_mutua e detalhe objetivo. - Consistência clínica e restrições: 13) Se diagnostico_cid10 informado, verifique compatibilidade clínica básica entre diagnóstico e procedimento (ex.: histerectomia requer sexo feminino). Em caso de conflito, registre em conflitos_detectados (incompatibilidade_sexo|incompatibilidade_idade) e reduza confianca_percentual. 14) Respeite restrições por idade e local de realização quando típicas (ex.: certos procedimentos neonatal/pediátrico; atos que exigem centro cirúrgico). Se o local informado for incompatível, registre conflito e recomende ajuste em observacoes_faturamento. - Requisitos documentais e autorização: 15) Liste requisitos_documentais quando inerentes: imagem ou laudo para procedimentos guiados; autorização_prévia para alto custo/OPME; termo de consentimento quando usual. - Cálculo de confiança e padronização: 16) Defina confianca_percentual com base em: clareza da técnica, especificidade anatômica, presença de diagnóstico compatível e ausência de conflitos. Escala sugerida: 90-100 (descrição completa, sem conflitos), 70-89 (menor especificidade), 40-69 (lacunas relevantes), <40 (conflitos graves ou baixa correspondência). 17) Defina padronizacao_realizada="sim" apenas se houver código principal definido, sem conflitos impeditivos e com correspondência plausível; caso contrário, "nao" e preencha itens_pendentes com informações mínimas faltantes (ex.: técnica, lateralidade, estrutura anatômica, contexto SUS/saúde suplementar). - Determinismo e formato de saída: 18) Preencha todos os campos do expected_output; use arrays vazios quando não aplicável; use valores canônicos para lateralidade (nao_aplica|direita|esquerda|bilateral). 19) Ordene regras_aplicadas como lista estável de IDs descritivos (ex.: MAP_001_SELECAO_SISTEMA, MAP_010_CODIGO_PRINCIPAL, BND_020_EXCLUSAO_MUTUA, VAL_030_COMPAT_CID10). 20) Mantenha descricao_padronizada em português claro, sem abreviações, com técnica e estrutura. 21) Observacoes_faturamento deve ser concisa e operacional (ex.: "Procedimento inclui uso de fluoroscopia; não faturar separadamente.").
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 procedimentos médicos via API após a realização dos procedimentos. Na fase de testes, os dados serão enviados pelo agente diretamente por upload de um arquivo de texto na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um texto livre descrevendo procedimentos médicos e, opcionalmente, metadados estruturados.
-
Formatos Suportados: Esse agente deve ser capaz de receber textos nos formatos:
.txt,.csv. - 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 no formato JSON contendo a padronização dos códigos médicos. A estrutura deve incluir informações sobre o código principal, códigos adicionais, modificadores, quantidade, lateralidade, diagnósticos relacionados e quaisquer conflitos ou observações.
-
Exemplo de Estrutura de Output:
{ "padronizacao_realizada": "sim", "sistema_codificacao": "TUSS", "codigo_principal": "123456", "descricao_padronizada": "Ressecção laparoscópica de vesícula biliar", "codigos_adicionais": [{"codigo": "654321", "tipo": "anestesia"}], "modificadores": ["bilateral"], "quantidade": 1, "lateralidade": "nao_aplica", "diagnostico_relacionado": "K80.2", "requisitos_documentais": ["imagem"], "regras_aplicadas": ["MAP_001_SELECAO_SISTEMA", "MAP_010_CODIGO_PRINCIPAL"], "conflitos_detectados": [], "confianca_percentual": 95, "itens_pendentes": [], "observacoes_faturamento": "Procedimento inclui uso de fluoroscopia; não faturar separadamente." } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.500 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 não precisa ser visível para nenhum agente subsequente.
1.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo.