Criar um app de pesquisa de saúde

Para pesquisar dados clínicos na Vertex AI para Pesquisa, siga um destes fluxos de trabalho:

  • Crie um repositório de dados de saúde, importe dados do FHIR R4 para ele, conecte-o a um app de pesquisa de saúde e consulte os dados clínicos. Para mais informações, consulte Criar um repositório de dados de saúde.
  • Crie um app de pesquisa de saúde, crie um repositório de dados de saúde e importe dados do FHIR R4 para o repositório durante o processo de criação do app e consulte os dados clínicos.

Esta página descreve o segundo método.

Sobre a frequência de importação de dados

É possível importar dados do FHIR R4 para um repositório de dados das seguintes maneiras:

  • Importação em lote: uma importação única. Os dados são importados para um repositório de dados. Para outras importações incrementais, consulte Atualizar dados de saúde.

  • Importação de streaming (pré-lançamento): uma importação de dados de streaming quase em tempo real. Todas as mudanças incrementais no armazenamento de FHIR de origem são sincronizadas no repositório de dados da Vertex AI para Pesquisa. O streaming requer um conector de dados, que é um tipo de repositório de dados que contém uma entidade. Uma entidade também é uma instância de repositório de dados.

    A taxa de streaming de dados de um determinado projeto do Google Cloud depende das cotas a seguir. Se você exceder a cota, poderá ocorrer atrasos no streaming.

    • O número de gravações pendentes de streaming do FHIR ou do BigQuery por minuto. Para mais informações, consulte Cotas e limites.
    • O número de operações de leitura do FHIR por minuto por região. Para mais informações, consulte Cotas do FHIR da API Cloud Healthcare.

É possível selecionar a frequência de importação de dados no momento da criação do repositório de dados, e não é possível mudar essa configuração mais tarde.

A importação de streaming está disponível para todos os recursos 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.

Antes de começar

Antes de criar o app de pesquisa de saúde, atenda a estes requisitos:

  • Entenda a relação entre apps e armazenamentos de dados para a pesquisa de saúde. Para mais informações, consulte Sobre apps e repositórios de dados.

  • Prepare seus dados FHIR para transferência.

  • A Vertex AI para Pesquisa de saúde fornece serviços de pesquisa apenas na multirregião dos EUA (us). Portanto, o app de pesquisa de saúde e os repositórios de dados precisam estar na multirregião us.

Criar um app

É possível criar um app de pesquisa de saúde no console do Google Cloud ou usando a API. As duas abordagens diferem da seguinte maneira:

  • No console do Google Cloud: selecione o armazenamento FHIR de origem na API Cloud Healthcare e importe dados FHIR como parte do processo de criação do app de pesquisa de saúde. Para transmitir dados FHIR (pré-lançamento), a loja de FHIR de origem precisa estar no mesmo projeto do Google Cloud que o app de destino da Vertex AI para Pesquisa.
  • Pela API REST: é possível importar dados FHIR de um armazenamento FHIR da API Cloud Healthcare. A loja FHIR pode estar no mesmo projeto do Google Cloud ou em outro.
    1. Use o método dataStores.create para criar um repositório de dados de saúde.
    2. Use o método documents.import para especificar o armazenamento FHIR na API Cloud Healthcare e importar dados FHIR.
    3. Use o método engines.create para criar o app de pesquisa de saúde e especificar um repositório de dados de saúde.

Para criar um app de pesquisa de saúde, siga estas etapas:

Console

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

    Agent Builder.

  2. Na página Apps, clique em Novo app.

  3. Na página Criar app, em Pesquisa de saúde, clique em Criar.

  4. No painel Configuração do app de pesquisa, selecione Saúde.

  5. Para ativar os recursos avançados do LLM para esse app, clique no botão Recursos avançados do LLM.

    Ative os recursos avançados do LLM para receber resumos de pesquisa, que são resumos curtos dos principais resultados de pesquisa.

    Quando você ativa os recursos do LLM, pode levar até cinco minutos para que os recursos com suporte sejam disponibilizados.

  6. No campo Nome do app, insira um nome para seu app.

  7. No campo Nome externo da sua empresa ou organização, insira o nome comum da empresa ou organização. Não é necessário incluir sufixos como Inc ou LLC. Esse campo é útil para que o LLM identifique a empresa que o app representa.

  8. Clique em Continuar.

  9. Para se conectar a um repositório de dados, na página Repositórios de dados, faça o seguinte:

    • Selecione um repositório de dados de saúde para importação em lote ou um conector de dados para importação de streaming. Para criar um repositório de dados ou um conector de dados antes de criar um app, consulte Criar um repositório de dados de saúde.
    • Crie um repositório de dados (para importação em lote única) ou um conector de dados, que é uma instância de um repositório de dados (para importação de streaming):
      1. Clique em Criar repositório de dados.
      2. No painel Selecionar uma fonte de dados, escolha API Healthcare (FHIR) como sua fonte de dados.
      3. Para importar dados do armazenamento FHIR, faça o seguinte:
        • Selecione o armazenamento FHIR na lista de opções disponíveis:
          1. Abra o campo Armazenamento FHIR.
          2. Nessa lista, selecione um conjunto de dados que esteja em um local permitido e, em seguida, selecione um armazenamento de FHIR que use a versão R4.

            Para transmitir dados FHIR (pré-lançamento), a loja de FHIR de origem precisa estar no mesmo projeto do Google Cloud que a repositório de dados destino Vertex AI para Pesquisa.

        • Insira o armazenamento FHIR manualmente:
          1. Abra o campo Armazenamento FHIR.
          2. Clique em Inserir o armazenamento FHIR manualmente.
          3. Na caixa de diálogo Nome da loja FHIR, insira o nome completo da loja FHIR no seguinte formato:

            project/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID

          4. Clique em Salvar.
      4. Na seção Sincronização, selecione uma das seguintes opções. Essa seleção não pode ser alterada após a criação do repositório de dados.
        • Única: para realizar uma importação única de dados em lote. Para mais importações incrementais, consulte Atualizar dados de saúde.
        • Streaming: para realizar uma importação de dados de streaming quase em tempo real. Para transmitir dados, crie um conector de dados, que é um tipo de repositório de dados. Este é um recurso em fase de pré-lançamento. Para configurar um repositório de dados de streaming usando a API REST, entre em contato com o engenheiro de clientes.
      5. Na seção Qual é o esquema desses dados?, selecione uma destas opções:
        • Esquema predefinido do Google: para manter as configurações de esquema definidas pelo Google, como capacidade de indexação, pesquisa e recuperação, para os recursos e elementos do FHIR com suporte. Depois de selecionar essa opção, não será possível atualizar o esquema após a criação do repositório de dados. Se você quiser mudar o esquema após a criação do repositório de dados, selecione a opção Esquema personalizado (pré-lançamento).
          1. Clique em Continuar.
          2. No campo Nome do repositório de dados, insira um nome para o repositório.
          3. Clique em Criar.

            4. O repositório de dados que você criou é listado na página Repositórios de dados.

        • Esquema personalizado (pré-lançamento): para definir suas próprias configurações de esquema, como capacidade de indexação, pesquisabilidade e recuperação, para os recursos e elementos do FHIR compatíveis. Este é um recurso em fase de pré-lançamento. Para configurar um esquema configurável, entre em contato com o engenheiro de clientes.
          1. Clique em Continuar.
          2. Revise o esquema, expanda cada campo e edite as configurações.
          3. Clique em Adicionar novos campos para adicionar novos campos nos recursos FHIR compatíveis. Não é possível remover os campos fornecidos no esquema definido pelo Google.
          4. Clique em Continuar.
          5. No campo Nome do conector de dados, insira um nome para o conector.
          6. Clique em Criar.

            7. O conector de dados criado é listado na página Repositórios de dados. O armazenamento FHIR de origem é adicionado como uma entidade no conector de dados.

      6. Clique em Continuar.
      7. Selecione o repositório ou conector de dados criado.

  10. Opcional: para conferir uma lista de repositórios de dados indisponíveis, clique em Saiba por quê.

    Uma tabela é mostrada com uma lista de repositórios de dados e o motivo de eles não estarem disponíveis. Confira alguns motivos pelos quais um repositório de dados pode estar indisponível:

    • O tipo de repositório de dados permite a conexão com apenas um app, e o repositório já está conectado.
    • O repositório de dados e o app são de tipos diferentes. Por exemplo, não é possível conectar um repositório de dados de pesquisa de sites a um app de pesquisa de saúde.

  11. Clique em Criar.

    Se o app e o repositório de dados forem criados, a página de detalhes do repositório de dados vai mostrar os detalhes dos dados FHIR importados.

REST

  1. Crie um repositório de dados de saúde e importe dados de saúde para ele.

  2. Crie um app de pesquisa de saúde e conecte-o a um repositório de dados. Um app de pesquisa de saúde só pode se conectar a um repositório de dados, enquanto um determinado repositório de dados pode ser conectado a vários apps.

    curl -X POST\
 -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json"\
 -H "X-Goog-User-Project: PROJECT_ID" \
"https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/engines?engineId=APP_ID" \
 -d '{
    "displayName": "APP_DISPLAY_NAME",
    "dataStoreIds":"DATA_STORE_ID",
    "industryVertical": "HEALTHCARE_FHIR",
    "solutionType": "SOLUTION_TYPE_SEARCH",
    "searchEngineConfig": {
      "searchTier": "SEARCH_TIER_STANDARD",
      "searchAddOns": ["SEARCH_ADD_ON"]
    }
}'

    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 criar.
    • APP_DISPLAY_NAME: o nome de exibição do app da Vertex AI para Pesquisa que você quer criar.
    • DATA_STORE_ID: o ID de um repositório de dados da Vertex AI para Pesquisa que você quer adicionar ao app Vertex AI para Pesquisa.
    • SEARCH_ADD_ON: um campo opcional para especificar se você quer os recursos avançados do LLM, como a pesquisa com respostas de IA generativa, para este app. Para ativar os recursos avançados do LLM, insira o valor SEARCH_ADD_ON_LLM. Se você não quiser usar os recursos avançados do LLM, especifique SEARCH_ADD_ON_UNSPECIFIED ou remova o campo searchAddOns. Para mais informações, consulte Recursos avançados do LLM.

Verificar a criação do app

Esta tarefa mostra como verificar se um app de pesquisa de saúde foi criado e se os dados FHIR foram importados para o repositório de dados.

  • No console do Google Cloud: selecione o app e verifique os detalhes.
  • Usando a API REST, use o método engines.get para conferir os detalhes do repositório de dados de saúde.

Para verificar a criação e a importação de dados do repositório de dados, siga estas etapas.

Console

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

    Agent Builder.

  2. Na página Apps, verifique se o app que você criou está na lista de apps.

  3. Verifique se o repositório de dados conectado ao app está listado na coluna Repositórios de dados conectados.

  4. Selecione o repositório de dados e verifique os detalhes dele.

REST

  1. Verifique a criação do app.

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json"\
 -H "X-Goog-User-Project: PROJECT_ID" \
 "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"

    Substitua:

    • PROJECT_ID: o ID do seu projeto do Google Cloud.
    • APP_ID: o ID do app da Vertex AI para Pesquisa.

  2. Verifique a criação do repositório de dados e a importação de dados FHIR.

A seguir