DocsAI AgentsInstructions (el prompt)

Instructions: cómo escribir el prompt del agente

Las Instructions son el prompt del agente: definen su rol, su alcance, cómo usa el conocimiento y cuándo debe rendirse. Unas buenas instructions son la diferencia entre un agente que resuelve y uno que divaga.

La estructura que funciona

  1. Rol: quién es. "Eres el agente de soporte de Acme, una tienda de bicicletas."
  2. Alcance: de qué responde y de qué no. "Respondes sobre productos, envíos y devoluciones. No des asesoría legal ni médica."
  3. Uso del conocimiento: "Responde solo con la información de la base de conocimiento. Si no está ahí, dilo — nunca inventes precios ni plazos."
  4. Escalación: "Si el cliente pide cambios de facturación o está enojado, escala a un humano." (configurar escalación)
  5. Estilo: longitud, formato, idioma. "Respuestas cortas, con pasos numerados cuando expliques un proceso."

El botón "Improve with AI"

Escribe un borrador de dos líneas y clic en Improve with AI: la IA lo reescribe con esta estructura, en tu idioma. Revisa y ajusta — tú conoces tu negocio.

Errores típicos

  • Instructions vacías — el agente queda genérico y se nota.
  • Prohibiciones sin alternativa — en vez de "no hables de precios", mejor "para precios actualizados, deriva a la página de planes".
  • Pedirle que sepa lo que no está en las fuentes — las instructions guían el cómo; el qué vive en el conocimiento.

Problemas comunes

  • Cambiaste las instructions y no ves efecto — guarda con Save draft y prueba en el Live Preview; el canal público solo cambia al publicar.