Todos os produtos
Search
Central de documentação

AgentBay:Gerenciar imagens

Última atualização: Jun 29, 2026

Gerencie todo o ciclo de vida das suas imagens. Ao criar e ativar uma imagem personalizada, você ativa um pool de recursos independente. Em seguida, configure políticas de imagem para controlar o serviço de streaming de exibição e garantir que os computadores em nuvem atendam às necessidades do seu negócio.

Pré-requisitos

O gerenciamento de imagens personalizadas é um recurso pago. Adquira um pacote de benefícios antes de usar esse recurso. Para mais informações, consulte Faturamento.

Criar uma imagem

  1. Faça login no console do AgentBay.

  2. No painel de navegação à esquerda, clique em Image Management.

  3. Na página Images, clique na aba Custom Image e em Create Image.

  4. No painel Create Image, insira um nome para a imagem, selecione uma imagem na aba System Image ou Custom Image e clique em Confirm and Start.

  5. Na página do criador online, crie a imagem personalizada.

    1. Na etapa Prepare Setup Environment, aguarde a preparação do ambiente. Quando o ambiente estiver pronto, uma caixa de diálogo de orientação será exibida. Nela, clique em Create.

    2. Na etapa Create and Configure Image, instale aplicativos, adicione arquivos ou modifique o registro conforme necessário. Depois, clique em Next.

    3. Na caixa de diálogo MCP Configuration, ative ou desative serviços conforme necessário e clique em Next.

      Você também pode registrar um serviço MCP personalizado. Clique em Register Custom MCP, configure os parâmetros necessários e clique em OK.

      Nota

      Ao registrar um serviço MCP personalizado, carregue o aplicativo MCP na imagem usando o recurso de upload de arquivos ou uma unidade de nuvem.

      Parâmetro

      Descrição

      Name

      Insira o nome do serviço MCP.

      Description

      Insira a descrição do serviço MCP.

      Icon

      Clique em Click to Upload para carregar um ícone.

      Connection

      STDIO

      MCP Configuration

      Altere o valor de command no bloco de código abaixo para o caminho absoluto do seu aplicativo MCP na imagem. Depois, copie e cole o bloco de código na caixa de entrada MCP Configuration.

      {
            "mcpServers": {
              "FileSystem": {
                "name": "FileSystem",
                "icon": "",
                "version": "1.0.0",
                "description": "",
                "detail": "https://www.alibabacloud.com/help/en/wuying-workspace/filesystem",
                "disabled": false,
                "timeout": 60,
                "command": "C:\Program Files (x86)\FileSystem.exe",
                "args": [],
                "transportType": "stdio"
              }
            }
          }
      Nota

      Um serviço MCP personalizado é ativado por padrão após a criação.

    4. Na caixa de diálogo Test, clique em Test Now.

      Nota

      A preparação do ambiente para a etapa Test and Verify geralmente leva de 1 a 5 minutos.

    5. Quando o ambiente de teste estiver pronto, clique em Start Test.

    6. No ambiente de Test, siga as instruções na tela para testar e verificar o serviço MCP.

    7. Após concluir o teste e a verificação, clique em Test Passed. Na caixa de diálogo de confirmação, clique em Confirm.

    8. Na página Test Passed, clique em Publish Image. Na caixa de diálogo de confirmação, clique em Confirm.

    9. Na caixa de diálogo exibida, clique em Go Now para retornar ao console do AgentBay e visualizar o progresso e o resultado da publicação da imagem.

Ativar uma imagem

Ao ativar uma imagem, você gera um pool de recursos independente a partir da imagem personalizada. Esse pool de recursos é revogado se permanecer desconectado por mais de 30 dias.

Pré-requisitos

Você já criou e publicou uma imagem personalizada.

Procedimento

  1. Na página Images, localize a imagem criada e clique em Enable na coluna Actions.

  2. Na caixa de diálogo exibida, clique em Enable.

    Importante

    É possível ativar no máximo duas imagens personalizadas simultaneamente.

Configurar uma política de imagem

Após ativar uma imagem, configure uma política de imagem para controlar o comportamento do pool de recursos independente gerado a partir dela.

  1. Na página Images, clique em Image Policy na coluna Actions da imagem ativada.

  2. Na caixa de diálogo Image Policy, configure os parâmetros conforme necessário e clique em OK.

    Linux

    Parâmetro

    Descrição

    System Taskbar, Application Launchers, and Desktop Setting

    Opções:

    • Default Reference Image

    • Customize by Administrator

    Hide System Taskbar, Application Launchers, and Desktop

    Este item de configuração aparece quando você define System Taskbar, Application Launchers, and Desktop Setting como Customize by Administrator.

    Se você ativar este recurso, o cliente ocultará a barra de tarefas, os inicializadores de aplicativos e a área de trabalho do usuário.

    Maximize, Minimize, and Close Button Setting

    Opções:

    • Default Reference Image

    • Customize by Administrator

    Hide the Maximize, Minimize, and Close buttons

    Este item de configuração aparece se você definir Maximize, Minimize, and Close Button Setting como Customize by Administrator.

    Se você ativar este recurso, o cliente ocultará os botões Maximizar, Minimizar e Fechar do usuário.

    Full Screen Setting

    Opções:

    • Default Reference Image

    • Customize by Administrator

    Default to Full Screen

    Este item de configuração aparece apenas se você definir Full Screen Setting como Customize by Administrator.

    Se você ativar este recurso, os aplicativos serão abertos em tela cheia por padrão.

    Windows

    Item de Configuração

    Descrição

    Hide system taskbar, application entry, and desktop

    Se você ativar este recurso, o cliente ocultará a entrada da barra de tarefas, a entrada de aplicativos e a área de trabalho do usuário.

Parar uma imagem

Caso não precise mais do pool de recursos independente gerado a partir de uma imagem, pare a imagem.

  1. Na página Images, localize a imagem ativada e, na coluna Actions, clique em Stop.

  2. Na caixa de diálogo exibida, clique em Stop.

    Importante

    Após parar uma imagem, o pool de recursos independente gerado a partir dela torna-se indisponível. No entanto, a imagem em si é mantida.

Excluir uma imagem

Se você não precisar mais de uma imagem ou se a criação da imagem falhar, exclua-a.

Pré-requisitos

A imagem criada não está ativada ou foi parada.

Procedimento

  1. Na página Images, localize a imagem que deseja excluir e clique em Delete na coluna Actions.

  2. Na caixa de diálogo, clique em Delete.