Criar um app

Nesta página, descrevemos como criar um app do Gemini Enterprise.

Importante: se você quiser usar chaves de criptografia gerenciadas pelo cliente (CMEK) para proteger os dados do app, registre a chave CMEK antes de criar o app. Os apps criados antes do registro da chave permanecem desprotegidos. Para mais informações, consulte Chaves de criptografia gerenciadas pelo cliente.

Observação: não é possível conectar repositórios de dados de sites aos seus apps de pesquisa e assistente do Gemini Enterprise.

Criar um app

Console

1. No console do Google Cloud , acesse a página Gemini Enterprise.
2. Na página Apps, clique em Criar app.
3. No campo Nome do app, insira um nome para seu app.
4. Para atualizar o ID do app gerado automaticamente, clique em Editar. Não é possível atualizar o ID do app depois que ele é criado.
5. Na seção Escolher um local, selecione Multirregião. Use a multirregião padrão global (Global), a menos que você precise restringir seus dados a uma região geográfica específica.

6. Opcional. Abra Opções avançadas e configure o seguinte:

   1. No campo Nome da empresa, insira o nome externo da sua empresa, omitindo sufixos como Inc ou LLC. Isso ajuda o LLM a identificar a empresa que o app representa.

   2. Se você estiver conectando um repositório de dados do Google Drive, poderá permitir que o app pesquise documentos fora da sua organização. Para ativar esse recurso, marque a caixa de seleção Incluir documentos de vários domínios.

      Aviso: ativar esse recurso aumenta os riscos de segurança, como injeção de comandos de documentos externos e manipulação de resultados da pesquisa.

7. Clique em Criar.

REST

Antes de usar a linha de comando para criar um app, é necessário ter um repositório de dados. Se você não tiver um repositório de dados, será necessário conectar uma fonte de dados do Google ou uma fonte de dados de terceiros ao seu app.

Para usar o método engines.create para criar um app na linha de comando, siga estas etapas:

1. Encontre o ID do seu repositório de dados. Se você já tiver o ID do repositório de dados, pule para a próxima etapa.

   1. No console do Google Cloud , acesse a página Gemini Enterprise e, no menu de navegação, clique em Repositórios de dados.

      Acesse a página Repositório de dados

   2. Clique no nome do seu repositório de dados.

   3. Na página Dados do seu repositório de dados, encontre o ID do repositório.

2. Crie um app e conecte-o a um repositório de dados.

   Termo-chave:no Gemini Enterprise, o termo app pode ser usado como sinônimo de mecanismo no contexto de APIs. Um mecanismo do Gemini Enterprise é um mecanismo de pesquisa genérico em que o campo app_type é definido como APP_TYPE_INTRANET.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \
   -d '{
     "displayName": "APP_DISPLAY_NAME",
     "dataStoreIds": ["DATA_STORE_ENTITY_ID_1", "DATA_STORE_ENTITY_ID_2", "DATA_STORE_ENTITY_ID_3"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "industryVertical": "GENERIC",
     "appType": "APP_TYPE_INTRANET"
   }'
   

   Substitua:

   • PROJECT_ID: ID do projeto.
   • APP_ID: o ID do app que você quer criar.
   • APP_DISPLAY_NAME: o nome de exibição do app que você quer criar.
   • DATA_STORE_ENTITY_ID: se o repositório de dados contiver entidades, use os IDs de entidade específicos. Se o repositório de dados não contiver entidades, use o ID dele.

   É possível incluir as seguintes configurações opcionais no payload JSON:

   • Para informar o nome externo da sua empresa, inclua o seguinte:

     "commonConfig": {
       "companyName": "COMPANY_NAME"
     }
     

     Substitua COMPANY_NAME pelo nome externo da sua empresa, omitindo sufixos como Inc ou LLC.

   • Se você estiver conectando um repositório de dados do Google Drive, poderá permitir que o app pesquise e indexe documentos fora da sua organização. Para ativar esse recurso, inclua o seguinte no payload JSON:

     "includeCrossDomainDocuments": true
     

     Aviso : ativar esse recurso aumenta a exposição a riscos de segurança, como a injeção de comandos de documentos externos e a possível manipulação de resultados da pesquisa.

   Exemplo de comando e resultado

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines?engineId=my-app" \
   -d '{
     "displayName": "my-app",
     "dataStoreIds": ["slack_1234567890123_conversation", "slack_1234567890123_file", "slack_1234567890123_message"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "industryVertical": "GENERIC",
     "appType": "APP_TYPE_INTRANET"
   }'
   
   {
     "name": "projects/123456/locations/global/collections/default_collection/operations/create-engine-12345678901234567890",
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.Engine",
       "name": "projects/123456/locations/global/collections/default_collection/engines/my-app",
       "displayName": "my-app",
       "dataStoreIds": [
         "slack_1234567890123_conversation",
         "slack_1234567890123_file",
         "slack_1234567890123_message"
       ],
       "solutionType": "SOLUTION_TYPE_SEARCH",
       "searchEngineConfig": {
         "searchTier": "SEARCH_TIER_STANDARD"
       },
       "industryVertical": "GENERIC",
       "appType": "APP_TYPE_INTRANET"
     }
   }
   

A seguir

• Para conectar um app a um repositório de dados, consulte Conectar um app a um repositório de dados.

• Para conectar suas fontes de dados, consulte Conectar uma fonte de dados do Google e Conectar uma fonte de dados de terceiros.

• Para conferir os resultados da pesquisa, acesse Configurações > Interface de pesquisa no console doGoogle Cloud ou consulte Receber resultados da pesquisa do StreamAssist.

• Para configurar o app da Web, como ativar e desativar configurações como o seletor de modelos e o gerador de imagens, consulte Gerenciar recursos do app da Web.