Filtrar pesquisa de serviços de saúde

**Descontinuado** :a Pesquisa do agente para saúde foi descontinuada e não estará mais disponível após 15 de maio de 2027.

Cuidado:

• Restrições para saúde: como cliente, você não usará nem permitirá que os usuários finais usem os Serviços de IA generativa para fins clínicos (para fins de esclarecimento, não há restrições para pesquisas não clínicas, agendamento ou outras tarefas administrativas), como substituto de aconselhamento médico profissional ou de qualquer forma que seja supervisionada por qualquer autoridade reguladora aplicável ou que exija autorização ou aprovação de uma autoridade reguladora. Para mais informações, consulte os Termos específicos do serviço.

  Para fins de esclarecimento, em relação ao uso da Pesquisa do agente para recuperar e resumir informações de saúde atuais, 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 devem ser considerados rascunho, e não resultados finais.
• O uso pretendido desse produto não é fornecer informações relacionadas à prevenção, diagnóstico ou tratamento de doenças. As perguntas sobre recomendações de diagnóstico ou tratamento não devem ser respondidas pelo produto. O uso pretendido desse produto é recuperar e resumir informações de saúde atuais fornecidas pelos usuários.
• Devido aos dados de teste limitados, esse produto pode ou não ser aplicável à faixa etária de 0 a 18 anos e à faixa etária de 85 anos ou mais. Portanto, ao revisar 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 aplicar critérios que incluem ou excluem determinadas respostas de pesquisa.

Por exemplo, ao pesquisar os dados de um único paciente, o corpo da solicitação de pesquisa 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 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.
• Consulte a lista de recursos FHIR R4 que a Pesquisa do agente oferece suporte como campos indexáveis, pesquisáveis e recuperáveis. Para mais informações, consulte Referência do esquema de dados FHIR R4 de saúde.
• Entenda a sintaxe da expressão de filtro.

Definir filtros

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

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 da resposta à consulta de pesquisa. Por exemplo, se a resposta contiver um recurso de observação, o patient_id referenciado pelo recurso de observação poderá ser usado como um literal de filtro.

As seções a seguir mostram alguns exemplos de 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 resource_datetime posterior ao valor de data e hora especificado.

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 Google Cloud projeto.
• DATA_STORE_ID: o ID do repositório de dados da Pesquisa do agente.
• QUERY: a consulta de pesquisa.
• PATIENT_ID: o ID do recurso do paciente cujos dados 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 à resposta truncada a seguir. A resposta contém resultados de pesquisa detalhados listados em ordem cronológica inversa com snippets, se 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"
            }
            ]
        }
        }
    }]
}

Definir um filtro de tipo de recurso

O exemplo a seguir mostra como criar um filtro que usa um operador AND para primeiro filtrar todos os recursos de composição e, em seguida, filtrar aqueles cuja data é 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 Pesquisa do agente. Por exemplo, você pode pesquisar um recurso DocumentReference que tenha o ID 6112d1ac-c6bd-4755-d689-bfb71d59afc5 usando o filtro a seguir.

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