Output estruturado

Ao inicializar o plugin, caso o parâmetro de configuração "structuredOutputSchema" seja preenchido com um schema válido, ao usar "Preencher prontuário" o plugin envia os dados estruturados na mensagem voa.plugin.ehr.structured_output (veja Comunicação com a página – mensagens). A mensagem de preenchimento (voa.plugin.ehr.fill) contém apenas o texto do documento; o objeto estruturado vem em eventData.output na mensagem voa.plugin.ehr.structured_output (e eventData.from_cache indica se o resultado veio de cache).

Esse schema segue o padrão JSON Schema, conforme o exemplo abaixo:

Estrutura do schema

// Exemplo de schema
{                                    // ← Schema raiz
  "type": "object",
  "properties": {
    "paciente": {                    // ← Schema da propriedade "paciente"
      "type": "object",
      "description": "Dados do paciente",
      "properties": {
        "nome": {                    // ← Schema da propriedade "nome"
          "description": "Nome completo do paciente"
          "type": "string"
        },
        "idade": {                    // ← Schema da propriedade "idade"
          "description": "Idade do paciente em número inteiro"
          "type": "number"
        }
      }
    },
    "medicamentos_em_uso": {         // ← Schema da propriedade "medicamentos_em_uso"
      "type": "array",
      "items": {                     // ← Schema dos itens da lista
        "type": "object"
        "properties": {
          "nome": {                  // ← Schema da propriedade "nome"
            "description": "Nome do medicamento em uso"
            "type": "string"
          },
          "dosagem": {               // ← Schema da propriedade "idade"
            "description": "Dosagem em uso do medicamento"
            "type": "string"
          }
        }
      }
    }
  }
}

// Exemplo de output
{
  "paciente": {
    "nome": "Fulano",
    "idade": 25
  },
  "medicamentos_em_uso": [
    {
      "nome": "dipirona",
      "dosagem": "1g em caso de dor"
    }
  ]
}

O schema é um objeto javascript que define o formato do output.

• A raíz do schema é sempre um schema do tipo object que pode ter outros schemas aninhados.

• Cada schema devem ter as propriedades description e type.

• A propriedade type pode ter os seguintes valores:

Tipo	Descrição
string	Texto livre
number	Valores numéricos
boolean	Verdadeiro ou Falso
object	Objeto com propriedades definidas
array	Lista de itens

• Todo schema do tipo object deve ter uma propriedade "properties" que são itens chave/valor de outros schemas.

• Todo schema do tipo array deve ter uma propriedade items que é o schema dos itens da lista

É possível utilizar ferramentas que transformam JSONs em schemas automaticamente para facilitar o processo, como o transform.

Campos Especiais

O schema oferece campos especiais, que são campos pré-configurados pela nossa equipe que facilitam a extração de informações médicas comuns. Estes campos contêm instruções e validações otimizadas para maximizar a precisão no preenchimento das informações.

• CID (Classificação Internacional de Doenças)

O campo especial CID instrui o preenchimento de um código e descrição CID, conforme no exemplo abaixo:

{
    "type": "object",
    "properties": {
        "diagnostico_principal": {
            "$ref": "#/$defs/CID" // Nomeclatura de referência aos campos especiais
        },
        "diagnosticos_secundarios": {
            "type": "array",
            "items": {
                "$ref": "#/$defs/CID" // Nomeclatura de referência aos campos especiais
            }
        }
    }
}

// Output
{
    "diagnostico_principal": {
        "code": "G20",
        "description": "Doença de Parkinson"
    },
    "diagnosticos_secundarios": [
        {
            "code": "I10",
            "description": "Hipertensão essencial (primária)"
        }
    ]
}