Compartir a través de

Recuperar una lista de resultados

  • Artículo

Importante

Las capacidades y características de Power Virtual Agents son ahora parte de Microsoft Copilot Studio tras importantes inversiones en IA generativa e integraciones mejoradas en Microsoft Copilot.

Algunos artículos y capturas de pantalla pueden hacer referencia a Power Virtual Agents mientras actualizamos la documentación y el contenido de capacitación.

Es común pedirle a un copiloto que busque datos en un sistema externo y devuelva una lista de resultados. Para hacer eso, Microsoft Copilot Studio puede llamar a un flujo de Power Automate para:

  • Autenticarse y conectarse a una solución externa
  • Ejecutar una consulta basada en las entradas del usuario
  • Formatear los resultados
  • devuelve los resultados al copiloto

En este ejemplo, utilizará el conector Dataverse en Power Automate para buscar cuentas. Luego, devolverá una lista de resultados que incluya el nombre de la cuenta, la ciudad y el número de cuenta para Microsoft Copilot Studio.

Requisitos previos

Configurar una tabla de cuentas de Dataverse

La tabla de cuentas es una tabla estándar que se incluye automáticamente en los entornos Power Platform. Sin embargo, no viene con los datos de la cuenta. Antes de que su copiloto pueda buscar cuentas, deberá completar la tabla Cuenta.

Si ya tiene una tabla de cuentas con datos, omita este paso y continúe con Crear un tema. Sin embargo, deberá utilizar diferentes términos de búsqueda cuando pruebe su copiloto en pasos posteriores.

  1. Vaya al portal de Power Apps.

  2. En el panel lateral, bajo Dataverse, 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. Vaya a la página Temas de su copiloto.

  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 ingrese el mensaje Parece que está buscando una cuenta. Puedo buscarla yo.

  5. Añada un nodo Pregunta e ingrese el mensaje ¿Cómo se llama el cliente que está buscando?.

  6. En Identificar, seleccione Organización.

    Respuesta completa del usuario también funcionará. Sin embargo, al seleccionar la entidad Organización se aprovechan las capacidades de comprensión del idioma del copiloto para extraer el nombre de la organización de la respuesta.

    Captura de pantalla de un nuevo tema con un nodo de mensaje y pregunta.

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

Creación de un flujo

  1. En el lienzo de creación, seleccione Agregar nodo (+). Seleccione Llamar una acción y seleccione Crear un flujo.

  2. En el portal Power Automate, asigne un nombre al flujo Buscar cuenta.

  3. Añada una entrada Texto con el nombre Organización.

    Captura de pantalla del desencadenador de flujo con una entrada de texto añadida.

  4. Seleccione Insertar un paso nuevo (+) y Agregar una acción.

  5. Seleccione el conector Microsoft Dataverse y la acción Buscar filas.

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

    Captura de pantalla de la acción Buscar filas en el conector de Dataverse.

  6. Para Término de búsqueda, seleccione la variable Organización.

  7. Seleccione Mostrar opciones avanzadas y establezca los siguientes elementos como se indica:

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

    Captura de pantalla de acciones Buscar filas con opciones avanzadas configuradas.

Dar formato a resultados

La acción Buscar filas devuelve la variable Lista de filas, que contiene datos JSON. Antes de que pueda usar los datos, deberá analizarlos con la acción Analizar JSON.

  1. Seleccione Insertar un paso nuevo (+) y Agregar una acción.

  2. Seleccione el conector Operación de datos y seleccione la acción Analizar JSON.

  3. En el recuadro Contenido, bajo Buscar filas, seleccione la variable 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"
        ]
    }
}

    Captura de pantalla del esquema JSON ingresado en el nodo Analizar JSON.

  5. Seleccione Insertar un paso nuevo (+) y Agregar una acción. Seleccione el conector Variable y seleccione la acción Inicializar variable.

  6. Para Nombre, introduzca ListOfAccounts. En Tipo, seleccione Cadena.

    Captura de pantalla de la acción Inicializar variable.

  7. Seleccione Insertar un paso nuevo (+) y Agregar una acción. Seleccione el conector Control y seleccione la acción Aplicar a cada uno.

  8. Seleccione el recuadro Seleccionar una salida de pasos anteriores para abrir el menú Contenido dinámico. Busque cuerpo y, bajo Analizar JSON, seleccione la variable Cuerpo.

  9. Seleccione Insertar un paso nuevo (+) y Agregar una acción. Seleccione el conector Variable y seleccione la acción Anexar a variable cadena.

  10. Para Nombre, seleccione ListOfAccounts. 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']}

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

    Captura de pantalla de la acción Aplicar a cada uno.

  12. En la acción Devolver valores a Microsoft Copilot Studio, añada una salida Texto. Para Nombre, introduzca FoundAccounts. Para Valor, seleccione ListOfAccounts.

    Captura de pantalla de la acción Devolver valores a Microsoft Copilot Studio.

  13. Seleccione Guardar.

Llamar al flujo de Microsoft Copilot Studio

  1. En el lienzo de creación de Microsoft Copilot Studio, seleccione Agregar nodo (+) y luego seleccione Llamar a una acción.

  2. Seleccione el flujo que ha creado anteriormente, Buscar cuenta.

  3. En La organización obtiene valor de, seleccione la variable organización.

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

  5. Agregue un segundo nodo Mensaje. Seleccione Insertar variable y, a continuación, FoundAccounts.

    Captura de pantalla de una conversación con un copiloto que respondió con una lista de cuentas encontradas.

  6. Seleccione Guardar.

  7. Pruebe su copiloto en el panel Probar copiloto.

    Captura de pantalla de la conversación del copiloto en el panel Probar copiloto.