Bac à sable

Vérifiez d’abord sur le site si le modèle et la Key sont utilisables, puis décidez de la méthode d’intégration à adopter

Si vous avez déjà créé une API Key, mais que vous n’êtes pas encore prêt à écrire du code immédiatement, la façon la plus simple de valider votre configuration est d’utiliser d’abord le bac à sable intégré au site.

Son intérêt ne se limite pas à « échanger quelques messages », il permet surtout de confirmer rapidement :

si votre compte peut appeler le modèle normalement
si les modèles disponibles dans votre groupe fonctionnent correctement
quelle est l’expérience de réponse approximative d’un modèle donné
si votre configuration de base est opérationnelle

Périmètre fonctionnel

Le bac à sable actuel ne prend en charge que l’interface chat/completions. Si vous devez tester des fonctionnalités avancées comme Tool-Calling, Agent, etc., veuillez pour le moment les valider via du code ou des outils tiers qui les prennent en charge.

Où se trouve le bac à sable

Depuis la console :

操练场
Accès direct : https://home.moleapi.com/console/playground

L’interface de la page ressemble globalement à ceci :

Interface du bac à sable MoleAPI, avec à gauche les paramètres du modèle et à droite la zone de conversation

Comment comprendre cette page

La page peut globalement être divisée en deux parties :

À gauche : zone de configuration du modèle

Cette zone sert principalement à sélectionner et ajuster :

le groupe
le modèle
l’activation ou non de l’entrée image
des paramètres comme Temperature / Top P / Frequency Penalty
l’activation ou non du streaming

Pour les débutants, le plus important n’est pas de comprendre immédiatement tous les paramètres, mais d’accomplir d’abord deux choses :

choisir un modèle actuellement disponible
envoyer un premier message qui retourne une réponse normale

À droite : zone de conversation

Il s’agit de la zone de conversation proprement dite. Vous pouvez y saisir directement une question, observer le résultat renvoyé et évaluer :

si la réponse est normale
quelle est la vitesse de réponse
si le style de sortie correspond à vos attentes

Utilisation recommandée du bac à sable pour les débutants

Il est conseillé de procéder dans cet ordre :

choisissez d’abord un modèle texte généraliste
ne modifiez pas trop de paramètres au départ
envoyez d’abord une phrase très simple, par exemple « Bonjour »
une fois les réponses stables, essayez progressivement des questions plus complexes

Les avantages de cette approche sont les suivants :

distinguer rapidement si « la plateforme fonctionne » ou si « le problème vient ensuite de votre code »
déterminer rapidement si un modèle/groupe est disponible
valider l’expérience avant une véritable intégration dans un client externe

Si le bac à sable fonctionne normalement, qu’est-ce que cela signifie

Si une conversation stable est déjà possible ici, cela signifie généralement que :

votre compte et vos autorisations de base sont corrects
la plateforme peut actuellement appeler ce modèle normalement
si vous échouez ensuite dans une application tierce ou dans du code, il est plus probable qu’il s’agisse d’un problème de configuration d’intégration

C’est aussi pour cela que je recommande à beaucoup de débutants :

Commencez par valider la conversation sur le site, puis passez à l’intégration dans une application tierce ou un SDK.

Questions fréquentes

Le bac à sable fonctionne, mais pas le client tiers

Vérifiez en priorité :

si la Base URL du client tiers est correcte
si l’API Key a été copiée intégralement
si le nom du modèle est identique
si l’outil tiers prend en charge l’interface compatible OpenAI

Dans le bac à sable, le modèle ne peut pas être sélectionné ou le résultat n’est pas correct

Vérifiez en priorité :

si le groupe actuel prend en charge ce modèle
si le modèle sélectionné est adapté à la tâche en cours
si trop de paramètres ont été modifiés par erreur

Que faire si la réponse est très lente

Ne concluez pas trop vite à une anomalie de la plateforme. Essayez d’abord :

de changer de modèle
de changer de groupe
de tester avec une question plus courte
d’éviter de fournir un contexte trop long dès le départ

Conseil d’utilisation le plus pratique

Le bac à sable convient avant tout comme « point de vérification avant intégration » et « espace d’évaluation des modèles », et pas seulement comme simple page de démonstration.