Optimización de avisos del agente mediante prompt Optimizer (versión preliminar)

Importante

Los elementos marcados (versión preliminar) de este artículo se encuentran actualmente en versión preliminar pública. Esta versión preliminar se proporciona sin un contrato de nivel de servicio y no se recomienda para cargas de trabajo de producción. Es posible que algunas características no se admitan o que tengan funcionalidades restringidas. Para obtener más información, vea Supplemental Terms of Use for Microsoft Azure Previews.

Utiliza "Prompt Optimizer" en "Microsoft Foundry" para mejorar automáticamente las instrucciones del sistema del agente. Prompt Optimizer aplica procedimientos recomendados de ingeniería de mensajes para reestructurar, aclarar y mejorar sus instrucciones. Proporciona razonamiento transparente de nivel de párrafo para cada cambio. Puede refinar los resultados de manera iterativa agregando sugerencias y reoptimizando hasta estar satisfecho y, a continuación, aplicar el resultado final con un solo clic.

En este artículo se explica cómo usar Prompt Optimizer en el área de juegos del portal de Foundry.

Requisitos previos

Funcionamiento del optimizador de mensajes

Prompt Optimizer usa un proceso de varios pasos que combina la entrada con optimización controlada por LLM:

  1. Colección de entrada: proporciona una descripción inicial de lo que el agente debe hacer (para nuevos agentes) o abre el optimizador con instrucciones existentes ya instaladas. Opcionalmente, puede proporcionar sugerencias adicionales para guiar la optimización (por ejemplo, "Tener un tono profesional" o "Hacer que sea amigable para niños").

  2. Optimización basada en LLM: un LLM recibe sus instrucciones y cualquier sugerencia. Aplica procedimientos recomendados de ingeniería rápida para reestructurar, aclarar y mejorar las instrucciones.

  3. Generación de razonamiento: para cada párrafo modificado, LLM genera una explicación de por qué se realizó el cambio. Este razonamiento se muestra junto con el texto optimizado para una transparencia completa.

  4. Refinamiento iterativo: después de la optimización inicial, puede proporcionar sugerencias adicionales y volver a optimizar. Cada optimización posterior usa el texto optimizado más reciente como la nueva línea base, combinada con la nueva sugerencia. Repita este bucle hasta que esté satisfecho con el resultado.

Abrir optimizador de instrucciones

Para abrir Prompt Optimizer en el portal de Foundry:

  1. Inicie sesión en Microsoft Foundry. Asegúrese de que el interruptor New Foundry esté activado.
  2. Vaya a BuildAgents (> y seleccione el agente que desea optimizar.
  3. En el panel de configuración del agente, busque la sección Instrucciones .
  4. Seleccione el lápiz con el icono de brillo (✏️✨) al lado del encabezado Instrucciones. Esta acción abre el cuadro de diálogo Optimizador de mensajes.

Propina

Puede usar Prompt Optimizer en la zona de pruebas del modelo donde haya instrucciones del sistema.

Optimización de las instrucciones de un nuevo agente

Si el agente aún no tiene instrucciones:

  1. Abra prompt Optimizer (Optimizador de mensajes). El cuadro de diálogo muestra un estado vacío que le pide que describa lo que desea que haga el agente.
  2. En el área de texto, escriba una descripción del propósito y el comportamiento del agente. Por ejemplo: "Asistente para planear viajes que ayuda a los usuarios a planear viajes de varios días con recomendaciones presupuestarias".
  3. Seleccione Optimizar. El optimizador genera un conjunto completo de instrucciones del sistema estructurado en función de la descripción.
  4. Revise las instrucciones optimizadas. Los párrafos modificados se resaltan en púrpura con un borde púrpura izquierdo.
  5. Seleccione Usar solicitud para aplicar las instrucciones optimizadas al agente. El cuadro de diálogo se cierra y el campo Instrucciones se actualiza con el texto optimizado.

Optimización de las instrucciones existentes

Si el agente ya tiene instrucciones, siga estos pasos:

  1. Abra prompt Optimizer (Optimizador de mensajes). El cuadro de diálogo muestra las instrucciones originales en una tarjeta con borde.
  2. Opcionalmente, escriba una sugerencia en la barra de sugerencias para guiar la optimización. Por ejemplo: "Agregar límites de protección para preguntas fuera del tema" o "Hacer que el tono sea más conversacional".
  3. Seleccione Optimizar. El optimizador analiza las instrucciones actuales y genera una versión mejorada.
  4. Revise las instrucciones optimizadas.
  5. Seleccione Usar mensaje para reemplazar las instrucciones actuales por la versión optimizada. El cuadro de diálogo se cierra y el campo Instrucciones se actualiza con el texto optimizado.

Nota

Puede dejar el campo de sugerencia vacío. En algunos casos, la optimización sin dirección adicional produce resultados fuertes, ya que el optimizador se centra exclusivamente en mejoras estructurales y de claridad.

Revisión del razonamiento de optimización

Prompt Optimizer proporciona un razonamiento transparente de nivel de párrafo para cada cambio:

  • Razonamiento individual: seleccione el icono de burbuja de chat (💬) junto a cualquier párrafo modificado para ver por qué se realizó ese cambio específico. El razonamiento aparece en un cuadro resaltado púrpura debajo del párrafo.
  • Mostrar todo el razonamiento: seleccione el botón Mostrar todo el razonamiento para mostrar el razonamiento de cada párrafo modificado a la vez.

Las explicaciones de razonamiento describen qué principio de ingeniería rápida se aplicó y por qué mejora las instrucciones. Esta información le ayuda a comprender y validar cada sugerencia antes de aceptarla.

Iterar en optimizaciones

Puede refinar el resultado optimizado tantas veces como sea necesario:

  1. Después de revisar las instrucciones optimizadas, escriba una nueva sugerencia en la barra de sugerencias. Por ejemplo: "Acortar la sección de formato de respuesta" o "Agregar un comportamiento alternativo cuando el usuario pregunta algo fuera del ámbito".
  2. Vuelva a seleccionar Optimizar . El optimizador usa el texto optimizado más reciente como línea base nueva y aplica la nueva sugerencia.
  3. Repita hasta que esté satisfecho.
  4. Seleccione Usar aviso para aplicar el resultado final. El cuadro de diálogo se cierra y el campo Instrucciones se actualiza con el texto optimizado.

Importante

Los resultados de optimización no se almacenan de forma permanente. Para aplicar los resultados, seleccione Usar indicador antes de cerrar el cuadro de diálogo, de lo contrario, perderá los resultados.

Regiones compatibles

Puede usar Prompt Optimizer en proyectos hospedados en las siguientes regiones.

  • Centro de EE. UU.
  • Este de EE. UU. 2
  • Centro de Francia
  • Centro-oeste de Alemania
  • Norte de Italia
  • Oeste de Japón
  • Centro-norte de EE. UU.
  • Centro de Polonia
  • Centro de España
  • Centro de Suecia
  • Oeste de Suiza
  • Norte de Emiratos Árabes Unidos
  • Oeste de EE. UU.
  • Oeste de EE. UU. 2
  • Oeste de EE. UU. 3

En regiones no admitidas, no aparece el botón Optimizar .

Limitaciones

  • Solo instrucciones basadas en texto: el optimizador solo funciona con instrucciones de agente basadas en texto. No admite la optimización de elementos de configuración que no son de texto, como definiciones de herramientas o orígenes de conocimiento.
  • Resultados efímeros: los resultados de optimización no se conservan entre sesiones. Seleccione Usar solicitud para aplicar los resultados antes de cerrar el cuadro de diálogo.
  • Sin historial de versiones: el optimizador no guarda automáticamente las versiones anteriores de las instrucciones. Considere la posibilidad de copiar las instrucciones originales antes de optimizar si desea conservarlas.

Procedimientos recomendados

  • Comience de forma sencilla y, a continuación, refinar: comience con una breve descripción del propósito del agente y deje que el optimizador cree la estructura inicial. A continuación, iteración con sugerencias dirigidas.
  • Usar sugerencias específicas: sugerencias vagas como "hacerlo mejor" producen resultados menos útiles que los específicos, como "agregar control de errores para fechas no válidas" o "restringir las respuestas solo al inglés".
  • Revisar el razonamiento antes de aceptar: el razonamiento por párrafo le ayuda a detectar cambios que podrían no alinearse con su caso de uso, incluso si siguen los procedimientos recomendados de ingeniería rápida.
  • Prueba después de optimizar: después de aplicar instrucciones optimizadas, pruebe el agente en el área de juegos para comprobar que los cambios producen el comportamiento esperado antes de la implementación.
  • Conservar el mensaje original: antes de optimizar, copie las instrucciones actuales si desea revertir. Volver a cargar la página después de aplicar los cambios restaura tus configuraciones anteriores siempre y cuando no hayas guardado el agente.
  • Ejecutar una evaluación completa: después de optimizar, ejecute una evaluación con su propio conjunto de datos para medir si los cambios mejoran realmente el rendimiento del agente. Prompt Optimizer aplica procedimientos recomendados generales, pero los datos de evaluación validan si esos cambios funcionan para su caso de uso específico.

Solución de problemas

Problema Causa posible Resolución
El icono optimizar no aparece El proyecto está en una región no admitida Mueva el proyecto a una región admitida o cree un nuevo proyecto en una de las regiones enumeradas.
La optimización genera resultados inesperados La sugerencia era demasiado imprecisa o conflictiva Proporcione instrucciones más específicas en la barra de sugerencias. Intente optimizar sin sugerencias primero, luego agregue refinamientos específicos.
La optimización tarda demasiado tiempo Instrucciones grandes o complejas Divida las instrucciones en secciones centradas y optimice individualmente y luego combine.
Los cambios no aparecen en el agente No se seleccionó "Usar solicitud" Vuelva a abrir el optimizador y vuelva a ejecutar la optimización. Asegúrese de seleccionar Usar aviso antes de cerrar el cuadro de diálogo.