# LLMs e IA (https://dev.cosmospay.lat/docs/es/ai/)

> Alimenta tu LLM o agente de programación con la documentación y el SDK de Cosmos Pay, con archivos llms.txt listos para usar, Markdown por página y "Abrir en ChatGPT/Claude".

Esta documentación está hecha para ser consumida por LLMs y agentes de programación (Cursor, Claude, ChatGPT…), no
solo por humanos. Copiar el Markdown de una página es una opción, pero hay mucho más.

## Archivos de contexto listos para usar

Dos endpoints exponen toda la documentación como texto plano que un LLM puede ingerir de una sola vez:

- `/docs/llms.txt`: un índice compacto: cada página con su título, URL y descripción.
- `/docs/llms-full.txt`: el texto completo de cada página, concatenado.

```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
```

## Cualquier página individual como Markdown

Cada página tiene un menú de acciones (arriba a la derecha de la página) con:

- **Copy Markdown** / **View as Markdown**: el código fuente Markdown en crudo de esa página.
- **Open in ChatGPT** / **Open in Claude**: abre el asistente precargado con esa página.

También puedes obtener el Markdown de una página directamente añadiendo `/content.md` bajo `/docs/llms.mdx`:

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

> **Úsalo en un prompt**
>
> Pega `llms-full.txt` (o el Markdown de una sola página) en tu asistente y déjalo escribir la
> integración. Por ejemplo: *"Usando esto, crea un checkout de Cosmos Pay que cobre 10 USDC y verifique
> el pago con un webhook."*

## La API REST de pagos en OpenAPI

La [referencia de la API](https://dev.cosmospay.lat/docs/api/) se genera a partir de un documento OpenAPI 3.0, que se publica
junto con esta documentación. Pásaselo a un agente de programación, a un cliente de API o a un
generador de código para tener el contrato completo: cada endpoint con sus parámetros, su cuerpo
de solicitud y sus respuestas.

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

## El SDK incluye su propia documentación para LLMs

El paquete `@cosmosapp/pay_sdk` incluye una carpeta `llms/` legible por IA, así que una vez que lo instales
la documentación está justo ahí en `node_modules`, sin necesidad de red:

```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
```

## Ejemplos ejecutables

El repositorio del SDK mantiene un ejemplo ejecutable por característica (intenciones de pago, webhooks, el cliente
web, clientes, productos, analíticas, manejo de errores), material ideal de pocos ejemplos para un agente.

- [Ejemplos del SDK](https://github.com/CosmosPay/CosmosJS_SDK/tree/main/examples): Un ejemplo ejecutable por característica, en el repositorio del SDK.
- [Inicio rápido](https://dev.cosmospay.lat/docs/sdk/server/quickstart/): La integración de extremo a extremo más corta.