Docs/ Assistant IA/ Premiers pas

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 :

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

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 du compte, dans Clés API IA, donnez un nom à la clé et cliquez sur Créer une clé. Votre clé commence par sh0_ai_ et n'est affichée qu'une seule fois.

Warning
Copiez votre clé API immédiatement après la génération. Elle ne peut pas être récupérée plus tard. Si vous la perdez, révoquez-la et générez-en une nouvelle.

Cette clé paie l'assistant ; elle ne porte aucun niveau de droits. Ce que l'assistant peut faire sur votre serveur, c'est ce que vous pouvez faire : ses outils s'exécutent dans votre session du tableau de bord, avec votre rôle. Un viewer obtient un assistant en lecture seule. Pour donner à un client MCP externe un accès limité, utilisez plutôt une clé d'API à portée restreinte de votre serveur (voir Serveur MCP).

É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 conservée dans le localStorage de votre navigateur. Le tableau de bord l'envoie, avec chaque message, à la passerelle IA de sh0 (https://sh0.dev/api/ai), qui vérifie vos crédits et transmet la conversation au modèle.

Note
Où vont vos conversations : chaque message et son contexte transitent par la passerelle IA de sh0 avant d'atteindre le modèle ; la passerelle conserve le texte de chaque réponse jusqu'à 24 heures, pour qu'une réponse survive à une connexion perdue. Votre historique est enregistré sur votre serveur sh0 (et dans votre navigateur), où vous pouvez l'archiver ou le supprimer.

É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 :

ModèleVitesseCoût/conversationRecommandé pour
Haiku~1-2s~0,002 $Vérifications rapides de statut, lister les apps, questions simples
Sonnet~3-5s~0,005 $Débogage de déploiements échoués, opérations multi-étapes, usage quotidien
Opus~8-15s~0,009 $Analyse de cause racine complexe, revue d'architecture, analyse de code dans le sandbox
Tip
Commencez avec Sonnet pour la plupart des tâches. Passez à Haiku pour les requêtes rapides où la vitesse compte plus que la profondeur, et à Opus quand vous avez besoin d'une analyse approfondie de problèmes complexes.

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 (apportez votre propre clé)

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 le BYOK, ouvrez la page de votre compte sh0.dev, section Bring Your Own Key (BYOK), collez la clé de votre fournisseur et cliquez sur Enregistrer.

Note
La clé de votre fournisseur est stockée sur votre compte sh0.dev, chiffrée (AES-256-GCM). La passerelle IA de sh0 la déchiffre pour appeler le fournisseur en votre nom : les requêtes passent toujours par la passerelle, qui ajoute le contexte de votre serveur et la définition des outils. Retirez la clé depuis la même page pour cesser de l'utiliser.