> ## 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.

# Inicio rápido de flujo de trabajo

> Crea un flujo de trabajo, ejecútalo en el editor, crea un despliegue de flujo de trabajo e invócalo a través de la API pública

# Inicio rápido de flujo de trabajo

Al final de esta guía, tendrás un flujo de trabajo funcionando en el panel y un fragmento público de cURL que puedes usar para invocarlo desde tu app.

## Requisitos previos

* Un espacio de trabajo de Fetch Hive
* Una clave de API del espacio de trabajo si quieres ejecutar el ejemplo público de cURL — consulta [Claves de API](../workspace/api-keys)

## Paso 1: Crear un flujo de trabajo

Abre **Workflows** en la barra lateral y luego haz clic en **Add Workflow**.

Ingresa un **Name**. Si tu espacio de trabajo usa categorías, también puedes elegir una **Category**. Haz clic en **Save** para abrir el editor del flujo de trabajo.

## Paso 2: Agregar tu primer paso

En el editor, haz clic en el conector **+** entre **Start** y **End**.

Esto abre **Search steps...**. Elige **AI Prompt** para obtener el primer flujo de trabajo más rápido posible.

Cuando el nuevo paso aparezca en el lienzo, haz clic en él para abrir **Step settings**.

## Paso 3: Configurar el paso

Agrega una instrucción corta en **Step settings** para que el flujo de trabajo tenga algo útil que hacer.

Si tu flujo de trabajo necesita entrada del llamador, define esa entrada primero en el paso **Start** y luego refiérete a ella dentro de tu paso **AI Prompt**.

Mantén la primera versión simple. No necesitas **Copilot**, tipos de paso avanzados ni múltiples ramas para este inicio rápido.

## Paso 4: Ejecutar el flujo de trabajo en el editor

Haz clic en **Run Workflow** en el encabezado.

Esto abre **Run History**. Haz clic en **Start** para abrir **Start a new Workflow Run** y luego haz clic en **Start Workflow Run**.

Este es un flujo de dos pasos en la interfaz. **Run Workflow** no inicia el flujo de trabajo inmediatamente por sí solo.

## Paso 5: Guardar una versión con nombre

Haz clic en **Save Version** en el encabezado.

Ingresa una descripción de lo que cambió y luego guarda la versión. Esto te da una versión con nombre a la que puedes referirte más tarde.

## Paso 6: Crear un despliegue

Haz clic en **Deploy** y luego elige **Create a Deployment**.

Ingresa una **Deployment key** y guárdala. Esto crea el despliegue de flujo de trabajo en vivo que puedes invocar a través de la API pública.

## Paso 7: Copiar el fragmento de invocación pública

Abre **More** en la barra lateral y haz clic en **Get Code**, o abre **Code Snippet** desde la página del despliegue.

Selecciona tu **Deployment** y **Variant**. El diálogo muestra un fragmento de cURL para `POST /v1/workflow/invoke`.

La carga útil pública ahora usa `deployment` y `variant`, coincidiendo con el lenguaje mostrado en la interfaz.

```bash theme={null}
curl 'https://api.fetchhive.com/v1/workflow/invoke' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data-raw '{
    "deployment": "YOUR_DEPLOYMENT_NAME",
    "variant": "YOUR_VARIANT_NAME",
    "inputs": {
      "topic": "State of enterprise AI in 2026"
    }
  }' \
  --compressed
```

Si quieres que Fetch Hive devuelva inmediatamente y envíe el resultado final más tarde, la interfaz admite un selector **Callback delivery** en el diálogo del fragmento de código. Eso agrega un bloque `async` con `enabled` y `callback_url`.

## Próximos pasos

* [Flujos de trabajo](../workflows/overview)
* [Pasos de flujo de trabajo](../workflows/steps/overview)
* [Publicación y versionado](../workflows/publishing-and-versioning)