Llamar a una acción para extraer datos de Dataverse for Teams
Con el nodo Llamar a una acción, los agentes pueden interactuar con flujos de Power Automate. Puede usar estos flujos para desencadenar procesos automatizados o conectarse con datos de Dataverse for Teams, Listas Microsoft u otros orígenes de datos.
Por ejemplo, el agente Event Contacts podría proporcionar los miembros del equipo del Sales Project desde una tabla de Dataverse for Teams. En lugar de editar el agente cuando se realizan cambios en este equipo, simplemente puede actualizar la tabla.
Paso 1: Crear una tabla de Dataverse for Teams
Para crear una tabla de Dataverse for Teams, siga estos pasos:
Cree una nueva tabla de Dataverse for Teams en el mismo equipo que el agente. Recuerde que tendrá que crearlo usando Power Apps para Teams. En Power Apps para Teams, seleccione la pestaña Crear y luego elija su equipo.
Seleccione Ver todo debajo de Elementos creados para [el nombre de su equipo] para que aparezca la lista de Soluciones de equipo. La lista de Soluciones de equipo incluye todas las aplicaciones, agentes, flujos de nube, tablas, etc. que se han integrado en Dataverse for Teams para el equipo seleccionado. Si ha seleccionado el mismo equipo en el que creó su agente Event Contacts, lo verá en la lista de Soluciones.
En la cinta de opciones de Solución de equipo en la parte superior, seleccione Nuevo>Tabla.
Dele a la tabla el nombre Sales Project Team y seleccione Guardar. Las columnas y tipos de datos que se deben utilizar son los siguientes:
| Columna | Tipo de datos |
|---|---|
| Nombre | Texto |
| Dirección de correo electrónico | Correo electrónico |
Deberá agregar la columna Dirección de correo electrónico a su tabla antes de continuar con el siguiente paso.
Agregue nuevas filas para cada uno de los cuatro contactos.
Nombre Dirección de correo electrónico Joseph Price JosephP@contoso.com Nathan Rigby NathanR@contoso.com Amber Rodriguez AmberR@contoso.com Monica Thomson MonicaT@contoso.com Cuando esté completa, vuelva a Microsoft Copilot Studio para Teams.
Paso 2: Crear un tema de agente con un paso de acción
Para agregar una acción, siga estos pasos:
En Microsoft Copilot Studio para Teams, seleccione la pestaña Agentes de la cinta de opciones; luego, busque y seleccione su agente Event Contacts para abrirlo.
Vaya a su lista de datos de Temas.
Seleccione Nuevo tema>Desde cero en la cinta de opciones de Temas para crear un nuevo tema. Para dar un nombre al tema, seleccione Detalles en la cinta de opciones. Introduzca "Equipo del Sales Project" en el campo Nombre.
Seleccione Frases desencadenadoras e introduzca cada una de las siguientes; pulse + después de cada entrada:
sales project teamsales project infosales team infosales project memberssales project infoEn el lienzo de creación dentro del nodo Mensaje, introduzca:
Let me look up the Sales Project Team!
Ahora, seleccione el botón Guardar de la cinta de opciones para guardar su tema. Cualquier cambio que no haya guardado en este momento podría perderse cuando cambie a Power Automate para crear el flujo.
Agregue un nuevo nodo después del nodo Mensaje y, a continuación, seleccione Llamar a una acción > Crear un flujo. Copilot Studio podría presentarle un cuadro de opción para recordarle que guarde su tema antes de salir. Si ya lo ha guardado, seleccione Salir. Esta acción abre el Power Automate Studio dentro de Copilot Studio.
Hay algunas plantillas comunes disponibles que puede elegir inmediatamente. Cada plantilla le permite pasar información al flujo cuando se desencadena. Cuando el flujo termina, puede pasar información de vuelta al agente. Si quiere ver más opciones de plantilla, puede seleccionar Ver más plantillas. Son interesantes algunas como:
Plantilla de flujo de Copilot Studio: esta plantilla solo tiene los pasos para recibir y enviar información al agente.
Enviar un mensaje a un canal de Teams: desencadena un mensaje de Teams desde el agente.
Enviar una tarjeta adaptable a un canal de Teams: desencadena una tarjeta adaptable para proporcionar información en un canal de Teams.
Seleccione la que tiene el nombre Plantilla de flujo de Copilot Studio. Mientras lo hace, el desencadenador será Copilot Studio, y tendrá un paso debajo llamado Devolver valores a Copilot Studio.
Cambie el nombre del flujo a Get Sales Team Members.
Cree una variable para que contenga la información que desea proporcionar al agente. Entre el desencadenador y el paso del valor de retorno, mueva el cursor hacia la flecha y seleccione el icono Insertar nuevo paso, que aparecerá al pasar el cursor sobre ese espacio, y seleccione Agregar una acción.
En el cuadro de búsqueda, escriba "variable" y, a continuación, debajo de Acciones, seleccione Inicializar variable.
Escriba "varContactInfo" como Nombre y, a continuación, seleccione Cadena como tipo. Deje el Valor en blanco.
Ahora necesitamos un paso para acceder a los datos de Dataverse desde Teams. Bajo el nuevo paso Inicializar variable, seleccione el icono Insertar nuevo paso y seleccione Agregar una acción. Busque el conector Microsoft Dataverse y luego seleccione Enumerar filas como desencadenador.
Para Nombre de tabla, seleccione Sales Project Team de la lista desplegable. (Puede introducir "sales" en el campo de entrada para filtrar la lista rápidamente).
La acción Enumerar filas extrae todas las filas de la tabla en una matriz. Una matriz es una tabla. Para agregar datos a nuestra variable de cadena, debe revisar cada fila de la tabla y agregar cada fila de datos a su variable varContactInfo. Así es como pasaremos estos datos a Microsoft Copilot Studio.
Seleccione el icono Insertar nuevo paso después de Enumerar filas. Seleccione Agregar una acción.
En el cuadro de búsqueda, escriba Control y, luego, bajo Acciones, seleccione Aplicar a cada uno.
En el campo Seleccionar una salida de los pasos anteriores, selecciónelo para agregar contenido dinámico. Luego, seleccione valor debajo de la acción Enumerar filas de Dataverse.
Seleccione Agregar una acción en el paso Aplicar a cada uno para continuar.
En el cuadro de búsqueda Elegir una operación, escriba variable y, luego, bajo Acciones, seleccione Anexar a la variable de cadena.
En el paso Anexar a la variable de matriz, seleccione varContactInfo para el Nombre.
Para el Valor, vamos a crear una lista de viñetas con varias líneas (con datos de cadena), con el nombre y el correo electrónico de cada persona. Power Automate usa la sintaxis Markdown al dar formato al texto. Para indicar una lista con viñetas en Markdown, necesita usar el carácter de asterisco * al comienzo de la línea. (Para obtener más información sobre Markdown, consulte la sección Resumen al final de este módulo).
En el cuadro de texto Valor:
Introduzca un asterisco * y luego agregue un espacio.
Bajo el contenido dinámico de Enumerar filas, seleccione Name y luego agregue un espacio.
En el contenido dinámico de Enumerar filas, seleccione Dirección de correo electrónico.
Presione Entrar para empezar una nueva línea.
Hemos terminado con este paso.
Seleccione el paso Devolver valores a Microsoft Copilot Studio al final del flujo y luego seleccione + Agregar una salida.
Seleccione Texto como tipo de salida.
En el cuadro de texto Introducir título, escriba ContactData.
Para el campo Escriba un valor para responder, seleccione el campo de entrada y luego seleccione varContactInfo bajo la sección Variables.
Su flujo ahora debe parecerse a la siguiente imagen:
Seleccione Guardar en la cinta de opciones de Power Automate para terminar de editar el flujo. Power Automate ejecuta automáticamente el Comprobador de flujo para buscar cualquier problema. Podría ver una advertencia sobre "…consultas de filtro OData…", que se puede ignorar. Puede usar filtros OData para limitar los datos que su paso Enumerar filas extrae, pero solo tenemos unas pocas filas en nuestro origen de datos, por lo que no es necesario un filtro. Seleccione Cerrar para salir de Power Automate y volver al editor del agente.
En el editor de agentes, consulte su paso Acción. Debería ver el flujo que acaba de crear: Get Sales Team Members como acción y la variable de cadena ContactData que creó enumerada como salida.
Agregue un paso Mostrar un mensaje después del nodo Acción.
Haga clic dentro del cuadro de texto para abrir el menú. Seleccione ContactData bajo Insertar variable {X}.
Seleccione Guardar en la cinta de opciones de edición de temas y espere a que se guarde el tema. Si el panel Probar bot no está visible, seleccione la opción de menú Probar el bot de chat.
En la parte superior del panel Probar chatbot, asegúrese de que la opción Seguimiento entre temas esté activada.
Escriba una de las frases desencadenadoras para probar el agente de Sales Project Team. El agente de prueba ofrecerá una lista con viñetas de los cuatro nombres y direcciones de correo electrónico de su Sales Project Team.
Enhorabuena Ha creado un método para que su agente obtenga información de las tablas de datos a través de un flujo de Power Automate integrado.