Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.qaos.machdel.com/llms.txt

Use this file to discover all available pages before exploring further.

Chaque exécution QAOS est pilotée par un fichier de configuration JSON. Ce fichier indique à l’agent où commencer, quoi tester et quels agents utiliser.

​
Mode QAOS vs. mode guidé

Il existe deux façons de lancer un audit : Mode QAOS (recommandé) — définissez qaosMode: true et fournissez un qaosConfig. L’agent explore votre site de manière autonome, découvre les pages par lui-même et signale les critères partout où il passe. Aucune définition de tâche n’est nécessaire. Mode guidé — définissez un tableau tasks avec des pages et des instructions spécifiques. Utilisez cette approche lorsque vous avez besoin d’un contrôle précis sur les flux testés par l’agent.

​
Structure du fichier de configuration

{
  "name": "string",
  "projectId": "string",
  "maxBudget": 5,
  "qaosMode": true,
  "qaosConfig": {
    "startUrl": "string",
    "subAgents": ["security", "uiux"],
    "maxPages": 20,
    "maxDepth": 3
  },
  "agentInfo": { "clé": "valeur" }
}

​
Champs de niveau supérieur

ChampTypeRequisDescription
namestringOuiNom lisible pour cette exécution, affiché dans le tableau de bord
projectIdstringOuiUUID du projet auquel associer cette exécution
maxBudgetnumberNonPlafond de dépense optionnel en USD pour l’exécution. L’exécution s’arrête dès que le coût OpenAI estimé atteint cette valeur
qaosModebooleanNonActive le mode d’exploration autonome. Quand true, qaosConfig est requis et tasks est ignoré
qaosConfigobjectSi qaosMode: trueParamètres de l’exploration autonome (voir ci-dessous)
tasksarraySi qaosMode n’est pas définiListe des tâches du mode guidé (voir ci-dessous)
agentInfoobjectNonMétadonnées arbitraires attachées au rapport d’exécution
websiteOriginstringNonRépertoire racine du site ; requis lorsqu’une startUrl est un chemin de système de fichiers (ex. : C:/mon-site)
Formule d’estimation utilisée par le serveur d’agent : costUsd = (inputTokens / 1000) * 0.00075 + (outputTokens / 1000) * 0.0045

​
Champs de qaosConfig

Utilisé lorsque qaosMode: true :
ChampTypeRequisDescription
startUrlstringOuiL’URL depuis laquelle l’agent commence l’exploration
subAgentsarrayOuiAgents à exécuter : "security", "uiux", ou les deux
maxPagesnumberNonNombre maximum de pages à visiter (par défaut : illimité)
maxDepthnumberNonProfondeur maximale de liens à suivre depuis startUrl (par défaut : illimité)

​
Champs de tâche

Chaque élément du tableau tasks définit un scénario de test :
ChampTypeRequisDescription
idstringOuiIdentifiant unique pour cette tâche au sein de l’exécution
descriptionstringOuiDescription en langage naturel de ce qu’il faut tester
contextstringNonContexte supplémentaire pour l’agent (identifiants, notes)
startUrlstringOuiL’URL vers laquelle l’agent navigue au début de cette tâche
subAgentsarrayNonAgents à exécuter : "security", "uiux", les deux, ou [] pour évaluation du flux uniquement

​
Rédiger des descriptions de tâches efficaces

Le champ description est interprété par un LLM, donc le langage naturel fonctionne bien. Soyez précis sur ce que l’agent doit faire et ce que vous souhaitez qu’il recherche. 
"Naviguer vers la page de connexion et tenter de se connecter avec les identifiants de test admin@example.com / password123"

"Parcourir la page des paramètres du compte utilisateur et vérifier tous les champs modifiables"

"Accéder au panneau d'administration et vérifier que les actions réservées aux administrateurs sont correctement restreintes"

​
Choisir les sous-agents

Vous pouvez exécuter l’agent de sécurité, l’agent UI/UX, les deux, ou aucun sur n’importe quelle tâche. 
"subAgents": ["security"]          // sécurité uniquement
"subAgents": ["uiux"]              // UI/UX uniquement
"subAgents": ["security", "uiux"]  // les deux
"subAgents": []                    // évaluation du flux uniquement
Quand utiliser les deux : Pour les pages avec des interactions utilisateur (formulaires, boutons, navigation), exécuter les deux agents ensemble donne une vue complète. Quand en utiliser un seul : Pour les endpoints API internes ou les pages système uniquement, security seul peut suffire. Pour les pages marketing statiques, uiux seul peut être plus pertinent. Quand n’en utiliser aucun : Pour vérifier qu’un flux peut être complété de bout en bout sans rechercher de critères spécifiques — la tâche échoue si l’agent ne peut pas la terminer, ce qui révèle des bugs dans le flux lui-même. Un tableau vide peut aussi servir à préparer un état (ex. : connexion) avant une tâche suivante qui effectuera des évaluations.
Si un sous-agent est listé dans subAgents mais que tous ses critères sont dans ignoredIssueIds, l’exécution sera rejetée. Retirez l’agent de subAgents ou réactivez au moins un de ses critères.

​
Deux façons de configurer

Constructeur visuel

Utilisez le tableau de bord QAOS pour générer un fichier de configuration via un formulaire guidé — sans édition JSON requise.

JSON depuis zéro

Rédigez ou modifiez le fichier de configuration directement avec la référence complète des champs.