Criar um app

Console

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

6. Opcional. Expanda 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 entre domínios.

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, precisará conectar uma fonte de dados do Google ou uma fonte de dados de terceiros ao seu app.

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

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

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

      Acessar a página Repositórios 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.

   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: ID do app que você quer criar.
   • APP_DISPLAY_NAME: 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 entidades específicos. Se o repositório de dados não contiver entidades, use o ID do repositório de dados.

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

   • Para fornecer 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
     

   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"
     }
   }