# Actualización automática ## Historial de revisiones | Fecha | Descripción | | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 08/09/2015 | Los cambios incluyen las mejoras introducidas. | | 04/25/2016 | Actualización de referencia de la función de actualización automática. | | 05/18/2016 | Revisar actualizaciones. | | 09/15/2016 | Actualización de formato. | | 09/22/2016 | Actualización de mejora en el controlador del sitio. | | 02/10/2017 | Actualizaciones de formato de 2017. Se agregó la consideración de TLS 1.2 para Backoffice. Se agregó una nota de que las aplicaciones Commander SMS pueden necesitar actualizaciones junto con las actualizaciones del software del controlador/POS. | | 02/28/2017 | Se agregó la actualización aplicada automáticamente. Términos del glosario ampliados. | | 05/17/2019 | Actualizado con comentarios del equipo de capacitación. | | 07/04/2019 | Información actualizada sobre por qué las nuevas funciones no están habilitadas de forma predeterminada para los roles. | ## GLOSARIO DE TÉRMINOS Los siguientes términos y definiciones ayudarán al lector a comprender el contenido de la Referencia de funciones. | Términos | Definiciones | | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ASM | Mantenimiento anual de soporte | | Actualización automática | Esta función permite a un sitio iniciar una actualización completa del software sin requerir la presencia o experiencia de un VASC, ni la intervención del Centro de Soporte Técnico de Verifone. | | DCR | Lector de tarjeta del dispensador | | EPS | Servidor de pagos electrónicos | | HASP | Protección de hardware contra la piratería de software. Una clave de hardware HASP, también llamada "dongle", es un dispositivo de protección contra copias de software que se conecta al puerto USB de la computadora. Al iniciarse, la aplicación busca la clave y solo se ejecutará si la clave contiene el código apropiado. | | LAN | Red de área local | | POS | Punto de venta | | Sistema POS | Incluye los terminales POS, el controlador del sitio y el servidor de pagos electrónicos. | | TLS | Transport Layer Security es un protocolo criptográfico que proporciona seguridad de comunicaciones a través de una red informática. | | USB | Bus serie universal | | VASC | Contratista de servicio autorizado de Verifone | | VRSD | Verifone Remote Software Download es la solución automatizada de descarga remota de software de Verifone. | | WFTPD | Windows FTP Daemon es un servidor FTP independiente para Windows. | ## Descripción general ### Descripción de la función La función de actualización automática permite a un sitio iniciar una actualización completa del software sin requerir la presencia o experiencia de un Contratista de servicio autorizado de Verifone (VASC), ni la intervención del Centro de soporte técnico de Verifone. Verifone Remote Software Download (VRSD) es la solución automatizada de descarga remota de software de Verifone. Todos los conjuntos de datos disponibles dentro del controlador del sitio se respaldan durante el proceso de actualización automática, junto con los registros de transacciones, los datos de informes (incluidos los totalizadores) y los datos del titular de la tarjeta. Cerrar el informe diario antes de realizar la actualización automática es fundamental para evitar la pérdida de los detalles de liquidación por lotes si la actualización presenta algún problema. ### Requisitos •Controlador de sitio Commander o RubyCi •Conexión a Internet de banda ancha ### Configuraciones de hardware compatibles •Controlador de sitio Commander con C18 •Controlador de sitio Commander con Topaz •Controlador de sitio Commander con Ruby2 •RubyCi con Topaz •RubyCi con Ruby2 ### Temas relacionados * [Referencia de interfaz de usuario de la versión 53 y superior](/feature-references/feature-references-es/referencias-de-funciones/referencia-de-interfaz-de-usuario-de-release-53-y-superior.md) — Revise los cambios de la interfaz de usuario que pueden aparecer después de una actualización. * [Selector de aplicaciones](/feature-references/feature-references-es/referencias-de-funciones/selector-de-aplicaciones.md) — Vea cómo se conservan los valores predeterminados de la aplicación C18 durante las actualizaciones. * [Autocobro](/feature-references/feature-references-es/referencias-de-funciones/caja-de-autoservicio.md) — Compruebe las actualizaciones de roles y el comportamiento que puede cambiar después de actualizar a una base con capacidad SCO. ## Configuración de la actualización automática {% hint style="danger" %} La siguiente información es fundamental para el proceso de actualización automática. Revise todo este capítulo antes de comenzar. Realice y siga los pasos descritos en este documento de acuerdo con las políticas y procedimientos de la tienda. {% endhint %} ### Preparación avanzada {% hint style="warning" %} *Detenga todas las operaciones de la tienda antes y durante el proceso de actualización automática:* *proceso:* * *Todos los cajeros deben haber cerrado sesión.* * *Todo el suministro de combustible debe haberse completado. Si es necesario,* *cubra todas las manijas de las bombas con bolsas de papel.* * *Todos los terminales POS deben permanecer inactivos.* * *No se debe vender ninguna mercancía ni combustible.* {% endhint %} Antes de iniciar la actualización automática: * •Asegúrese de que todos los dispositivos de los sistemas Point of Sales estén conectados y funcionando sin errores de comunicación. * •El host de pagos debe estar en línea para que se aplique la actualización. Por ejemplo, el sitio debe estar procesando crédito/débito. * •La impresora de recibos del POS debe estar funcionando para imprimir los mensajes e instrucciones de actualización automática. * •Realice un cierre de período desde el terminal POS: Funciones CSR > Menú de informes. Cierre el período (turno/día) y active un cierre de lote de red. * •Imprima los informes de cierre de período desde el terminal POS: Funciones CSR > Menú de informes. Imprima todos los informes de período, informes de red, informes de cajero, informes de nómina, etc., que normalmente se imprimen como parte del proceso de cierre o conciliación. {% hint style="info" %} *Los informes anuales pueden deshabilitarse para acelerar el proceso de instalación.* *Consulte la sección Informes para conocer los pasos para deshabilitar y habilitar los informes anuales.* *informes.* {% endhint %} * •Confirme que todos los informes disponibles de totales de red se hayan guardado o impreso. Imprima o guarde cada uno de los informes de red antes de continuar. * •Transmita toda la información de informes desde el terminal POS al sistema de back office, si corresponde a la configuración del sitio. * •Opcional: aunque la actualización automática preservará los conjuntos de datos en el controlador del sitio, también puede realizar una copia de seguridad secundaria con SMS Import/Export antes de aplicar la actualización. {% hint style="warning" %} *Debido a los requisitos de seguridad mejorados, los sistemas de* *software de Backoffice ahora deben usar el protocolo de seguridad TLS 1.2. Verifique con* *su proveedor de Backoffice la compatibilidad del sistema antes de aplicar* *actualizaciones.* {% endhint %} ### Tiempo real Permita hasta una hora para que el proceso de actualización automática se complete. La duración del proceso de actualización depende del alcance de la actualización y de la cantidad de datos que se respalden y restauren. Comuníquese con el Centro de soporte técnico de VeriFone si se producen demoras prolongadas o problemas. Durante la actualización automática: * •No apague ni reinicie manualmente el sistema en ningún momento durante el proceso. * •El sistema se reiniciará varias veces durante el proceso de actualización. * •Asegúrese de que no haya interrupciones de energía durante el proceso de actualización. ![](/files/a942101df81f8b90d747870874a40346a11482b5) ## Uso de la actualización automática ### Transferencia del paquete de actualización Los siguientes métodos se usan para transferir un paquete de actualización automática al sistema: #### Uso de una unidad flash USB en el terminal POS 1. Conecte la unidad USB que contiene el paquete de actualización automática (Overlay.sig y Overlay.Zip) desde la carpeta de la aplicación al terminal POS.\ **NOTA:** *Estos archivos deben estar en el directorio raíz de la unidad USB.* 2. Desde el terminal POS, vaya a: Func. CSR > menú Mantenimiento. 3. Haga clic en **\[Buscar actualizaciones USB].** 4. Siga las instrucciones en el terminal POS. #### Uso del remitente de paquetes **1.**Desde la carpeta de la aplicación de software, haga doble clic en **\[Auto\_Upgrade.jar]** para seleccionar y ejecutar el archivo.
2.Confirme el paquete *Tipo: Archivo de paquete* ![](/files/5a3436b8c14504262723eb50f14c39e2a23c6ddf) 3.Haga clic en **\[Examinar] para** elegir el archivo de paquete para enviar.
4.Haga clic para seleccionar el **archivo overlay.zip** de los archivos de la imagen del CD. ![](/files/147d13094d527817e87de23e8b2bb1ad12b5d6e4) 5.Haga clic en **\[Abrir].**
6.Haga clic en **\[Instalar].**
Se muestra la ventana de progreso del instalador de software de actualización automática. ![](/files/0b73f86297fe0b1fc5a7cb967a183bb2547d2dda) #### Uso de Verifone Remote Software Download (VRSD) Los comerciantes con un contrato activo de Mantenimiento anual de soporte (ASM) son elegibles para recibir actualizaciones de software a través del servicio Verifone Remote Software Delivery (VRSD). Para obtener información detallada sobre Verifone Remote Software Download, visite la página de soporte de Verifone en >> Petro & Convenience >> Products and Services >> Software Updates (VRSD). Los comerciantes deben enviar una Solicitud de actualización de VRSD mediante el formulario de solicitud en línea ubicado en el portal de soporte técnico de Verifone en . Haga clic en el enlace \[TechSupportChat or Email].
Ingrese lo siguiente: 1. Seleccione el Departamento/Categoría para su chat/correo electrónico: Petroleum and Convenience. 2. Seleccione cómo desea comunicarse con Soporte técnico: Correo electrónico. 3. Seleccione el motivo para contactarnos: Solicitud de actualización de VRSD. 4. Ingrese nombre y apellido, número de teléfono y dirección de correo electrónico. 5. Seleccione el tipo de entrada: ID de servicio. 6. Ingrese el valor de entrada: ID de servicio ASM. 7. Escriba una descripción detallada, por ejemplo:\ Versión actual de la aplicación: Buypass 2.06.00.\ Solicitud de actualización de la versión de la aplicación. 8. Haga clic en **\[Enviar].**
Se enviarán correos electrónicos a la dirección proporcionada con la solicitud de actualización, con actualizaciones de estado e instrucciones para aplicar la actualización. El paquete de actualización automática debería llegar automáticamente en un plazo de 48 a 72 horas. Las actualizaciones de estado en tiempo real están disponibles desde el menú Funciones de cajero del POS. Vaya a **Funciones CSR >> Seleccione Mantenimiento >> Buscar actualizaciones VRSD**. El sistema responde con un mensaje de estado de actualización. **Seleccione \[Sí]** para buscar actualizaciones. La respuesta del sistema muestra el estado de descarga del software actualizado: “La descarga está programada.” #### Uso de la utilidad cliente RCI Si Verifone lo indica, solicite una copia del manual de la utilidad cliente RCI para obtener más instrucciones. ### Actualización aplicada manualmente {% hint style="warning" %} *Antes de iniciar el proceso de actualización automática, confirme que todos los terminales POS* *hayan cerrado sesión de ventas y que todas las bombas de combustible estén inactivas.* *No inicie el proceso de actualización automática si la sección de* *Preparación avanzada no ha sido revisada.* {% endhint %} Después de que la descarga de la actualización de software haya sido transferida por uno de los métodos anteriores: 1.El controlador del sitio Commander mostrará un mensaje de alarma en todos los terminales POS: “ X.XX.XX Disponible”. ***terminales POS: “ X.XX.XX Disponible”.*** 2.Desde un terminal POS, vaya a: Func. CSR > Mantenimiento. Se mostrará el menú de funciones de mantenimiento del registro. 3.Haga clic en **\[Aplicar actualización].** Al aplicar el paquete de actualización, el mensaje de error "PMC Not Ready" indica que el controlador del sitio no se está comunicando con la red de pagos.
El sistema iniciará el proceso de actualización automática ***y comenzará “Buscando actualizaciones”.*** 4.Cuando se le solicite ***“¿Imprimir instrucciones?”,*** seleccione **\[Sí]** para imprimir las instrucciones de actualización automática. Ejemplo de instrucciones impresas de actualización automática: ![](/files/604ccdd3f1341c04556463df75c4a16e7ae9ab33) *5.Seleccione **\[Sí]** cuando se le solicite **“¿Aplicar actualización ahora?”,** y comience el proceso de* actualización automática. ### Actualización aplicada automáticamente Una vez completada la descarga de la actualización de software, se muestra un mensaje en los terminales POS indicando que hay una actualización disponible para aplicarse. La actualización puede iniciarse manualmente, o el sistema puede configurarse para iniciar la actualización automáticamente si no se ejecuta manualmente dentro de un número determinado de días. Los sistemas configurados para aplicar actualizaciones automáticamente reducen los problemas asociados con la actualización oportuna del nuevo software, o con actualizaciones que no se aplican en absoluto. Para los sistemas configurados para la actualización aplicada automáticamente: * Las actualizaciones se aplicarán después de un número determinado de días a partir de la fecha en que el motor de actualización automática del sistema Commander recibe localmente el paquete de actualización. Los días restantes para la actualización se contarán en función de un cambio de fecha de calendario. * Una notificación diaria recuerda al sitio la actualización pendiente. Esta acción solo se implementa en terminales POS Verifone y, en este momento, no admite terminales POS de terceros. * Una notificación diaria recuerda al sitio que imprima las instrucciones de actualización. La notificación final en la fecha de ejecución proporcionará instrucciones básicas de actualización previas requeridas. * Antes de que se active la actualización automática, se imprimirá el informe de cierre diario más reciente. * Una vez activado, los mensajes mostrados en los registros POS y una Pausa del sitio de combustible impedirán cualquier actividad o venta adicional antes de aplicar la actualización automáticamente. * El sistema aplicará las actualizaciones automáticamente solo cuando el cierre de período esté completo en todos los registros. El marco de actualización automática comprueba la disponibilidad de todos los terminales POS cliente antes de iniciar la actualización del software. * El proceso de actualización no comenzará si existen transacciones de combustible postpago pendientes de liquidación en el sistema. El proceso de actualización se mantendrá en espera hasta que dichas transacciones se eliminen, y se mostrará una alarma ‘No se puede continuar la actualización’ en los terminales POS mientras se imprime el informe diario antes de la actualización programada {% hint style="info" %} *Las actualizaciones **no** se aplicarán automáticamente si hay* *transacciones pendientes o transacciones de combustible postpago sin liquidar abiertas en el* *sistema.* {% endhint %} #### Requisitos * Los sitios ya deben estar en Base 44+ para esta funcionalidad. * Las propiedades del sistema deben configurarse para habilitar la actualización aplicada automáticamente. Las actualizaciones de software se aplicarían automáticamente en la siguiente actualización de nivel base descargada. #### Habilitación de la actualización aplicada automáticamente Para habilitar la función, el usuario que inició sesión debe tener permisos para editar los permisos del sistema. 1.Vaya a Configuración inicial>Propiedades del sistema.
*El parámetro del sistema apply.upgrade.forcefully es la variable de control. De forma predeterminada* el valor del parámetro está establecido en ‘no’.
*2.Localice y seleccione el parámetro apply.upgrade.forcefully.* 3.Edite el valor del parámetro y establézcalo en ‘yes’. 4.Haga clic en **\[Guardar].**
#### Actualización aplicada automáticamente habilitada y lista Algunas grandes marcas petroleras han elegido que sus sitios corporativos y afiliados tengan esta función habilitada en sus paquetes de descarga de software. En estos casos, el *valor apply.upgrade.forcefully ya está establecido dentro de la aplicación en ‘yes’, y* *no puede editarse ni cambiarse. En esos paquetes de software, la* propiedad del sistema apply.upgrade.forcefully está oculta y no es accesible al ver la lista de propiedades del sistema. ![](/files/b69f372599b5dd4494be35924eb839da1dd5a2e5) #### Proceso de actualización aplicada automáticamente *La propiedad del sistema apply.upgrade.forcefully está establecida en ‘yes’. Esto está incluido en* el paquete de software actual, o puede habilitarse manualmente.
Durante las operaciones diarias, una vez que la actualización del software ha sido recibida por el *sistema POS, se notifica a los cajeros que hay una actualización pendiente.* El día de la descarga del software, un mensaje de alerta indica que la actualización del software se aplicará automáticamente cuando el contador diario haya alcanzado la fecha de ejecución. El sitio puede iniciar manualmente la actualización del software al final del cierre del día en cualquier momento antes de que expire el contador. El día en que el sistema POS recibe la actualización del software, cuando el usuario inicia el cierre de período accediendo al menú Funciones de informes del POS >Informe de cierre de día/mes/año, se muestra un mensaje de actualización automática. La notificación indica que la actualización del software se aplicará automáticamente cuando la cuenta regresiva diaria haya alcanzado la fecha de ejecución, aunque la actualización puede aplicarse manualmente si el sitio así lo decide. Si la actualización del software no se aplica manualmente, el sistema se configura entonces para aplicar automáticamente la actualización al final del día hábil cuando el contador diario alcance la fecha de ejecución. Un mensaje de alerta indica que la actualización del software se aplicará automáticamente al final de ese cierre del día. Cuando el contador diario ha expirado y alcanzado la fecha de ejecución, y el usuario inicia el cierre de período accediendo al menú Funciones de informes del POS >Informe de cierre de día/mes/año, se muestra un mensaje de actualización automática. La notificación indica que la actualización del software se aplicará automáticamente como parte del cierre de período. ### Ventana de estado de actualización Si el sitio ejecuta el conjunto de funciones 37 o superior del controlador del sitio Commander, el proceso de actualización automática se divide en dos fases: •Fase uno: actualización del sistema •Fase dos: restauración de datos históricos Después de completar todas las tareas de la fase uno, el sitio queda completamente operativo para realizar ventas y otras operaciones. Las tareas de la fase dos se ejecutarán en segundo plano y no interrumpen ninguna operación del sitio. Una tarea típica de la fase dos es restaurar los datos de totales cerrados anteriormente. El terminal POS muestra la ventana de estado de actualización con barras de progreso que indican el estado de la tarea en ejecución y el progreso general de la instalación. Junto con la información de la tarea actual, la ventana de estado también incluye el estado de las tareas ejecutadas previamente. ***El mensaje, “Espere,*** ***reinicio del servidor en progreso...”*** aparece en el área de la barra de progreso durante las etapas del reinicio del controlador del sitio Commander. Después de que todas las tareas de la fase uno ***muestren “Completado”,** el* estado general muestra 100 % completado y el *mensaje de estado **“Actualización automática*** ***Fase 1 completada”*** se muestra. *Cuando el mensaje del sistema muestra **“Actualización automática fase 1 completada. Fase 2 en*** ***progreso (restaurando totales cerrados anteriormente)”,** haga una de las siguientes acciones:* •Haga clic en **\[Aceptar]** para descartar el mensaje superpuesto y continuar con las ventas u otras operaciones del sitio. •No realice ninguna acción hasta que la fase dos de la actualización esté completa; la ventana de estado de la actualización continuará mostrándose en el terminal POS. *Durante la fase dos, se **“Restaurar (Etapa 2)”** muestra un mensaje de estado en el terminal* POS. En cualquier momento durante la fase dos, las tareas pueden supervisarse en cualquier terminal POS seleccionando **Func. CSR > Mantenimiento > Mostrar estado de la actualización**. Si el sitio ejecuta el conjunto de funciones 38.15 o superior del controlador del sitio Commander, la actividad de la fase dos de actualización automática, restaurar totales históricos, tendrá un tiempo de espera de 2 horas y 30 minutos. Los datos históricos para informes se restauran en orden cronológico inverso. Es decir, los datos del período más reciente se restauran primero, seguidos por los del período anterior y así sucesivamente; este proceso se repite hasta que se restauran los datos del período disponible más antiguo. Si el tiempo necesario para restaurar los datos históricos supera el tiempo de espera especificado, el proceso de restauración finaliza. En caso de terminación por tiempo de espera, el Informe de resumen de actualización incluirá detalles sobre el rango de períodos de informe restaurados. Después de completar la actualización, se muestra una ***ventana de mensaje confirmando “Actualización*** ***completada correctamente.”*** Haga clic en **\[Aceptar]** para cerrar la ventana**.** Durante el proceso de actualización automática, se muestra la siguiente sucesión de mensajes en la ventana de estado de actualización del terminal POS: * •Preparando la actualización * •Descarga de archivo (Etapa1) * •Verificación de comunicación (Etapa1) * •Comprobación de la versión del software * •Actualización del motor de actualización * •Actualización del motor de actualización completada * •Actualizar estado de la actualización * •Copia de seguridad (Etapa1-12) * •Instalación de la aplicación SC * •Instalación de la aplicación (Etapa2) * •Restaurar (Etapa1-11) * •Actualización de carga útil * •Inicialización del sitio * •Limpieza * •Reinicio / búsqueda del cliente (Etapa1) * •Restaurar (Etapa2) * •Limpieza ### Pasos posteriores a la actualización {% hint style="warning" %} ***Espere hasta que todas las bombas y lectores de tarjetas del dispensador (DCR) estén*** ***completamente cargados antes de volver a iniciar sesión en el sistema, incluso si las*** ***pantallas del terminal POS muestran “Actualización completada.”*** {% endhint %} •Imprima el Informe de resumen de actualización y verifique que el estado de cada tarea aparezca como ***Completado.*** •Si los informes anuales estaban deshabilitados, habilite los informes (consulte el Apéndice). •Póngase en contacto con el soporte técnico de Verifone si: * ***–Si se encuentran estados** de Fallado o Completado con errores.* * –Si se imprimieron mensajes de error en la impresora de recibos del POS durante la actualización. * –Si se encuentra una pantalla de solicitud de registro, llame al servicio de ayuda de Verifone al 1-800-519-7225 opción 2 para solicitar una nueva clave de registro. Los VASC pueden volver a registrar sistemas en el portal Verifone Premier. {% hint style="info" %} *Después de completar las actualizaciones de software, es posible que sea necesario volver a instalar las aplicaciones dentro de la* *suite de gestión del sitio Commander.* *Esto incluye Site Report Navigator, Site Transaction Manager,* *y la utilidad de importación/exportación de Commander.* *Estos programas se pueden descargar desde Support.Verifone.Com* *dentro de su carpeta de instaladores SMS correspondiente.* {% endhint %} {% hint style="info" %} *Después de completar las actualizaciones de software, todas las nuevas funciones* *no están habilitadas de forma predeterminada para los usuarios existentes del sistema. Un* *gerente tendría que asignar las nuevas funciones a los roles* *requeridos.* *Esto afecta comúnmente a funciones como* [*Autocobro*](/feature-references/feature-references-es/referencias-de-funciones/caja-de-autoservicio.md) *y* [*Selector de aplicaciones*](/feature-references/feature-references-es/referencias-de-funciones/selector-de-aplicaciones.md)*.* {% endhint %} #### Inicializar DCR Si los DCR no se actualizan durante el proceso de actualización: 1.Inicialice los DCR mediante el cliente de configuración: Configurar Pista > Inicialización > DCR.
2.Seleccione **\[Todos los DCR]** > haga clic en **\[Aceptar].**
3.Confirme la inicialización > haga clic en **\[Aceptar].**
## Informes ### Informe de resumen de actualización
El Informe de resumen de actualización proporciona un resumen de la actualización automática que puede imprimirse. Para acceder al Informe de resumen de actualización desde el terminal POS, vaya a: **Func. CSR > Mantenimiento > Imprimir resumen de actualización**. #### Detalles del informe El Informe de resumen de actualización proporciona los siguientes detalles: •versión del software antes y después de la actualización •estado general de la actualización •hora de inicio y finalización de la actualización •detalles de la tarea * –nombre de la tarea * –dispositivo de destino * –tiempo empleado para la ejecución de la tarea * –estado de la tarea * • Completado * • Completado con errores * • Fallado ### Informes anuales #### Deshabilitar informes anuales 1.Desde el cliente de configuración, vaya a: > Informes > Configuración de informes.
2.Seleccione **\[Anual] desde Configuración de período.** 3.Seleccione **\[No]** para Informes de base de datos acumulada > haga clic en **\[Guardar].**
#### Habilitar informes anuales 1.Desde el cliente de configuración, vaya a: > Informes > Configuración de informes.
2.Seleccione **\[Anual]** desde Configuración de período. 3.Seleccione **\[Sí]** para Informes de base de datos acumulada > haga clic en **\[Guardar].**
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.verifone.com/feature-references/feature-references-es/referencias-de-funciones/actualizacion-automatica.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.