Esta página foi traduzida pela API Cloud Translation.

Pesquisar dados de saúde

Cuidado:

Restrições para a área de saúde: como cliente, você não vai permitir que os Usuários Finais usem os Serviços de IA generativa para fins clínicos (para fins de esclarecimento, pesquisas não clínicas, agendamento ou outras tarefas administrativas não são restritas), como substituto de orientação médica profissional ou de qualquer maneira que seja supervisionada ou que exija aprovação de uma autoridade regulatória aplicável. Para mais informações, consulte os Termos específicos do serviço.
Para maior clareza, em relação ao uso da Pesquisa da Vertex AI para recuperar e resumir informações médicas, a restrição de uso para fins clínicos significa a restrição de uso para fins de diagnóstico ou tratamento direto sem revisão por um profissional licenciado em conformidade com as leis e regulamentações aplicáveis.
A saída gerada nem sempre é totalmente confiável. Devido à natureza dos LLMs e da IA generativa, as saídas podem ter informações incorretas ou tendenciosas (por exemplo, estereótipos ou outros conteúdos nocivos) e precisam ser revisadas. Todos os resumos ou respostas precisam ser considerados rascunho e não definitivo.
O uso pretendido deste produto não é fornecer informações relacionadas à prevenção, ao diagnóstico ou ao tratamento de doenças. Perguntas sobre diagnóstico ou recomendações de tratamento não são deve ser abordada pelo produto. O uso pretendido deste produto é recuperar e resumir informações de saúde existentes fornecidas por usuários.
Devido aos dados de teste limitados, este produto pode ou não ser aplicável ao grupo de 0 a 18 anos e ao grupo de 85 anos ou mais. Portanto, ao revisar a saída gerada, os clientes devem considerar a representatividade de subpopulações nos seus dados de origem.

Depois de importar dados do FHIR R4 para seu app de pesquisa de saúde, você pode consultar os dados importados para receber resultados relevantes. Você pode pesquisar usando os seguintes tipos de consultas:

Consulta de palavra-chave
Consulta do Natural Language
Consulta de linguagem natural com uma resposta de IA generativa

Além disso, é possível filtrar sua pesquisa usando consultas com filtro de data. Para mais informações, consulte Defina um filtro resource_datetime.

Ao pesquisar no console do Google Cloud, primeiro você precisa informar um ID de paciente e pesquisar dados de um paciente por vez. Quando você pesquisa usando a API REST, é possível pesquisar todo o repositório de dados.

Esta página mostra como pesquisar dados de saúde usando os vários tipos de consultas.

Uso pretendido da Vertex AI para Pesquisa na pesquisa de dados de saúde

A Vertex AI para Pesquisa não tem como objetivo fornecer informações relacionados à prevenção, diagnóstico ou tratamento de uma doença. As perguntas sobre recomendações de diagnóstico ou tratamento não são destinadas a serem abordadas pelo produto. O uso pretendido deste produto é extrair e resumir as informações médicas fornecidas pelos usuários.

Devido aos dados de teste limitados, este produto pode ou não ser aplicável aos grupos de 0 a 18 anos e 85 anos ou mais. Portanto, ao analisar a saída gerada, os clientes precisam considerar a representatividade das subpopulações nos dados de origem.

Confira abaixo alguns exemplos de como esse produto deve ser usado:

Consultas exploratórias para encontrar informações de um paciente relevantes para um tópico:
- "Resumir os usos da aspirina"
- "pressão arterial"
- "diabetes management?"
Consultas de navegação para encontrar recursos específicos que podem ser mapeados para uma consulta estruturada:
- "Mostre a versão a1c mais recente"
Perguntas e respostas extrativas para responder a perguntas específicas quando as evidências possam ser distribuídos entre os recursos:
- "Este paciente já foi tratado com cefalsporina?".
- "O paciente já fez avaliação psiquiátrica?"

Confira a seguir exemplos de como não usar o produto:

Recomendações de diagnóstico e tratamento:
- "Qual é o diagnóstico diferencial deste paciente?"
- "Quais medicamentos devo prescrever para o paciente?"

Antes de começar

Antes de pesquisar, faça o seguinte:

Crie um app de pesquisa de saúde e um repositório de dados de pesquisa de saúde e importe dados do FHIR R4. Para mais informações, consulte Criar um app de pesquisa de saúde e Criar um repositório de dados de pesquisa de saúde.
Configurar resultados da pesquisa para dados de saúde.
Para receber sugestões de consulta úteis durante a pesquisa, ative preenchimento automático. Este é um recurso em fase de pré-lançamento.
Confira a lista de recursos FHIR R4 compatíveis com a Vertex AI para Pesquisa. Para mais informações, consulte a Referência do esquema de dados do FHIR R4 para cuidados de saúde.

Pesquisar usando uma palavra-chave

Você pode pesquisar seu repositório de dados de saúde usando uma palavra-chave. Por exemplo, pode pesquisar usando palavras-chave como "a1c", "insulína" ou "úlcera" para se tornar relevante recursos FHIR.

A imagem a seguir mostra os resultados da pesquisa quando a palavra-chave é "lipid". Este exemplo não inclui um resumo ou uma resposta de IA generativa.

A consulta é "lipid". — **Figura 1.** Pesquisar usando palavra-chave.

Para pesquisar usando uma palavra-chave, conclua as etapas a seguir.

Console

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

Agent Builder.
Selecione o app de pesquisa de saúde que você quer consultar.
No menu de navegação, clique em Visualizar.
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.
Pressione Enter ou clique em Visualizar para enviar o ID do paciente.
Na barra de pesquisa Pesquisar aqui, digite uma palavra-chave.

Se você tiver ativado o preenchimento automático, verá uma lista de sugestões abaixo. na barra de pesquisa enquanto digita.
Pressione Enter para enviar a consulta.
- Os resultados da pesquisa são exibidos em tabelas paginadas que são categorizadas com base no tipo de recurso FHIR.
- Por padrão, os resultados da pesquisa de todos os tipos de recursos FHIR são exibidos em ordem cronológica inversa.
Opcional. Para filtrar os resultados, selecione uma ou mais categorias de recursos FHIR que estão abaixo da barra de pesquisa.
Opcional. Para ordenar os resultados de acordo com a relevância para a composição, os DocumentReference e os recursos do DiagnosticReport, clique nos Sort: Reverse Chronological (Classificar: ordem cronológica inversa) do filtro da lista selecione Relevância. Para mais informações, consulte Ordenar resultados de pesquisa de saúde.

REST

O exemplo a seguir mostra como pesquisar os dados FHIR R4 de um único paciente no aplicativo de pesquisa de saúde usando uma palavra-chave. Este exemplo usa o método servingConfigs.search.

Por padrão, os resultados da pesquisa são retornados em ordem cronológica inversa. Ao pesquisar nos recursos Composition, DiagnosticReport e DocumentReference, você pode ordenar os resultados da pesquisa de acordo com a relevância. Para mais informações, consulte Ordenar resultados de pesquisa de saúde.

Pesquise usando uma palavra-chave.

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": "patientId: ANY(\"PATIENT_ID\")",
"contentSearchSpec":{"snippetSpec":{"returnSnippet":true}}
}'

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.

Resposta

Você vai receber uma resposta JSON semelhante a esta resposta truncada. A resposta contém os resultados da pesquisa listados em ordem cronológica inversa com snippets, se estiverem disponíveis. O campo structData contém os dados JSON estruturados do documento.

{
  "results": [
    {
      "id": "DOCUMENT_ID",
      "document": {
        "name": "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID",
        "id": "DOCUMENT_ID",
        "structData": {
          ...
          "resource_type": "FHIR_RESOURCE_TYPE",
          "resource_datetime": "RESOURCE_DATETIME",
          "patient_id": "PATIENT_ID",
          "FHIR_RESOURCE_TYPE": { ... }
        },
        "derivedStructData": {
          "snippets": [
            {
              "snippet": "SNIPPET_TEXT",
              "snippet_status": "SUCCESS"
            }
          ]
        }
      }
    }
  ]
}

Pesquisar usando consulta em linguagem natural

Com a Vertex AI para Pesquisa, é possível gerar resultados para pesquisas naturais consultas em outros idiomas. Por exemplo, a imagem a seguir mostra os resultados da consulta de linguagem natural: "Resultados de laboratório relacionados à diabetes".

A consulta é "Quais são os exames de lípidos do paciente?". — **Figura 2.** Pesquisa usando consulta em linguagem natural.

Para pesquisar usando uma consulta de linguagem natural, siga estas etapas.

Console

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

Agent Builder.
Selecione o app de pesquisa de saúde que você quer consultar.
No menu de navegação, clique em Visualizar.
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.
Pressione Enter ou clique em Visualizar para enviar o ID do paciente.
Na barra de pesquisa Pesquisar aqui, insira uma consulta de linguagem natural, como "Resultados de laboratório relacionados a diabetes".

Se você tiver ativado o preenchimento automático, uma lista de sugestões vai aparecer abaixo da barra de pesquisa conforme você digita.
Pressione Enter para enviar a consulta.
- Os resultados da pesquisa são exibidos em tabelas paginadas que são categorizadas com base no tipo de recurso FHIR.
- Por padrão, os resultados da pesquisa de todos os tipos de recursos FHIR são exibidos em em ordem cronológica inversa.
Opcional. Selecione uma ou mais categorias de recursos do FHIR que estão abaixo da barra de pesquisa para filtrar os resultados.
Opcional. Para ordenar os resultados de acordo com a relevância para os recursos Composition, DocumentReference e DiagnosticReport, clique no filtro Sort: Reverse Chronological e selecione Relevance na lista. Para mais informações, consulte Ordenar resultados de pesquisa de saúde.

REST

O exemplo a seguir mostra como pesquisar os dados FHIR R4 de um único paciente no app de pesquisa de saúde. usando uma consulta de linguagem natural. Este exemplo usa o método servingConfigs.search. Para pesquisar usando um é necessário adicionar o naturalLanguageQueryUnderstandingSpec ao corpo da solicitação.

Postar uma consulta em linguagem natural.

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": "NATURAL_LANGUAGE_QUERY",
"filter": "patientId: ANY(\"PATIENT_ID\")",
"contentSearchSpec":{"snippetSpec":{"returnSnippet":true}},
"naturalLanguageQueryUnderstandingSpec":{"filterExtractionCondition":"ENABLED"}
}'

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.
NATURAL_LANGUAGE_QUERY: a consulta em linguagem natural, como "Resultados de laboratório relacionados a diabetes" ou "O paciente está tomando algum medicamento?".
PATIENT_ID: o ID de recurso do paciente com os dados que você quer pesquisar.

Resposta

Você vai receber uma resposta JSON semelhante à seguinte resposta. A resposta contém os resultados da pesquisa listados em ordem cronológica inversa com snippets, se estiverem disponíveis.

{
  "results": [
    {
      "id": "DOCUMENT_ID",
      "document": {
        "name": "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID",
        "id": "DOCUMENT_ID",
        "structData": {
          ...
          "resource_type": "FHIR_RESOURCE_TYPE",
          "resource_datetime": "RESOURCE_DATETIME",
          "patient_id": "PATIENT_ID",
          "FHIR_RESOURCE_TYPE": { ... }
        },
        "derivedStructData": {
          "snippets": [
            {
              "snippet": "SNIPPET_TEXT",
              "snippet_status": "SUCCESS"
            }
          ]
        }
      }
    }
  ]
}

Pesquisar usando a consulta de linguagem natural com a resposta de IA generativa

Ao pesquisar os dados FHIR de um paciente usando uma consulta de linguagem natural, você pode escolher receber uma resposta de IA generativa junto com os resultados da pesquisa. A resposta resume os resultados da pesquisa e também mostra os referências usadas para gerar a resposta.

Ao usar o console, você pode selecionar o modelo de linguagem grande (LLM) para respostas de IA generativa. Para mais informações, consulte Configurar resultados da pesquisa para dados de saúde.

Ao usar a API REST, você pode especificar um dos seguintes modelos de LLM para receber respostas de IA generativa no campo version:

gemini-1.5-flash-001/answer_gen/v1 ou stable: um modelo estável e geralmente disponível com base no modelo gemini-1.5-flash-001. Para mais informações, consulte Modelos de disponibilidade geral (GA).
gemini-1.0-pro-002/answer_gen/v1: uma pesquisa da Vertex AI baseada no modelo gemini-1.0-pro-002. Para mais informações, consulte Modelos de disponibilidade geral (GA).
medlm-medium/answer_gen/v1 oupreview: um modelo de pré-visualização baseado no MedLM. Para mais informações, consulte Modelo MedLM.

A imagem a seguir mostra um exemplo de consulta de linguagem natural com resposta de IA generativa. O resumo de pesquisa fornece uma resposta para a consulta as descobertas de resultados relevantes. Você pode expandir segmentos que têm citações para ver as referências usadas para gerar o segmento selecionado. Nem todas as respostas geradas têm citações.

A consulta é "Quais são os
laboratórios de lípidos do paciente?". Os resultados da pesquisa são mostrados em um formato
tabular. Os
resultados da pesquisa são acompanhados por um resumo gerado pela IA generativa que diz "O paciente não tem
alergias conhecidas". — **Figura 3.** Pesquise usando a consulta de linguagem natural com a resposta de IA generativa.

Para pesquisar com a resposta de IA generativa, faça o seguinte:

Console

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

Agent Builder.
Selecione o app de pesquisa de saúde que você quer consultar.
No menu de navegação, clique em Configurações.
Personalize o widget de pesquisa:
1. No campo Tipo de pesquisa, selecione Pesquisar com uma resposta.
2. Selecione o modelo que você quer usar para gerar o resumo. Para mais informações, consulte Configurar resultados de pesquisa para dados de saúde.
3. Salve e publique suas preferências.
No menu de navegação, clique em Visualizar.
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.
Pressione Enter ou clique em Visualizar para enviar o ID do paciente.
Na barra de pesquisa Pesquisar aqui, insira uma consulta de linguagem natural, como "nsaids", "Quais são os laboratórios de lipídios do paciente" ou "Qual é a clonagem mais recente resultado de A1C".

Se você tiver ativado o preenchimento automático, verá uma lista de sugestões abaixo. na barra de pesquisa enquanto digita.
Pressione Enter para enviar a consulta.
- A resposta da IA generativa aparece abaixo da barra de pesquisa.
- 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 recursos FHIR são exibidos em em ordem cronológica inversa.
Opcional. Abra um segmento da resposta que tenha citações para conferir as referências nos resultados da pesquisa.
Opcional. Selecione uma ou mais categorias de recursos do FHIR que estão abaixo da barra de pesquisa para filtrar os resultados.
Opcional. Para ordenar os resultados de acordo com a relevância para os recursos Composition, DocumentReference e DiagnosticReport, clique no filtro Sort: Reverse Chronological e selecione Relevance na lista. Para mais informações, consulte Ordenar resultados de pesquisa de saúde.

REST

O exemplo a seguir mostra como pesquisar os dados FHIR R4 de um único paciente no App de pesquisa de saúde usando uma consulta de linguagem natural com respostas de IA generativa. Este exemplo usa o método servingConfigs.search.

Para pesquisar usando uma consulta de linguagem natural, adicione o campo naturalLanguageQueryUnderstandingSpec ao corpo da solicitação.
Para incluir índices de citação inline, adicione o campo includeCitations. Este é um campo booleano com o padrão definido como false.

Publique uma consulta em linguagem natural.

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": "QUERY",
        "filter": "patientId: ANY(\"PATIENT_ID\")",
        "contentSearchSpec": {
          "snippetSpec": {
            "returnSnippet": true
          },
          "summarySpec": {
            "summaryResultCount": 1,
            "includeCitations": true,
            "modelSpec": {
              "version": "MODEL_VERSION"
            }
          }
        },
        "naturalLanguageQueryUnderstandingSpec": {
          "filterExtractionCondition": "ENABLED"
        }
      }'

Substitua:

PROJECT_ID: o ID do seu projeto do Google Cloud.
APP_ID: o ID do app Vertex AI para Pesquisa que você o que você quer consultar.
QUERY: a consulta em linguagem natural. como "nsaids", "Quais são os laboratórios de lipídios dos pacientes" ou "Qual é resultado mais recente de A1C". Se a consulta incluir um apóstrofo ', substitua-o pela referência numérica do caractere apóstrofo: '.
PATIENT_ID: o ID de recurso do paciente com os dados que você quer pesquisar.
MODEL_VERSION: a versão do modelo que você quer usar para gerar a resposta.

Resposta

Você vai receber uma resposta JSON semelhante a esta resposta truncada. A resposta contém resultados da pesquisa detalhados, listados ao contrário ordem cronológica junto com os seguintes campos no objeto summary:

summaryText: contém o resumo da resposta gerada.
summaryWithMetadata: contém o resumo da resposta gerado, com citações. Esse campo só aparece se houver citações. Nem todas as respostas geradas têm citações. Quando o campo summaryWithMetadata estiver disponível, o Google recomenda usar o campo summaryWithMetadata em vez do campo summaryText.
citations.sources.referenceIndex: contém o índice de referência do documentos citados na resposta. Isso é útil para encontrar o nome completo do recurso do documento no campo references.

{
  "results": [
    {
      "id": "DOCUMENT_ID",
      "document": {
        "name": "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID",
        "id": "DOCUMENT_ID",
        "structData": {
          ...
          "resource_type": "FHIR_RESOURCE_TYPE",
          "resource_datetime": "RESOURCE_DATETIME",
          "patient_id": "PATIENT_ID",
          "FHIR_RESOURCE_TYPE": { ... }
        },
        "derivedStructData": {
          "snippets": [
            {
              "snippet": "SNIPPET_TEXT",
              "snippet_status": "SUCCESS"
            }
          ]
        }
      }
    }
  ],
  "summary": {
    "summaryText": "GENERATE_ANSWER_TEXT",
    "summaryWithMetadata": {
      "summary": "GENERATE_ANSWER_TEXT",
      "citationMetadata": {
        "citations": [
          {
            "sources": [
              {
                "id": "DOCUMENT_ID",
                "referenceIndex": "REFERENCE_INDEX_FROM_SUMMARY_METADATA"
              }
            ]
          }
       ]
      },
      "references": [
        {
          "document": "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID"
        },
        ...
      ]
    },
  }
...
}