# Instrucciones para el agente: Spice: conecta datos y búsquedas a un runtime consultable

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: avanzado
- Proyecto: https://github.com/spiceai/spiceai (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/spice-ai-sidecar

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Preparación

Para la ruta binaria del README, comprueba curl y Bash en macOS, Linux o WSL. Windows necesita WSL para el runtime desde v2.0. No es necesario compilar Rust ni preparar Node.js para esta ruta. Revisa el instalador antes de ejecutarlo.

### Paso 1: instala la CLI

En macOS, Linux o WSL, el README indica:

```bash
curl https://install.spiceai.org | /bin/bash
```

### Paso 2: prepara un proyecto

```bash
spice init spice_qs
cd spice_qs
spice run
```

Deja el runtime abierto. En una segunda terminal, entra en la misma carpeta spice_qs y añade el conjunto público del inicio rápido:

```bash
spice add spiceai/quickstart
spice sql
```

Dentro del intérprete SQL, comprueba la tabla:

```sql
show tables;
SELECT trip_distance, total_amount FROM taxi_trips ORDER BY trip_distance DESC LIMIT 10;
```

Fuente: [inicio rápido oficial](https://github.com/spiceai/spiceai#readme). Para fuentes propias configura el acceso documentado por el conector.

## Comprobación

Haz una consulta con resultado conocido y comprueba la fuente y fecha de actualización. Si habilitas búsqueda, revisa los documentos que respaldan una recuperación.

## Si algo falla

Si falta un dataset, revisa el conector y su configuración. Si los resultados están atrasados, comprueba el refresco antes de atribuir el problema al modelo del agente.