Utiliser la documentation avec une IA
Donnez à votre assistant une page Markdown ou la documentation complète de SpectrAI, avec les liens sources, la langue et les dates de mise à jour.
Sur cette page
Cette documentation est publique et consultable sans connexion. Les versions HTML et Markdown sont produites à partir des mêmes pages. Vous pouvez les donner à un assistant pour préparer un pentest, comprendre un rapport ou retrouver une procédure.
Choisir le bon contexte#
| Besoin | Ressource |
|---|---|
| Poser une question sur la page ouverte | Le bouton « Copier en Markdown » ou le menu « Utiliser avec une IA » |
| Trouver les pages pertinentes | L’index des pages, avec les résumés et les liens Markdown en anglais puis en français |
| Lire plusieurs sujets ou constituer un index local | Le texte complet, anglais puis français, avec les adresses et les dates de chaque page |
| Découvrir l’arborescence française | L’accueil en Markdown |
| Découvrir l’arborescence anglaise | L’accueil anglais en Markdown |
Pour une question précise, commencez par l’index et récupérez uniquement les pages utiles. Le fichier complet convient à un assistant capable d’en lire l’ensemble ; sa taille peut dépasser la place disponible dans certains outils.
Récupérer une page en Markdown#
Ajoutez .md à l’adresse d’une page. Le français est à la racine ; l’anglais utilise le préfixe /en et les mêmes slugs.
curl https://docs.spectr-ai.eu/pentest-externe/verifier-le-domaine.md
curl https://docs.spectr-ai.eu/en/pentest-externe/verifier-le-domaine.md
Vous pouvez aussi demander le Markdown à l’adresse HTML avec l’en-tête Accept :
curl -H 'Accept: text/markdown' https://docs.spectr-ai.eu/pentest-externe/verifier-le-domaine
Chaque page fournit son titre, son résumé, sa langue, ses dates, son adresse HTML, son adresse Markdown et l’autre langue dans le front matter. Les liens sont absolus pour rester utilisables une fois le texte copié. Les pages liées permettent d’approfondir le sujet.
Poser une question avec ses sources#
Exemple de consigne à adapter :
Lis https://docs.spectr-ai.eu/llms.txt et les pages utiles à ma question.
Explique comment vérifier un domaine avant un pentest externe.
Cite les adresses sources et leurs dates de mise à jour.
Distingue les faits documentés de tes déductions.
Si une information manque, indique-le et demande une précision.
Le menu « Utiliser avec une IA » ouvre un assistant avec une consigne et les adresses de la page. L’assistant doit pouvoir récupérer ces adresses. S’il ne le peut pas, utilisez « Copier en Markdown » et collez le texte dans la conversation.
Garder le contexte adapté#
La documentation décrit le fonctionnement public du produit. Elle ne donne pas accès à votre compte, à vos commandes ou à vos rapports. Transmettre une page à un assistant ne lance aucun test et ne lui donne aucune autorisation sur votre application.
Pour préparer une question, utilisez les concepts, les limites et engagements et les règles de confidentialité. Pour un blocage dans l’application, consultez le dépannage.