Criar um app de pesquisa de saúde

No console Google Cloud , acesse a página Aplicativos de IA.

Aplicativos de IA

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

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

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

Para ativar os recursos avançados do LLM para esse app, clique na opção Recursos avançados do LLM.

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

Quando você ativa os recursos do LLM, pode levar até cinco minutos para que os recursos compatíveis fiquem disponíveis.

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

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

Na seção Transparência no acesso, selecione Desativar métricas de pesquisa para este app se quiser desativar as métricas de registro do app atual. Isso não pode ser alterado depois que o app é criado.

Clique em Continuar.

Para se conectar a um repositório de dados, na página Repositórios de dados, faça uma destas ações:

• Selecione um repositório de dados de saúde para importação em lote ou um conector de dados para importação por 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 serviços 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 add_box 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 seu armazenamento FHIR, faça o seguinte:
     • Selecione o armazenamento de FHIR na lista de armazenamentos disponíveis:
       1. Abra o campo Armazenamento FHIR.
       2. Nessa lista, selecione um conjunto de dados que esteja em um local permitido e um armazenamento de FHIR que use a versão R4 do FHIR.
     • Insira o armazenamento de FHIR manualmente:
       1. Abra o campo Armazenamento FHIR.
       2. Clique em Inserir armazenamento FHIR manualmente.
       3. Na caixa de diálogo Nome do armazenamento FHIR, insira o nome completo do armazenamento 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 depois que o repositório de dados é criado.
     • Única: para realizar uma importação única de dados em lote. Para mais importações incrementais, consulte Atualizar dados de saúde.
     • Streaming: para importar dados de streaming quase em tempo real. Para transmitir dados, crie um conector de dados, que é um tipo de repositório de dados. Para configurar um repositório de dados de streaming usando a API REST, entre em contato com seu engenheiro de clientes.
  5. Na seção Qual é o esquema para esses dados?, selecione uma destas opções:
     • Esquema predefinido do Google: para manter as configurações de esquema definidas pelo Google, como indexação, capacidade de pesquisa e capacidade de recuperação, para os recursos e elementos FHIR compatíveis. Depois de selecionar essa opção, não será possível atualizar o esquema após criar o repositório de dados. Se quiser mudar o esquema depois da criação do repositório de dados, selecione a opção Esquema personalizado.
       1. Clique em Continuar.
       2. No campo Nome do repositório de dados, insira um nome para o repositório.
       3. Clique em Criar.

       O repositório de dados criado aparece na página Repositórios de dados.

     • Esquema personalizado: para definir suas próprias configurações de esquema, como indexação, capacidade de pesquisa e capacidade de recuperação, para os recursos e elementos FHIR compatíveis. Para configurar um esquema configurável, entre em contato com seu 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 campos aos 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.

       O conector de dados criado aparece 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 de dados ou o conector de dados criado.

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

Uma tabela é exibida com uma lista de repositórios de dados e o motivo da indisponibilidade. 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.
• Seu repositório de dados e seu app são de tipos diferentes. Por exemplo, não é possível conectar um repositório de dados de pesquisa de site a um app de pesquisa de saúde.

Clique em Criar.

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

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/v1/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 Google Cloud projeto.
• 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 Search 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 da Vertex AI para Pesquisa.
• SEARCH_ADD_ON: um campo opcional para especificar se você quer os recursos avançados de LLM, como pesquisar com respostas de IA generativa, para esse app. Para ativar os recursos avançados de LLM, insira o valor SEARCH_ADD_ON_LLM. Se você não quiser os recursos avançados do LLM, especifique SEARCH_ADD_ON_UNSPECIFIED ou remova o campo searchAddOns. Para mais informações, consulte Recursos avançados de LLM.

{
  "name": "projects/PROJECT_ID/locations/us/collections/default_collection/operations/APP_CREATION_OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.Engine",
    "name": "projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID",
    "displayName": "APP_DISPLAY_NAME",
    "dataStoreIds": [
      "DATA_STORE_ID"
    ],
    "solutionType": "SOLUTION_TYPE_SEARCH",
    "searchEngineConfig": {
      "searchTier": "SEARCH_TIER_STANDARD",
      "searchAddOns": [
        "SEARCH_ADD_ON_LLM"
      ]
    },
    "industryVertical": "HEALTHCARE_FHIR"
  }
}

No console Google Cloud , acesse a página Aplicativos de IA.

Aplicativos de IA

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

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

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

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/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"

Substitua:

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

{
  "name": "projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID",
  "displayName": "APP_DISPLAY_NAME",
  "createTime": "APP_CREATION_TIMESTAMP",
  "dataStoreIds": [
    "DATA_STORE_ID"
  ],
  "solutionType": "SOLUTION_TYPE_SEARCH",
  "searchEngineConfig": {
    "searchTier": "SEARCH_TIER_STANDARD",
    "searchAddOns": [
      "SEARCH_ADD_ON_LLM"
    ]
  },
  "industryVertical": "HEALTHCARE_FHIR",
  "dataStores": [
    "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/APP_ID"
  ]
}

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