Skip to main content

​
Utilisation de base

Avec un fichier de configuration prêt et le CLI authentifié, démarrez une exécution :
Le CLI se connecte au serveur QAOS, lance un navigateur headless et commence à exécuter les tâches. La progression est diffusée dans votre terminal en temps réel.

​
Options de la commande

​
Recherche de configuration par défaut

Si aucun flag --config n’est fourni, QAOS recherche qaos-config.json dans le répertoire de travail actuel :

​
Mode avec fenêtre

Utilisez --headed (ou -h) pour ouvrir une fenêtre de navigateur visible pendant l’exécution. Cela est utile pour :
  • Déboguer des descriptions de tâches qui ne produisent pas le comportement attendu
  • Observer l’agent naviguer dans votre application
  • Comprendre comment l’agent interprète vos pages
Le mode avec fenêtre peut être légèrement plus lent que le mode headless. Utilisez le mode headless pour les pipelines CI en production.

​
Ce qui se passe pendant une exécution

1

Connexion

Le CLI se connecte au serveur QAOS via WebSocket et envoie votre configuration pour initier l’exécution. Un ID d’exécution est assigné et affiché.
2

Exécution des tâches

Les tâches s’exécutent séquentiellement. Pour chaque tâche :
  • Le navigateur navigue vers startUrl
  • L’agent analyse la page (DOM, captures d’écran, en-têtes réseau, cookies, journaux console)
  • Des sous-tâches sont générées pour les tests interactifs (ex. : tentative de connexion avec des mots de passe faibles)
  • Les critères sont détectés et signalés en temps réel
3

Évaluation par les agents

Sur chaque page, les sous-agents sélectionnés évaluent la page par rapport à leur catalogue complet de critères, en utilisant une combinaison de vérifications déterministes (rapides, basées sur le code) et d’évaluation LLM (plus approfondie, sensible au contexte).
4

Finalisation

Une fois toutes les tâches terminées, le CLI affiche un résumé des critères détectés et un lien vers le rapport complet dans le tableau de bord.

​
Sortie en temps réel

Pendant l’exécution, le CLI diffuse les résultats dans votre terminal au fur et à mesure de leur détection, et affiche un résumé avec un lien vers le rapport complet une fois l’exécution terminée.

​
Exécution en CI/CD

QAOS fonctionne bien dans les pipelines CI. Utilisez l’authentification par jeton API et un fichier de configuration versionné :
Exemple GitHub Actions
Le CLI se termine avec le code 0 en cas de succès et un code non nul si l’exécution échoue ou si le serveur est inaccessible.

​
Limitations connues

L’agent QAOS s’exécute comme un navigateur automatisé et ne peut pas effectuer toutes les actions qu’un utilisateur humain peut réaliser :

​
Résolution de problèmes

Votre jeton a peut-être expiré ou été révoqué. Réauthentifiez-vous :
Vérifiez le chemin fourni :
QAOS nécessite que les binaires de navigateur Playwright soient installés sur votre machine. Installez-les une seule fois avant votre première exécution :
Si les binaires sont manquants, QAOS affichera un message d’erreur vous demandant d’exécuter la commande ci-dessus. Après l’installation, relancez simplement votre exécution.
Si votre application charge lentement, envisagez d’ajouter un contexte descriptif dans votre configuration de tâche pour aider l’agent à comprendre le comportement attendu. Chaque tâche dispose d’un délai d’expiration généreux, mais les pages très lentes peuvent occasionnellement être ignorées.