> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references/org/devices/report-primary-user-mismatch_scheduled.md). # Generar informe programado de discrepancia de usuario principal Comparar usuarios principales e inicios de sesión entre Intune y RealmJoin {% hint style="info" %} Este es un runbook programado. Está diseñado para ejecutarse según una programación recurrente en lugar de activarse para un único objeto. Véase [Programación](/es/automatizacion/runbooks/scheduling.md) para obtener detalles sobre cómo configurar las programaciones del runbook. {% endhint %} ### Descripción Compara, para dispositivos Windows, el usuario principal registrado en Intune con el registrado en RealmJoin y enumera todos los dispositivos en los que difieren. También comprueba quién inicia sesión realmente en cada dispositivo, utilizando los inicios de sesión registrados por Intune y el agente de RealmJoin, y enumera los dispositivos cuyo usuario principal ya no lo hace. Las categorías que se enumeran se configuran en la personalización del runbook. Solo se tienen en cuenta los dispositivos que se sincronizaron recientemente con Intune. El informe se puede enviar por correo electrónico o proporcionar como enlace de descarga. ### Cómo funciona El runbook lee dos listas y las relaciona mediante el ID de dispositivo de Entra (con el ID de dispositivo de Intune como alternativa): * **Intune**: todos los dispositivos Windows que completaron una sincronización dentro de los últimos *Última sincronización de Intune dentro de (días)*, con su usuario principal y los inicios de sesión de Intune registrados en el dispositivo. Los dispositivos que dejaron de sincronizarse con Intune se excluyen deliberadamente; pertenecen al **Informar dispositivos obsoletos (Programado)** runbook. * **RealmJoin**: la lista de dispositivos de la API de clientes de RealmJoin. Para cada dispositivo incluye los usuarios que el agente de RealmJoin ha informado que han iniciado sesión, cada uno con una marca de tiempo de *visto por última vez* y cuál de ellos RealmJoin considera como usuario principal. Para cada dispositivo, el runbook responde dos preguntas: ¿coinciden los usuarios principales y el usuario principal sigue iniciando sesión? Cada respuesta es una categoría; un dispositivo puede estar en varias. Que el propio agente de RealmJoin siga informando es una cuestión diferente y se responde mediante el **Informar contacto del agente RealmJoin (Programado)** runbook. ### Categorías | Categoría | Significado | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Discordancia` | El usuario principal de Intune y el usuario principal de RealmJoin difieren. | | `PrimaryUserDeleted` | El usuario principal de Intune se eliminó de Entra ID. Intune escribe entonces el ID de objeto del usuario delante del nombre principal de usuario; el runbook lo reconoce y no lo cuenta como una discordancia. | | `PrimaryUserNotLoggingOn` | Otra persona inició sesión en el dispositivo y el usuario principal no lo hizo dentro de *El usuario principal debe haber iniciado sesión dentro de (días)*. Es probable que el dispositivo lo use una persona diferente de la registrada. | | `MissingInRealmJoin` | El dispositivo existe en Intune, pero RealmJoin no lo conoce o lo conoce sin un usuario principal. | | `MissingInIntune` | RealmJoin conoce el dispositivo, pero este no se sincronizó con Intune dentro de la ventana de sincronización. | Las categorías que se enumeran se configuran en la personalización del runbook; de forma predeterminada, solo `Discordancia` está activada. Cada categoría tiene su propia tabla en la pestaña Datos de salida de la ejecución, con las columnas que explican el hallazgo. Los archivos de informe contienen una fila por dispositivo en las categorías habilitadas con todas las columnas, incluida una columna `Hallazgos` que nombra cada categoría en la que se encuentra el dispositivo. #### De dónde proceden los inicios de sesión Se combinan dos fuentes: * **Intune** registra los inicios de sesión más recientes en un dispositivo con el ID de objeto del usuario y una marca de tiempo. El runbook resuelve los ID en nombres principales de usuario; un usuario que ya no existe se muestra como eliminado. * **El agente de RealmJoin** se ejecuta en el contexto del usuario que ha iniciado sesión e informa a RealmJoin cada 15 minutos mientras haya alguien con sesión iniciada. Cada informe actualiza el *visto por última vez* de ese usuario en ese dispositivo, por lo que los usuarios de RealmJoin de un dispositivo son las personas a las que el agente vio con sesión iniciada, cada una con su última hora. El usuario principal cuenta como que inició sesión cuando cualquiera de las fuentes lo vio dentro de la ventana de inicio de sesión. `PrimaryUserNotLoggingOn` requiere ambas condiciones: se vio a otra persona y no se vio al usuario principal dentro de la ventana. Un dispositivo en el que no se vio a nadie se muestra como `Desconocido` en la `PrimaryUserLogon` columna y nunca se cuenta como que no inició sesión. Los dispositivos compartidos en los que varias personas inician sesión por diseño generan este hallazgo para su usuario principal; exclúyalos con *Excluir dispositivos del grupo*. #### Ámbito de dispositivos *Incluir dispositivos del grupo* limita la comparación a los dispositivos de ese grupo de Entra ID, *Excluir dispositivos del grupo* omite los dispositivos de un grupo. Ambos son opcionales y se pueden combinar; un filtro se aplica en cuanto se selecciona su grupo. ### Habilitación de categorías Los conmutadores de categoría están ocultos en el portal y se configuran en la personalización del runbook, por lo que una programación siempre informa el mismo conjunto. Una personalización que habilita la comprobación de inicio de sesión además de las discordancias: ```json "rjgit-org_devices_report-primary-user-mismatch_scheduled": { "parameters": { "IncludeMismatches": { "Default": true }, "IncludePrimaryUserDeleted": { "Default": true }, "IncludePrimaryUserNotLoggingOn": { "Default": true }, "PrimaryUserLogonDays": { "Default": 30 } } } ``` Consulte la [Guía de personalización de runbooks](https://docs.realmjoin.com/automation/runbooks/runbook-customization) para la sintaxis. ### Entrega del informe Los archivos del informe solo se generan cuando se selecciona un método de entrega a través de la **Entrega del informe** opción (correo electrónico y/o enlace de descarga). Con *Solo datos de salida* seleccionado, los resultados se leen directamente en la pestaña Datos de salida del portal RealmJoin, donde cada tabla también puede exportarse a Excel. La entrega por correo electrónico y la generación del enlace de descarga son independientes y pueden combinarse. Para el enlace de descarga, los archivos del informe se cargan en la Storage Account de Azure configurada en la `RJReport.StorageAccount.*` configuración del Tenant, y se devuelven enlaces de descarga SAS con tiempo limitado. La carga al almacenamiento se autentica con la identidad administrada de la cuenta de Automation; esa identidad necesita el **Reader and Data Access** rol RBAC en la Storage Account de destino (esto es una asignación de RBAC de Azure, no un permiso de aplicación de Graph). Las programaciones que se crearon antes de que la **Entrega del informe** opción existiera siguen enviando su correo electrónico: con un destinatario almacenado solo, el correo electrónico sigue estando habilitado para ellos. Cuando se abre una programación de ese tipo para editarla, la opción muestra *Solo datos de salida*; seleccione de nuevo la entrega antes de guardar; de lo contrario, la programación deja de enviar el informe. ### Resultado sin hallazgos No se envía ningún correo electrónico ni se crea ningún archivo cuando ningún dispositivo pertenece a una categoría habilitada. Una ejecución sin hallazgos se completa normalmente y no es un error; la pestaña Datos de salida sigue mostrando el resumen. ### Configuración relativa a las credenciales de la API de RealmJoin El runbook consulta la API de clientes de RealmJoin y necesita una credencial dedicada almacenada en la cuenta de Azure Automation. La misma credencial sirve para todos los runbooks que utilizan la API, por lo que es una configuración única por cuenta de Automation. 1. **Obtener credenciales de API** - Si aún no tiene credenciales de la API de RealmJoin, solicítelas en . El nombre de usuario tiene el formato `t-`, la contraseña es el secreto de la API. Un inicio de sesión en el portal no funciona aquí. 2. **Solicitar la característica de usuarios de dispositivos** - La lista de dispositivos de la API de clientes es una característica que RealmJoin habilita por Tenant. Pida al soporte técnico que la habilite junto con las credenciales; sin ella, la API responde con HTTP 403 y el runbook se detiene con ese mensaje. 3. **Abrir la cuenta de Automation** - En Azure Portal, abra la cuenta de Automation utilizada para los runbooks. 4. **Vaya a Recursos compartidos > Credenciales** - En el menú izquierdo, en *Recursos compartidos*, haga clic en *Credenciales*. 5. **Agregar una nueva credencial** - Haga clic en *Agregar una credencial*. 6. **Asígnele exactamente el nombre `RJAPI`** - El runbook busca este nombre; cualquier otro nombre hace que falle la búsqueda de credenciales. 7. **Introducir el nombre de usuario y el secreto de la API** - Utilice los valores del paso 1. 8. **Guardar** - Haga clic en *Crear* y ejecute el runbook de nuevo. La API permite 30 solicitudes por minuto por Tenant y responde con HTTP 429 si se supera ese límite. El runbook necesita una solicitud por ejecución y repite una solicitud limitada tras una breve demora, hasta cinco veces, antes de abandonar. ### Configuración relacionada con el envío de correo electrónico Enviar un informe por correo electrónico es opcional y solo ocurre cuando *Enviar también el informe por correo electrónico* o *Enviar también el informe por correo electrónico y enlace de descarga* se selecciona como entrega del informe; entonces se requiere un destinatario. La dirección del remitente se toma de la `RJReport.EmailSender` configuración del Tenant. Este runbook envía correos electrónicos usando la API de Microsoft Graph. Para enviar correos electrónicos a través de la API de Graph, debe configurar una dirección de correo electrónico existente en la personalización del runbook. Este proceso se describe detalladamente en el [documentación de configuración de informes de RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings). #### Marca del correo electrónico El correo electrónico del informe tiene en cuenta la opción opcional `RJReport.Branding.*` del Tenant: * **Imagen de encabezado y pie de página** - URL HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada una * **Enlace del pie de página** - destino de la imagen del pie de página * **Color de acento y de texto** - valores hexadecimales de 6 dígitos, p. ej. `#0052cc` Cuando estos ajustes no están configurados, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen que no puede descargarse o validarse, o un valor de color no válido, nunca impide el correo electrónico del informe; en su lugar se usa el valor predeterminado correspondiente. Instrucciones de configuración y requisitos de imagen: [Marca del correo electrónico](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional). ### Notas y limitaciones * Solo se comparan dispositivos Windows: el agente de RealmJoin se ejecuta en Windows, por lo que RealmJoin no tiene datos de usuario principal ni de inicio de sesión para otras plataformas. * El informe es una instantánea por ejecución. No conserva la ejecución anterior y, por lo tanto, no informa que un usuario principal *cambió* entre dos ejecuciones; compare dos archivos de informe para ello. * Los inicios de sesión que registra Intune solo cubren los más recientes, y el agente de RealmJoin solo ve a los usuarios que tenían sesión iniciada mientras se ejecutaba. Por lo tanto, un usuario que inicia sesión con poca frecuencia puede aparecer como si no iniciara sesión. * El usuario principal mostrado para RealmJoin es el que RealmJoin determinó a partir de los informes del agente; no es el propietario registrado del dispositivo en Entra ID. ### Ubicación Organización → Dispositivos → Informar discordancia de usuario principal (programado) **Nombre completo del runbook** rjgit-org\_devices\_report-primary-user-mismatch\_scheduled ### Detalles | Propiedad | Valor | | ------------------ | ------------------------------------------------------------------------------------------------------------------ | | Versión | 1.8.0 | | Módulos requeridos |

RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
Az.Accounts (>= 5.5.2)

| | Programable | sí | ### Permisos #### Permisos de aplicación * **Tipo**: Microsoft Graph * DeviceManagementManagedDevices.Read.All * *Lee los dispositivos Windows en Intune con su usuario principal, la hora de la última sincronización y los usuarios que iniciaron sesión* * Directory.Read.All * *Resuelve los ID de usuario de los registros de inicio de sesión de Intune en nombres principales de usuario y lee los miembros de dispositivo de los grupos opcionales de inclusión y exclusión* * Mail.Send *(opcional — característica: informe por correo electrónico)* * *Envía el correo electrónico del informe mediante Send-RjRbReportEmail cuando se configura un destinatario* * Organization.Read.All *(opcional — característica: informe por correo electrónico)* * *Lee el nombre para mostrar del Tenant para el asunto del correo, el cuerpo del correo y los nombres de archivo del informe* #### Notas sobre permisos API de clientes de RealmJoin: una credencial de cuenta de Automation denominada 'RJAPI' con el nombre de usuario de API del Tenant (t-) y el secreto, emitidos por el soporte técnico de RealmJoin. API de clientes de RealmJoin: la característica de usuarios de dispositivos de la API debe estar habilitada para el Tenant por el soporte técnico de RealmJoin (de lo contrario, la lista de dispositivos responde con HTTP 403). Storage Account de Azure: rol de 'Lector y acceso a datos' para la identidad administrada de la cuenta de Automation en la cuenta de almacenamiento de destino; la carga recupera las claves de la cuenta mediante listKeys (solo necesario para las opciones de enlace de descarga) ### Parámetros #### SyncThresholdDays Solo se comparan los dispositivos que se sincronizaron con Intune dentro de esta cantidad de días. Los dispositivos que dejaron de sincronizarse por completo pertenecen al informe de dispositivos inactivos. | Propiedad | Valor | | ------------------------------ | ------------------------------------------------ | | Requerido | falso | | Valor predeterminado | 30 | | Tipo | Int32 | | Nombre para mostrar del portal | Última sincronización de Intune dentro de (días) | #### DeviceNamePrefix Solo los dispositivos cuyo nombre comienza con este texto. Déjelo vacío para incluir todos. | Propiedad | Valor | | ------------------------------ | ---------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar del portal | Prefijo del nombre del dispositivo | #### PrimaryUserLogonDays El usuario principal cuenta como que no inició sesión cuando otra persona inició sesión en el dispositivo y el usuario principal no lo hizo dentro de esta cantidad de días. | Propiedad | Valor | | ------------------------------ | ---------------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | 30 | | Tipo | Int32 | | Nombre para mostrar del portal | El usuario principal debe haber iniciado sesión dentro de (días) | #### IncludeMismatches Enumera los dispositivos cuyo usuario principal difiere entre Intune y RealmJoin. | Propiedad | Valor | | ------------------------------ | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Verdadero | | Tipo | Booleano | | Nombre para mostrar del portal | ¿Incluir discordancias? | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### IncludeMissingInRealmJoin Enumera los dispositivos que existen en Intune pero no en RealmJoin, o que RealmJoin conoce sin un usuario principal. | Propiedad | Valor | | ------------------------------ | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar del portal | ¿Incluir dispositivos que faltan en RealmJoin? | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### IncludeMissingInIntune Enumera los dispositivos que existen en RealmJoin pero no se sincronizaron con Intune dentro de la ventana de sincronización. | Propiedad | Valor | | ------------------------------ | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar del portal | ¿Incluir dispositivos que faltan en Intune? | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### IncludePrimaryUserDeleted Enumera los dispositivos cuyo usuario principal de Intune se eliminó de Entra ID. Sin esto, parecerían discordancias, porque Intune reescribe el nombre de un usuario eliminado. | Propiedad | Valor | | ------------------------------ | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar del portal | ¿Incluir usuarios principales eliminados? | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### IncludePrimaryUserNotLoggingOn Enumera los dispositivos en los que otros usuarios inician sesión, pero el usuario principal no lo ha hecho dentro de "El usuario principal debe haber iniciado sesión dentro de (días)". Utiliza los inicios de sesión registrados por Intune y el agente de RealmJoin. | Propiedad | Valor | | ------------------------------ | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar del portal | ¿Incluir usuarios principales que no inician sesión? | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### IncludeDeviceGroup Solo los dispositivos de este grupo de Entra ID. Déjelo vacío para todos los dispositivos. | Propiedad | Valor | | ------------------------------ | ------------------------------ | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar del portal | Incluir dispositivos del grupo | #### ExcludeDeviceGroup Omite los dispositivos de este grupo de Entra ID, por ejemplo, los dispositivos compartidos en los que varias personas inician sesión por diseño. Déjelo vacío para no omitir ninguno. | Propiedad | Valor | | ------------------------------ | ------------------------------ | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar del portal | Excluir dispositivos del grupo | #### SendEmailReport Enviar el informe a la dirección de correo electrónico del destinatario. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### EmailTo Envía el informe a estas direcciones. Separe varias con comas; cada destinatario recibe un correo electrónico independiente. | Propiedad | Valor | | ------------------------------ | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar del portal | Dirección(es) de correo electrónico del destinatario | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### EmailFrom Dirección del remitente del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.EmailSender. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingHeaderImageUrl Imagen de encabezado del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Se toma de la configuración del Tenant RJReport.Branding.HeaderImageUrl; se usa el encabezado predeterminado de RealmJoin cuando está vacío. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingFooterImageUrl Imagen de pie de página del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Se toma de la configuración del Tenant RJReport.Branding.FooterImageUrl; se usa el pie de página predeterminado de RealmJoin cuando está vacío. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingFooterLink Enlace asociado a la imagen de pie de página del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.Branding.FooterLink; realmjoin.com se usa cuando está vacío. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingAccentColor Color de acento del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.AccentColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingTextColor Color de texto del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.TextColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### ReportFileFormat Entrega el informe como CSV, como un libro de Excel o ambos. | Propiedad | Valor | | ------------------------------ | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | CSV y XLSX | | Tipo | Cadena | | Nombre para mostrar del portal | Formato del archivo del informe | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | **Opciones del portal** | Opción del portal | Valor | | ----------------- | ---------- | | CSV y XLSX | CSV y XLSX | | Solo CSV | Solo CSV | | Solo XLSX | Solo XLSX | #### CreateDownloadLink También carga el informe y devuelve un enlace de descarga que expira después de unos días. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### ContainerName Contenedor de almacenamiento al que se cargan los archivos del informe. Se configura por runbook. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | report-primary-user-mismatch | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### ResourceGroupName Grupo de recursos de la Storage Account para las cargas del informe. Obtenido de la configuración del Tenant RJReport.StorageAccount.ResourceGroup. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### StorageAccountName Storage Account para las cargas del informe. Obtenido de la configuración del Tenant RJReport.StorageAccount.StorageAccountName. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### LinkExpiryDays Número de días que un enlace de descarga permanece válido. Obtenido de la configuración del Tenant RJReport.StorageAccount.LinkExpiryDays. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | 6 | | Tipo | Int32 | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | [Volver a la vista general de referencia del runbook](/es/automatizacion/runbooks/runbook-references.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references/org/devices/report-primary-user-mismatch_scheduled.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.