> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# JSON Schema

> Configura un paso del flujo de trabajo que define campos estructurados y devuelve una salida con forma JSON para pasos posteriores

# 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ón                                                                | Requerido | Descripción                                                                                     |
| --------------------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------- |
| Name                                                                  | No        | Etiqueta del paso en el lienzo del flujo de trabajo.                                            |
| Schema Items                                                          | Sí        | 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:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

Si quieres el resultado estructurado completo, referencia directamente la salida base:

```text theme={null}
{{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.

{/* Add screenshot: JSON Schema output after a test run */}

## 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](../../creating-and-editing), [Pruebas e iteración](../../testing-and-iteration) y [AI Prompt](../ai/ai-prompt)
