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 da conta, em Chaves de API de IA, dê um nome à chave e clique em Criar chave. A sua chave começa com sh0_ai_ e é exibida uma única vez.
Esta chave paga o assistente; ela não tem nível de permissão. O que o assistente pode fazer no seu servidor é o que você pode fazer: as ferramentas rodam na sua sessão do painel, com o seu papel. Um viewer recebe um assistente somente leitura. Para dar a um cliente MCP externo um acesso limitado, use uma chave de API do seu servidor com escopo restrito (veja Servidor MCP).
Passo 3: Configurar Seu Dashboard
Abra seu dashboard sh0 e navegue até Settings. Na seção IA, cole sua chave sh0_ai_.
A chave fica guardada no localStorage do navegador. O painel a envia, com cada mensagem, ao gateway de IA do sh0 (https://sh0.dev/api/ai), que verifica os seus créditos e repassa a conversa ao modelo.
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 o BYOK, abra a página da sua conta sh0.dev, seção Traga Sua Própria Chave (BYOK), cole a chave do seu provedor e clique em Salvar.