Crea una app

En esta página, se describe cómo crear una app de Gemini Enterprise.

Nota: No puedes conectar almacenes de datos de sitios web a tus apps de búsqueda y asistente de Gemini Enterprise.

Crea una app

Console

1. En la consola de Google Cloud , ve a la página de Gemini Enterprise.
2. En la página Apps, haz clic en Crear app.
3. En el campo Nombre de la app, ingresa un nombre para ella.
4. Para actualizar el ID de la app generado automáticamente, haz clic en Editar. El ID de la app no se puede actualizar después de que creas la app.
5. En la sección Elige una ubicación, selecciona una Multirregión. Usa la multiregión predeterminada global (Global), a menos que necesites restringir tus datos a una ubicación geográfica específica.
6. Para proporcionar el nombre externo de tu empresa, expande Opciones avanzadas. En el campo Nombre de la empresa, ingresa el nombre externo de tu empresa y omite los sufijos, como S.A. o S.R.L. Esto ayuda al LLM a identificar la empresa que representa la app.

REST

Antes de usar la línea de comandos para crear una app, debes tener un almacén de datos existente. Si no tienes un almacén de datos, debes conectar una fuente de datos de Google o una fuente de datos de terceros a tu app.

Para usar el método engines.create y crear una app desde la línea de comandos, sigue estos pasos:

1. Busca el ID de tu almacén de datos. Si ya tienes el ID del almacén de datos, ve al siguiente paso.

   1. En la consola de Google Cloud , ve a la página Gemini Enterprise y, en el menú de navegación, haz clic en Almacenes de datos.

      Ve a la página Almacenes de datos.

   2. Haz clic en el nombre de tu almacén de datos.

   3. En la página Datos de tu almacén de datos, obtén el ID del almacén de datos.

2. Crea una app y conéctala a un almacén de datos.

   Término clave: En Gemini Enterprise, el término app se puede usar indistintamente con el término motor en el contexto de las APIs. Un motor de Gemini Enterprise es un motor de búsqueda genérico en el que el campo app_type está configurado 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",
     "dataStoreEntityIds": ["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"
   }'
   

   Reemplaza lo siguiente:

   • PROJECT_ID: el ID de tu proyecto.
   • APP_ID: Es el ID de la app que deseas crear.
   • APP_DISPLAY_NAME: Es el nombre visible de la app que deseas crear.
   • DATA_STORE_ENTITY_ID: Si tu almacén de datos contiene entidades, usa los IDs de entidades específicos. Si tu almacén de datos no contiene entidades, usa el ID del almacén de datos.

   Ejemplo de comando y 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"
     }
   }
   

¿Qué sigue?

• Para conectar tus fuentes de datos, consulta Conecta una fuente de datos de Google y Conecta una fuente de datos de terceros.
• Obtener una vista previa de los resultados de la búsqueda