Saltar al contenido principal

​
JSON Schema

Usa JSON Schema cuando quieras que un paso del flujo de trabajo defina una forma de salida estructurada que los pasos posteriores puedan referenciar campo por campo.

​
Configuración

OpciónRequeridoDescripción
NameNoEtiqueta del paso en el lienzo del flujo de trabajo.
Schema ItemsSíFilas en Schema Items. Cada fila tiene un campo Key y un campo Value / Description.
Agrega este paso desde el grupo Utilities en Search steps….
En Schema Items, haz clic en Add Item para agregar otro campo. Cada fila te permite definir la clave de salida y describir el valor que debe contener esa clave. El campo Value / Description admite Insert Variable. Si un valor se resuelve a un arreglo u objeto JSON, Fetch Hive lo almacena como JSON estructurado en lugar de como cadena. Por ejemplo, un valor de {{step_2.output.items}} puede producir un arreglo que un paso de Iteration pueda usar más adelante. También puedes construir un literal de arreglo JSON a partir de múltiples variables de arreglo, como [{{step_2.output.items}},{{step_3.output.items}}]; esto crea un arreglo de arreglos, no una concatenación aplanada.

​
Salida

Haz clic en Run en el encabezado del paso para probar el paso. Fetch Hive muestra el resultado generado en Output después de que se complete la ejecución. Usa el selector de variables en un paso posterior para insertar la ruta de salida exacta para tu ejecución. La referencia base es: 
{{STEP_IDENTIFIER.output}}
Si quieres el resultado estructurado completo, referencia directamente la salida base: 
{{step_2.output}}
Si tu ejecución devuelve claves anidadas, el selector de variables muestra los campos exactos que puedes insertar en pasos posteriores.

​
Ejemplo

Agrega JSON Schema desde el grupo Utilities en Search steps…. Establece Name en algo como Article fields. En Schema Items, agrega claves como title, summary y sentiment. Para cada elemento, describe qué debe contener el valor en Value / Description. Si un campo debe depender de datos anteriores del flujo de trabajo, haz clic en Insert Variable y agrega esa referencia. Haz clic en Run y revisa el resultado estructurado en Output antes de usar esas claves en pasos posteriores.

​
Notas

  • El panel de configuración te permite agregar y eliminar filas de esquema con Add Item y la acción de eliminar en cada fila.
  • Este editor de paso no muestra un control When the step fails en su panel de configuración.
  • JSON Schema preserva los arreglos y objetos JSON resueltos para los pasos posteriores, incluidos los pasos de Iteration. Actualmente no fusiona dos arreglos en un solo arreglo plano automáticamente.
  • Usa el selector de variables después de una ejecución de prueba si quieres confirmar las claves exactas disponibles para los pasos posteriores.
Consulta también: Creación y edición, Pruebas e iteración y AI Prompt