Compartir por

Uso del intérprete de código para analizar datos estructurados (versión preliminar)

[Este artículo es documentación preliminar y está sujeto a modificaciones].

Mediante el intérprete de código, los agentes de Copilot Studio pueden generar y ejecutar Python código cuando necesiten responder a las solicitudes del usuario. El intérprete de código admite tareas como el análisis estadístico, las combinaciones de tablas, la previsión y la generación de gráficos. Estas tareas funcionan con archivos estructurados como CSV y Excel.

Importante

Este artículo contiene Microsoft Copilot Studio documentación de vista previa y está sujeto a cambios.

Las funciones de vista previa no están diseñadas para un uso en producción y pueden tener funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que pueda tener acceso anticipado y proporcionar comentarios.

Si va a crear un agente listo para producción, consulte Microsoft Copilot Studio Overview.

La propuesta de valor de usar el intérprete de código para analizar archivos de datos estructurados es:

  • Mediante el uso de cálculos deterministas y reproducibles, puede desbloquear análisis fiable dentro de los agentes en lugar de confiar en las capacidades matemáticas e inferenciales inherentes de los grandes modelos de lenguaje para responder a preguntas analíticas.
  • Reduce la barrera de habilidades para análisis avanzados permitiendo a los usuarios hacer preguntas analíticas en lenguaje natural.
  • Genera tablas y visualizaciones de resultados de forma programática que los usuarios puedan ver, descargar y reutilizar.

Copilot Los agentes de Studio pueden usar el intérprete de código para analizar los archivos estructurados que se proporcionan al agente de las dos maneras siguientes:

  • Como usuario final, cuando sube archivos estructurados mientras chatea con el agente.
  • Como creador, al agregar la biblioteca Documents de SharePoint como origen de conocimiento, que a su vez contiene los archivos estructurados.

Requisitos

Escenarios ampliamente probados

Microsoft ha probado ampliamente los siguientes escenarios con un alto nivel de confianza.

Nota:

  • Si el escenario no está entre los escenarios enumerados en las tablas, es posible que siga funcionando. Los escenarios enumerados en las tablas siguientes reflejan el grupo de escenarios que Microsoft probó ampliamente en función del uso previsto del cliente.
  • El límite de tamaño de cada archivo que el intérprete de código puede analizar, independientemente del tipo de archivo, es de 16 MB. Puede cargar un máximo de 10 archivos.

Escenarios para archivos de Excel (.xlsx)

Categoría Descripción del escenario Ejemplo 1 Ejemplo 2 Ejemplo 3
Búsqueda: hoja única Recupere un valor, una etiqueta o un registro específicos de una sola hoja de un archivo de Excel. No se necesita ningún cálculo entre filas. La respuesta existe como una búsqueda directa de celdas o filas. Trata valores numéricos, atributos de texto (nombres, roles, categorías) y marcas de tiempo. ¿Qué equipos incluyen una red lateral con un mínimo de tres goles? ¿Cuál fue el flujo de caja libre en el T4 de 2024? ¿A qué segmento pertenecen los combustibles mayoristas a partir del Q1 2024?

Escenarios para archivos de .csv

Categoría Descripción del escenario Ejemplo 1 Ejemplo 2 Ejemplo 3
Búsqueda: archivo único Recupere un valor, atributo o registro específico de un único archivo CSV. Trata búsquedas de entidades (contactos, aeropuertos, proyectos eólicos), recuperación de valores a un momento dado y búsquedas de tablas pequeñas. No se requiere ninguna agregación entre filas. ¿Quién es el desarrollador del proyecto Sunrise Wind? ¿Cuántas motocicletas se registraron en Tennessee en 1970? ¿Quién posee el aeropuerto Horseshoe Landings en Keenesburg, CO?
Conjunto - archivo único Calcula los totales, recuentos, diferencias, resúmenes agrupados o búsquedas clasificadas dentro de un único archivo CSV. Trata las agregaciones financieras, los recuentos condicionales, las recuperaciones clasificadas (max/min) y los resúmenes de nivel de grupo devueltos como números, texto o tablas. ¿Cuál fue el valor total de regalías de las ventas de petróleo en tierra en 2019? ¿Cuántos camiones más se registraron en California en 2020 que en 2010? ¿Cuáles son los ingresos totales de ventas generados por cada región en enero de 2025?
Búsqueda: varios archivos Combinar o hacer referencia cruzada a varios archivos CSV para recuperar un valor o lista específicos (por ejemplo, buscar inventario mediante la coincidencia de nombres de elementos en una lista de partes, inventario y lista de precios; o consultar datos de emisiones mediante la unión de nombres de sector a un archivo de emisiones principal). ¿Cuántos cortadores de chorros de agua están disponibles en el almacén este? ¿Cuál es el precio educativo de un torno de 10x24? ¿Cuántos bits de perforación de 3/8" están en existencias en el almacén este?
Conjunto de varios archivos Agregue o compare los datos distribuidos entre varios archivos CSV (por ejemplo, sumando las horas de los empleados en los CSV mensuales para un total trimestral, contando ofertas en exportaciones de CSV anuales o clasificando sectores por emisiones entre archivos unidos). ¿Cuántas horas de trabajo totales se registraron en Q3? ¿Cuál fue la hora más temprana que Chris fichó durante julio? ¿Qué sector produjo más CO2 en 2020?

Utiliza un intérprete de código para analizar un archivo de datos estructurados subido por el usuario

  1. En Copilot Studio, seleccione Settings>Generative AI. Bajo Capacidades de procesamiento de archivos, active el interruptor Cargas de archivos.

  2. En Capacidades de procesamiento de archivos, activa el interruptor del intérprete de código .

  3. Haga clic en Guardar.

  4. En el panel de prueba, escriba una consulta que requiera que el agente realice un cálculo mediante datos de un archivo de datos estructurado. Adjunte el archivo de datos a la solicitud.

    Haz una captura de pantalla de un panel de prueba que muestra el prompt que requiere generación y ejecución de código para completarse y la anexión de un archivo de datos estructurado.

Utiliza un intérprete de código para el análisis de un archivo de datos estructurados como fuente de conocimiento de SharePoint

  1. Si el agente aún no tiene un archivo de datos estructurado SharePoint como origen de conocimiento, agredía este archivo SharePoint como origen de conocimiento.

  2. En Copilot Studio, seleccione Settings>Generative AI. En Capacidades de procesamiento de archivos, activa el interruptor del intérprete de código .

  3. En Búsqueda, activa el anclaje de gráfico de inquilinos activando la búsqueda semántica.

  4. Haga clic en Guardar.

  5. Si agregó un archivo SharePoint siguiendo las instrucciones del primer paso, publique el agente.

  6. Pruebe el agente al darle una consulta que requiera que el agente realice un cálculo para responder.

  • Last updated on