Agente de IA para Codificação Automática de Procedimentos Médicos

08 de December de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que transforma descrições de procedimentos médicos em códigos padronizados.

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.

© 2025 prototipe.ai. Todos os direitos reservados.