# Instrucciones para el agente: Onyx: conecta documentos empresariales con tus 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/onyx-dot-app/onyx (licencia NOASSERTION)
- Guía completa: https://lab.wisd.ai/hub/onyx-enterprise-knowledge

---

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

Comprueba Docker con Compose, curl y Bash. Para Standard, la [guía de recursos](https://docs.onyx.app/deployment/getting_started/resourcing) pide al menos 4 vCPU, 10 GB RAM y 32 GB de disco más unas 2,5 veces el tamaño de los datos indexados. Asigna esos recursos al motor de Docker. Lee el script y el [inicio rápido oficial](https://docs.onyx.app/deployment/overview) antes de ejecutarlo; elige la modalidad Standard para la búsqueda en conectores de esta ficha. La ruta documentada es:

```sh
curl -fsSL https://onyx.app/install_onyx.sh | bash
```

El script instala `onyx-cli` y lanza `onyx-cli deploy install`; los archivos de despliegue quedan normalmente en `~/.config/onyx` y los datos en volúmenes Docker. Espera al final del asistente y abre la dirección local que imprima. Comprueba el despliegue con:

```sh
onyx-cli deploy status
```

Crea la cuenta inicial. En **Admin Panel → Language Models**, configura un proveedor al que tengas acceso y elige un modelo disponible. Prepara `prueba.txt` con un hecho ficticio único, por ejemplo «El proyecto de ensayo se llama Nube Naranja». En **Admin Panel → Add Connector**, elige [File](https://docs.onyx.app/admins/connectors/official/file), carga ese archivo y configura acceso **Private**. Espera a que termine su indexación y pregunta desde el chat por el nombre del proyecto de ensayo. La respuesta debe recuperar el hecho y citar el archivo. Comprueba el alcance de la edición y los permisos antes de incorporar información del equipo.

## Comprobación

Busca un documento conocido y compara la respuesta con su contenido. Verifica con usuarios de prueba el acceso a material restringido.

## Si algo falla

Si falta contenido, revisa la sincronización y permisos de la fuente. Si falla la respuesta del modelo, comprueba el proveedor por separado del índice.

Consulta [el README oficial](https://github.com/onyx-dot-app/onyx#readme) para requisitos y variantes de instalación.