Docs/ Asistente de IA/ Primeros pasos

Primeros pasos con IA

Cuatro pasos para ir de cero a un asistente de IA funcional que conoce tu servidor por dentro y por fuera.

Paso 1: Comprar créditos de IA

Navega a sh0.dev/account/ai y compra un paquete de créditos. Los paquetes están disponibles en cinco tamaños:

PaqueteConversaciones aprox. (Sonnet)
$5~1,000
$10~2,000
$25~5,000
$50~10,000
$100~20,000

Los tres modelos de Claude (Haiku, Sonnet, Opus) están disponibles en todos los planes. Los créditos nunca expiran -- úsalos cuando los necesites.

Paso 2: Crear una clave API de IA

En la misma página de la cuenta, en Claves API de IA, pon un nombre a la clave y haz clic en Crear clave. Tu clave empieza por sh0_ai_ y solo se muestra una vez.

Warning
Copia tu clave API inmediatamente después de generarla. No se puede recuperar después. Si la pierdes, revócala y genera una nueva.

Esta clave paga el asistente; no tiene ningún nivel de permisos. Lo que el asistente puede hacer en tu servidor es lo que puedes hacer tú: sus herramientas se ejecutan en tu sesión del panel, con tu rol. Un viewer obtiene un asistente de solo lectura. Para dar a un cliente MCP externo un acceso limitado, usa en su lugar una clave de API de tu servidor con alcance restringido (ver Servidor MCP).

Paso 3: Configurar tu panel de control

Abre tu panel de control sh0 y navega a Settings. En la sección de IA, pega tu clave sh0_ai_.

La clave se guarda en el localStorage de tu navegador. El panel la envía, con cada mensaje, a la pasarela de IA de sh0 (https://sh0.dev/api/ai), que comprueba tus créditos y reenvía la conversación al modelo.

Note
Adónde van tus conversaciones: cada mensaje y su contexto pasan por la pasarela de IA de sh0 antes de llegar al modelo; la pasarela conserva el texto de cada respuesta hasta 24 horas para que una respuesta sobreviva a una conexión perdida. Tu historial se guarda en tu servidor sh0 (y en tu navegador), donde puedes archivarlo o eliminarlo.

Paso 4: Empezar a chatear

Abre /ai en tu panel de control. La IA detecta automáticamente el contexto de tu servidor -- apps en ejecución, métricas de recursos, versión de sh0 y configuración. Sin configuración manual requerida.

Escribe una pregunta o comando en lenguaje natural. El asistente determinará qué herramientas llamar, las ejecutará contra tu servidor y devolverá los resultados con su análisis.

Elegir un modelo

Selecciona el modelo desde el menú desplegable en la interfaz de chat. Cada modelo tiene diferentes fortalezas:

ModeloVelocidadCosto/ConversaciónRecomendado para
Haiku~1-2s~$0.002Verificaciones rápidas de estado, listar apps, preguntas simples
Sonnet~3-5s~$0.005Depurar despliegues fallidos, operaciones de múltiples pasos, uso diario
Opus~8-15s~$0.009Análisis complejo de causa raíz, revisión de arquitectura, análisis de código en sandbox
Tip
Comienza con Sonnet para la mayoría de tareas. Cambia a Haiku para consultas rápidas donde la velocidad importa más que la profundidad, y a Opus cuando necesites un análisis exhaustivo de problemas complejos.

Conversaciones de ejemplo

Estas son algunas cosas que puedes preguntarle al asistente de IA:

  • "¿Por qué falló mi último despliegue?" -- La IA obtiene los logs de despliegue, identifica el error y sugiere una corrección.
  • "Lista todas mis apps y su estado" -- Llama a list_apps y presenta una tabla resumen.
  • "Genera un sh0.yaml para mi proyecto Node.js" -- Crea una configuración de despliegue basada en mejores prácticas.
  • "Verifica si mi base de datos es accesible desde my-app" -- Usa el sandbox para probar conectividad de red entre contenedores.
  • "Mi app está usando demasiada memoria. Ayúdame a depurarla." -- Verifica métricas, inspecciona logs y puede analizar código en el sandbox.
  • "Reinicia my-api y observa los logs" -- Reinicia la app y transmite los logs de inicio para verificar que se recupere correctamente.
  • "¿Qué cambió en el último despliegue de frontend?" -- Revisa el historial de despliegues y logs de build para resumir los cambios.

BYOK (Trae tu propia clave)

Los usuarios del plan Business pueden omitir el sistema de créditos completamente proporcionando su propia clave API de LLM. Esto te da precios sin recargo -- pagas al proveedor directamente a sus tarifas publicadas.

Formatos de clave soportados:

  • Anthropic -- Claves que comienzan con sk-ant-. Acceso directo a modelos Claude.
  • OpenRouter -- Claves que comienzan con sk-or-. Acceso a Claude y otros modelos vía la API unificada de OpenRouter.

Para configurar BYOK, abre la página de tu cuenta de sh0.dev, sección Trae tu propia clave (BYOK), pega la clave de tu proveedor y haz clic en Guardar.

Note
La clave de tu proveedor se guarda en tu cuenta de sh0.dev, cifrada (AES-256-GCM). La pasarela de IA de sh0 la descifra para llamar al proveedor en tu nombre: las peticiones siguen pasando por la pasarela, que añade el contexto de tu servidor y las definiciones de herramientas. Elimina la clave desde la misma página para dejar de usarla.