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.
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.
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.