Sumarização de Textos Clínicos

Esta API permite a sumarização de textos clínicos para um mesmo paciente, organizando informações relevantes sobre o histórico médico, medicamentos, exames, e o plano de tratamento em uma estrutura definida. A API recebe um conjunto de textos clínicos, verifica se todos pertencem ao mesmo paciente e ordena por data antes de executar a sumarização utilizando IA.

Endpoint

POST https://apim.doctorassistant.ai/api/sandbox/summary

Descrição:

Recebe um conjunto de textos clínicos de um paciente, valida as informações, organiza os textos por data, e retorna um sumário estruturado.

Autenticação:

Para utilizar esta API, é necessário fornecer a chave de API no cabeçalho da requisição:

"x-daai-api-key": "SUA_API_KEY"

Request Body:

• texts: Uma lista de textos clínicos contendo patient_id, dt_cn (data em formato ISO), e cn (conteúdo clínico).

Exemplo de Requisição HTTP

Aqui está um exemplo de como a requisição pode ser estruturada:

Curl

curl -X POST "https://apim.doctorassistant.ai/api/sandbox/summary" \
      -H "x-daai-api-key: <INSIRA_SUA_API_KEY_AQUI>" \
      -H "Content-Type: application/json" \
      -d '{
            "texts": [
              {
                "patient_id": 2504703,
                "dt_cn": "2022-10-24T16:30:00.000Z",
                "cn": "PACIENTE VEIO COM A ESPOSA...ESTEVE INTERNADO RECENTEMENTE POR HEMORRAGIA DIGESTIVA BAIXA..."
              },
              {
                "patient_id": 2504703,
                "dt_cn": "2022-11-01T10:00:00.000Z",
                "cn": "O PACIENTE RELATOU MELHORA APÓS O TRATAMENTO..."
              }
            ]
          }'

Python

import requests

url = "https://apim.doctorassistant.ai/api/sandbox/summary"

headers = {
    "x-daai-api-key": "SUA_API_KEY",
}

json_data = {
  "texts": [
    {
      "patient_id": 2504703,
      "dt_cn": "2022-10-24T16:30:00.000Z",
      "cn": "PACIENTE VEIO COM A ESPOSA...ESTEVE INTERNADO RECENTEMENTE POR HEMORRAGIA DIGESTIVA BAIXA..."
    },
    {
      "patient_id": 2504703,
      "dt_cn": "2022-11-01T10:00:00.000Z",
      "cn": "O PACIENTE RELATOU MELHORA APÓS O TRATAMENTO..."
    }
  ]
}

response = requests.post(url, json=json_data, headers=headers)

print(response.json())

Estrutura do Sumário

• Lista de Problemas Ativos: Descrição das condições clínicas atuais do paciente.
• Histórico Médico Resumido: Inclui condições de saúde relevantes, medicamentos em uso, histórico familiar, cirurgias anteriores e outros.
• Sinais e Sintomas do Último Registro: Lista de sinais vitais e sintomas observados na consulta mais recente.
• Resultados de Exames Recentes: Lista de resultados de exames registrados nos textos clínicos.
• Episódio de Cuidado Atual: Descreve os sintomas recentes, plano de tratamento ou investigação mais recente.
• Objetivos do Cuidado Atual: Indica ações ou recomendações específicas do tratamento.
• Anotações Adicionais: Informações relevantes mencionadas pelo médico para continuidade do cuidado.

Exemplo de Resposta

{
  "patient_id": 2504703,
  "summary": "## Lista de Problemas Ativos\n- Anemia grave\n- Hemorragia digestiva baixa\n\n## Histórico Médico Resumido\n- Condições de saúde relevantes: Anemia grave, hemorragia digestiva baixa...\n"
}

Tratamento de Erros

A API pode retornar diferentes erros dependendo da validação dos dados de entrada ou problemas internos do processamento.

Códigos de Erro:

• 400: Erro de validação de dados (ex.: IDs de paciente diferentes).
• 422: Campos obrigatórios ausentes no corpo da requisição (ex.: dt_cn ou cn faltando).
• 500: Erro interno do servidor (ex.: falha na execução principal).