Visão Geral do Assistente IA

Um assistente IA integrado que pode inspecionar, gerenciar e depurar seu servidor — diretamente do dashboard, Claude Desktop ou qualquer cliente compatível com MCP.

O que é o Assistente IA

sh0 vem com um assistente IA integrado alimentado por Claude (Anthropic). Ele tem acesso direto ao seu servidor via 103 ferramentas — pode listar apps, depurar deploys, reiniciar containers, analisar código em um ambiente sandbox e mais.

Diferente de chatbots IA genéricos, o assistente sh0 entende o contexto do seu servidor. Ele sabe quais apps estão rodando, seu estado de saúde, logs de deploy recentes, uso de recursos e configuração. Cada resposta é fundamentada em dados reais da sua infraestrutura.

Três Formas de Usar

O assistente IA é acessível por três interfaces, todas compartilhando o mesmo backend de 103 ferramentas:

1. Chat no Dashboard — A página /ai no seu dashboard sh0. Integrado, sem configuração necessária além de uma chave API. Histórico completo de conversas armazenado localmente no seu navegador.
2. Claude Desktop / Claude Code — Conecte via MCP (Model Context Protocol). Seu servidor sh0 se torna um provedor de ferramentas que o Claude pode chamar diretamente do app desktop ou CLI.
3. Qualquer Cliente MCP — Cursor, Windsurf, agentes personalizados ou qualquer ferramenta que fale MCP. Aponte para o endpoint MCP do seu servidor sh0 e ele ganha todas as 103 ferramentas automaticamente.

103 Ferramentas em 5 Categorias

Cada ferramenta é classificada por nível de risco. Ferramentas somente leitura executam imediatamente. Ferramentas de escrita requerem permissões standard. Ferramentas destrutivas requerem escopo admin e um token de confirmação.

Leitura (37 ferramentas)

Observe sua infraestrutura sem fazer alterações. Disponível com qualquer escopo de chave API.

• list_apps — Listar todas as aplicações implantadas com status
• get_app — Obter informações detalhadas sobre um app específico
• server_status — CPU, memória, disco, uptime e versão do sh0
• get_app_logs — Buscar logs de build ou runtime
• get_app_env — Ler variáveis de ambiente (valores ocultados)
• list_databases — Listar bancos de dados provisionados
• get_database — Detalhes do banco de dados, tamanho e info de conexão
• list_domains — Todos os domínios configurados e status SSL
• get_deploy_history — Deploys recentes com status e duração
• list_backups — Backups disponíveis e seus timestamps
• get_metrics — Gráficos e tendências de uso de recursos
• list_cron_jobs — Tarefas agendadas e seu histórico de execução

Escrita (44 ferramentas)

Fazer alterações na sua infraestrutura. Requer chave API com escopo standard ou admin.

• restart_app — Reiniciar uma aplicação em execução
• deploy_app — Acionar um novo deploy
• set_env_var — Criar ou atualizar uma variável de ambiente
• scale_app — Alterar a contagem de réplicas
• rollback_app — Reverter para um deploy anterior
• sandbox_exec_command — Executar um comando no AI sandbox

Destrutivas (2 ferramentas)

Operações irreversíveis. Requer escopo admin e um token de confirmação de confirm_action.

• delete_app — Excluir permanentemente uma aplicação e seus dados
• delete_database — Excluir permanentemente um banco de dados e todos os seus dados

Sandbox (5 ferramentas)

Ambiente de desenvolvimento completo em um container sidecar. Requer sandbox_enabled no app. Veja AI Sandbox para detalhes.

• sandbox_exec_command — Executar qualquer comando shell (instalar pacotes, clonar repos, rodar apps)
• sandbox_read_file — Ler arquivos dos volumes do app
• sandbox_list_processes — Listar processos em execução no container do app
• sandbox_check_connectivity — Testar conectividade de rede com bancos de dados e serviços
• sandbox_status — Verificar estado do sandbox

Meta (1 ferramenta)

• confirm_action — Gera um token de confirmação de uso único para operações destrutivas. A IA deve explicar o que pretende fazer e receber aprovação do usuário antes de prosseguir.

Três Modelos Claude

Escolha o modelo que se adapta à sua tarefa. Todos os três estão disponíveis em todos os planos.

Arquitetura de Segurança

O assistente IA é projetado com múltiplas camadas de proteção para prevenir alterações acidentais ou não autorizadas:

• Chaves API com escopo — Cada chave recebe um escopo: read, standard ou admin. A IA só pode chamar ferramentas dentro do escopo da chave.
• Classificação de risco — Cada ferramenta é marcada com um nível de risco. Ferramentas de leitura são seguras. Ferramentas de escrita requerem escopo standard. Ferramentas destrutivas requerem escopo admin mais um token de confirmação.
• Tokens de confirmação — Antes de executar uma operação destrutiva (excluir app, excluir banco de dados), a IA deve chamar confirm_action, que apresenta uma descrição clara ao usuário e requer aprovação explícita.
• Log de auditoria — Cada chamada de ferramenta é registrada com timestamp, nome da ferramenta, parâmetros, chave API usada e resultado. Admins podem revisar toda a atividade da IA pelo dashboard.

Créditos

O uso de IA é cobrado através de um sistema de créditos pré-pagos:

• Pacotes de créditos — Disponíveis em incrementos de $5, $10, $25, $50 e $100.
• Sem expiração — Créditos nunca expiram. Use-os no seu ritmo.
• Cobrança por conversa — Cada conversa deduz créditos com base no modelo usado e tokens consumidos.
• BYOK (Traga Sua Própria Chave) — Usuários do plano Business podem fornecer sua própria chave API Anthropic ou OpenRouter para preço sem markup.