> 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/pt/automatizacao/runbooks/runbook-references/org/devices/report-realmjoin-agent-contact_scheduled.md).

# Reportar contacto do agente RealmJoin agendado

Reportar dispositivos cujo agente RealmJoin deixou de reportar

{% hint style="info" %}
Este é um runbook agendado. Foi concebido para ser executado num agendamento recorrente, em vez de ser acionado para um único objeto. Veja [Agendamento](https://docs.realmjoin.com/pt/automatizacao/runbooks/scheduling.md) para obter detalhes sobre como configurar agendamentos de runbook.
{% endhint %}

### Descrição

Compara, para dispositivos Windows, quando o RealmJoin viu o dispositivo pela última vez com quando ele sincronizou pela última vez com o Intune. Um dispositivo que o Intune viu bem depois de o RealmJoin o ter visto pela última vez aponta para um agente RealmJoin ausente, bloqueado ou com falha. Dispositivos que o RealmJoin nunca viu e dispositivos conhecidos apenas por um dos lados também podem ser listados. O relatório pode ser enviado por e-mail ou disponibilizado como link de download.

### Como funciona

O runbook lê duas listas e as combina pelo ID de dispositivo do Entra ID (com o ID de dispositivo do Intune como recurso de fallback):

* **Intune**: todos os dispositivos Windows que concluíram uma sincronização nos últimos *Última sincronização do Intune em (dias)*. Dispositivos que pararam de sincronizar com o Intune são deixados de fora de propósito; eles pertencem ao **Relatório de dispositivos obsoletos (Agendado)** runbook.
* **RealmJoin**: a lista de dispositivos da API de cliente do RealmJoin. Para cada dispositivo, ela contém os usuários que o agente RealmJoin relatou como com sessão iniciada, cada um com um *última vez visto* carimbo de data/hora. O RealmJoin grava o mesmo carimbo de data/hora no usuário e no dispositivo a cada relatório do agente, portanto o valor mais recente entre esses é o último contato do agente com o dispositivo.

Para cada dispositivo do Intune, o runbook calcula a **lacuna**: quantos dias o Intune continuou vendo o dispositivo depois do último relatório do agente RealmJoin. Cada dispositivo recebe um status:

| Estado               | Significado                                                                                                                                                                                                                                                                                           |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `InSync`             | O agente relatou recentemente o suficiente; a lacuna está abaixo do valor permitido.                                                                                                                                                                                                                  |
| `AgentStale`         | O Intune viu o dispositivo pelo menos *Lacuna permitida até a última vez visto no RealmJoin (dias)* após o último relatório do agente. O dispositivo estava em uso enquanto o agente não relatava: o agente está ausente, bloqueado por um proxy ou firewall, não está em execução ou está com falha. |
| `NeverSeen`          | O RealmJoin conhece o dispositivo, mas o agente nunca relatou um usuário com sessão iniciada nele, por exemplo um dispositivo que foi registrado e nunca usado, ou um quiosque.                                                                                                                       |
| `MissingInRealmJoin` | O dispositivo existe no Intune, mas não no RealmJoin: o agente nunca o registrou.                                                                                                                                                                                                                     |
| `MissingInIntune`    | O dispositivo existe no RealmJoin, mas não sincronizou com o Intune dentro da janela de sincronização. Não disponível em conjunto com um prefixo de nome de dispositivo, porque os dispositivos RealmJoin não têm nome de dispositivo para corresponder.                                              |

`AgentStale` faz sempre parte do relatório. As outras categorias são ativadas com as *opções Incluir ...* A aba Dados de saída da execução mostra um resumo e uma tabela por categoria; os arquivos do relatório contêm as mesmas linhas.

Se os usuários principais de um dispositivo concordam e quem faz login nele são questões diferentes; o **Relatório de incompatibilidade de utilizador primário (Agendado)** runbook responde a elas.

#### Por que a lacuna e não a idade

Comparar o carimbo de data/hora do RealmJoin com o dia de hoje listaria todos os dispositivos que estão simplesmente desligados, por exemplo durante as férias. A lacuna compara as duas fontes entre si: um dispositivo que o Intune também não viu não é um problema do agente RealmJoin. Só um dispositivo que continua se comunicando com o Intune enquanto o RealmJoin não recebe nada aponta para o agente. O padrão de 14 dias corresponde ao ponto em que o RealmJoin Portal marca um dispositivo como desatualizado.

#### O que o carimbo de data/hora do RealmJoin significa

O agente RealmJoin é executado no contexto do usuário com sessão iniciada e relata a cada 15 minutos enquanto alguém está com sessão iniciada. Cada relatório atualiza o *última vez visto* desse usuário nesse dispositivo e do próprio dispositivo. Um dispositivo sem usuário com sessão iniciada, por exemplo um dispositivo quiosque, um dispositivo compartilhado sem conta com sessão iniciada ou um dispositivo que é ligado apenas para atualizações, não produz um novo carimbo de data/hora e pode aparecer como `AgentStale` embora o agente esteja bem. Exclua tais dispositivos com *Excluir dispositivos do grupo*, ou aumente a lacuna permitida.

O *Última deteção* a coluna no RealmJoin Portal não é o mesmo valor: o portal mostra o mais recente entre o contato do agente, a sincronização do Intune e a atividade de entrada do Entra ID. Este relatório usa deliberadamente apenas o contato do agente, porque é isso que indica se o agente funciona.

#### Linha de plausibilidade

O runbook também lê as próprias estatísticas do cliente do RealmJoin e imprime quantos clientes o RealmJoin conta como ativos. O limiar por trás dessa contagem é uma configuração de Tenant do RealmJoin (90 dias por padrão), portanto o número costuma ser maior do que o número de dispositivos em sincronização aqui; uma grande diferença na outra direção significa que a janela de sincronização ou a lacuna permitida está configurada restritamente demais para o Tenant.

### Configuração relativa às credenciais da API do RealmJoin

O runbook consulta a API de cliente do RealmJoin e precisa de uma credencial dedicada armazenada na Automation Account do Azure. A mesma credencial serve para todos os runbooks que usam a API, portanto esta é uma configuração única por Automation Account.

1. **Obter credenciais da API** - Se ainda não tiver credenciais da API do RealmJoin, solicite-as em <support@realmjoin.com>. O nome de usuário tem o formato `t-<id do tenant>`, a senha é o segredo da API. Um login no portal não funciona aqui.
2. **Solicitar o recurso de usuários do dispositivo** - A lista de dispositivos da API de cliente é um recurso que o RealmJoin habilita por Tenant. Peça ao suporte para habilitá-lo junto com as credenciais; sem isso, a API responde com HTTP 403 e o runbook para com essa mensagem.
3. **Abrir a Automation Account** - No Azure Portal, abra a Automation Account usada para runbooks.
4. **Acesse Recursos Compartilhados > Credenciais** - No menu à esquerda, em *Recursos Compartilhados*, clique em *Credenciais*.
5. **Adicionar uma nova credencial** - Clique em *Adicionar uma credencial*.
6. **Dê a ela exatamente o nome `RJAPI`** - O runbook procura esse nome; qualquer outro nome faz falhar a pesquisa da credencial.
7. **Insira o nome de usuário e o segredo da API** - Use os valores da etapa 1.
8. **Salvar** - Clique em *Criar* e execute o runbook novamente.

A API permite 30 solicitações por minuto por Tenant e responde com HTTP 429 além disso. O runbook precisa de duas solicitações por execução e repete uma solicitação limitada após um pequeno atraso, até cinco vezes, antes de desistir.

### Entrega do relatório

Os resultados sempre aparecem como tabelas nomeadas na aba Dados de saída da execução no portal do RealmJoin. Os arquivos do relatório só são gerados quando a **Entrega do relatório** opção inclui um e-mail e/ou um link de download; *Apenas Output Data* não cria arquivos de relatório. A entrega por e-mail e a geração de link de download são independentes e podem ser combinadas.

Para o link de download, os ficheiros do relatório são carregados na conta de armazenamento Azure configurada nas `RJReport.StorageAccount.*` definições do Tenant, e são devolvidos links SAS de download com duração limitada. O carregamento para o armazenamento autentica-se com a identidade gerida da conta de Automation; essa identidade necessita da **Reader and Data Access** função RBAC na Storage Account de destino (esta é uma atribuição de Azure RBAC, não uma permissão de aplicação do Graph).

### Configuração relativa ao envio de e-mails

O envio de um relatório por e-mail é opcional e só acontece quando *Enviar também o relatório por e-mail* ou *Enviar também por e-mail e link de download* é selecionado como entrega do relatório; nesse caso, é necessário um destinatário. O endereço do remetente é obtido da `RJReport.EmailSender` definição do Tenant.

Este runbook envia e-mails usando a API Microsoft Graph. Para enviar e-mails via Graph API, é necessário configurar um endereço de e-mail existente na personalização do runbook.

Consulte a [Documentação das definições de relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para detalhes sobre todas as definições disponíveis.

#### Branding do e-mail

O e-mail do relatório respeita as opções facultativas `RJReport.Branding.*` definições do Tenant:

* **Imagem do cabeçalho e do rodapé** - URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada
* **Link do rodapé** - destino da imagem do rodapé
* **Cor de destaque e de texto** - valores hexadecimais de 6 dígitos, por ex. `#0052cc`

Quando estas definições não estão configuradas, são utilizados os gráficos e cores predefinidos do RealmJoin. Uma imagem que não possa ser transferida ou validada, ou um valor de cor inválido, nunca impede o e-mail do relatório - é usado, em vez disso, o valor predefinido correspondente.

Instruções de configuração e requisitos de imagem: [Branding do e-mail](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Agendamento

Execute o relatório semanalmente. Comece com o padrão de 14 dias para a lacuna permitida e uma janela de sincronização de 30 dias; reduza a lacuna quando a lista estiver limpa, ou aumente-a quando dispositivos com longos períodos de inatividade continuarem aparecendo.

Uma personalização que fixa ambos os valores e entrega o relatório por e-mail:

```json
"rjgit-org_devices_report-realmjoin-agent-contact_scheduled": {
    "parameters": {
        "SyncThresholdDays": {
            "Default": 30
        },
        "AgentContactThresholdDays": {
            "Default": 14
        },
        "EmailTo": {
            "Default": "endpoint-team@contoso.com"
        }
    }
}
```

Consulte a [Guia de Personalização de Runbooks](https://docs.realmjoin.com/automation/runbooks/runbook-customization) para a sintaxe.

### Notas e limitações

* Somente dispositivos Windows são comparados, pois o agente RealmJoin é executado no Windows.
* A API de cliente do RealmJoin não expõe nem a versão do agente nem o horário de sincronização do Intune por dispositivo; a comparação se baseia no contato do agente descrito acima.
* O usuário principal do Intune mostrado nas tabelas é o usuário registrado no Intune, não necessariamente o usuário que o agente viu por último; ambos são listados para as `AgentStale` linhas.

### Localização

Organização → Dispositivos → Relatório de contato do agente RealmJoin (Agendado)

**Nome completo do runbook**

rjgit-org\_devices\_report-realmjoin-agent-contact\_scheduled

### Detalhes

| Propriedade         | Valor                                                                                                              |
| ------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Versão              | 1.1.0                                                                                                              |
| Módulos necessários | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Agendável           | sim                                                                                                                |

### Permissões

#### Permissões da aplicação

* **Tipo**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *Lê os dispositivos Windows no Intune com o respetivo usuário principal e horário da última sincronização para a comparação*
  * GroupMember.Read.All
    * *Lê os membros de dispositivos dos grupos opcionais de inclusão e exclusão que restringem o escopo*
  * Mail.Send *(opcional — funcionalidade: relatório por e-mail)*
    * *Envia o e-mail do relatório através de Send-RjRbReportEmail quando a entrega por e-mail é selecionada*
  * Organization.Read.All *(opcional — funcionalidade: relatório por e-mail)*
    * *Lê o nome de exibição do Tenant para o assunto do e-mail, o corpo do e-mail e os nomes dos arquivos do relatório*

#### Notas sobre permissões

API de cliente do RealmJoin: uma credencial da Automation Account chamada 'RJAPI' com o nome de usuário da API do Tenant (t-) e o segredo, emitidos pelo suporte do RealmJoin; API de cliente do RealmJoin: o recurso de usuários do dispositivo da API precisa estar habilitado para o Tenant pelo suporte do RealmJoin (caso contrário, a lista de dispositivos responde com HTTP 403) Azure Storage Account: função 'Reader and Data Access' para a identidade gerenciada da Automation Account na Storage Account de destino - o upload recupera as chaves da conta por meio de listKeys (necessário apenas para as opções de link de download)

### Parâmetros

#### SyncThresholdDays

Só são comparados os dispositivos que sincronizaram com o Intune dentro desse número de dias. Dispositivos que pararam de sincronizar por completo pertencem ao relatório de dispositivos desatualizados, em vez disso.

| Propriedade                | Valor                                    |
| -------------------------- | ---------------------------------------- |
| Obrigatório                | false                                    |
| Valor predefinido          | 30                                       |
| Tipo                       | Int32                                    |
| Nome de exibição no portal | Última sincronização do Intune em (dias) |

#### AgentContactThresholdDays

Um dispositivo é considerado AgentStale quando o Intune o viu pelo menos esse número de dias depois de o RealmJoin tê-lo visto pela última vez. Lacunas curtas são normais, pois o agente só relata enquanto um usuário está com sessão iniciada.

| Propriedade                | Valor                                                       |
| -------------------------- | ----------------------------------------------------------- |
| Obrigatório                | false                                                       |
| Valor predefinido          | 14                                                          |
| Tipo                       | Int32                                                       |
| Nome de exibição no portal | Lacuna permitida até a última vez visto no RealmJoin (dias) |

#### DeviceNamePrefix

Somente dispositivos cujo nome começa com este texto. Deixe em branco para todos.

| Propriedade                | Valor                          |
| -------------------------- | ------------------------------ |
| Obrigatório                | false                          |
| Valor predefinido          |                                |
| Tipo                       | String                         |
| Nome de exibição no portal | Prefixo do nome do dispositivo |

#### IncludeAgentStale

Lista dispositivos que o Intune viu bem depois de o RealmJoin os ter visto pela última vez, sinal de um agente que não relata mais.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido | Verdadeiro                                      |
| Tipo              | Boolean                                         |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### IncludeNeverSeen

Lista dispositivos que o RealmJoin conhece, mas nos quais nunca viu um usuário com sessão iniciada, por exemplo dispositivos que foram registrados, mas ainda não usados.

| Propriedade                | Valor                                           |
| -------------------------- | ----------------------------------------------- |
| Obrigatório                | false                                           |
| Valor predefinido          | Verdadeiro                                      |
| Tipo                       | Boolean                                         |
| Nome de exibição no portal | Incluir dispositivos que o RealmJoin nunca viu? |

**Opções do portal**

| Opção do portal | Valor |
| --------------- | ----- |
| Sim             | true  |
| Não             | false |

#### IncludeMissingInRealmJoin

Lista dispositivos que existem no Intune, mas não no RealmJoin.

| Propriedade                | Valor                                       |
| -------------------------- | ------------------------------------------- |
| Obrigatório                | false                                       |
| Valor predefinido          | Falso                                       |
| Tipo                       | Boolean                                     |
| Nome de exibição no portal | Incluir dispositivos ausentes no RealmJoin? |

**Opções do portal**

| Opção do portal | Valor |
| --------------- | ----- |
| Sim             | true  |
| Não             | false |

#### IncludeMissingInIntune

Lista dispositivos que existem no RealmJoin, mas não sincronizaram com o Intune dentro da janela de sincronização. Não disponível junto com um prefixo de nome de dispositivo.

| Propriedade                | Valor                                    |
| -------------------------- | ---------------------------------------- |
| Obrigatório                | false                                    |
| Valor predefinido          | Falso                                    |
| Tipo                       | Boolean                                  |
| Nome de exibição no portal | Incluir dispositivos ausentes no Intune? |

**Opções do portal**

| Opção do portal | Valor |
| --------------- | ----- |
| Sim             | true  |
| Não             | false |

#### IncludeDeviceGroup

Apenas dispositivos neste grupo do Entra ID. Deixe em branco para todos os dispositivos.

| Propriedade                | Valor                         |
| -------------------------- | ----------------------------- |
| Obrigatório                | false                         |
| Valor predefinido          |                               |
| Tipo                       | String                        |
| Nome de exibição no portal | Incluir dispositivos do grupo |

#### ExcludeDeviceGroup

Ignora dispositivos neste grupo do Entra ID, por exemplo dispositivos de quiosque ou compartilhados que raramente têm um usuário com sessão iniciada. Deixe em branco para não ignorar nenhum.

| Propriedade                | Valor                         |
| -------------------------- | ----------------------------- |
| Obrigatório                | false                         |
| Valor predefinido          |                               |
| Tipo                       | String                        |
| Nome de exibição no portal | Excluir dispositivos do grupo |

#### EmailFrom

Endereço do remetente do e-mail do relatório. Obtido da definição do Tenant RJReport.EmailSender.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingHeaderImageUrl

Imagem do cabeçalho do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.HeaderImageUrl; o cabeçalho predefinido do RealmJoin é usado quando estiver vazio.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingFooterImageUrl

Imagem do rodapé do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.FooterImageUrl; o rodapé predefinido do RealmJoin é usado quando estiver vazio.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingFooterLink

Link associado à imagem do rodapé do e-mail do relatório. Obtido da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é usado quando estiver vazio.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingAccentColor

Cor de destaque do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.AccentColor; o valor predefinido do RealmJoin é usado quando estiver vazio ou inválido.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingTextColor

Cor do texto do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.TextColor; o valor predefinido do RealmJoin é usado quando estiver vazio ou inválido.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### SendEmailReport

Enviar o relatório para o endereço de e-mail do destinatário.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido | Falso                                           |
| Tipo              | Boolean                                         |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### EmailTo

Enviar o relatório para estes endereços. Separe vários com vírgulas; cada destinatário recebe um e-mail separado.

| Propriedade                | Valor                                           |
| -------------------------- | ----------------------------------------------- |
| Obrigatório                | false                                           |
| Valor predefinido          |                                                 |
| Tipo                       | String                                          |
| Nome de exibição no portal | Endereço(s) de e-mail do destinatário           |
| Oculto no portal           | sim (predefinido via personalização do runbook) |

#### ReportFileFormat

Entregue o relatório em CSV, como um livro do Excel, ou ambos.

| Propriedade                | Valor                                           |
| -------------------------- | ----------------------------------------------- |
| Obrigatório                | false                                           |
| Valor predefinido          | CSV e XLSX                                      |
| Tipo                       | String                                          |
| Nome de exibição no portal | Formato do ficheiro do relatório                |
| Oculto no portal           | sim (predefinido via personalização do runbook) |

**Opções do portal**

| Opção do portal | Valor       |
| --------------- | ----------- |
| CSV e XLSX      | CSV e XLSX  |
| Apenas CSV      | Apenas CSV  |
| Apenas XLSX     | Apenas XLSX |

#### CreateDownloadLink

Carregue também o relatório e devolva um link de download que expira após alguns dias.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido | Falso                                           |
| Tipo              | Boolean                                         |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### ContainerName

Contentor de armazenamento para onde os ficheiros do relatório são carregados. Definido por runbook.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido | report-realmjoin-agent-contact                  |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### ResourceGroupName

Grupo de recursos da Storage Account para carregamentos do relatório. Obtido da definição do Tenant RJReport.StorageAccount.ResourceGroup.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### StorageAccountName

Storage Account para carregamentos do relatório. Obtida da definição do Tenant RJReport.StorageAccount.StorageAccountName.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### SubscriptionId

ID da subscrição da Storage Account para carregamentos do relatório. Obtida da definição do Tenant RJReport.StorageAccount.SubscriptionId; quando estiver vazio, é usada a subscrição na qual a identidade gerida inicia sessão.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### LinkExpiryDays

Número de dias durante os quais um link de download permanece válido. Obtido da definição do Tenant RJReport.StorageAccount.LinkExpiryDays.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido | 6                                               |
| Tipo              | Int32                                           |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

[Voltar à visão geral da referência do runbook](https://docs.realmjoin.com/pt/automatizacao/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/pt/automatizacao/runbooks/runbook-references/org/devices/report-realmjoin-agent-contact_scheduled.md?ask=<question>&goal=<user_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.
