Importa y exporta

Puedes importar y exportar aplicaciones del agente:

  1. Abre la consola de Gemini Enterprise for CX.
  2. Elige tu proyecto. Se muestra la lista de aplicaciones del agente para tu proyecto.
  3. Haz clic en el menú contextual de tu aplicación y, luego, selecciona importar o exportar.

Archivo de entorno

Cuando exportas una aplicación de agente, se incluye un archivo llamado environment.json en el directorio raíz del archivo descargado. Este archivo te ayuda a administrar la configuración específica del entorno de tu aplicación, como los buckets de Cloud Storage, los extremos de servicio y los URI del almacén de datos.

Usar este archivo para las importaciones y exportaciones tiene las siguientes ventajas:

  • Portabilidad mejorada: Transfiere aplicaciones de agentes entre diferentes proyectos o entornos (por ejemplo, de desarrollo a producción) modificando un solo archivo.
  • Configuración centralizada: Todas las dependencias externas clave se enumeran en un solo lugar, lo que simplifica la administración y proporciona una descripción general clara.
  • Reducción de errores: Minimiza el riesgo de errores en comparación con la edición manual de la configuración en varios archivos de recursos.
  • Compatible con la automatización: El formato JSON te permite actualizar la configuración de manera programática con secuencias de comandos como parte de una canalización de CI/CD.

Para actualizar la configuración específica del entorno, sigue estos pasos:

  1. Exportación: Descarga la aplicación del agente exportado y extráela.
  2. Modifica: Abre el archivo environment.json ubicado en el directorio raíz. Modifica los valores de las dependencias para que coincidan con la configuración de tu entorno de destino.
  3. Importar: Comprime todo el directorio, incluido el archivo environment.json modificado, en un nuevo archivo zip. Importa este nuevo archivo al entorno de destino. El sistema aplica los valores actualizados de environment.json.

Detalles del archivo de entorno

El archivo environment.json actúa como un manifiesto central para las dependencias externas que podrían cambiar entre diferentes entornos (por ejemplo, desarrollo, pruebas y producción).

Cuando exportas una aplicación del agente, el sistema identifica los campos específicos del entorno dentro de los recursos de la aplicación. En lugar de codificar estos valores de forma rígida, el sistema los extrae y los coloca en el archivo environment.json. Los valores se organizan por tipo y nombre de recurso. En los archivos de manifiesto de recursos originales, estos valores extraídos se reemplazan por una variable de marcador de posición, $env_var.

Cuando importas la aplicación del agente, el sistema lee el archivo environment.json. Busca los marcadores de posición $env_var en los manifiestos de recursos y los reemplaza por los valores correspondientes del archivo environment.json. Este proceso configura la aplicación para el nuevo entorno.

Los siguientes campos se administran en el archivo environment.json:

  • ApiKeyConfig.key_name
  • ApiKeyConfig.api_key_secret_version
  • AudioRecordingConfig.gcs_bucket
  • BoostSpecs.data_stores
  • ConnectorTool.connection
  • DataStore.name
  • EngineSource.engine
  • FileSearchTool.file_corpus
  • OAuthConfig.client_secret_version
  • OAuthConfig.token_endpoint
  • OpenApiToolset.url (se extrae automáticamente de OpenApiToolset.open_api_schema)
  • ServiceAccountAuthConfig.service_account
  • VertexAiRagRetrievalTool.RagResource.rag_corpus
  • VertexAiRagRetrievalTool.RagResource.rag_file_ids