Ordenar os resultados da pesquisa de saúde

Por padrão, quando você pesquisa dados de saúde, os resultados são retornados em ordem cronológica inversa. Ao pesquisar nos seguintes tipos de recurso FHIR que contêm texto não estruturado, é possível ordenar os resultados de pesquisa de acordo com a relevância para a consulta:

  • Composição
  • DiagnosticReport
  • DocumentReference

Exemplo de cenário

Suponha que você esteja procurando a palavra-chave insulin para um determinado paciente e tenha filtrado os resultados para os recursos que contêm texto não estruturado. Entre outros resultados, você recebe os seguintes documentos:

  • Resultado 1: um recurso DocumentReference, datado em 24 de abril de 2024, que contém anotações sobre os níveis de "HbA1c" do paciente.
  • Resultado 2: um recurso de DiagnosticReport, datado de 11 de janeiro de 2024, que contém notas sobre o "regime de insulina" que o paciente precisa seguir.

Por padrão, o resultado 1 aparece mais alto nos resultados porque é um documento mais recente. No entanto, quando você ordena por relevância, o resultado 2 aparece mais alto nos resultados. Isso ocorre porque ele é mais relevante para a consulta de pesquisa insulin.

Ordenar os resultados da pesquisa de saúde

Para ordenar os resultados da pesquisa de acordo com a relevância, siga estas etapas:

Console

  1. No Console do Google Cloud, acesse a página Criador de agentes.

    Agent Builder.

  2. Selecione o app de pesquisa de saúde que você quer consultar.

  3. No menu de navegação, clique em Visualizar.

  4. No campo ID do paciente, insira o ID do paciente cujos dados você quer consultar. Os IDs dos pacientes diferenciam maiúsculas de minúsculas.

  5. Pressione Enter ou clique em Visualizar para enviar o ID do paciente.

  6. Na barra de pesquisa Pesquisar aqui, digite sua consulta.

    Se você tiver ativado o preenchimento automático, uma lista de sugestões vai aparecer abaixo da barra de pesquisa conforme você digita.

  7. Pressione Enter para enviar a consulta.

    • Os resultados da pesquisa são mostrados em tabelas paginadas categorizadas com base no tipo de recurso do FHIR.
    • Por padrão, os resultados da pesquisa de todos os tipos de recurso do FHIR são mostrados em ordem cronológica inversa.

  8. Para os recursos Composition, DocumentReference e DiagnosticReport, clique no filtro Sort: Reverse Chronological e selecione Relevance na lista. Os resultados desses recursos são ordenados de acordo com a relevância.

REST

Para ordenar os resultados da pesquisa de acordo com a relevância, modifique a solicitação search da seguinte maneira:

  • Adicione o campo filter à sua solicitação para limitar os resultados da pesquisa apenas aos recursos do FHIR que contêm texto não estruturado: Composition, DiagnosticReport e DocumentReference.
  • Adicione o campo orderBy à solicitação de pesquisa e defina o valor como _RELEVANCE para receber respostas de pesquisa classificadas de acordo com a relevância.

  1. Enviar a solicitação de pesquisa.

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
  -d '{
"query": "KEYWORD_QUERY",
"filter": "patient_id: ANY(\"PATIENT_ID\") AND resource_type: ANY(\"Composition\", \"DiagnosticReport\", \"DocumentReference\")",
"orderBy": "_RELEVANCE"
}'

    Substitua:

    • PROJECT_ID: o ID do seu projeto do Google Cloud.
    • APP_ID: o ID do app da Vertex AI para Pesquisa que você quer consultar.
    • KEYWORD_QUERY: a palavra-chave que você quer pesquisar nos dados clínicos do paciente filtrado, como "diabetes" ou "a1c".
    • PATIENT_ID: o ID do recurso do paciente cujos dados você quer pesquisar.

    Você vai receber uma resposta JSON que contém os resultados da pesquisa listados na ordem de relevância.