# Instrucciones para el agente: Monid: conectores declarativos de herramientas para agentes

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/monid-ai/monid (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/monid-connectors

---

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

### Paso 1: prepara Git y Deno

Comprueba que tienes Git y Deno 2.x disponibles. Esta ruta usa el repo local de conectores, no crea una cuenta en el servicio alojado. Lee el [README](https://github.com/monid-ai/monid) y la guía de desarrollo para comprobar tu entorno.

### Paso 2: descarga y verifica el código

Secuencia oficial:

```bash
git clone https://github.com/monid-ai/monid.git
cd monid
deno task check && deno task test
```

Las pruebas usan fixtures y no necesitan credenciales de proveedores.

### Paso 3: inspecciona el catálogo

Comandos documentados:

```bash
deno task catalog providers
deno task catalog endpoints --provider exa
deno task catalog endpoints --category web-search
deno task catalog inspect 'exa#search'
```

Lee el contrato y el coste de la operación elegida antes de ejecutar llamadas reales. Para crear un conector, usa los ejemplos del repo y `AGENT.md` como referencia de formato.

## Comprobación

Confirma que pasan tipos y pruebas y que puedes inspeccionar un endpoint real del catálogo local. Revisa los fixtures del proveedor elegido y distingue esos resultados de una prueba contra su API actual.

## Si algo falla

Consulta [DEVELOPMENT.md](https://github.com/monid-ai/monid/blob/HEAD/DEVELOPMENT.md). Si fallan tipos o esquemas, corrige el contrato antes de añadir claves. Si haces una prueba real, usa variables de entorno privadas con los nombres documentados por el proveedor; no guardes valores en conectores ni fixtures.