Platform For AI:Gerenciar instâncias do Instant Service

Criação pelo console

O PAI-Instant Service oferece três pontos de entrada no console para criar instâncias:

1. Ponto de entrada 1: Na bancada do Instant Service, clique em Create Instance.

2. Ponto de entrada 2: Na lista Private Templates/Public Templates, selecione a ação Create Instance do modelo desejado.

3. Ponto de entrada 3: Na página de detalhes do modelo, clique em Create Instance na lista de instâncias.

Na caixa de diálogo Create Instance, configure os seguintes parâmetros:

Clique em Create Instance para criar a instância.

Criação com o SDK

O PAI-Instant Service é nativamente compatível com o E2B SDK. O uso é idêntico ao do E2B:

import os
from e2b import Sandbox

# Set authentication credentials
os.environ["E2B_API_KEY"] = "<YOUR-TOKEN>"
os.environ["E2B_DOMAIN"] = "sandbox01.cn-shanghai.pai-eas.aliyuncs.com"

# Create an instance
sandbox = Sandbox.create(
    template="<YOUR-TEMPLATE-ID>",
    timeout=300000,
)

print(f"Sandbox ID: {sandbox.sandbox_id}")          

Na página Template Details, clique em SDK Access no canto superior direito para visualizar a configuração de conexão do SDK e o código de exemplo em Python. Para mais detalhes sobre a API, consulte E2B SDK integration.

Visualizar detalhes da instância

Acesse a bancada do Instant Service, localize a instância desejada na lista de instâncias e clique em Details na coluna Actions para abrir a página de detalhes da instância.

A página de detalhes da instância exibe:

• Especificações de recursos: CPU, memória e disco.

• Informações de status: status (Running/Paused) e tempo de atividade.

• Informações básicas: ID da instância, modelo, horário de criação, horário de expiração, ID do usuário RAM, ID da conta Alibaba Cloud e Access Token.

• Metadados: pares chave-valor como sandbox.alicloud.com/service-name e userId.

Abrir um terminal

Clique em Open Terminal para abrir uma janela do Web Terminal. O terminal exibe o ID da instância, o ID do modelo e o tempo limite da sessão (tempo limite de ociosidade de 10 minutos e máximo de 30 minutos por padrão).

Execute qualquer comando de shell diretamente no terminal. Isso equivale a chamar sandbox.commands.run() via SDK e é útil para depurar e verificar seu ambiente.

Abrir o VNC

Para modelos do tipo Desktop, clique em Open VNC para iniciar uma sessão de área de trabalho remota.

O VNC é útil para:

• Depurar aplicações que exigem interface gráfica.

• Verificar visualmente a automação de navegadores (como Playwright e Selenium).

• Realizar testes de GUI e capturar screenshots.

Gerenciar arquivos

A página de detalhes da instância oferece um painel File Management com visualização em árvore de diretórios:

• Navegue pela estrutura de diretórios dentro da instância, como bin, boot, code, dev, etc e home.

• Crie pastas, faça upload de arquivos, atualize a visualização, navegue um nível acima e retorne ao diretório raiz.

• Visualize tamanhos de arquivos e horários de modificação.

O gerenciamento de arquivos equivale a chamar sandbox.files.read() / sandbox.files.write() via SDK, permitindo acessar rapidamente os resultados da execução sem sair do console.

Invocar services

O painel Service Invocation fornece uma interface de interação HTTP para chamar services em execução dentro da instância.

Opções de configuração:

• Método de requisição: GET, POST, PUT, DELETE, entre outros.

• Porta: porta de escuta do service dentro da instância.

• Caminho: caminho da URL para a requisição, como /health.

• Cabeçalhos da requisição: cabeçalhos HTTP personalizados, como Content-Type: application/json.

• URL de pré-visualização: URL completa da requisição montada pelo sistema, que pode ser copiada e usada diretamente.

Clique em Send Request. O painel HTTP Interaction History à direita exibe o conteúdo da requisição e da resposta para depuração em tempo real.

Visualizar logs de requisição

Mude para a aba Request Logs para visualizar todas as requisições HTTP encaminhadas à instância pelo plano de dados. Utilize esses logs para auditoria e solução de problemas.

Pausar e retomar

Pause e retome instâncias para preservar seu estado visando recuperação posterior ou para salvá-las como modelos.

• Pausar: Clique em Pause na lista de instâncias ou chame sandbox.pause(). O estado da instância é persistido no armazenamento da instância.

• Retomar: Clique em Resume na lista de instâncias ou chame Sandbox.connect("<sandbox-id>"). A instância recupera rapidamente o estado de execução.

Salvar como modelo

Salve o estado atual de uma instância, incluindo arquivos, dependências instaladas e processos em execução, como um novo modelo para reutilização do ambiente.

Cenários típicos:

• Após concluir alterações de código e configurações de ambiente durante o desenvolvimento, salve a instância como modelo para evitar a reconstrução da imagem a cada mudança.

• Capture um ambiente de execução de agente totalmente configurado como um modelo padrão para reutilização pela equipe.

Pré-requisitos: O Instant Service deve ter uma Enterprise Edition Image Instance configurada (Standard ou Enterprise Edition).

Procedimento:

1. Pause a instância que deseja salvar como modelo.

2. Clique em Save as Template.

3. Insira um nome e uma descrição para o novo modelo.

4. Clique em OK. O sistema cria um novo modelo com base no estado atual da instância.

Estender o tempo limite da instância

É possível estender o tempo limite de duas maneiras: