Saltar para o conteúdo
Rascunho

VPS Full Stack

Um VPS que é aprovisionado com a sua própria chave de API limitada, pronto para o seu código, a CLI e os agentes de IA.

Um VPS Full Stack é um servidor padrão alojado pela Xuda, pré-carregado com a xuda-cli, o codex e a sua própria chave de API limitada, emitida automaticamente, para que a própria máquina, o seu código a correr nela, a CLI ou um agente de IA possam chamar o ecossistema Xuda assim que arranca. O aprovisionamento corre a partir do painel: deploy_full_stack_vps é um método apenas de sessão. O que essa chamada de aprovisionamento lhe entrega é a parte interessante desta página.

O que o aprovisionamento emite

É criada uma chave limitada

A chave de API da própria máquina é criada antes do aprovisionamento, limitada pelos grupos de capacidades full_stack_tools escolhidos na criação, acesso a ficheiros, acesso SSH, regras de firewall, ligação de domínios e mais; cada grupo expande-se num conjunto dos mesmos métodos de plataforma documentados nesta secção da API.

A chave e o endpoint são gravados na aplicação

full_stack_vps.api_key_id, full_stack_vps.tools e full_stack_vps.mcp_url ficam no documento da aplicação, para que as ferramentas da própria máquina os leiam no arranque sem que uma pessoa copie uma chave manualmente.

A máquina liga-se sozinha

O Cloud-init escreve a chave em /root/xuda.config.js e /etc/profile.d/xuda.sh, pelo que uma shell na máquina, a CLI ou o codex já têm XUDA_API_KEY e XUDA_AGENT_KEY no seu ambiente.

As capacidades são definidas na criação

Os grupos de ferramentas que a chave de uma máquina transporta são definidos quando a máquina é aprovisionada, por isso escolha nesse momento os grupos de que ela precisa.

O que a chave da máquina pode chamar

Os métodos a que a chave de um VPS Full Stack chega são a mesma superfície de ficheiros, SSH e firewall documentada em VPS externo: vps_fs_list, vps_fs_read, vps_fs_write e o resto da família vps_fs_*, vps_enable_ssh / vps_rotate_ssh_token / vps_disable_ssh, agent_firewall_list / _open / _close, agent_domain_list / agent_domain_connect, mais get_platform_regions, get_account_vps, get_deploy_info e get_app_server_usage para ler o estado da própria máquina.

curl -s https://xuda.ai/cpi/vps_fs_list \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_BOX_API_KEY","path":"/var/www"}'
const res = await fetch('https://xuda.ai/cpi/vps_fs_list', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_BOX_API_KEY', path: '/var/www' }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/vps_fs_list',
    json={'api_key': 'YOUR_BOX_API_KEY', 'path': '/var/www'},
)

Através de MCP

full_stack_vps.mcp_url aponta para o mesmo endpoint MCP que todas as chaves utilizam. Uma máquina cuja chave tenha o âmbito full_stack_vps também tem expostas as ferramentas de plugins instalados da própria aplicação da máquina, a par dos métodos do ecossistema, pelo que um agente ligado à máquina alcança ambos numa única sessão.

Métodos

A mesma tabela completa do app_module para que apontam VPS externo e Plataforma de desenvolvimento. A chave de uma máquina só alcança as linhas de ficheiros, SSH, firewall e domínios indicadas acima, não todas as linhas que esta tabela lista.