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.
Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.
Pasos de configuración
Delimita la prueba
Prepara preguntas con respuesta conocida, una sin respuesta y otra que choque con una versión antigua. Define documentos vigentes y quién puede consultar cada uno.
Configura Onyx
Sigue Onyx, incluidos sus requisitos, configuración y comprobación actuales. Usa Standard, completa proveedor y carga privada del archivo de prueba; espera el índice y comprueba que la respuesta cita ese archivo.
Configura Human Review
Sigue Human Review, incluidos sus requisitos, configuración y comprobación actuales. Comprueba una ronda sobre una copia Markdown: envía un comentario, reanuda el agente si hace falta y verifica el cambio en el archivo original revisado.
Datos que pasan entre piezas
Los archivos siguientes son entregables de este caso preparados por el agente; no implican exportadores ni sincronización automática.
Pasa de Onyx a Human Review respuesta.md con pregunta, respuesta propuesta, identificadores o enlaces de documentos, versión vigente, pasajes leídos y lagunas. Conserva la ruta del archivo al aplicar comentarios; sin respaldo vigente o permisos comprobados, detén la respuesta de ese caso y deriva a revisión.
Monta el flujo
Paso 1
Despliega Onyx Standard según su guía y conecta una carpeta o fuente de prueba. Espera la sincronización y busca un documento conocido antes de incorporar más material.
Paso 2
Pregunta por un caso de soporte y registra los documentos recuperados. Prepara un archivo con respuesta, afirmaciones, pasajes de respaldo y lagunas. Excluye documentos obsoletos según la política de tu equipo.
Paso 3
Abre el borrador con Human Review y aplica comentarios. Comprueba fuentes y acceso con usuarios de prueba. Entrega solo la versión aceptada al responsable; conserva como escalamiento los casos sin evidencia.
Comprobación
Prueba preguntas conocida, ausente y contradictoria. El caso sin evidencia debe quedar pendiente y un usuario sin permiso no debe obtener contenido restringido.
Si algo falla
Si falta conocimiento, revisa sincronización y conector. Si aparecen citas que no sostienen la respuesta, corrige la interpretación o deriva el caso; no amplíes permisos para resolverlo.
Esta composición de WISD no se ha ejecutado como prueba integral. La configuración se consulta en las guías enlazadas; las etapas describen cómo coordinar las piezas.
Prompt para tu agente
Sustituye los campos entre <> antes de pegarlo.
Lee y sigue las instrucciones publicadas de las piezas: Onyx: /hub/onyx-enterprise-knowledge/instrucciones.md; Human Review: /hub/human-review-skill/instrucciones.md. Completa los requisitos, configuración y comprobación de cada pieza antes de usarla; comprueba su uso desde el cliente o arnés elegido, no solo su presencia en disco. Si falta un campo entre <>, una fuente obligatoria, acceso o una operación documentada, detén la etapa dependiente, informa qué falta y pídemelo; usa una alternativa manual solo cuando esté descrita y comprobada. No inventes datos ni des por superada una comprobación pendiente.
Con Onyx Standard consulta <fuentes de soporte aprobadas> para <preguntas de prueba>. Comprueba vigencia y acceso de los documentos. Guarda en <archivo> cada respuesta con afirmaciones, pasajes, enlaces y lagunas. Revisa con Human Review, aplica mis comentarios y contrasta una pregunta conocida, otra ausente y otra contradictoria. Deja pendientes los casos sin evidencia o con permisos insuficientes y entrega el borrador aceptado al responsable; no respondas automáticamente al cliente.
Pasa de Onyx a Human Review respuesta.md con pregunta, respuesta propuesta, identificadores o enlaces de documentos, versión vigente, pasajes leídos y lagunas. Conserva la ruta del archivo al aplicar comentarios; sin respaldo vigente o permisos comprobados, detén la respuesta de ese caso y deriva a revisión.
Qué es
Un recorrido de soporte interno para responder preguntas usando un conjunto de documentos aprobados. El agente entrega una respuesta con referencias y una lista de lagunas; una persona decide si es suficiente para compartirla con el cliente.
Para qué te sirve
Cuando dos versiones de una política de devoluciones aparecen en la búsqueda.
Cuando una respuesta parece correcta pero la documentación no respalda un plazo.
Cuando una pregunta requiere abrir un ticket porque el conocimiento disponible no la resuelve.
Cómo funciona
Onyx conecta e indexa fuentes de conocimiento para recuperar documentos. Human Review permite revisar el borrador Markdown y pedir correcciones. El traslado desde la respuesta de Onyx al archivo es explícito; esta composición no instala un bot público de soporte.
Antes de empezar
Necesitas Docker con Compose y la modalidad Standard de Onyx para indexar documentos; Lite no incluye ese índice. Configura un proveedor de modelos y una fuente de prueba con documentos aprobados. Human Review requiere un arnés con skills, Node.js ≥20 y npm/npx. Confirma permisos con usuarios de prueba antes de incorporar tickets privados.
Límites y alternativas
La recuperación puede omitir documentos y la respuesta puede interpretar mal un pasaje. Los permisos dependen de la edición y conector elegidos; deben comprobarse. Si no hay fuente suficiente o hay contradicción, deriva a revisión en lugar de completar una política por intuición.
