Cambiar la salida de su solicitud (versión preliminar)
[Este tema es documentación preliminar y está sujeto a modificaciones.]
De forma predeterminada, la solicitud genera texto como respuesta. El texto puede resultar útil para muchos casos de uso. Sin embargo, si la respuesta tiene varios elementos que deben identificarse individualmente, la opción de texto puede ser limitada.
Importante
- Esta es una característica en versión preliminar.
- Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.
Beneficios del uso de la salida JSON
La salida JSON le permite generar una estructura JSON para su respuesta rápida en lugar de un texto. JSON permite un procesamiento más sencillo de respuestas con múltiples elementos en Power Automate o Power Apps.
A continuación se muestra un ejemplo de casos de uso que son posibles con la salida JSON:
- Mostrar contenido estructurado como el cronograma del proyecto o información del producto.
- Extraer datos de texto como facturas, órdenes de compra, formularios de entrega y muchos más.
- Identificare atributos de objetos de fuentes de texto como correos electrónicos o datos de Dataverse.
- Obtener múltiples categorías o sentimientos de un texto.
Crear una solicitud con salida JSON
Esta sección describe cómo seleccionar JSON como salida y editar el formato JSON.
Seleccionar JSON como salida
Para cambiar la forma en que se representa la respuesta rápida, siga estos pasos:
En el panel directamente debajo del encabezado Configuración de la solicitud, seleccione Salida>JSON (versión preliminar).
En la parte inferior izquierda, seleccione Probar solicitud para comprobar cómo se representa la respuesta de la solicitud en JSON.
Editar formato JSON
De forma predeterminada, el formato es Detectado automáticamente. Este formato significa que cada vez que prueba su solicitud, el formato asociado a la solicitud se actualiza con el detectado en el momento de la prueba. Este formato es conveniente cuando repite las instrucciones de la solicitud y desea saber cómo evoluciona el formato de respuesta.
Si actualiza el ejemplo JSON, el formato se vuelve Personalizado y nunca se actualiza si vuelve a probar la solicitud. Este formato es conveniente cuando no desea que los ajustes rápidos influyan en el formato o si necesita seguir un formato específico.
Puede volver al modo de detección automática seleccionando Volver a detección automática.
Para probar y guardar la solicitud, siga estos pasos:
Para confirmar el ejemplo recién modificado, seleccione Aplicar.
Para comprobar cómo se visualiza su respuesta rápida con el nuevo formato, seleccione Probar solocitud.
Cuando termines tus modificaciones, Seleccionar Save solicitud personalizada.
Si omite este paso, sus cambios se perderán.
Cuando guarda su solicitud, bloquea el último formato Detectado automáticamente o el formato Personalizado definido. Esto significa que cuando usas tu mensaje en Power Automate o Power Apps, se usa el formato guardado, no varía.
En cualquier momento, puede comprobar el esquema JSON que se genera a partir de los ejemplos JSON seleccionando </>. No puede modificar este esquema actualmente.
usar una solicitud con salida JSON en Power Automate
Después de agregar la acción Texto creado con GPT en un flujo de Power Automate , puede usar todos los campos JSON como valores dinámicos sin agregar lógica compleja para analizar la respuesta.
El siguiente ejemplo muestra cómo puede procesar una factura recibida por correo electrónico utilizando la solicitud descrita en Crear una solicitud con salida JSON en este artículo.
Cree un flujo con el desencadenador Cuando llega un nuevo correo electrónico.
Para obtener más información, vaya a Introducción a los desencadenadores.
Si solo necesita procesar correos electrónicos específicos, asegúrese de configurar filtros.
Extraiga el texto de los archivos adjuntos con la acción, Reconocer el texto de una imagen o de un documento PDF.
Para obtener más información sobre cómo crear y modificar un flujo en el diseñador, vaya a Comprender el diseñador de flujos de nube.
Debido a que la acción anterior devuelve una tabla de líneas dentro de una tabla de la página, es más conveniente agregar todas las líneas en una variable única.
Inicialice una variable y agregue el valor dinámico Texto de la acción Reconocer el texto de una imagen o de un documento PDF en esta variable.
Complete el flujo realizando los pasos siguientes:
- En su flujo, seleccione Crear texto con GPT mediante una solicitud.
- En la pestaña Parámetros, en campo Pregunta, seleccione solicitud con JSON como la salida.
- Agregue la variable de factura que creó en la entrada del mensaje.
El siguiente procedimiento le permite utilizar de forma fácil y segura múltiples valores extraídos de un texto mediante un mensaje.
En su flujo, seleccione Enviar un correo electrónico.
En la pestaña Parámetros , envíe un correo electrónico que contenga los elementos extraídos por el mensaje con salida JSON.
Preguntas frecuentes
No se pudo generar un JSON
Es posible que aparezca el siguiente error al probar un mensaje: No se pudo generar un JSON. Edite la instrucción del mensaje y vuelva a intentarlo.
Este error podría deberse a que el modelo incluye la salida JSON con información de metadatos que impide la verificación exitosa del formato JSON requerido. Intente agregar la siguiente instrucción a su solicitud para resolver el problema: No incluya JSON Markdown en su respuesta.
No se devuelve ningún JSON en el modo de detección automática
Es posible que no se devuelva ningún JSON después de seleccionar Probar solicitud con el modo de detección automática activado. Puede deberse a que las instrucciones del mensaje contradicen las instrucciones del sistema de devolver un JSON. Podría resolverse cambiando las instrucciones del aviso y probando nuevamente.
El formato JSON no se actualiza en runtime de la solicitud
El último formato JSON detectado en el modo de detección automática o el último formato JSON definido en el modo personalizado se registra en el momento de guardar la solicitud. Este formato JSON grabado se aplica en runtime de la solicitud, lo que garantiza la coherencia del formato de respuesta incluso cuando las entradas dinámicas al mensaje cambian.
Limitaciones
- No puede modificar un esquema de JSON.
- No admitimos la definición de un formato JSON sin claves de campo.
Ejemplo:["abc", "def"]no se admite pero[{"Field1": "abc"}, {"Field1": "def"}]sí se admite.