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. "Sos el agente de soporte de Acme, una tienda de bicicletas."
  2. Alcance: de qué responde y de qué no. "Respondés sobre productos, envíos y devoluciones. No des asesoría legal ni médica."
  3. Uso del conocimiento: "Respondé solo con la información de la base de conocimiento. Si no está ahí, decilo — nunca inventes precios ni plazos."
  4. Escalación: "Si el cliente pide cambios de facturación o está enojado, escalá 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"

Escribí un borrador de dos líneas y clic en Improve with AI: la IA lo reescribe con esta estructura, en tu idioma. Revisá y ajustá — vos conocés 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, derivá 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 — guardá con Save draft y probá en el Live Preview; el canal público recién cambia al publicar.