Usar el intérprete de código en una solicitud para generar y ejecutar código Python

El Intérprete de Código en Microsoft Copilot Studio y las indicaciones del generador de indicaciones permiten a los creadores crear agentes de inteligencia artificial que:

• Ejecutar código Python para el análisis de datos, el procesamiento de Word, Excel, PowerPoint y archivos PDF y visualizaciones
• Usan modelos de lenguaje para respuestas generativas

Esta característica está adaptada para desarrolladores, analistas de negocios y creadores con poco código. La generación de código y la ejecución se integran perfectamente con el ecosistema de Copilot Studio para crear soluciones eficaces controladas por IA.

Los desarrolladores deben leer Intérprete de código para desarrolladores y revisar el componente de ejemplo Intérprete de código Power Apps Component Framework (PCF) para comprender cómo pueden utilizar el mensaje de Dataverse Predict para incitar solicitudes y procesar las respuestas devueltas.

Requisitos

• Licensing: Microsoft Copilot Studio facturación y licencias. Generación de código y recuento de ejecuciones como características de herramientas de inteligencia artificial generativa (Premium) y texto.

• Regiones admitidas: disponible para todas las nubes públicas. Actualmente no se admiten las nubes soberanas.

Funcionalidades del intérprete de código

Los agentes que usan el intérprete de código pueden escribir y ejecutar código Python para tareas avanzadas. Entre los casos de uso se incluyen:

• Procesamiento de archivos de Excel: crea, copia y actualiza hojas de cálculo en un libro, lee y aplica estilos de celda, copia el formato entre celdas, copia y actualiza fórmulas entre celdas, y más.
• Procesamiento de archivos de Word y PowerPoint.
• Procesamiento de archivos PDF: crear y copiar archivos PDF, leer tablas y párrafos de texto.
• Procesamiento de datos de tablas en Dataverse.
• Cálculos matemáticos y estadísticos complejos.
• Análisis, manipulación y visualización de datos (por ejemplo, tablas y gráficos).

El intérprete de código agrega las siguientes funcionalidades a las indicaciones:

• Compatibilidad con archivos como tipo de salida en mensajes.
• Compatibilidad con archivos Excel como tipos de entrada y salida para solicitudes.

Cree mensajes de una de estas dos maneras:

• En Power Apps: usa la opción Crear tu propia consulta en AI Hub.
• En Copilot Studio: añada un mensaje como herramienta en el nivel de agente o tema.

Obtenga más información sobre las indicaciones en Visión general de las indicaciones.

También puede usar el intérprete de código en el chat del agente en Copilot Studio.

Iniciar un nuevo mensaje en Power Apps AI Hub y activar el intérprete de código

Puede iniciar una nueva entrada en AI Hub en Power Apps y activar el intérprete de código en la configuración de la entrada.

1. Vaya a Power Apps.

2. Seleccione Centro de INTELIGENCIA ARTIFICIAL en el panel izquierdo.

3. Seleccione Indicaciones.

   

4. Seleccione Crear su propia solicitud.

5. Escriba un nombre para el mensaje.

6. En la sección Instrucciones , seleccione los tres puntos (...) y, a continuación, seleccione Configuración.

   

7. En Configuración, active el intérprete de código.

8. Cerrar Configuración para volver al editor de prompts.

El editor de mensajes está abierto con el intérprete de código activado. A continuación, escriba instrucciones para el mensaje.

Iniciar un nuevo indicador como una herramienta dentro de un agente y habilitar el intérprete de código

Puede iniciar un nuevo indicador como una herramienta dentro de un agente en Copilot Studio y activar el intérprete de código para ese indicador.

1. En Copilot Studio, vaya al agente donde desea usar el intérprete de código.

2. Se le agrega un nuevo indicador al agente como una herramienta, ya sea en el nivel de agente o en el nivel de tema.

   • Agregue un mensaje en el nivel de agente:

     1. Vaya a la página Herramientas .

     2. Seleccione Agregar una>Solicitud.

   • Agregue un mensaje a nivel de tema.

     1. Vaya a la página Temas y seleccione el tema en el que desea agregar el indicador.

     2. Seleccione Agregar nodo en la posición del tema donde desea añadir el indicador.

     3. Seleccione Agregar una herramienta>Nueva solicitud.

   Se abre la interfaz de creación de comandos integrada del constructor de comandos.

3. En la barra de información, seleccione los tres puntos (...) y, a continuación, seleccione Configuración.

   

4. En la página Configuración, seleccione Habilitar intérprete de código.

5. Cierre Configuración para volver al editor de instrucciones.

El editor de mensajes está abierto con el intérprete de código activado. A continuación, escriba instrucciones para el mensaje.

Escribir instrucciones para el mensaje

A continuación, puede escribir las instrucciones del mensaje, configurar el mensaje según sea necesario y guardarlo para crear el mensaje.

Obtenga más información sobre cómo usar el intérprete de código en los mensajes en ejemplos de mensajes del intérprete de código.

Prácticas recomendadas para el intérprete de código en indicaciones

• Utiliza otras herramientas de inteligencia artificial como Copilot para obtener el mensaje optimizado para comenzar.
• Use indicaciones precisas con ejemplos (indicación de pocas capturas).
• Especifique salidas (por ejemplo, "Devolver como JSON" o "Excel" o "PDF").

Limitaciones

• No se admite el análisis de varios archivos cargados en una sola solicitud.
• No se admite el retorno de varias salidas de archivo en una sola solicitud.
• No se admite la formulación de preguntas sobre un archivo cargado en varios turnos.
• Para usar el intérprete de código, necesitas configurar tu agente, en la configuración del agente, para usar autenticación de usuario. Por ejemplo, el uso de Direct Line con autenticación No seleccionado no funciona en escenarios que usan el intérprete de código.

Solución de problemas

Si se producen errores al usar el intérprete de código, pruebe los pasos siguientes:

1. Asegúrese de que se conceden todos los permisos necesarios. Compruebe que la cuenta de usuario y el agente tienen los permisos necesarios para ejecutar mensajes de intérprete de código.
2. Comprueba los ajustes de configuración. Confirme que el intérprete de código está habilitado en la configuración del mensaje y que el agente está configurado para usar la autenticación de usuario.
3. Consulte los registros de errores para obtener información detallada. Revise los registros de errores en Copilot Studio o el entorno de Power Platform asociado para identificar la causa principal del problema y tomar medidas correctivas.

Información relacionada

• Utiliza un intérprete de código para analizar datos estructurados
• Intérprete de código para desarrolladores
• Ejemplo de componente pcF del intérprete de código