Recuperar una lista de resultados

Es habitual pedirle a un agente que busque datos en un sistema externo y le devuelva una lista de resultados. Para hacer eso, un agente puede llamar a un flujo de Power Automate para:

1. Autenticarse y conectarse a una solución externa.
2. Ejecutar una consulta basada en la entrada de usuario.
3. Formatear los resultados.
4. Devolver los resultados al agente.

Este ejemplo usa el conector Dataverse en Power Automate para buscar cuentas. El conector devuelve una lista de resultados que incluye el nombre de la cuenta, la ciudad y el número de cuenta al agente.

Requisitos previos

• Comprender cómo crear un flujo a partir del lienzo de creación de Copilot Studio
• Usar variables para la entrada y salida de información
• Configurar la búsqueda de Dataverse para su entorno

Configurar una tabla de cuentas de Dataverse

La tabla Cuenta es una tabla estándar disponible de forma predeterminada en entornos Power Platform. Sin embargo, no viene con los datos de la cuenta. Antes de que su agente pueda buscar cuentas, debe rellenar la tabla Cuenta.

Si ya tiene una tabla de cuentas con datos, omita este paso y continúe con Crear un tema. Sin embargo, recuerde usar términos de búsqueda relevantes para los datos al probar el agente en pasos posteriores.

1. Vaya a Portal de Power Apps.

2. En el panel de navegación, seleccione Tablas.

3. Seleccione la tabla Cuentas y luego seleccione la página de propiedades de la tabla y seleccione Editar.

4. Añada las siguientes filas a la tabla:

   Dirección 1: Ciudad	Nombre de cuenta	Número de cuenta
   Pontevedra	Contoso Inc	AC0125
   San Francisco	Contoso Residences	AC0255
   Olympia	Contoso Meal Delivery	AC0035

Crear un tema

1. En Copilot Studio, vaya a la página Temas de su agente.

2. Crear un tema llamado Búsqueda de cuentas.

3. Agregue las siguientes frases desencadenadoras:

   • Estoy buscando un cliente
   • Estoy buscando una cuenta
   • buscar cuenta
   • buscar cliente

4. Agregue un nodo Mensaje e introduzca el mensaje «Parece que estás buscando una cuenta. Puedo buscarlo por ti."

5. Agregue un nodo Pregunta e ingrese el mensaje «¿Cómo se llama el cliente que estás buscando?»

6. En Identificar, seleccione Organización.

   La respuesta completa del usuario también funcionaría. Sin embargo, al seleccionar la entidad Organización, aprovecha las capacidades de comprensión del lenguaje del agente para extraer el nombre de la organización de la respuesta.

7. En Guardar respuesta del usuario como, cambie el nombre de la variable a «organización».

   

Crear un flujo de

1. Seleccione el icono Agregar nodo debajo de cualquier nodo y seleccione Agregar una herramienta.

2. En la pestaña Acciones básicas, seleccione Nuevo flujo de agente. La pestaña Diseñador de flujos de agente se abre con una plantilla inicial para un flujo de agente llamado por un agente. El flujo incluye dos acciones: Cuando un agente llama al flujo y Responder al agente.

3. Seleccione Publicar para guardar el flujo antes de realizar cambios. Aparece una notificación cuando el flujo se crea correctamente.

4. Seleccione Volver al agente para volver al tema. Se agrega un nuevo nodo Acción al tema para el flujo.

5. Seleccione Guardar para terminar de agregar el flujo como una herramienta al agente.

Editar como detalles del flujo

1. En el nodo Acción con el flujo, seleccione el vínculo Ver detalles del flujo para volver al flujo del agente.

2. En la pestaña Información general del flujo, edite los detalles del flujo y reemplace el nombre por Buscar cuenta. Seleccione Guardar.

3. Regrese a la pestaña Diseñador. Seleccione el desencadenador de flujo Cuando un agente llama al flujo y agregue un parámetro de entrada de Texto denominado Organización.

   

4. Seleccione el icono Añadir situado debajo del activador Cuando un agente llama al flujo.

5. En Agregar una acción, busque "Microsoft Dataverse" y seleccione la acción Buscar filas.

   Esta acción utiliza coincidencias aproximadas para encontrar cuentas relevantes en su tabla de cuentas de Dataverse.

6. En el cuadro Términos de búsqueda, escriba una barra diagonal (/), seleccione Insertar contenido dinámico y, a continuación, seleccione el parámetro de entrada de su Organización.

7. En Parámetros avanzados, seleccione Mostrar todo y defina los siguientes valores:

   • Elemento de filtro de tabla: account
   • Ordenar por artículo - 1: search.score desc
   • Ordenar por artículo - 2: name asc

   

Dar formato a resultados

La acción Buscar filas devuelve la variable Lista de filas, que contiene datos JSON. Antes de utilizar los datos, debe analizarlos con la acción Analizar JSON.

1. Seleccione el icono Agregar debajo de la acción Buscar filas.

2. En Agregar una acción, busque «Operación de datos» y seleccione la acción Parse JSON.

3. En el cuadro Contenido, escriba una barra diagonal (/), seleccione Insertar contenido dinámico y, a continuación, seleccione Lista de filas.

4. Copie el siguiente esquema JSON y péguelo en el recuadro Esquema:

   {
       "type": "array",
       "items": {
           "type": "object",
           "properties": {
               "@@search.score": {
                   "type": "number"
               },
               "name": {
                   "type": "string"
               },
               "address1_city": {
                   "type": "string"
               },
               "accountnumber": {
                   "type": "string"
               }
           },
           "required": [
               "name"
           ]
       }
   }
   

   

5. Seleccione el icono Agregar situado debajo de la acción Parse JSON.

6. En Agregar una acción, busque «Variable» y seleccione la acción Inicializar variable.

7. En el cuadro Nombre, introduzca «ListOfAccounts».

8. En Tipo, seleccione Cadena.

   

9. Seleccione el icono Agregar debajo de la acción Inicializar variable.

10. En Agregar una acción, busque «Control» y seleccione la acción Aplicar a cada.

11. En el cuadro Seleccionar una salida de pasos anteriores, escriba una barra oblicua (/), seleccione Insertar contenido dinámico y, a continuación, seleccione la variable Body en Parse JSON.

12. Seleccione el icono Agregar dentro de la acción Aplicar a cada.

13. En Agregar una acción, busque «Variable» y seleccione la acción Anexar a variable cadena.

14. Para Nombre, seleccione ListOfAccounts.

15. Copie el siguiente texto y péguelo en el recuadro Valor:

    - @{items('Apply_to_each')['accountnumber']}: @{items('Apply_to_each')['name']} - @{items('Apply_to_each')['address1_city']}
    

16. Agregue un salto de línea después del fragmento de código para que cada resultado aparezca en su propia línea.

    

17. En la acción Responder al agente, agregue una salida de Texto.

18. Para Nombre, escriba «FoundAccounts».

19. Para el valor, escriba una barra (/) en el cuadro, seleccione Insertar contenido dinámico y luego seleccione la variable ListOfAccounts.

    

20. Guarde y publique su flujo. Copilot Studio le informa cuando se publica el flujo del agente.

21. Seleccione Volver al agente para volver al editor de temas del agente. El nuevo flujo de acción se añade al tema.

Llame al flujo desde Copilot Studio

1. Seleccione el nuevo nodo de acción.

2. Establezca el parámetro de entrada de flujo en la variable de salida del nodo Pregunta: Organización (cadena) obtiene su valor de la variable organización.

3. Agregue un nodo Mensaje e ingrese el mensaje «Bien, esto es lo que encontré».

4. Agregue un segundo nodo Mensaje. Seleccione el icono Insertar variable y después seleccione FoundAccounts.

   

5. Seleccione Guardar.

6. Pruebe el agente.