feat(i18n): update translations (#1756)

2026-02-16 17:35:49 -05:00 · 2025-10-28 12:43:33 -07:00
parent 368576b082
commit aef1f18c1e
26 changed files with 1787 additions and 220 deletions
--- a/apps/docs/content/docs/es/blocks/index.mdx
+++ b/apps/docs/content/docs/es/blocks/index.mdx
@@ -16,7 +16,7 @@ Los bloques son los componentes de construcción que conectas para crear flujos

 ## Tipos de bloques principales

-Sim proporciona siete tipos de bloques principales que manejan las funciones esenciales de los flujos de trabajo de IA:
+Sim proporciona tipos de bloques esenciales que manejan las funciones principales de los flujos de trabajo de IA:

 ### Bloques de procesamiento
 - **[Agente](/blocks/agent)** - Chatea con modelos de IA (OpenAI, Anthropic, Google, modelos locales)
@@ -28,14 +28,18 @@ Sim proporciona siete tipos de bloques principales que manejan las funciones ese
 - **[Enrutador](/blocks/router)** - Usa IA para dirigir inteligentemente las solicitudes a diferentes caminos
 - **[Evaluador](/blocks/evaluator)** - Puntúa y evalúa la calidad del contenido usando IA

+### Bloques de flujo de control
+- **[Variables](/blocks/variables)** - Establecer y gestionar variables con alcance de flujo de trabajo
+- **[Espera](/blocks/wait)** - Pausar la ejecución del flujo de trabajo durante un tiempo específico
+
 ### Bloques de salida
- **[Respuesta](/blocks/response)** - Formatea y devuelve resultados finales de tu flujo de trabajo
+- **[Respuesta](/blocks/response)** - Formatear y devolver resultados finales desde tu flujo de trabajo

 ## Cómo funcionan los bloques

 Cada bloque tiene tres componentes principales:

-**Entradas**: Datos que llegan al bloque desde otros bloques o entrada del usuario
+**Entradas**: Datos que ingresan al bloque desde otros bloques o entrada del usuario
 **Configuración**: Ajustes que controlan cómo se comporta el bloque
 **Salidas**: Datos que el bloque produce para que otros bloques los utilicen

@@ -55,8 +59,8 @@ Cada bloque tiene tres componentes principales:

 Creas flujos de trabajo conectando bloques entre sí. La salida de un bloque se convierte en la entrada de otro:

- **Arrastra para conectar**: Arrastra desde un puerto de salida a un puerto de entrada
- **Conexiones múltiples**: Una salida puede conectarse a múltiples entradas
+- **Arrastrar para conectar**: Arrastra desde un puerto de salida a un puerto de entrada
+- **Múltiples conexiones**: Una salida puede conectarse a múltiples entradas
 - **Rutas ramificadas**: Algunos bloques pueden dirigir a diferentes rutas según las condiciones

 <div className="w-full max-w-2xl mx-auto overflow-hidden rounded-lg">
@@ -110,7 +114,7 @@ Cada tipo de bloque tiene opciones de configuración específicas:

 **Bloques de integración** (API, Respuesta):
 - Configuración de endpoint
- Cabeceras y autenticación
+- Encabezados y autenticación
 - Formato de solicitud/respuesta

 <Cards>
@@ -126,4 +130,10 @@ Cada tipo de bloque tiene opciones de configuración específicas:
  <Card title="Bloque de condición" href="/blocks/condition">
    Crea lógica de ramificación basada en evaluación de datos
  </Card>
+  <Card title="Bloque de variables" href="/blocks/variables">
+    Establece y gestiona variables con alcance de flujo de trabajo
+  </Card>
+  <Card title="Bloque de espera" href="/blocks/wait">
+    Pausa la ejecución del flujo de trabajo durante retrasos de tiempo específicos
+  </Card>
 </Cards>
--- a/apps/docs/content/docs/es/blocks/loop.mdx
+++ b/apps/docs/content/docs/es/blocks/loop.mdx
@@ -9,7 +9,7 @@ import { Image } from '@/components/ui/image'

 El bloque Loop es un bloque contenedor en Sim que permite crear flujos de trabajo iterativos ejecutando un grupo de bloques repetidamente. Los bucles permiten el procesamiento iterativo en tus flujos de trabajo.

-El bloque Loop admite dos tipos de iteración:
+El bloque Loop admite cuatro tipos de iteración:

 <Callout type="info">
  Los bloques Loop son nodos contenedores que pueden albergar otros bloques dentro de ellos. Los bloques dentro de un bucle se ejecutarán múltiples veces según tu configuración.
@@ -27,7 +27,7 @@ El bloque Loop te permite:
    <strong>Repetir operaciones</strong>: Ejecutar bloques un número fijo de veces
  </Step>
  <Step>
-    <strong>Procesamiento secuencial</strong>: Manejar transformación de datos en iteraciones ordenadas
+    <strong>Bucles con condiciones</strong>: Continuar ejecutando mientras o hasta que se cumpla una condición
  </Step>
  <Step>
    <strong>Agregar resultados</strong>: Recopilar salidas de todas las iteraciones del bucle
@@ -47,11 +47,11 @@ El bloque Loop ejecuta los bloques contenidos a través de iteración secuencial

 ### Tipo de bucle

-Elige entre dos tipos de bucles:
+Elige entre cuatro tipos de bucles:

-<Tabs items={['For Loop', 'ForEach Loop']}>
+<Tabs items={['For Loop', 'ForEach Loop', 'While Loop', 'Do-While Loop']}>
  <Tab>
-    **For Loop (Iteraciones)** - Un bucle numérico que se ejecuta un número fijo de veces:
+    **Bucle For (Iteraciones)** - Un bucle numérico que se ejecuta un número fijo de veces:
    
    <div className="flex justify-center">
      <Image
@@ -100,13 +100,65 @@ Elige entre dos tipos de bucles:
    ```

  </Tab>
+  <Tab>
+    **Bucle While (Basado en condición)** - Continúa ejecutándose mientras una condición se evalúe como verdadera:
+    
+    <div className="flex justify-center">
+      <Image
+        src="/static/blocks/loop-3.png"
+        alt="Bucle While con condición"
+        width={500}
+        height={400}
+        className="my-6"
+      />
+    </div>
+    
+    Úsalo cuando necesites hacer un bucle hasta que se cumpla una condición específica. La condición se comprueba **antes** de cada iteración.
+    
+
+    ```
+    Example: While <variable.i> < 10
+    - Check condition → Execute if true
+    - Inside loop: Increment <variable.i>
+    - Inside loop: Variables assigns i = <variable.i> + 1
+    - Check condition → Execute if true
+    - Check condition → Exit if false
+    ```
+
+  </Tab>
+  <Tab>
+    **Bucle Do-While (Basado en condición)** - Se ejecuta al menos una vez, luego continúa mientras una condición sea verdadera:
+    
+    <div className="flex justify-center">
+      <Image
+        src="/static/blocks/loop-3.png"
+        alt="Bucle Do-While con condición"
+        width={500}
+        height={400}
+        className="my-6"
+      />
+    </div>
+    
+    Úsalo cuando necesites ejecutar al menos una vez, luego hacer un bucle hasta que se cumpla una condición. La condición se comprueba **después** de cada iteración.
+    
+
+    ```
+    Example: Do-while <variable.i> < 10
+    - Execute blocks
+    - Inside loop: Increment <variable.i>
+    - Inside loop: Variables assigns i = <variable.i> + 1
+    - Check condition → Continue if true
+    - Check condition → Exit if false
+    ```
+
+  </Tab>
 </Tabs>

 ## Cómo usar los bucles

-### Creación de un bucle
+### Creando un bucle

-1. Arrastra un bloque de bucle desde la barra de herramientas a tu lienzo
+1. Arrastra un bloque Loop desde la barra de herramientas a tu lienzo
 2. Configura el tipo de bucle y los parámetros
 3. Arrastra otros bloques dentro del contenedor del bucle
 4. Conecta los bloques según sea necesario
@@ -136,19 +188,32 @@ Después de que un bucle se completa, puedes acceder a los resultados agregados:
 <div className="mb-4 rounded-md border p-4">
  <h4 className="font-medium">Escenario: Generar múltiples variaciones</h4>
  <ol className="list-decimal pl-5 text-sm">
-    <li>Configurar el bucle For para 5 iteraciones</li>
+    <li>Configurar bucle For para 5 iteraciones</li>
    <li>Dentro del bucle: El agente genera una variación de contenido</li>
    <li>Dentro del bucle: El evaluador puntúa el contenido</li>
    <li>Después del bucle: La función selecciona la mejor variación</li>
  </ol>
 </div>

+### Contador con bucle While
+
+<div className="mb-4 rounded-md border p-4">
+  <h4 className="font-medium">Escenario: Procesar elementos con bucle basado en contador</h4>
+  <ol className="list-decimal pl-5 text-sm">
+    <li>Inicializar variable de flujo de trabajo: `i = 0`</li>
+    <li>Bucle While con condición: `<variable.i>` \< 10</li>
+    <li>Dentro del bucle: El agente procesa el elemento en el índice `<variable.i>`</li>
+    <li>Dentro del bucle: La variable incrementa `i = <variable.i> + 1`</li>
+    <li>El bucle continúa mientras i sea menor que 10</li>
+  </ol>
+</div>
+
 ## Características avanzadas

 ### Limitaciones

 <Callout type="warning">
-  Los bloques contenedores (Bucles y Paralelos) no pueden anidarse unos dentro de otros. Esto significa:
+  Los bloques contenedores (Bucles y Paralelos) no pueden anidarse dentro de otros. Esto significa:
  - No puedes colocar un bloque de Bucle dentro de otro bloque de Bucle
  - No puedes colocar un bloque Paralelo dentro de un bloque de Bucle
  - No puedes colocar ningún bloque contenedor dentro de otro bloque contenedor
@@ -157,7 +222,7 @@ Después de que un bucle se completa, puedes acceder a los resultados agregados:
 </Callout>

 <Callout type="info">
-  Los bucles se ejecutan secuencialmente, no en paralelo. Si necesitas ejecución concurrente, utiliza el bloque Paralelo en su lugar.
+  Los bucles se ejecutan secuencialmente, no en paralelo. Si necesitas ejecución concurrente, usa el bloque Paralelo en su lugar.
 </Callout>

 ## Entradas y salidas
@@ -166,7 +231,7 @@ Después de que un bucle se completa, puedes acceder a los resultados agregados:
  <Tab>
    <ul className="list-disc space-y-2 pl-6">
      <li>
-        <strong>Tipo de bucle</strong>: Elige entre 'for' o 'forEach'
+        <strong>Tipo de bucle</strong>: Elige entre 'for', 'forEach', 'while', o 'doWhile'
      </li>
      <li>
        <strong>Iteraciones</strong>: Número de veces a ejecutar (bucles for)
@@ -174,6 +239,9 @@ Después de que un bucle se completa, puedes acceder a los resultados agregados:
      <li>
        <strong>Colección</strong>: Array u objeto sobre el que iterar (bucles forEach)
      </li>
+      <li>
+        <strong>Condición</strong>: Expresión booleana a evaluar (bucles while/do-while)
+      </li>
    </ul>
  </Tab>
  <Tab>
@@ -192,7 +260,7 @@ Después de que un bucle se completa, puedes acceder a los resultados agregados:
  <Tab>
    <ul className="list-disc space-y-2 pl-6">
      <li>
-        <strong>loop.results</strong>: Array con todos los resultados de las iteraciones
+        <strong>loop.results</strong>: Array de todos los resultados de iteración
      </li>
      <li>
        <strong>Estructura</strong>: Los resultados mantienen el orden de iteración
@@ -206,6 +274,6 @@ Después de que un bucle se completa, puedes acceder a los resultados agregados:

 ## Mejores prácticas

- **Establece límites razonables**: Mantén un número razonable de iteraciones para evitar tiempos de ejecución largos
+- **Establece límites razonables**: Mantén el número de iteraciones razonable para evitar tiempos de ejecución largos
 - **Usa ForEach para colecciones**: Cuando proceses arrays u objetos, usa bucles ForEach en lugar de bucles For
 - **Maneja los errores con elegancia**: Considera añadir manejo de errores dentro de los bucles para flujos de trabajo robustos
--- a/apps/docs/content/docs/es/blocks/variables.mdx
+++ b/apps/docs/content/docs/es/blocks/variables.mdx
@@ -0,0 +1,123 @@
+---
+title: Variables
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Step, Steps } from 'fumadocs-ui/components/steps'
+import { Image } from '@/components/ui/image'
+
+El bloque Variables actualiza las variables del flujo de trabajo durante la ejecución. Las variables deben inicializarse primero en la sección Variables de tu flujo de trabajo, luego puedes usar este bloque para actualizar sus valores mientras se ejecuta tu flujo de trabajo.
+
+<div className="flex justify-center">
+  <Image
+    src="/static/blocks/variables.png"
+    alt="Bloque de Variables"
+    width={500}
+    height={350}
+    className="my-6"
+  />
+</div>
+
+<Callout>
+  Accede a las variables en cualquier parte de tu flujo de trabajo usando la sintaxis `<variable.variableName>`.
+</Callout>
+
+## Descripción general
+
+El bloque Variables te permite:
+
+<Steps>
+  <Step>
+    <strong>Actualizar variables del flujo de trabajo</strong>: Cambiar valores de variables durante la ejecución
+  </Step>
+  <Step>
+    <strong>Almacenar datos dinámicos</strong>: Capturar salidas de bloques en variables
+  </Step>
+  <Step>
+    <strong>Mantener el estado</strong>: Seguir contadores, indicadores y resultados intermedios
+  </Step>
+</Steps>
+
+## Cómo usar Variables
+
+### 1. Inicializar en Variables del flujo de trabajo
+
+Primero, crea tus variables en la sección Variables del flujo de trabajo (accesible desde la configuración del flujo de trabajo):
+
+```
+customerEmail = ""
+retryCount = 0
+currentStatus = "pending"
+```
+
+### 2. Actualizar con el bloque Variables
+
+Usa el bloque Variables para actualizar estos valores durante la ejecución:
+
+```
+customerEmail = <api.email>
+retryCount = <variable.retryCount> + 1
+currentStatus = "processing"
+```
+
+### 3. Acceder desde cualquier lugar
+
+Referencia variables en cualquier bloque:
+
+```
+Agent prompt: "Send email to <variable.customerEmail>"
+Condition: <variable.retryCount> < 5
+API body: {"status": "<variable.currentStatus>"}
+```
+
+## Ejemplos de casos de uso
+
+### Contador de bucle y estado
+
+<div className="mb-4 rounded-md border p-4">
+  <h4 className="font-medium">Escenario: Seguimiento del progreso a través de iteraciones de bucle</h4>
+  <ol className="list-decimal pl-5 text-sm">
+    <li>Inicializar en el flujo de trabajo: `itemsProcessed = 0`, `lastResult = ""`</li>
+    <li>El bucle itera sobre elementos</li>
+    <li>Dentro del bucle: El agente procesa el elemento actual</li>
+    <li>Dentro del bucle: Variables actualiza `itemsProcessed = <variable.itemsProcessed> + 1`</li>
+    <li>Dentro del bucle: Variables actualiza `lastResult = <agent.content>`</li>
+    <li>Siguiente iteración: Accede a `<variable.lastResult>` para comparar con el resultado actual</li>
+  </ol>
+</div>
+
+### Lógica de reintentos
+
+<div className="mb-4 rounded-md border p-4">
+  <h4 className="font-medium">Escenario: Seguimiento de intentos de reintento de API</h4>
+  <ol className="list-decimal pl-5 text-sm">
+    <li>Inicializar en el flujo de trabajo: `retryCount = 0`</li>
+    <li>El bloque API intenta realizar la solicitud</li>
+    <li>Si falla, Variables incrementa: `retryCount = <variable.retryCount> + 1`</li>
+    <li>La condición verifica si `<variable.retryCount>` \< 3 para reintentar o fallar</li>
+  </ol>
+</div>
+
+### Configuración dinámica
+
+<div className="mb-4 rounded-md border p-4">
+  <h4 className="font-medium">Escenario: Almacenar contexto de usuario para el flujo de trabajo</h4>
+  <ol className="list-decimal pl-5 text-sm">
+    <li>Inicializar en el flujo de trabajo: `userId = ""`, `userTier = ""`</li>
+    <li>La API obtiene el perfil del usuario</li>
+    <li>Variables almacena: `userId = <api.id>`, `userTier = <api.tier>`</li>
+    <li>El agente personaliza la respuesta usando `<variable.userTier>`</li>
+    <li>La API usa `<variable.userId>` para el registro</li>
+  </ol>
+</div>
+
+## Salidas
+
+- **`<variables.assignments>`**: Objeto JSON con todas las asignaciones de variables de este bloque
+
+## Mejores prácticas
+
+- **Inicializar en la configuración del flujo de trabajo**: Siempre crea variables en la sección Variables del flujo de trabajo antes de usarlas
+- **Actualizar dinámicamente**: Usa bloques de Variables para actualizar valores basados en salidas de bloques o cálculos
+- **Usar en bucles**: Perfecto para rastrear el estado a través de iteraciones
+- **Nombrar descriptivamente**: Usa nombres claros como `currentIndex`, `totalProcessed`, o `lastError`
--- a/apps/docs/content/docs/es/blocks/wait.mdx
+++ b/apps/docs/content/docs/es/blocks/wait.mdx
@@ -0,0 +1,99 @@
+---
+title: Espera
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Step, Steps } from 'fumadocs-ui/components/steps'
+import { Image } from '@/components/ui/image'
+
+El bloque Espera pausa tu flujo de trabajo durante un tiempo específico antes de continuar con el siguiente bloque. Úsalo para añadir retrasos entre acciones, respetar límites de frecuencia de API o espaciar operaciones.
+
+<div className="flex justify-center">
+  <Image
+    src="/static/blocks/wait.png"
+    alt="Bloque de Espera"
+    width={500}
+    height={350}
+    className="my-6"
+  />
+</div>
+
+## Descripción general
+
+El bloque Espera te permite:
+
+<Steps>
+  <Step>
+    <strong>Añadir retrasos de tiempo</strong>: Pausar la ejecución entre pasos del flujo de trabajo
+  </Step>
+  <Step>
+    <strong>Respetar límites de frecuencia</strong>: Espaciar llamadas a API para mantenerse dentro de los límites
+  </Step>
+  <Step>
+    <strong>Programar secuencias</strong>: Crear flujos de trabajo temporizados con retrasos entre acciones
+  </Step>
+</Steps>
+
+## Configuración
+
+### Cantidad de espera
+
+Introduce la duración para pausar la ejecución:
+- **Entrada**: Número positivo
+- **Máximo**: 600 segundos (10 minutos) o 10 minutos
+
+### Unidad
+
+Elige la unidad de tiempo:
+- **Segundos**: Para retrasos cortos y precisos
+- **Minutos**: Para pausas más largas
+
+<Callout type="info">
+  Los bloques de espera pueden cancelarse deteniendo el flujo de trabajo. El tiempo máximo de espera es de 10 minutos.
+</Callout>
+
+## Salidas
+
+- **`<wait.waitDuration>`**: La duración de la espera en milisegundos
+- **`<wait.status>`**: Estado de la espera ('waiting', 'completed', o 'cancelled')
+
+## Ejemplos de casos de uso
+
+### Limitación de frecuencia de API
+
+<div className="mb-4 rounded-md border p-4">
+  <h4 className="font-medium">Escenario: Mantenerse dentro de los límites de frecuencia de API</h4>
+  <ol className="list-decimal pl-5 text-sm">
+    <li>El bloque API realiza la primera solicitud</li>
+    <li>El bloque Espera pausa durante 2 segundos</li>
+    <li>El bloque API realiza la segunda solicitud</li>
+    <li>El proceso continúa sin alcanzar los límites de frecuencia</li>
+  </ol>
+</div>
+
+### Notificaciones temporizadas
+
+<div className="mb-4 rounded-md border p-4">
+  <h4 className="font-medium">Escenario: Enviar mensajes de seguimiento</h4>
+  <ol className="list-decimal pl-5 text-sm">
+    <li>La función envía el correo electrónico inicial</li>
+    <li>El bloque Espera pausa durante 5 minutos</li>
+    <li>La función envía el correo electrónico de seguimiento</li>
+  </ol>
+</div>
+
+### Retrasos de procesamiento
+
+<div className="mb-4 rounded-md border p-4">
+  <h4 className="font-medium">Escenario: Espera para sistema externo</h4>
+  <ol className="list-decimal pl-5 text-sm">
+    <li>El bloque API activa un trabajo en el sistema externo</li>
+    <li>El bloque de espera pausa durante 30 segundos</li>
+    <li>El bloque API verifica el estado de finalización del trabajo</li>
+  </ol>
+</div>
+
+## Mejores prácticas
+
+- **Mantén esperas razonables**: Usa Espera para retrasos de hasta 10 minutos. Para retrasos más largos, considera flujos de trabajo programados
+- **Monitorea el tiempo de ejecución**: Recuerda que las esperas extienden la duración total del flujo de trabajo
--- a/apps/docs/content/docs/es/tools/onedrive.mdx
+++ b/apps/docs/content/docs/es/tools/onedrive.mdx
@@ -50,7 +50,7 @@ En Sim, la integración con OneDrive permite a tus agentes interactuar directame

 ## Instrucciones de uso

-Integra OneDrive en el flujo de trabajo. Puede crear, subir y listar archivos. Requiere OAuth.
+Integra OneDrive en el flujo de trabajo. Puede crear archivos de texto y Excel, subir archivos y listar archivos.

 ## Herramientas

@@ -61,12 +61,13 @@ Subir un archivo a OneDrive
 #### Entrada

 | Parámetro | Tipo | Obligatorio | Descripción |
-| --------- | ---- | ----------- | ----------- |
+| --------- | ---- | -------- | ----------- |
 | `fileName` | string | Sí | El nombre del archivo a subir |
 | `file` | file | No | El archivo a subir \(binario\) |
 | `content` | string | No | El contenido de texto a subir \(si no se proporciona un archivo\) |
+| `mimeType` | string | No | El tipo MIME del archivo a crear \(p. ej., text/plain para .txt, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet para .xlsx\) |
 | `folderSelector` | string | No | Seleccionar la carpeta donde subir el archivo |
-| `manualFolderId` | string | No | ID de carpeta ingresado manualmente \(modo avanzado\) |
+| `manualFolderId` | string | No | ID de carpeta introducido manualmente \(modo avanzado\) |

 #### Salida