Premiers pas avec l'IA

Quatre étapes pour passer de zéro à un assistant IA fonctionnel qui connaît votre serveur de fond en comble.

Étape 1 : Acheter des crédits IA

Naviguez vers sh0.dev/account/ai et achetez un pack de crédits. Les packs sont disponibles en cinq tailles :

Les trois modèles Claude (Haiku, Sonnet, Opus) sont disponibles sur tous les plans. Les crédits n'expirent jamais -- utilisez-les quand vous en avez besoin.

Étape 2 : Créer une clé API IA

Sur la même page de compte, cliquez sur Generate AI Key. Votre clé commence par sh0_ai_ et n'est affichée qu'une seule fois.

Lors de la création de la clé, sélectionnez une portée :

• Read -- Ne peut qu'interroger les données (lister les apps, voir les logs, vérifier le statut). Option la plus sûre pour la surveillance.
• Standard -- Peut lire et écrire (redémarrer les apps, déployer, définir les variables d'environnement). Recommandé pour l'usage quotidien.
• Admin -- Accès complet incluant les opérations destructives (supprimer des apps, supprimer des bases de données). À utiliser avec précaution.

Étape 3 : Configurer votre tableau de bord

Ouvrez votre tableau de bord sh0 et naviguez vers Settings. Dans la section IA, collez votre clé sh0_ai_.

La clé est stockée localement dans le localStorage de votre navigateur. Elle n'est jamais envoyée aux serveurs de sh0 -- elle n'est utilisée que pour s'authentifier directement auprès de l'endpoint IA de votre instance sh0.

Étape 4 : Commencer à discuter

Ouvrez /ai dans votre tableau de bord. L'IA détecte automatiquement le contexte de votre serveur -- apps en cours d'exécution, métriques de ressources, version de sh0 et configuration. Aucune configuration manuelle requise.

Tapez une question ou une commande en langage naturel. L'assistant déterminera quels outils appeler, les exécutera sur votre serveur et retournera les résultats avec son analyse.

Choisir un modèle

Sélectionnez le modèle dans le menu déroulant de l'interface de chat. Chaque modèle a des forces différentes :

Exemples de conversations

Voici quelques exemples de ce que vous pouvez demander à l'assistant IA :

• "Pourquoi mon dernier déploiement a-t-il échoué ?" -- L'IA récupère les logs de déploiement, identifie l'erreur et suggère un correctif.
• "Liste toutes mes apps et leur statut" -- Appelle list_apps et présente un tableau récapitulatif.
• "Génère un sh0.yaml pour mon projet Node.js" -- Crée une configuration de déploiement basée sur les bonnes pratiques.
• "Vérifie si ma base de données est accessible depuis my-app" -- Utilise le sandbox pour tester la connectivité réseau entre les conteneurs.
• "Mon app utilise trop de mémoire. Aide-moi à déboguer." -- Vérifie les métriques, inspecte les logs et peut analyser le code dans le sandbox.
• "Redémarre my-api et surveille les logs" -- Redémarre l'app et diffuse les logs de démarrage pour vérifier qu'elle revient en bonne santé.
• "Qu'est-ce qui a changé dans le dernier déploiement de frontend ?" -- Passe en revue l'historique des déploiements et les logs de build pour résumer les changements.

BYOK (Bring Your Own Key)

Les utilisateurs du plan Business peuvent contourner entièrement le système de crédits en fournissant leur propre clé API LLM. Cela vous donne une tarification sans marge -- vous payez le fournisseur directement à ses tarifs publiés.

Formats de clés supportés :

• Anthropic -- Clés commençant par sk-ant-. Accès direct aux modèles Claude.
• OpenRouter -- Clés commençant par sk-or-. Accès à Claude et d'autres modèles via l'API unifiée d'OpenRouter.

Pour configurer BYOK, allez dans Settings de votre tableau de bord et entrez votre clé de fournisseur dans la section IA. La clé est stockée localement dans votre navigateur, tout comme la clé IA sh0.