# LLM & IA (https://dev.cosmospay.lat/docs/fr/ai/)

> Fournissez la documentation et le SDK Cosmos Pay à votre LLM ou agent de codage grâce à des fichiers llms.txt prêts à l'emploi, au Markdown par page et à « Ouvrir dans ChatGPT/Claude ».

Cette documentation est conçue pour être consommée par des LLM et des agents de codage (Cursor, Claude, ChatGPT…), et pas
seulement par des humains. Copier le Markdown d'une page est une option, mais il y a bien plus.

## Fichiers de contexte prêts à l'emploi

Deux points de terminaison exposent l'ensemble de la documentation en texte brut qu'un LLM peut ingérer d'un seul coup :

- `/docs/llms.txt` : un index compact qui liste chaque page avec son titre, son URL et sa description.
- `/docs/llms-full.txt` : le texte complet de chaque page, concaténé.

```bash
# the index
curl https://dev.cosmospay.lat/docs/llms.txt

# everything, in one file (great for a single prompt or a RAG ingest)
curl https://dev.cosmospay.lat/docs/llms-full.txt
```

## N'importe quelle page seule en Markdown

Chaque page possède un menu d'actions (en haut à droite de la page) avec :

- **Copy Markdown** / **View as Markdown** : la source Markdown brute de cette page.
- **Open in ChatGPT** / **Open in Claude** : ouvre l'assistant préchargé avec cette page.

Vous pouvez aussi récupérer le Markdown d'une page directement en ajoutant `/content.md` sous `/docs/llms.mdx` :

```bash
# the quickstart page, as Markdown
curl https://dev.cosmospay.lat/docs/llms.mdx/sdk/server/quickstart/content.md
```

> **Utilisez-le dans une invite**
>
> Collez `llms-full.txt` (ou le Markdown d'une seule page) dans votre assistant et laissez-le écrire
> l'intégration, par ex. *« À partir de ceci, créez un paiement Cosmos Pay qui facture 10 USDC et vérifie
> le paiement avec un webhook. »*

## L'API Payments en OpenAPI

La [référence de l'API](https://dev.cosmospay.lat/docs/api/) est générée à partir d'un document OpenAPI 3.0, publié avec cette
documentation. Donnez-le à un agent de programmation, à un client d'API ou à un générateur de code
pour disposer du contrat complet : chaque endpoint avec ses paramètres, son corps de requête et
ses réponses.

```bash
curl https://dev.cosmospay.lat/docs/openapi.json
```

## Le SDK fournit sa propre documentation pour LLM

Le paquet `@cosmosapp/pay_sdk` embarque un dossier `llms/` lisible par l'IA, de sorte qu'une fois installé,
la documentation se trouve directement dans `node_modules` (aucun réseau requis) :

```text
node_modules/@cosmosapp/pay_sdk/llms/
├─ llms.txt          # index
├─ llms-full.txt     # everything in one file
└─ NN-*.md           # one atomic topic per file
```

```bash
# point your agent at the installed SDK docs
cat node_modules/@cosmosapp/pay_sdk/llms/llms-full.txt
```

## Exemples exécutables

Le dépôt du SDK conserve un exemple exécutable par fonctionnalité (intentions de paiement, webhooks, le client
web, clients, produits, analyses, gestion des erreurs), ce qui constitue un matériau few-shot idéal pour un agent.

- [Exemples du SDK](https://github.com/CosmosPay/CosmosJS_SDK/tree/main/examples): Un exemple exécutable par fonctionnalité, dans le dépôt du SDK.
- [Démarrage rapide](https://dev.cosmospay.lat/docs/sdk/server/quickstart/): L'intégration de bout en bout la plus courte.