Filtrar pesquisa em 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 fins de esclarecimento, em relação ao uso da Vertex AI para Pesquisa para recuperar e resumir informações médicas existentes, a restrição quanto ao uso de consultas médicas significa a restrição do uso para fins de diagnóstico direto ou tratamento sem análise, 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 objetivo deste produto não é fornecer informações sobre à prevenção, diagnóstico ou 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 analisar a saída gerada, os clientes precisam considerar a representatividade das subpopulações nos dados de origem.

Ao consultar dados de saúde, você pode usar filtros para refinar as respostas da pesquisa. Em uma solicitação de pesquisa, é possível fornecer filtros para impor critérios que para incluir ou excluir determinadas respostas da pesquisa.

Por exemplo, quando você está pesquisando os dados de um único paciente, a solicitação de pesquisa O corpo precisa conter a seguinte expressão de filtro que especifica o ID do paciente:

"filter": "patient_id: ANY(\"PATIENT_ID\")"

Esta página mostra como definir filtros para a pesquisa de saúde.

Antes de começar

Antes de começar, 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.
• Confira a lista de recursos FHIR R4 compatíveis com a Vertex AI para Pesquisa como campos indexáveis, pesquisáveis e recuperáveis. Para mais informações, consulte a referência do esquema de dados FHIR R4 do Healthcare.
• Entenda a sintaxe da expressão de filtro.

Definir filtros

Os filtros são especificados no campo filter no corpo da solicitação do método servingConfigs.search.

A definição do filtro segue a sintaxe da expressão de filtro. Na expressão de filtro, o literal pode ser qualquer campo indexável do resposta à consulta de pesquisa. Por exemplo, se a resposta contiver um recurso de observação, o patient_id que o recurso de observação referencia pode ser usado como um literal de filtro.

As seções a seguir mostram alguns exemplos sobre como criar filtros.

Definir um filtro resource_datetime

Este exemplo mostra como especificar um filtro para uma pesquisa que inclui apenas os recursos que têm um valor de resource_datetime posterior à data especificada; e o valor de tempo.

REST

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/dataStores/DATA_STORE_ID/servingConfigs/default_search:search" \
    -d '{
"query": "QUERY",
"filter": "patient_id: ANY(\"PATIENT_ID\") AND resource_datetime > \"DATE_TIME_VALUE,
"contentSearchSpec":{"snippetSpec":{"returnSnippet":true}}
}'

Substitua:

• PROJECT_ID: o ID do seu projeto do Google Cloud.
• DATA_STORE_ID: o ID do repositório de dados da Vertex AI para Pesquisa.
• QUERY: a consulta de pesquisa.
• PATIENT_ID: o ID de recurso do paciente com os dados que você quer pesquisar.
• DATE_TIME_VALUE: o valor do campo resource_datetime que representa uma data e hora no formato dateTime do FHIR. Confira alguns exemplos desse campo:
  • Para especificar uma data e hora com um fuso horário separado por um separador T: 2022-08-05T01:00:00+00:00
  • Para especificar uma data: 2022-08-05
  • Para especificar um mês: 2022-08
  • Para especificar um ano: 2022

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. O O campo structData contém os dados JSON estruturados para o 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"
            }
            ]
        }
        }
    }]
}

Definir um filtro de tipo de recurso

O exemplo a seguir mostra como criar um filtro que usa um AND. para filtrar todos os recursos de composição e depois os que têm é posterior a uma data e hora especificadas.

"filter": "resource_type: ANY("Composition") AND Composition.date > "2022-08-05T01:00:00+00:00""

Definir um filtro de recurso FHIR

É possível usar um filtro para verificar se um recurso FHIR está presente no repositório de dados da Vertex AI para Pesquisa. Por exemplo, é possível pesquisar um recurso DocumentReference que tenha o ID 6112d1ac-c6bd-4755-d689-bfb71d59afc5 usando o filtro abaixo.

"filter": "DocumentReference.id: ANY(\"6112d1ac-c6bd-4755-d689-bfb71d59afc5\")"