Primeiros Passos com IA
Quatro passos para ir do zero a um assistente IA funcional que conhece seu servidor por dentro e por fora.
Passo 1: Comprar Créditos de IA
Navegue até sh0.dev/account/ai e compre um pacote de créditos. Pacotes estão disponíveis em cinco tamanhos:
| Pacote | Conversas Aprox. (Sonnet) |
|---|---|
| $5 | ~1,000 |
| $10 | ~2,000 |
| $25 | ~5,000 |
| $50 | ~10,000 |
| $100 | ~20,000 |
Todos os três modelos Claude (Haiku, Sonnet, Opus) estão disponíveis em todos os planos. Créditos nunca expiram — use-os quando precisar.
Passo 2: Criar uma Chave API de IA
Na mesma página de conta, clique em Generate AI Key. Sua chave começa com sh0_ai_ e é exibida apenas uma vez.
Ao criar a chave, selecione um escopo:
- Read — Pode apenas consultar dados (listar apps, ver logs, verificar status). Opção mais segura para monitoramento.
- Standard — Pode ler e escrever (reiniciar apps, fazer deploy, definir variáveis de ambiente). Recomendado para uso diário.
- Admin — Acesso total incluindo operações destrutivas (excluir apps, excluir bancos de dados). Use com cautela.
Passo 3: Configurar Seu Dashboard
Abra seu dashboard sh0 e navegue até Settings. Na seção IA, cole sua chave sh0_ai_.
A chave é armazenada localmente no localStorage do seu navegador. Ela nunca é enviada aos servidores do sh0 — é usada apenas para autenticar diretamente com o endpoint de IA da sua instância sh0.
Passo 4: Começar a Conversar
Abra /ai no seu dashboard. A IA detecta automaticamente o contexto do seu servidor — apps rodando, métricas de recursos, versão do sh0 e configuração. Sem configuração manual necessária.
Digite uma pergunta ou comando em linguagem natural. O assistente determinará quais ferramentas chamar, executará contra seu servidor e retornará os resultados com sua análise.
Escolhendo um Modelo
Selecione o modelo no dropdown da interface de chat. Cada modelo tem diferentes pontos fortes:
| Modelo | Velocidade | Custo/Conversa | Recomendado Para |
|---|---|---|---|
| Haiku | ~1-2s | ~$0,002 | Verificações rápidas de status, listar apps, perguntas simples |
| Sonnet | ~3-5s | ~$0,005 | Depurar deploys falhos, operações multi-etapa, uso diário |
| Opus | ~8-15s | ~$0,009 | Análise complexa de causa raiz, revisão de arquitetura, análise de código no sandbox |
Exemplos de Conversas
Aqui estão algumas coisas que você pode perguntar ao assistente IA:
- "Por que meu último deploy falhou?" — A IA busca logs de deploy, identifica o erro e sugere uma correção.
- "Liste todos os meus apps e seus status" — Chama
list_appse apresenta uma tabela resumida. - "Gere um sh0.yaml para meu projeto Node.js" — Cria uma configuração de deploy baseada em boas práticas.
- "Verifique se meu banco de dados está acessível pelo my-app" — Usa o sandbox para testar conectividade de rede entre containers.
- "Meu app está usando muita memória. Me ajude a depurar." — Verifica métricas, inspeciona logs e pode analisar código no sandbox.
- "Reinicie my-api e acompanhe os logs" — Reinicia o app e transmite os logs de inicialização para verificar se volta saudável.
- "O que mudou no último deploy do frontend?" — Revisa histórico de deploy e logs de build para resumir mudanças.
BYOK (Traga Sua Própria Chave)
Usuários do plano Business podem contornar completamente o sistema de créditos fornecendo sua própria chave API de LLM. Isso dá preço sem markup — você paga diretamente ao provedor nas taxas publicadas.
Formatos de chave suportados:
- Anthropic — Chaves começando com
sk-ant-. Acesso direto aos modelos Claude. - OpenRouter — Chaves começando com
sk-or-. Acesso a Claude e outros modelos via API unificada do OpenRouter.
Para configurar BYOK, vá a Settings no seu dashboard e insira sua chave do provedor na seção IA. A chave é armazenada localmente no seu navegador, assim como a chave IA sh0.