Guía de instrucciones 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:

• Las instrucciones se utilizan cuando el agente decide qué herramienta o conocimiento podría ser necesario invocar para abordar una consulta de un usuario o un desencadenante autónomo.

• Las instrucciones también se usan para rellenar entradas para cualquier herramienta en función del contexto disponible.

• Las instrucciones se utilizan cuando el agente genera una respuesta para el usuario final.

Instrucciones de contexto

Es importante comprender que los agentes no pueden actuar sobre instrucciones para usar herramientas o búsquedas de origen de conocimiento si el agente no tiene esas herramientas ni orígenes de conocimiento. Debe configurar primero su agente con las herramientas y fuentes de conocimiento adecuadas. 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.

Instrucciones basadas en conversación

El siguiente ejemplo ilustra cómo dar formato a instrucciones basadas en conversación, utilizando una construcción de restricciones, formato de la respuesta y orientación. Los tres se combinan 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.

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 el origen de conocimiento adecuados para el agente, asegúrese de que cada herramienta y origen de conocimiento 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. Además, 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 el origen 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. El agente también utiliza los nombres y descripciones de las herramientas o fuentes de conocimiento para determinar cuál usar, por lo que no es necesario especificar opciones específicas para el agente.

En su lugar, céntrese en agregar instrucciones solo para los casos en los que desea dar algunas pistas al agente cuando la herramienta o el origen de conocimiento adecuados puedan ser ambiguos. También puede proporcionar una instrucción que haga referencia a varias herramientas o 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 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, usa el historial de conversaciones y las llamadas anteriores a herramientas y orígenes de conocimiento para determinar cuáles deben ser las entradas. En caso de que no identifique 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, puede utilizar instrucciones para indicar a su agente cuándo no debe responder. El agente generará una respuesta después de realizar llamadas a herramientas o orígenes de conocimiento pertinentes para el escenario actual. Si ha activado Permitir que la inteligencia artificial use su propio conocimiento general (versión preliminar), el agente puede generar una respuesta sin llamar a ninguna herramienta o origen de conocimiento.

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 tiene un tema específico que no desea que su agente trate, puede agregar un tema para este escenario con una respuesta creada manualmente. Este método evita tener que confiar solo en las instrucciones para evitar ese tema.

En segundo lugar, puede dar 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 autónomas

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

Ayudar al agente a elegir la secuencia correcta de herramientas

El agente intenta seleccionar la herramienta correcta y, por lo general, suele tener éxito, pero ayuda ser explícito en tus instrucciones. Por ejemplo, si desea que el agente cree un registro de pedido de compra en Dataverse mediante la herramienta "crear pedido", 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 /Purchase Order". Esta especificidad es útil cuando hay numerosas herramientas (más de cinco) agregadas al agente.

Numere o enumere sus instrucciones y especifique que deben seguirse en orden. También puede aplicar el formato markdown, que no solo mejora la legibilidad de sus instrucciones, sino que también puede ayudar a la IA generativa a comprender y procesar sus instrucciones.

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.

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 significativamente a que el agente elija la herramienta adecuada. Rellene la descripción de la herramienta para informar al agente de cuándo llamar a una herramienta específica, como "llamar a esta herramienta cuando el usuario pida que recupere el historial de reservas de clientes".

Los desencadenadores podrían ser susceptibles a 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 se deben usar 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.

Lenguaje para redactar instrucciones

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

Los siguientes verbos se usan comúnmente para crear instrucciones simples:

Ayudar al agente a elegir las fuentes de conocimiento adecuadas

Para ayudar a garantizar que su agente recupere correctamente la información de las fuentes de conocimiento, asegúrese de explicar qué documentos debe buscar en las instrucciones, como "busque en su base de conocimientos el documento de incorporación de empleados". Si bien este tipo de especificidad no es estrictamente necesaria, puede ser útil para guiar a su agente. Esta especificidad es útil cuando hay numerosos documentos que el agente necesita buscar.

Incluir un 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.

Instrucciones y comportamiento del agente

Las instrucciones del agente en Copilot Studio pueden usarse para influir en el resumen de la respuesta tras la recuperación del documento. Se enumeran los siguientes conceptos erróneos comunes y mejores prácticas para ayudarte a diseñar experiencias fiables para los agentes.

Comportamiento adaptativo de la tarjeta

Las instrucciones del agente no pueden modificar cómo se activan las Tarjetas Adaptativas .

En su lugar, si usas Cartas Adaptativas:

• Edita directamente la tarjeta adaptativa.
• Ajusta las frases de disparo dentro de la configuración de la tarjeta para controlar cuándo aparece.

Usa preguntas de seguimiento

Utiliza preguntas de seguimiento para aclarar la intención, recopilar las entradas que faltan y sacar a la luz acciones o conocimientos relevantes. Esto permite al agente hacer la siguiente pregunta correcta a continuación, basándose en lo que puede hacer y lo que sabe en tiempo de ejecución.

Para usar preguntas de seguimiento, se aplican las siguientes advertencias:

• Las preguntas de seguimiento solo funcionan cuando está activado Usar conocimientos generales .
• Si Usar conocimientos generales está desactivado, el orquestador considera que las preguntas aclaratorias que no tienen cita son fundamentadas y las suprime. El agente responde por defecto a la siguiente: "Lo siento, no sé cómo ayudar con eso. ¿Puede intentar decirlo de otra forma?"

Los agentes pueden anticipar las necesidades de los usuarios y sugerir el siguiente paso lógico basándose en las herramientas y conocimientos que disponen. Por ejemplo, un agente que responda "¿Qué tiempo hace hoy en Roma?" puede ofrecer "¿Quieres saber también la previsión para mañana?" 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 crear todas las ramas posibles a guiar el razonamiento del agente con instrucciones que hacen referencia a sus capacidades.

Al usar preguntas de seguimiento, sigue esta estrategia:

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

• Pide al agente que concluya las respuestas con preguntas de seguimiento relevantes para el contexto actual y las herramientas activas del agente. Esto permite un comportamiento adaptativo en lugar de flujos fijos y frágiles.

• Mantén 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 sepa qué herramientas están activas.

Cambiar el mensaje de respaldo predeterminado

Las instrucciones personalizadas no pueden anular el mensaje de respaldo por defecto.

El mensaje por defecto es: "Lo siento, no sé cómo ayudar con eso. ¿Puede intentar decirlo de otra forma?"

Para cambiar el mensaje por defecto:

1. Navega al tema de respaldo : Temas → sistema → respaldo.

2. Dentro del tema de Respaldo , edita el texto del Mensaje .

Términos ambiguos

Evita frases vagas, como "cuadro de escritura", en las instrucciones. Este tipo de términos son ambiguos para el modelo de lenguaje y pueden conducir a comportamientos impredecibles.

Recuperación de búsqueda

Las instrucciones del agente no pueden modificar la lógica de recuperación de búsqueda. Elimina cualquier instrucción que intente influir en la recuperación de documentos.

Compartición de documentos recuperados

No puedes cambiar cómo se comparten los documentos recuperados. Este comportamiento está controlado por el sistema.

Soporte multilingüe

Las instrucciones que solicitan soporte multilingüe pueden funcionar, pero no están garantizadas. La función multilingüe no está probada ni soportada oficialmente.

Conclusiones clave

• Utiliza instrucciones del agente para resumir y fluir conversacional, no para comportamientos a nivel de sistema.
• Para la personalización de tarjetas de respaldo y adaptativa, confía en la configuración de los temas en lugar de en las instrucciones.
• Valida siempre funciones como el soporte multilingüe antes de prometerlas a los usuarios.

Contenido relacionado

• Orquestar el comportamiento del agente con IA generativa
• Información general de los orígenes de conocimientos
• Uso de herramientas con agentes personalizados
• Preguntas frecuentes sobre uso de orquestación generativa