---
title: Estágios do usuário
slug: help/neurons/pt_br/estagios-do-usuario
createdAt: 2026-09-08T07:53:19.604Z
---

Crie estágios de usuário para personalizar e salvar estágios a serem usados na criação de bots. Uma vez criados, os estágios ficam disponíveis para reutilização no [Editor de bots](docId\:cNkswIDqBFPU3MgjuPLJ-), em **Estágios** > **Usuário**.

## Para criar um estágio de usuário

1. Vá para **Menu principal&#x20;**> **Bots**.
   A página inicial **Bots** é exibida.
2. Selecione a guia **Bots Gerais** ou **Bots de Pesquisa**.
3. Selecione **Criar bot** ou **Criar pesquisa**.
   A págin&#x61;**&#x20;Criar bot&#x20;**&#x6F;&#x75;**&#x20;Criar pesquisa** é exibida.
4. Selecione o gatilho do bot: **Agendamento** ou **Ação personalizada**.
5. Selecione o tipo de destino: **Dispositivos** ou **Pessoas**.
6. Insira um **Nome** para o bot. Opcionalmente, insira uma breve descrição.
7. Clique em **Criar**.
   A página do editor de bots aparece.
   O novo bot é salvo como rascunho inativo.
8. Na página **Novo editor de bots**, selecione **Gerenciar estágio do usuário** para exibir a página **Gerenciador de Estágios do Usuário**.
9. Na página **Gerenciador de Estágios do Usuário**, clique no menu suspenso **Criar&#x20;**&#x65; selecione o estágio desejado entre os seguintes:
   - Consulta do PowerShell
   - Ação do PowerShell
   - Ação Bash
   - Ação de Comando
   - OSQuery
10. Na página **Editor de Estágio do Usuário**, insira o **Nome do estágio**. Por exemplo, Compactar arquivo/pasta.
11. Opcionalmente, insira uma descrição. O texto descritivo é exibido no editor de bot, e as Informações do estágio ficam selecionadas no painel **Configurações do Estágio**. Por exemplo, Este estágio compacta os arquivos de origem, do caminho especificado para o caminho de destino, com o nível de compactação especificado.
12. Insira o código do script.
    **Exemplo**:
    `Compress-Archive -path C:\\logs\\file.txt `
    `-destinationpath C:\\logs\\arquivo.zip `
    `-compressionlevel Optimal`

:::Paragraph{indent="1"}
Você pode tornar esse script mais flexível substituindo parte do código por variáveis. Isso permite que você personalize certos elementos ao usar o estágio.
**Exemplo**:
`Compress-Archive -path __Caminho do arquivo ou pasta de origem__`
`-destinationpath __Caminho de destino__`
`-compressionlevel __Nível de compressão|opções: Fastest, Optimal, No ``Compression__`
:::

:::Paragraph{indent="1"}
Selecione Ctrl + Space para inserir uma **variável de opções** ou uma **variável de valor**:
:::

- Uma **variável de opções** é exibida nas configurações como um menu suspenso de seleção; as opções disponíveis serão as que você inserir no script. Neste exemplo: opções de nível de compactação Mais rápido, Ideal, Sem compactação.
- Uma **variável de valor** é exibida nas configurações como uma caixa de texto, com o rótulo que você inserir no script. Neste exemplo: Caminho do arquivo ou pasta de origem, Caminho de destino e Nível de compactação.

:::Paragraph{indent="1"}
Para este exemplo, as **configurações do estágio** ficariam assim:
:::

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/l5SC39S-x2KGTizdnLH64_bots-custom-stage.png" alt="configurações de estágio personalizadas " position="flex-start" size="35" width="346" height="602" initialPath="Images/bots-custom-stage.png" githubPath="PTB/Images/bots-custom-stage.png" showCaption="false" indent="1"}

13. Preencha as **Configurações do Estágio**; os parâmetros disponíveis dependem do tipo de estágio que está sendo criando:

::::ExpandableHeading
## Consulta do PowerShell

**Executar como**:

- Sistema
- Usuário conectado
- Credenciais

**Tipo**:

- PowerShell
- Core
- Automático

**Saída**: adicione uma saída para cada nome de coluna retornado pela consulta do PowerShell que você queira usar em um estágio de filtragem de resultados a jusante ou como variável em outro estágio.

**Resultado singular**: ativar/desativar. Use resultados únicos/múltiplos para definir se a consulta retornará resultados únicos ou múltiplos por dispositivo. Isso determina se as variáveis estão disponíveis como entradas de token diretamente nos estágios downstream (único) ou se estão disponíveis apenas para estágios em um bloco de resultados [for-each](docId\:YcuDNBjFKSeMYTYdwBTv2) (múltiplos) para fazer um loop desses estágios para cada resultado.

**Exemplo de consulta do PowerShell:**

Use o PowerShell para consultar seu ambiente quando os comportamentos personalizados desejados não forem possíveis com os estágios de bot padrão.

Para executar a consulta com êxito, certifique-se de que:

- A saída do script é JSON (você pode usar o commandlet ConvertTo-JSON).
- Você consegue nomear cada campo de dado como uma inserção de saída nas **Configurações do estágio**.

:::hint{type="info"}
Por padrão, o tempo limite do script é de 25 minutos.
:::

**Tipos de PowerShell:**

- Se você definir o tipo do **PowerShell** como **Core**, o script PowerShell será executado no PowerShell Core; o .Net Core 3.1 Desktop Runtime, versão 24.64.28315 ou superior, deverá estar instalado na máquina em que você estiver executando.
- Se definir o tipo de **PowerShell** como **Automático**, a consulta procurará Net Core 3.1 Desktop Runtime, versão 24.64.28315 ou superior. A seguir estão os resultados:
  - Quando o runtime estiver instalado, o script será executado no **PowerShell Core**.
  - Quando o runtime não estiver instalado, o script será executado no **PowerShell**.

**Tipos de saída:**

Ative se quiser que os resultados apareçam individualmente; desative se quiser que apareçam em conjunto.

- Individual – se o tipo de saída for especificado como individual, será retornado um objeto no formato JSON.

```bash
$name = [System.Net.Dns]::GetHostName()
```

```bash
ConvertTo-Json @([customobject]@{Name = $name;})
```

- Vários – se o tipo de saída for especificado como vários, você deverá retornar os dados como uma matriz de objetos no formato JSON.
  Os objetos dentro da matriz contêm os tipos primitivos. No campo **Saída** do **Inspetor de Estágio**, você deve vincular o campo **Exemplo** e inserir o **Nome**.

  ```bash
  [{"Campo de exemplo": "A"}, {"Campo de exemplo": "B"}]
  ```

  ```bash
  $processes = Get-Process | Select-Object Name
  ConvertTo-Json $processes
  ```
::::

:::ExpandableHeading
## Ação do PowerShell

**Executar como**:

- Sistema
- Usuário conectado
- Credenciais

**Tipo**:

- PowerShell
- Core
- Automático

Exemplo de ação do PowerShell:

**Ação do PowerShell** é semelhante a **Consulta do PowerShell**, exceto pelo fato de que não há saídas em **Ação do PowerShell**. Para saber mais, consulte [Exemplo de consulta do PowerShell](docId\:pXvErz0gS-ZS_pDNRRVrs).
:::

:::ExpandableHeading
## Ação Bash

**Executar como**:

- Sistema
- Usuário conectado

Exemplo de Ação Bash:

Para reduzir o tamanho removendo as primeiras 100 entradas, use o seguinte comando:

```bash
sed 1,100d nomedoarquivo
```
:::

:::ExpandableHeading
## Ação de Comando

**Executar como**:

- Sistema
- Usuário conectado

Exemplo de ação de comando:

- Para verificar e reparar arquivos corrompidos:

```bash
sfc /scannow
```

- Para verificar e corrigir o status do disco físico:

```bash
chkdsk /offlinescanandfix
```
:::

:::ExpandableHeading
## OSQuery

**Resultado singular**: ativar/desativar. Use resultados únicos/múltiplos para definir se a consulta retornará resultados únicos ou múltiplos por dispositivo. Isso determina se as variáveis estão disponíveis como entradas de token diretamente nos estágios downstream (único) ou se estão disponíveis apenas para estágios em um bloco de resultados for-each (múltiplos) para fazer um loop desses estágios para cada resultado.

**Adicionar mapeamento de coluna**: adicione um mapeamento de coluna para cada nome de coluna retornado pelo osquery que você deseja usar em um estágio de resultados de filtro downstream ou como uma variável em outro estágio.

Exemplo de OSQuery:

Para descobrir os aplicativos iniciados com mais frequência por dispositivo, execute o script:

```bash
select path,last_execution_time,count,
sid from userassist order by count desc
limit __Number of Apps to return|options:1,5,10__
```
:::

14. Selecione **Aplicar e Fechar** para salvar o estágio do usuário.
    Se você fez edições em um estágio de usuário existente, uma nova versão é criada. Ao salvar, uma caixa de diálogo é exibida para avisar que qualquer bot usando o estágio de usuário precisará ser atualizado para usar a versão mais recente.

## Ações

Você pode executar as seguintes ações para qualquer um dos estágios do usuário:

- **Clonar**: selecione um estágio de usuário, selecione **Ações&#x20;**> **Clonar**. A caixa de diálogo **Clonar Estágio** é exibida. Digite um nome exclusivo e selecione **Clonar**. Uma mensagem pop-up é exibida para informar que a criação do estágio foi bem-sucedida. O estágio clonado aparece na lista para você selecionar e editar.
- **Excluir**: selecione um ou mais estágios do usuário, selecione **Ações&#x20;**> **Excluir**. A caixa de diálogo **Excluir estágios** é exibida. Selecione **Excluir&#x20;**&#x70;ara confirmar a exclusão do estágio. Esta ação não pode ser desfeita e irá descontinuar o estágio de qualquer bot que o utilize.**&#x20;Os estágios descontinuados** são indicados por uma borda vermelha.

### Tópicos relacionados

[Estágios de Bots](docId\:YcuDNBjFKSeMYTYdwBTv2)
