Skip to main content
El editor web tiene dos capas de configuración:
  • Tu configuración se aplica solo a ti y controla cómo la IA del editor te ayuda con tus ediciones.
  • La configuración de publicación se aplica a todos los miembros de un deployment y determina qué sucede cuando confirmas cambios y los conviertes en pull requests.
Puedes configurar ambas desde el menú Settings en el editor.

​
Instrucciones de IA

Las instrucciones de IA son pautas persistentes que el editor envía a la IA junto con tu solicitud. Úsalas para capturar reglas de estilo y tono que no quieres repetir cada vez, como la voz, la terminología o las convenciones de formato. Tus instrucciones se aplican a:
  • Acciones Edit with AI sobre una selección, como reescribir, ampliar o corregir.
  • Sesiones del agente iniciadas desde el editor.
Cada compañero de equipo mantiene sus propias instrucciones, asociadas a su cuenta de usuario.

​
Cuándo usar las instrucciones de IA

Agrega instrucciones de IA cuando notes que repites las mismas pautas en los prompts, por ejemplo:
  • Obligar el uso de la segunda persona o encabezados en mayúscula inicial.
  • Preferir nombres de producto o terminología específicos.
  • Prohibir lenguaje de marketing o frases de relleno.
  • Exigir ciertos componentes, como usar siempre <Note> para los avisos.
Mantén las instrucciones cortas y específicas. La IA las sigue en cada solicitud, así que las reglas vagas o contradictorias degradan los resultados.

​
Configurar las instrucciones de IA

  1. Abre el editor y haz clic en tu avatar en la barra de herramientas.
  2. Selecciona Settings.
  3. En el campo AI instructions, introduce las pautas que quieres que siga la IA.
  4. Guarda los cambios.
Ejemplo:
Deja el campo vacío para eliminar tus instrucciones.

​
Configuración de publicación

La configuración de publicación se establece por deployment y se aplica a todas las personas que publican desde el editor. Controla cómo el editor genera, abre y fusiona los pull requests y los commits. Necesitas acceso de administrador a tu deployment de Mintlify para cambiar la configuración de publicación.

​
Instrucciones para el pull request

Las instrucciones para el pull request guían a la IA cuando genera el título y la descripción de un pull request. Se aplican siempre que el editor abre un pull request en tu nombre, incluyendo los flujos Create pull request y Merge and publish. Usa las instrucciones para el pull request para estandarizar lo que ven los revisores, por ejemplo:
  • Secciones obligatorias como Summary y Changes.
  • Una plantilla de descripción que enlace con un sistema de seguimiento.
  • Requisitos de tono o de longitud para los títulos.
Ejemplo:

​
Crear pull requests como borradores por defecto

Activa esta opción para que el editor abra todos los pull requests nuevos en estado de borrador. No puedes fusionar un pull request en borrador hasta que lo marques como listo para revisión. Esto es útil cuando:
  • Tu equipo requiere una revisión manual antes de abrir el pull request para aprobación.
  • Quieres compartir URLs de vista previa sin indicar que el cambio está listo para fusionarse.
Todavía puedes marcar un pull request como listo para revisión desde tu proveedor de Git.

​
Método de fusión predeterminado

Elige cómo fusiona el editor los pull requests cuando haces clic en Merge and publish:
  • Merge: Crea un commit de fusión que preserva el historial completo de la rama.
  • Squash: Combina todos los commits de la rama en un único commit en tu rama de deployment.
  • Rebase: Reproduce cada commit de la rama sobre tu rama de deployment sin crear un commit de fusión.
El editor usa el método seleccionado por defecto. Si pasas un método de fusión explícito a través de la API o de la interfaz de tu proveedor de Git, esa elección tiene prioridad.
Ajusta tu método de fusión predeterminado a las reglas de protección de ramas de tu proveedor de Git. Si tu rama de deployment solo permite fusiones tipo squash, configura el valor predeterminado en Squash para evitar fusiones fallidas desde el editor.