# Instrucciones para el agente: Soporte con fuentes: respuestas en borrador y revisión de cobertura

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: intermedio
- Guía completa: https://lab.wisd.ai/hub/rag-support-agent

---

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

### 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](/hub/onyx-enterprise-knowledge), 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](/hub/human-review-skill), 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.

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