La documentation produit de Piano est exportée dans des formats conçus pour les grands modèles de langage, selon le standard http://llmstxt.org. Utilisez ces fichiers pour ancrer vos agents de code, chatbots et pipelines RAG sur des informations exactes et à jour concernant Analytics, Subscriptions, Audience et Amplifier.
Vous cherchez plutôt la documentation de référence de l'API ? Ce site (http://docs.piano.io ) couvre la documentation produit, les guides pratiques et les FAQ du support. Pour la documentation de référence SDK/API destinée aux développeurs qui intègrent Piano Analytics, consultez plutôt http://developers.piano.io/analytics/for-ai-agents/, qui propose des index thématiques supplémentaires (collecte de données, Reporting API, gestion des accès).
Quel fichier utiliser ?
Choisissez le fichier le plus léger qui fournit à votre agent un contexte suffisant. L'index est peu coûteux ; le corpus complet est puissant mais lourd, et suffisamment volumineux pour être réparti sur plusieurs pages.
-
Explorer et router. Laissez votre agent parcourir l'index et ne récupérer que les pages dont il a besoin →
llms.txt -
Tout ingérer. Chargez le corpus complet en une seule requête lorsque la fenêtre de contexte le permet →
llms-full.txt -
Approfondir un sujet. Récupérez l'URL markdown d'une page précise depuis n'importe quelle entrée de l'index →
*.md
Fichiers disponibles
llms.txt
Index principal de l'ensemble du site de documentation : toutes les pages, pour tous les produits (Analytics, Subscriptions, Audience, Amplifier) et toutes les langues (anglais, français, japonais). Chaque entrée renvoie vers une page .md lisible par une machine.
Idéal pour : point de départ de tout agent IA, pour découvrir les sujets et router vers la bonne page.
Adresse : https://docs.piano.io/llms.txt
llms-full.txt
Contenu complet de la documentation dans un seul export, selon le standard http://llmstxt.org. Comme le corpus couvre quatre produits et plusieurs langues, ce fichier est paginé. Suivez le lien « Next Page » en bas de chaque page pour continuer.
Idéal pour : une ingestion unique lorsque vous avez besoin d'un contexte large et disposez d'une grande fenêtre de contexte.
Adresses :
https://docs.piano.io/llms-full.txt
https://docs.piano.io/llms-full.txt/1
https://docs.piano.io/llms-full.txt/2
...et ainsi de suite
Cibler par produit ou par langue
Il n'existe actuellement pas de fichiers d'index dédiés par produit (par ex. llms-analytics.txt) sur ce site. Ciblez plutôt l'exploration de votre agent à l'aide du préfixe de chemin d'URL. Toutes les pages d'un même produit/locale partagent un préfixe cohérent :
-
Piano Analytics : anglais :
docs.piano.io/en/analytics/, français :docs.piano.io/fr/analytics/ -
Piano Subscriptions : anglais :
docs.piano.io/en/subscriptions/ -
Piano Audience : anglais :
docs.piano.io/en/audience/ -
Piano Amplifier :
docs.piano.io/amplifier/
Conseil pour les agents : récupérez llms.txt une seule fois, puis filtrez les liens renvoyés selon le préfixe correspondant au produit sur lequel porte la question de l'utilisateur, avant de récupérer les pages .md individuelles. Cela reproduit le comportement d'un index ciblé sans requête supplémentaire.
Fichiers markdown par page
Chaque page de documentation dispose également d'un export .md autonome. Les liens présents dans llms.txt pointent directement vers ces URL.
Modèle : https://docs.piano.io/<route>.md
Exemple : fr/analytics/create-modify-a-board.md
Démarrage rapide
Récupérez un index ou une page depuis la ligne de commande :
curl -s https://docs.piano.io/llms.txt
curl -s https://docs.piano.io/llms-full.txt
curl -s https://docs.piano.io/fr/analytics/create-modify-a-board.md
Exemples de prompts
Copiez et adaptez ces instructions pour l'outil d'IA de votre choix :
Règle Cursor / Windsurf
Lorsque vous répondez à des questions sur la documentation produit de Piano :
Récupérez d'abord https://docs.piano.io/llms.txt.
Filtrez l'index pour ne garder que les liens correspondant au chemin du produit concerné (/fr/analytics/, /fr/subscriptions/, /fr/audience/, /amplifier/).
Ne récupérez que les pages .md correspondantes ; ne devinez pas les détails des fonctionnalités.
Pour les questions de référence API/SDK, reportez-vous plutôt à developers.piano.io/analytics/llms.txt.
Instruction de projet ChatGPT / Claude
Vous avez accès à la documentation produit de Piano via les exports llms.txt sur http://docs.piano.io. Commencez par https://docs.piano.io/llms.txt comme catalogue de routage. Identifiez le produit sur lequel porte la question de l'utilisateur (Analytics, Subscriptions, Audience ou Amplifier) et ne récupérez que les pages .md situées sous le préfixe de chemin de ce produit. Suivez les liens vers les pages individuelles pour obtenir des réponses fiables et à jour.
Workflow RAG / agent
Étape d'indexation : ingérez llms.txt comme catalogue de routage (léger, peu coûteux).
Étape de récupération : récupérez les URL .md ciblées listées dans l'index. Évitez llms-full.txt sauf si vous avez besoin d'un contexte large et multi-produits, et prévoyez de parcourir la pagination /1, /2, /3, etc.
Les résumés de l'index proviennent des métadonnées de titre/description de chaque page.