Configurar instrucciones de alta calidad para la orquestación generativa

En este artículo, se proporcionan instrucciones sobre cómo escribir las mejores instrucciones para el agente cuando este usa la orquestación generativa. Las instrucciones se definen en la página Descripción general de su agente.

El agente utiliza las instrucciones de las siguientes maneras:

• Es necesario decidir qué herramienta o conocimiento pertinente se debe usar para abordar adecuadamente una consulta de usuario o un desencadenador autónomo.
• Rellenar los campos de cualquier herramienta basándose en el contexto disponible.
• Generar una respuesta al usuario final.

Lenguaje para redactar instrucciones

Use verbos como Obtener o Usar para recuperar y analizar datos, y palabras como Desde y Con para actuar sobre los resultados.

Las siguientes palabras se usan comúnmente para crear instrucciones simples:

Instrucciones básicas en fuentes de conocimiento y herramientas

Los agentes no pueden actuar sobre instrucciones para usar herramientas o búsquedas de conocimiento si el agente no tiene esas herramientas ni orígenes de conocimiento. Primero debe configurar el agente con las herramientas y orígenes de conocimiento adecuados. Por ejemplo, si proporciona una instrucción para que el agente busque las preguntas más frecuentes de un sitio web, el agente no puede seguir esa instrucción a menos que agregue las preguntas más frecuentes del sitio web como origen de conocimiento en un tema. Asegúrese de que las instrucciones que proporcione al agente estén fundamentadas en herramientas y conocimientos configurados para el agente.

Ayudar al agente a determinar las herramientas y los conocimientos adecuados a los que llamar

Antes de agregar instrucciones para llamar a las herramientas y las fuentes de conocimiento adecuadas para el agente, asegúrese de que cada herramienta y fuente de conocimientos siguen los procedimientos recomendados para crear descripciones. Para obtener los mejores resultados, el nombre y la descripción deben ser precisos y específicos, ya que estos campos son los que utiliza el agente para determinar a qué debe llamar. Use la descripción para indicar lo que no debe hacer el agente lo está llamando en el momento equivocado.

No es necesario definir las herramientas o las fuentes de conocimiento disponibles en las instrucciones, ya que esta información ya está disponible para el agente. Puede usar / al escribir instrucciones para especificar una herramienta, un tema o una variable específicos o una expresión de Power Fx para el agente. Sin embargo, el agente también usa nombres y descripciones de fuentes de conocimiento o herramientas para determinar qué usar, por lo que no es necesario especificar otros específicos para el agente.

En su lugar, céntrese en agregar instrucciones solo para los casos en los que desea proporcionar las sugerencias del agente cuando la herramienta o el origen de conocimiento adecuados pueden ser ambiguos. También puede proporcionar una instrucción que haga referencia a varias herramientas u orígenes de conocimiento.

Use the FAQ documents only if the question is not relevant to Hours, Appointments, or Billing.
Only use the ticket creation topic for creating tickets.
For other requests related to fixing issues, use the troubleshooting topic.

Ayudar al agente a elegir las fuentes de conocimiento adecuadas

Para ayudar a que su agente obtenga con éxito información de fuentes de conocimientos, asegúrese de explicar qué documentos debe buscar el agente en las instrucciones. Por ejemplo, "busca en tu base de conocimientos el documento de incorporación de empleados". Aunque este tipo de especificidad no es estrictamente necesaria, puede ser útil para guiar a su agente. Este tipo de especificidad es útil cuando hay numerosos documentos que el agente necesita buscar.

Ayudar al agente a elegir la secuencia correcta de herramientas

El agente intenta seleccionar la herramienta correcta y, por lo general, se realiza correctamente, pero ayuda a ser explícito en las instrucciones. Por ejemplo, si desea que el agente cree un registro de pedido de compra en Dataverse mediante la herramienta create order, use / y agregue esa herramienta específica a las instrucciones. En este escenario, se proporciona una instrucción clara: "Cuando el usuario ha proporcionado detalles de su portátil preferido, cree un pedido de compra mediante /Pedido de compra". Esta especificidad es útil cuando hay numerosas herramientas (más de cinco) agregadas al agente.

Enumere o presente en forma de lista (con viñetas) sus instrucciones y especifique que el agente debe seguirlas en el orden indicado. También puede utilizar el formato Markdown para mejorar la legibilidad de sus instrucciones y facilitar que la IA generativa las comprenda y las procese.

Al asignar un nombre a una herramienta en las instrucciones, asegúrese de usar exactamente el mismo nombre que la propia herramienta. Las ligeras diferencias en la nomenclatura pueden afectar negativamente a los resultados. Además, asegúrate de usar el / en la construcción del nombre específico de la herramienta (/"Tool_Name").

Si necesita que su agente sea muy específico al responder a la entrada del usuario, podría ser apropiado crear un tema para manejar este caso de uso en particular. Por ejemplo, crear un tema que reconozca frases similares a "¿hay otras opciones disponibles?" Luego, el agente responde específicamente: "No hay otras opciones disponibles actualmente, seleccione de la lista disponible".

El agente usa la descripción de la herramienta para comprender por qué usar esa herramienta. Rellenar la descripción de la herramienta ayuda a que el agente elija la herramienta adecuada. Añada una descripción que indique al agente cuándo debe recurrir a una herramienta concreta, por ejemplo: "Recurra a esta herramienta cuando el usuario solicite consultar el historial de reservas del cliente".

Los desencadenadores pueden ser vulnerables ante ataques de jailbreak. Este tipo de ataque es aquel en el que un atacante envía instrucciones para que el agente las siga en la carga del activador del ataque. Por ejemplo, el atacante podría pedir al agente que envíe por correo electrónico la información a la que puede acceder el agente.

Para proteger al agente contra este riesgo, asegúrese de que sus instrucciones incluyen la siguiente información:

• Limite las herramientas que debe tomar el agente al hacer referencia a orígenes de conocimiento. Por ejemplo, solo envíe información por correo electrónico después de verificar el contexto de una fuente de conocimiento.

• Limite los parámetros que el agente debe utilizar para las herramientas. Por ejemplo, solo envíe un correo electrónico a una lista específica de personas.

Si observa que el agente bloquea el comportamiento normal con el filtrado de contenido, puede actualizar las instrucciones del agente para indicar que se espera que el comportamiento funcione.

Ayudar a que el agente rellene las entradas de las herramientas

El agente puede llamar a una herramienta que tenga parámetros de entrada que deben rellenarse. En este caso, el agente usa el historial de conversaciones y las llamadas anteriores a herramientas y orígenes de conocimiento para determinar cuáles deben ser las entradas. Si el agente no identifica todas las entradas, le pide al usuario que ayude a completar la información que falta.

En este escenario, primero asegúrese de configurar las entradas para su agente en función de los tipos de interacciones que espera que maneje su agente. Luego, solo en situaciones en las que el agente debe completar la mejor entrada disponible, usa las instrucciones para ayudar a completar las entradas.

Use the email address from the contact field of the lead when helping the user to draft an email to follow-up on a lead.

Ayudar al agente a generar una respuesta

En primer lugar, use instrucciones para indicar a su agente cuándo no debe responder. El agente genera una respuesta después de realizar llamadas a herramientas u orígenes de conocimiento pertinentes para el escenario actual. Si activa la opción Permitir respuestas sin fundamento en la sección de Conocimiento de la configuración de IA generativa de su agente, el agente puede generar una respuesta sin llamar a ninguna herramienta ni fuente de conocimientos.

He aquí un ejemplo de cómo utilizar las instrucciones para las barandillas:

Only respond to messages that are relevant to Contoso corporation and ordering coffee. 
Otherwise, tell the user you can't help with their inquiry.

Si no desea que su agente aborde un tema concreto, añada un tema para esta situación con una respuesta redactada manualmente. Este método evita tener que confiar solo en las instrucciones para evitar ese tema.

En segundo lugar, proporcione instrucciones al agente sobre cómo debe formatear o estructurar las respuestas. Por ejemplo:

Always give responses about order status in a table format.

Si quiere que su agente sea profesional y hable con cortesía, no es necesario que le de instrucciones para este tono, ya que es el comportamiento predeterminado del agente. Solo dé instrucciones de tono para casos de uso específicos.

Instrucciones basadas en conversación

El siguiente ejemplo muestra cómo dar formato a instrucciones basadas en conversación, utilizando una construcción de restricciones, formato de la respuesta y orientación. Combine estos tres elementos en uno para proporcionar un conjunto completo de instrucciones para el agente.

Limitaciones

Only respond to requests to provide information about educational, legal, wellness, wellbeing, health, dental care, and newborn benefits for employees and dependents. 
Respond to benefit types with details, health plan comparisons available for employees and dependents in tabular format.
Answer in bold and underline fonts as necessary.

Formato de respuesta

Respond to inquiries by providing benefit types along with details, health plan comparisons available for employees and dependents in tabular format. 
Add a column for available options. 
Include insurance provider details and provide a link for enrollment. 
Answer in bold and underline fonts as necessary.

Orientación

Search only within specific country folders relevant to the employee's country.

Instrucciones autónomas

El siguiente gráfico ilustra los pasos dados por un agente basados en instrucciones autónomas:

Instrucciones y comportamiento del agente

Use las instrucciones del agente de Copilot Studio para influir en el resumen de respuestas después de la recuperación de documentos. Los siguientes conceptos erróneos comunes y procedimientos recomendados le ayudan a diseñar experiencias de agente fiables.

Comportamiento de la tarjeta adaptable

Las instrucciones del agente no pueden modificar cómo se desencadenan las tarjetas adaptables.

En su lugar, si usa tarjetas adaptables:

• Edite la tarjeta adaptable directamente.
• Ajuste las frases de desencadenador dentro de la configuración de la tarjeta para controlar cuándo aparece.

Use preguntas de seguimiento

Utilice preguntas de seguimiento para aclarar la intención, recopilar datos faltantes e identificar acciones o conocimientos relevantes. Cuando utiliza este enfoque, el agente hace la pregunta adecuada siguiente según lo que puede hacer y lo que sabe en ese momento.

Se aplican las siguientes advertencias al utilizar preguntas de seguimiento:

• Si la configuración Permitir respuestas no fundamentadas está desactivada, las preguntas de seguimiento no funcionan.
• Si desactiva esta configuración, el orquestador considera que las preguntas de aclaración que no tienen una cita no están fundamentadas y las suprime. El agente tiene como valor predeterminado la siguiente respuesta: "Lo siento, no estoy seguro de cómo ayudar con eso. ¿Puede intentar decirlo de otra forma?"

Los agentes pueden anticipar las necesidades del usuario y sugerir el siguiente paso lógico según las herramientas y conocimientos de los que disponen. Por ejemplo, un agente que responde "¿Cuál es el tiempo hoy en Roma?" puede ofrecer "¿Te gustaría conocer el pronóstico para mañana también?" y luego actuar según el "sí" del usuario sin aclaraciones adicionales.

Este enfoque reduce los caminos de diálogo codificados de forma fija. En cambio, traslada la carga de la creación de todas las ramas posibles a guiar el razonamiento del agente con instrucciones que hacen referencia a las capacidades del agente.

Al usar preguntas de seguimiento, siga esta estrategia:

• Referencia herramientas, conocimientos y variables en las instrucciones para que el agente pueda usarlas y generar preguntas de seguimiento contextuales. Las instrucciones permiten referenciar directamente agentes, variables, herramientas, conocimientos y expresiones de Power Fx.

• Pida al agente que concluya las respuestas con preguntas de seguimiento relevantes al contexto actual y a las herramientas activas del agente. Este enfoque permite un comportamiento adaptativo en lugar de flujos fijos y frágiles.

• Mantenga los ejemplos y el razonamiento visibles en las instrucciones para que el agente aprenda el patrón esperado (qué preguntar y por qué). Listar las herramientas disponibles mejora la relevancia y naturalidad de las preguntas de seguimiento, aunque el orquestador ya sabe qué herramientas están activas.

Cambio del mensaje de reserva predeterminado

Las instrucciones personalizadas no pueden invalidar el mensaje de reserva predeterminado.

El mensaje predeterminado es: "Lo siento, no estoy seguro de cómo ayudar con eso. ¿Puede intentar decirlo de otra forma?"

Para cambiar el mensaje predeterminado:

1. Vaya al tema Alternativo: Temas → Sistema → Alternativo.

2. En el tema Reserva, edite el texto del Mensaje.

Términos ambiguos

Evite frases vagas, como "cuadro de escritura", en instrucciones. Estos tipos de términos son ambiguos para el modelo de lenguaje y pueden provocar un comportamiento impredecible.

Recuperación de búsqueda

Las instrucciones del agente no pueden modificar la lógica de recuperación de búsqueda. Quite las instrucciones que intenten influir en la recuperación de documentos.

Uso compartido de documentos recuperados

No se puede cambiar cómo se comparten los documentos recuperados. El sistema controla este comportamiento.

Incluir un desencadenador

Modifique la carga útil predeterminada del desencadenador para ayudar al agente a comprender qué hacer cuando se invoca el desencadenador. Utilice variables para reducir el tamaño de la carga útil. Cree el desencadenador y, a continuación, edítelo usando Power Automate para seleccionar variables específicas. Por ejemplo, envíe solo el campo de asunto de un correo electrónico recibido, en lugar de toda la carga útil del mensaje.

Puede ser útil decirle al agente qué hacer con la carga útil del desencadenador en las instrucciones del desencadenador. Por ejemplo, si su agente ayuda a los nuevos empleados a incorporarse a su empresa, defina la carga útil del desencadenador como "Incorporar al siguiente empleado". A esta instrucción le sigue el cuerpo del desencadenador, que contiene los detalles del nuevo empleado. Una vez que el agente recibe la carga útil, sigue las instrucciones de agente definidas para la incorporación de empleados.

Múltiples desencadenadores

Puede agregar varios desencadenadores, cada uno con sus propias instrucciones. Estas instrucciones pueden complementar las instrucciones generales del agente o utilizarse para diferentes casos de uso dentro del mismo agente, como la gestión de la incorporación de empleados y los informes de incidentes. Puede ser útil asegurarse de que cada carga útil del desencadenador indique al agente qué hacer cuando se active el desencadenador.

Dar formato a correos electrónicos

Instruya a su agente para que "envíe correos electrónicos con formato de texto enriquecido para el contenido del cuerpo del correo electrónico" o una redacción similar. También puede agregar esta solicitud en la descripción de la herramienta para un énfasis adicional.

Soporte multilingüe

Las instrucciones que solicitan soporte multilingüe pueden funcionar, pero no están garantizadas. La característica multilingüe no se prueba ni se admite oficialmente.

Puntos clave de aprendizaje

• Procure que las instrucciones para los agentes sean lo más sencillas y breves posible.
• Use las instrucciones del agente para el resumen y el flujo conversacional, no para los comportamientos de nivel de sistema.
• Use la configuración de temas para la personalización de tarjetas adaptables y de reserva, confíe en la configuración del tema en lugar de en instrucciones.
• Valide características como la compatibilidad multilingüe antes de prometerlos a los usuarios.

Información relacionada

• Orquestar el comportamiento del agente con IA generativa
• Resumen de orígenes de conocimiento
• Agregar herramientas a agentes personalizados
• Preguntas frecuentes sobre uso de orquestación generativa