| Aktion | Wie | Vorschau |
|---|---|---|
| Arbeitsbereich erstellen | +Arbeitsbereich-Dropdown anklicken → **Neuer Arbeitsbereich** | +|
| Arbeitsbereiche wechseln | +Arbeitsbereich-Dropdown anklicken → Arbeitsbereich auswählen | +|
| Teammitglieder einladen | +Seitenleiste → **Einladen** | +|
| Arbeitsbereich umbenennen | +Rechtsklick auf Arbeitsbereich → **Umbenennen** | +|
| Arbeitsbereich duplizieren | +Rechtsklick auf Arbeitsbereich → **Duplizieren** | +|
| Arbeitsbereich exportieren | +Rechtsklick auf Arbeitsbereich → **Exportieren** | +|
| Arbeitsbereich löschen | +Rechtsklick auf Arbeitsbereich → **Löschen** | +
| Aktion | Wie | Vorschau |
|---|---|---|
| Workflow erstellen | +**+**-Schaltfläche in der Seitenleiste anklicken | +|
| Workflows neu anordnen / verschieben | +Workflow nach oben/unten oder auf einen Ordner ziehen | +|
| Workflow importieren | +Import-Schaltfläche in der Seitenleiste anklicken → Datei auswählen | +|
| Mehrere Workflows auswählen | +`Mod+Click` oder `Shift+Click` Workflows in der Seitenleiste | +|
| In neuem Tab öffnen | +Rechtsklick auf Workflow → **In neuem Tab öffnen** | +|
| Workflow umbenennen | +Rechtsklick auf Workflow → **Umbenennen** | +|
| Workflow-Farbe zuweisen | +Rechtsklick auf Workflow → **Farbe ändern** | +|
| Workflow duplizieren | +Rechtsklick auf Workflow → **Duplizieren** | +|
| Workflow exportieren | +Rechtsklick auf Workflow → **Exportieren** | +|
| Workflow löschen | +Rechtsklick auf Workflow → **Löschen** | +|
| Ordner umbenennen | +Rechtsklick auf Ordner → **Umbenennen** | +|
| Workflow in Ordner erstellen | +Rechtsklick auf Ordner → **Workflow erstellen** | +|
| Ordner in Ordner erstellen | +Rechtsklick auf Ordner → **Ordner erstellen** | +|
| Ordner duplizieren | +Rechtsklick auf Ordner → **Duplizieren** | +|
| Ordner exportieren | +Rechtsklick auf Ordner → **Exportieren** | +|
| Ordner löschen | +Rechtsklick auf Ordner → **Löschen** | +
| Aktion | Wie | Vorschau |
|---|---|---|
| Block hinzufügen | +Aus Toolbar-Panel ziehen oder Rechtsklick auf Canvas → **Block hinzufügen** | +|
| Mehrere Blöcke auswählen | +`Mod+Click` zusätzliche Blöcke oder Shift-Ziehen für Auswahlrahmen | +|
| Blöcke kopieren | +`Mod+C` mit ausgewählten Blöcken | +|
| Blöcke einfügen | +`Mod+V` zum Einfügen kopierter Blöcke | +|
| Blöcke duplizieren | +Rechtsklick → **Duplizieren** | +|
| Blöcke löschen | +`Delete` oder `Backspace` Taste oder Rechtsklick → **Löschen** | +|
| Block umbenennen | +Auf Blocknamen im Header klicken oder im Editor-Panel bearbeiten | +|
| Block aktivieren/deaktivieren | +Rechtsklick → **Aktivieren/Deaktivieren** | +|
| Block sperren/entsperren | +Über Block hovern → Auf Schloss-Symbol klicken (nur Admin) | +|
| Handle-Ausrichtung umschalten | +Rechtsklick → **Handles umschalten** | +|
| Block konfigurieren | +Block auswählen → Editor-Panel rechts verwenden | +
| Aktion | Wie | Vorschau |
|---|---|---|
| Verbindung erstellen | +Vom Ausgangs-Handle zum Eingangs-Handle ziehen | +|
| Verbindung löschen | +Auf Kante klicken zum Auswählen → `Delete` Taste | +|
| Ausgabe in anderem Block verwenden | +Verbindungs-Tag in Eingabefeld ziehen | +
| Aktion | Wie | Vorschau |
|---|---|---|
| Symbolleiste durchsuchen | +`Mod+F` | +|
| Alles durchsuchen | +`Mod+K` | +|
| Manuellen Modus umschalten | +Klicken Sie auf die Umschalt-Schaltfläche, um zwischen manuell und Selektor zu wechseln | +|
| Seitenleiste ein-/ausklappen | +Klicken Sie auf die Einklappen-Schaltfläche in der Seitenleiste | +
| Aktion | Wie | Vorschau |
|---|---|---|
| Workflow ausführen | +Klicken Sie auf die Schaltfläche Workflow ausführen oder `Mod+Enter` | +|
| Workflow stoppen | +Klicken Sie auf die Stopp-Schaltfläche oder `Mod+Enter` während der Ausführung | +|
| Mit Chat testen | +Verwenden Sie das Chat-Panel auf der rechten Seite | +|
| Ausgabe zum Anzeigen auswählen | +Klicken Sie auf das Dropdown-Menü im Chat-Panel → Wählen Sie Block-Ausgabe aus | +|
| Chat-Verlauf löschen | +Klicken Sie auf die Löschen-Schaltfläche im Chat-Panel | +|
| Ab Block ausführen | +Bewegen Sie den Mauszeiger über den Block → Klicken Sie auf die Wiedergabe-Schaltfläche oder Rechtsklick → **Ab Block ausführen** | +|
| Bis Block ausführen | +Rechtsklick auf Block → **Bis Block ausführen** | +|
| Ausführungsprotokolle anzeigen | +Öffnen Sie das Terminal-Panel unten oder `Mod+L` | +|
| Protokolle filtern | +Klicken Sie auf das Filter-Symbol im Terminal → Filtern Sie nach Block oder Status | +|
| Protokolle durchsuchen | +Verwenden Sie das Suchfeld im Terminal oder Rechtsklick auf Protokolleintrag → **Suchen** | +|
| Protokolleintrag kopieren | +Zwischenablage-Symbol oder Rechtsklick auf Protokolleintrag → **Kopieren** | +|
| Terminal leeren | +Papierkorb-Symbol oder `Mod+D` | +
| Aktion | Wie | Vorschau |
|---|---|---|
| Workflow bereitstellen | +Klicken Sie auf die Schaltfläche **Bereitstellen** im Panel | +|
| Bereitstellung aktualisieren | +Klicken Sie auf **Aktualisieren**, wenn Änderungen erkannt werden | +|
| Bereitstellungsstatus anzeigen | +Überprüfen Sie die Statusanzeige (Live/Aktualisieren/Bereitstellen) im Tab „Bereitstellen" | +|
| Bereitstellung zurücksetzen | +Greifen Sie auf frühere Versionen im Tab „Bereitstellen" zu → **Zu Live befördern** | +|
| Versionsbeschreibung hinzufügen | +Tab „Bereitstellen" → Klicken Sie auf das Beschreibungssymbol → Beschreibung hinzufügen oder generieren | +|
| API-Endpunkt kopieren | +Tab „Bereitstellen" → API → API-cURL kopieren | +
| Aktion | Wie | Vorschau |
|---|---|---|
| Workflow-Variable hinzufügen / bearbeiten / löschen | +Panel → Variablen → **Variable hinzufügen**, zum Bearbeiten klicken oder Löschsymbol verwenden | +|
| Umgebungsvariable hinzufügen | +Einstellungen → **Umgebungsvariablen** → **Hinzufügen** | +|
| Auf Workflow-Variable verweisen | +Verwenden Sie die Syntax ` |
+ |
| Auf Umgebungsvariable verweisen | +Verwenden Sie die Syntax `{{ENV_VAR}}` in Block-Eingaben | +
<
- Behandle den Start-Block als einzigen Einstiegspunkt, wenn du sowohl API- als auch Chat-Aufrufer unterstützen möchtest.
- Bevorzuge benannte Eingabeformat-Felder gegenüber dem Parsen von rohem JSON in nachgelagerten Knoten; Typumwandlung erfolgt automatisch.
-- Füge Validierung oder Routing unmittelbar nach dem Start hinzu, wenn bestimmte Felder für den Erfolg deines Workflows erforderlich sind.
\ No newline at end of file
+- Füge Validierung oder Routing unmittelbar nach dem Start hinzu, wenn bestimmte Felder für den Erfolg deines Workflows erforderlich sind.
+
+## Best Practices
+
+- Behandeln Sie den Start-Block als einzigen Einstiegspunkt, wenn Sie sowohl API- als auch Chat-Aufrufer unterstützen möchten.
+- Bevorzugen Sie benannte Input-Format-Felder gegenüber dem Parsen von rohem JSON in nachgelagerten Knoten; die Typumwandlung erfolgt automatisch.
+- Fügen Sie unmittelbar nach Start eine Validierung oder ein Routing hinzu, wenn bestimmte Felder für den Erfolg Ihres Workflows erforderlich sind.
\ No newline at end of file
diff --git a/apps/docs/content/docs/es/blocks/agent.mdx b/apps/docs/content/docs/es/blocks/agent.mdx
index 12b1ccfbd..f8da7a466 100644
--- a/apps/docs/content/docs/es/blocks/agent.mdx
+++ b/apps/docs/content/docs/es/blocks/agent.mdx
@@ -156,3 +156,9 @@ Input → Agent (Google Search, Notion) → Function (Compile Report)
- **Sé específico en los prompts del sistema**: Define claramente el rol, tono y limitaciones del agente. Cuanto más específicas sean tus instrucciones, mejor podrá el agente cumplir con su propósito.
- **Elige la configuración de temperatura adecuada**: Usa configuraciones de temperatura más bajas (0-0.3) cuando la precisión sea importante, o aumenta la temperatura (0.7-2.0) para respuestas más creativas o variadas.
- **Aprovecha las herramientas eficazmente**: Integra herramientas que complementen el propósito del agente y mejoren sus capacidades. Sé selectivo con las herramientas que proporcionas para evitar sobrecargar al agente. Para tareas con poco solapamiento, usa otro bloque de Agente para obtener mejores resultados.
+
+## Mejores prácticas
+
+- **Sé específico en los prompts del sistema**: Define claramente el rol, tono y limitaciones del agente. Cuanto más específicas sean tus instrucciones, mejor podrá el agente cumplir con su propósito previsto.
+- **Elige la configuración de temperatura adecuada**: Usa configuraciones de temperatura más bajas (0-0.3) cuando la precisión sea importante, o aumenta la temperatura (0.7-2.0) para respuestas más creativas o variadas
+- **Aprovecha las herramientas de manera efectiva**: Integra herramientas que complementen el propósito del agente y mejoren sus capacidades. Sé selectivo sobre qué herramientas proporcionas para evitar abrumar al agente. Para tareas con poca superposición, usa otro bloque de agente para obtener los mejores resultados.
diff --git a/apps/docs/content/docs/es/blocks/loop.mdx b/apps/docs/content/docs/es/blocks/loop.mdx
index 0546c70f4..acecdbbb7 100644
--- a/apps/docs/content/docs/es/blocks/loop.mdx
+++ b/apps/docs/content/docs/es/blocks/loop.mdx
@@ -248,3 +248,57 @@ while (count < items.length) {
- **Establece límites razonables**: Mantén el número de iteraciones en un nivel razonable para evitar tiempos de ejecución prolongados
- **Usa ForEach para colecciones**: Cuando proceses arrays u objetos, utiliza 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
+
+## Entradas y salidas
+
+
+
+
+ -
+ Tipo de bucle: elige entre 'for', 'forEach', 'while' o 'doWhile'
+
+ -
+ Iteraciones: número de veces a ejecutar (bucles for)
+
+ -
+ Colección: array u objeto sobre el que iterar (bucles forEach)
+
+ -
+ Condición: expresión booleana a evaluar (bucles while/do-while)
+
+
+
+
+ Disponible **dentro** del bucle únicamente:
+
+ -
+ {"
"} : número de iteración actual (basado en 0)
+
+ -
+ {"
"} : elemento actual siendo procesado (solo forEach)
+
+ -
+ {"
"} : colección completa (solo forEach)
+
+
+
+
+
+ -
+ {"
"} : array de todos los resultados de iteración (accedido mediante el nombre del bloque)
+
+ -
+ Estructura: los resultados mantienen el orden de iteración
+
+ -
+ Acceso: disponible en bloques después de que el bucle se complete
+
+
+
+
+
+## Buenas prácticas
+
+- **Establece límites razonables**: mantén los conteos de iteración razonables para evitar tiempos de ejecución largos
+- **Usa ForEach para colecciones**: cuando proceses arrays u objetos, usa ForEach en lugar de bucles For
+- **Maneja errores con elegancia**: considera añadir manejo de errores dentro de los bucles para flujos de trabajo robustos
diff --git a/apps/docs/content/docs/es/blocks/parallel.mdx b/apps/docs/content/docs/es/blocks/parallel.mdx
index b8acc20d4..6b53c74cc 100644
--- a/apps/docs/content/docs/es/blocks/parallel.mdx
+++ b/apps/docs/content/docs/es/blocks/parallel.mdx
@@ -189,3 +189,51 @@ Entendiendo cuándo usar cada uno:
- **Solo operaciones independientes**: Asegúrate de que las operaciones no dependan entre sí
- **Gestionar límites de tasa**: Añade retrasos o limitaciones para flujos de trabajo con uso intensivo de API
- **Manejo de errores**: Cada instancia debe manejar sus propios errores correctamente
+
+## Entradas y salidas
+
+
+
+
+ -
+ Tipo paralelo: elige entre 'count' o 'collection'
+
+ -
+ Count: número de instancias a ejecutar (basado en recuento)
+
+ -
+ Collection: array u objeto a distribuir (basado en colección)
+
+
+
+
+ Disponible **dentro** del paralelo únicamente:
+
+ -
+ {"
"} : número de instancia (basado en 0)
+
+ -
+ {"
"} : elemento para esta instancia (solo basado en colección)
+
+ -
+ {"
"} : colección completa (solo basado en colección)
+
+
+
+
+
+ -
+ {"
"} : array de todos los resultados de instancia (accedido mediante el nombre del bloque)
+
+ -
+ Acceso: disponible en bloques después de que se complete el paralelo
+
+
+
+
+
+## Buenas prácticas
+
+- **Solo operaciones independientes**: asegúrate de que las operaciones no dependan unas de otras
+- **Gestiona los límites de tasa**: añade retrasos o limitación para flujos de trabajo con uso intensivo de API
+- **Gestión de errores**: cada instancia debe gestionar sus propios errores de forma elegante
diff --git a/apps/docs/content/docs/es/blocks/router.mdx b/apps/docs/content/docs/es/blocks/router.mdx
index 18c2287e5..97b984bb0 100644
--- a/apps/docs/content/docs/es/blocks/router.mdx
+++ b/apps/docs/content/docs/es/blocks/router.mdx
@@ -100,3 +100,18 @@ Input (Lead) → Router → Agent (Enterprise Sales) or Workflow (Self-serve)
- **Probar con entradas diversas**: Asegúrate de que el Router maneja varios tipos de entrada, casos extremos y contenido inesperado
- **Monitorear el rendimiento del enrutamiento**: Revisa las decisiones de enrutamiento regularmente y refina los criterios basándote en patrones de uso reales
- **Elegir modelos apropiados**: Usa modelos con fuertes capacidades de razonamiento para decisiones de enrutamiento complejas
+
+Cuando el Router no puede determinar una ruta apropiada para el contexto dado, enrutará a la **ruta de error** en lugar de seleccionar una ruta arbitrariamente. Esto sucede cuando:
+
+- El contexto no coincide claramente con ninguna de las descripciones de ruta definidas
+- La IA determina que ninguna de las rutas disponibles es apropiada
+
+## Mejores prácticas
+
+- **Escribe descripciones de ruta claras**: cada descripción de ruta debe explicar claramente cuándo debe seleccionarse esa ruta. Sé específico sobre los criterios.
+- **Haz que las rutas sean mutuamente excluyentes**: cuando sea posible, asegúrate de que las descripciones de ruta no se superpongan para evitar decisiones de enrutamiento ambiguas.
+- **Conecta una ruta de error**: maneja los casos en los que ninguna ruta coincida conectando un manejador de errores para un comportamiento de respaldo elegante.
+- **Usa títulos de ruta descriptivos**: los títulos de ruta aparecen en el lienzo del flujo de trabajo, así que hazlos significativos para mejorar la legibilidad.
+- **Prueba con entradas diversas**: asegúrate de que el Router maneje varios tipos de entrada, casos extremos y contenido inesperado.
+- **Monitorea el rendimiento del enrutamiento**: revisa las decisiones de enrutamiento regularmente y refina las descripciones de ruta según los patrones de uso reales.
+- **Elige modelos apropiados**: usa modelos con capacidades de razonamiento sólidas para decisiones de enrutamiento complejas.
diff --git a/apps/docs/content/docs/es/copilot/index.mdx b/apps/docs/content/docs/es/copilot/index.mdx
index 38a8b1ccc..5d65b551e 100644
--- a/apps/docs/content/docs/es/copilot/index.mdx
+++ b/apps/docs/content/docs/es/copilot/index.mdx
@@ -169,3 +169,175 @@ copilotCost = (inputTokens × inputPrice + outputTokens × (outputPrice × 1.5))
Los precios de los modelos son por millón de tokens. El cálculo divide por 1.000.000 para obtener el costo real. Consulta la página de Cálculo de Costos para obtener información general y ejemplos.
+
+Pasa el cursor sobre cualquiera de tus mensajes y haz clic en **Editar** para modificarlo y reenviarlo. Esto es útil para refinar tus prompts.
+
+### Cola de mensajes
+
+Si envías un mensaje mientras Copilot aún está respondiendo, se pone en cola. Puedes:
+- Ver los mensajes en cola en el panel expandible de cola
+- Enviar un mensaje en cola inmediatamente (interrumpe la respuesta actual)
+- Eliminar mensajes de la cola
+
+## Archivos adjuntos
+
+Haz clic en el icono de adjunto para subir archivos con tu mensaje. Los tipos de archivo compatibles incluyen:
+- Imágenes (se muestran miniaturas de vista previa)
+- PDFs
+- Archivos de texto, JSON, XML
+- Otros formatos de documentos
+
+Los archivos se muestran como miniaturas en las que se puede hacer clic y que se abren en una nueva pestaña.
+
+## Puntos de control y cambios
+
+Cuando Copilot realiza cambios en tu flujo de trabajo, guarda puntos de control para que puedas revertirlos si es necesario.
+
+### Ver puntos de control
+
+Pasa el cursor sobre un mensaje de Copilot y haz clic en el icono de puntos de control para ver los estados guardados del flujo de trabajo para ese mensaje.
+
+### Revertir cambios
+
+Haz clic en **Revertir** en cualquier punto de control para restaurar tu flujo de trabajo a ese estado. Un diálogo de confirmación te advertirá que esta acción no se puede deshacer.
+
+### Aceptar cambios
+
+Cuando Copilot propone cambios, puedes:
+- **Aceptar**: aplicar los cambios propuestos (`Mod+Shift+Enter`)
+- **Rechazar**: descartar los cambios y mantener tu flujo de trabajo actual
+
+## Bloques de pensamiento
+
+Para solicitudes complejas, Copilot puede mostrar su proceso de razonamiento en bloques de pensamiento expandibles:
+
+- Los bloques se expanden automáticamente mientras Copilot está pensando
+- Haz clic para expandir/contraer manualmente
+- Muestra la duración del proceso de pensamiento
+- Te ayuda a entender cómo Copilot llegó a su solución
+
+## Selección de opciones
+
+Cuando Copilot presenta múltiples opciones, puedes seleccionar usando:
+
+| Control | Acción |
+|---------|--------|
+| **1-9** | Seleccionar opción por número |
+| **Flecha arriba/abajo** | Navegar entre opciones |
+| **Enter** | Seleccionar opción resaltada |
+
+Las opciones seleccionadas están resaltadas; las opciones no seleccionadas aparecen tachadas.
+
+## Atajos de teclado
+
+| Atajo | Acción |
+|----------|--------|
+| `@` | Abrir menú contextual |
+| `/` | Abrir comandos de barra |
+| `Arrow Up/Down` | Navegar elementos del menú |
+| `Enter` | Seleccionar elemento del menú |
+| `Esc` | Cerrar menús |
+| `Mod+Shift+Enter` | Aceptar cambios de Copilot |
+
+## Límites de uso
+
+El uso de Copilot se factura por token del LLM subyacente. Si alcanzas tu límite de uso, Copilot te pedirá que aumentes tu límite. Puedes agregar uso en incrementos ($50, $100) desde tu base actual.
+
+
+ Consulta la [página de cálculo de costos](/execution/costs) para detalles de facturación.
+
+## Copilot MCP
+
+Puedes usar Copilot como servidor MCP en tu editor o cliente de IA favorito. Esto te permite construir, probar, desplegar y gestionar flujos de trabajo de Sim directamente desde herramientas como Cursor, Claude Code, Claude Desktop y VS Code.
+
+### Generar una clave API de Copilot
+
+Para conectarte al servidor MCP de Copilot, necesitas una **clave API de Copilot**:
+
+1. Ve a [sim.ai](https://sim.ai) e inicia sesión
+2. Navega a **Configuración** → **Copilot**
+3. Haz clic en **Generar clave API**
+4. Copia la clave — solo se muestra una vez
+
+La clave se verá como `sk-sim-copilot-...`. Usarás esto en la configuración a continuación.
+
+### Cursor
+
+Agrega lo siguiente a tu `.cursor/mcp.json` (nivel de proyecto) o configuración global de MCP de Cursor:
+
+```json
+{
+ "mcpServers": {
+ "sim-copilot": {
+ "url": "https://www.sim.ai/api/mcp/copilot",
+ "headers": {
+ "X-API-Key": "YOUR_COPILOT_API_KEY"
+ }
+ }
+ }
+}
+```
+
+Reemplaza `YOUR_COPILOT_API_KEY` con la clave que generaste anteriormente.
+
+### Claude Code
+
+Ejecuta el siguiente comando para añadir el servidor MCP de Copilot:
+
+```bash
+claude mcp add sim-copilot \
+ --transport http \
+ https://www.sim.ai/api/mcp/copilot \
+ --header "X-API-Key: YOUR_COPILOT_API_KEY"
+```
+
+Reemplaza `YOUR_COPILOT_API_KEY` con tu clave.
+
+### Claude Desktop
+
+Claude Desktop requiere [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) para conectarse a servidores MCP basados en HTTP. Añade lo siguiente a tu archivo de configuración de Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json` en macOS):
+
+```json
+{
+ "mcpServers": {
+ "sim-copilot": {
+ "command": "npx",
+ "args": [
+ "-y",
+ "mcp-remote",
+ "https://www.sim.ai/api/mcp/copilot",
+ "--header",
+ "X-API-Key: YOUR_COPILOT_API_KEY"
+ ]
+ }
+ }
+}
+```
+
+Reemplaza `YOUR_COPILOT_API_KEY` con tu clave.
+
+### VS Code
+
+Añade lo siguiente a tu `settings.json` de VS Code o al `.vscode/settings.json` del espacio de trabajo:
+
+```json
+{
+ "mcp": {
+ "servers": {
+ "sim-copilot": {
+ "type": "http",
+ "url": "https://www.sim.ai/api/mcp/copilot",
+ "headers": {
+ "X-API-Key": "YOUR_COPILOT_API_KEY"
+ }
+ }
+ }
+ }
+}
+```
+
+Reemplaza `YOUR_COPILOT_API_KEY` con tu clave.
+
+
+ Para implementaciones auto-alojadas, reemplaza `https://www.sim.ai` con tu URL de Sim auto-alojada.
+
diff --git a/apps/docs/content/docs/es/enterprise/index.mdx b/apps/docs/content/docs/es/enterprise/index.mdx
index 1f1b253db..b4a88f1d3 100644
--- a/apps/docs/content/docs/es/enterprise/index.mdx
+++ b/apps/docs/content/docs/es/enterprise/index.mdx
@@ -75,3 +75,40 @@ Para implementaciones self-hosted, las funciones enterprise se pueden activar me
BYOK solo está disponible en Sim alojado. Las implementaciones autoalojadas configuran las claves de proveedor de IA directamente a través de variables de entorno.
+
+Cuando la facturación está deshabilitada, usa la API de administración para gestionar organizaciones:
+
+```bash
+# Create an organization
+curl -X POST https://your-instance/api/v1/admin/organizations \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"name": "My Organization", "ownerId": "user-id-here"}'
+
+# Add a member
+curl -X POST https://your-instance/api/v1/admin/organizations/{orgId}/members \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"userId": "user-id-here", "role": "admin"}'
+```
+
+### Miembros del espacio de trabajo
+
+Cuando las invitaciones están deshabilitadas, usa la API de administración para gestionar las membresías de espacios de trabajo directamente:
+
+```bash
+# Add a user to a workspace
+curl -X POST https://your-instance/api/v1/admin/workspaces/{workspaceId}/members \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"userId": "user-id-here", "permissions": "write"}'
+
+# Remove a user from a workspace
+curl -X DELETE "https://your-instance/api/v1/admin/workspaces/{workspaceId}/members?userId=user-id-here" \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY"
+```
+
+### Notas
+
+- Habilitar `ACCESS_CONTROL_ENABLED` habilita automáticamente las organizaciones, ya que el control de acceso requiere membresía en la organización.
+- Cuando `DISABLE_INVITATIONS` está configurado, los usuarios no pueden enviar invitaciones. Usa la API de administración para gestionar las membresías de espacios de trabajo y organizaciones en su lugar.
diff --git a/apps/docs/content/docs/es/execution/costs.mdx b/apps/docs/content/docs/es/execution/costs.mdx
index 59c5d386a..53b242f51 100644
--- a/apps/docs/content/docs/es/execution/costs.mdx
+++ b/apps/docs/content/docs/es/execution/costs.mdx
@@ -241,4 +241,45 @@ Esto distribuye los cargos por excedentes grandes a lo largo del mes en lugar de
- Revisa tu uso actual en [Configuración → Suscripción](https://sim.ai/settings/subscription)
- Aprende sobre [Registro](/execution/logging) para rastrear detalles de ejecución
- Explora la [API externa](/execution/api) para monitoreo programático de costos
-- Consulta las [técnicas de optimización de flujos de trabajo](/blocks) para reducir costos
\ No newline at end of file
+- Consulta las [técnicas de optimización de flujos de trabajo](/blocks) para reducir costos
+
+**Plan Pro ($20/mes):**
+- La suscripción mensual incluye $20 de uso
+- Uso menor a $20 → Sin cargos adicionales
+- Uso mayor a $20 → Paga el excedente al final del mes
+- Ejemplo: $35 de uso = $20 (suscripción) + $15 (excedente)
+
+**Plan Team ($40/usuario/mes):**
+- Uso compartido entre todos los miembros del equipo
+- Excedente calculado del uso total del equipo
+- El propietario de la organización recibe una sola factura
+
+**Planes Enterprise:**
+- Precio mensual fijo, sin excedentes
+- Límites de uso personalizados según acuerdo
+
+### Facturación por umbral
+
+Cuando el excedente no facturado alcanza $50, Sim factura automáticamente el monto total no facturado.
+
+**Ejemplo:**
+- Día 10: $70 de excedente → Factura $70 inmediatamente
+- Día 15: $35 adicionales de uso ($105 total) → Ya facturado, sin acción
+- Día 20: Otros $50 de uso ($155 total, $85 no facturados) → Factura $85 inmediatamente
+
+Esto distribuye los cargos por excedentes grandes a lo largo del mes en lugar de una sola factura grande al final del período.
+
+## Mejores prácticas de gestión de costos
+
+1. **Monitorea regularmente**: Revisa tu panel de uso frecuentemente para evitar sorpresas
+2. **Establece presupuestos**: Usa los límites del plan como barreras para tu gasto
+3. **Optimiza flujos de trabajo**: Revisa las ejecuciones de alto costo y optimiza prompts o selección de modelos
+4. **Usa modelos apropiados**: Ajusta la complejidad del modelo a los requisitos de la tarea
+5. **Agrupa tareas similares**: Combina múltiples solicitudes cuando sea posible para reducir la sobrecarga
+
+## Próximos pasos
+
+- Revisa tu uso actual en [Configuración → Suscripción](https://sim.ai/settings/subscription)
+- Aprende sobre [Registro](/execution/logging) para rastrear detalles de ejecución
+- Explora la [API externa](/execution/api) para monitoreo programático de costos
+- Consulta [técnicas de optimización de flujos de trabajo](/blocks) para reducir costos
\ No newline at end of file
diff --git a/apps/docs/content/docs/es/execution/files.mdx b/apps/docs/content/docs/es/execution/files.mdx
new file mode 100644
index 000000000..f45aa5382
--- /dev/null
+++ b/apps/docs/content/docs/es/execution/files.mdx
@@ -0,0 +1,172 @@
+---
+title: Pasar archivos
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+
+Sim facilita el trabajo con archivos a lo largo de tus flujos de trabajo. Los bloques pueden recibir archivos, procesarlos y pasarlos a otros bloques sin problemas.
+
+## Objetos de archivo
+
+Cuando los bloques generan archivos (como adjuntos de Gmail, imágenes generadas o documentos analizados), devuelven un objeto de archivo estandarizado:
+
+```json
+{
+ "name": "report.pdf",
+ "url": "https://...",
+ "base64": "JVBERi0xLjQK...",
+ "type": "application/pdf",
+ "size": 245678
+}
+```
+
+Puedes acceder a cualquiera de estas propiedades al hacer referencia a archivos de bloques anteriores.
+
+## El bloque de archivo
+
+El **bloque de archivo** es el punto de entrada universal para archivos en tus flujos de trabajo. Acepta archivos de cualquier fuente y genera objetos de archivo estandarizados que funcionan con todas las integraciones.
+
+**Entradas:**
+- **Archivos cargados** - Arrastra y suelta o selecciona archivos directamente
+- **URLs externas** - Cualquier URL de archivo públicamente accesible
+- **Archivos de otros bloques** - Pasa archivos de adjuntos de Gmail, descargas de Slack, etc.
+
+**Salidas:**
+- Una lista de objetos `UserFile` con estructura consistente (`name`, `url`, `base64`, `type`, `size`)
+- `combinedContent` - Contenido de texto extraído de todos los archivos (para documentos)
+
+**Ejemplo de uso:**
+
+```
+// Get all files from the File block
+
+
+// Get the first file
+
+
+// Get combined text content from parsed documents
+
+```
+
+El bloque de archivo automáticamente:
+- Detecta tipos de archivo desde URLs y extensiones
+- Extrae texto de PDFs, CSVs y documentos
+- Genera codificación base64 para archivos binarios
+- Crea URLs prefirmadas para acceso seguro
+
+Usa el bloque de archivo cuando necesites normalizar archivos de diferentes fuentes antes de pasarlos a otros bloques como Vision, STT o integraciones de correo electrónico.
+
+## Pasar archivos entre bloques
+
+Haz referencia a archivos de bloques anteriores usando el menú desplegable de etiquetas. Haz clic en cualquier campo de entrada de archivo y escribe `<` para ver las salidas disponibles.
+
+**Patrones comunes:**
+
+```
+// Single file from a block
+
+
+// Pass the whole file object
+
+
+// Access specific properties
+
+
+```
+
+La mayoría de los bloques aceptan el objeto de archivo completo y extraen lo que necesitan automáticamente. No necesitas extraer manualmente `base64` o `url` en la mayoría de los casos.
+
+## Activar flujos de trabajo con archivos
+
+Al llamar a un flujo de trabajo a través de la API que espera entrada de archivos, incluye los archivos en tu solicitud:
+
+
+
+
+ ```bash
+ curl -X POST "https://sim.ai/api/workflows/YOUR_WORKFLOW_ID/execute" \
+ -H "Content-Type: application/json" \
+ -H "x-api-key: YOUR_API_KEY" \
+ -d '{
+ "document": {
+ "name": "report.pdf",
+ "base64": "JVBERi0xLjQK...",
+ "type": "application/pdf"
+ }
+ }'
+ ```
+
+
+
+
+ ```bash
+ curl -X POST "https://sim.ai/api/workflows/YOUR_WORKFLOW_ID/execute" \
+ -H "Content-Type: application/json" \
+ -H "x-api-key: YOUR_API_KEY" \
+ -d '{
+ "document": {
+ "name": "report.pdf",
+ "url": "https://example.com/report.pdf",
+ "type": "application/pdf"
+ }
+ }'
+ ```
+
+
+
+
+El bloque de inicio del flujo de trabajo debe tener un campo de entrada configurado para recibir el parámetro de archivo.
+
+## Recibir archivos en respuestas de API
+
+Cuando un flujo de trabajo genera archivos, se incluyen en la respuesta:
+
+```json
+{
+ "success": true,
+ "output": {
+ "generatedFile": {
+ "name": "output.png",
+ "url": "https://...",
+ "base64": "iVBORw0KGgo...",
+ "type": "image/png",
+ "size": 34567
+ }
+ }
+}
+```
+
+Usa `url` para descargas directas o `base64` para procesamiento en línea.
+
+## Bloques que funcionan con archivos
+
+**Entradas de archivos:**
+- **File** - Analiza documentos, imágenes y archivos de texto
+- **Vision** - Analiza imágenes con modelos de IA
+- **Mistral Parser** - Extrae texto de PDFs
+
+**Salidas de archivos:**
+- **Gmail** - Archivos adjuntos de correo electrónico
+- **Slack** - Archivos descargados
+- **TTS** - Archivos de audio generados
+- **Video Generator** - Videos generados
+- **Image Generator** - Imágenes generadas
+
+**Almacenamiento de archivos:**
+- **Supabase** - Subir/descargar desde almacenamiento
+- **S3** - Operaciones de AWS S3
+- **Google Drive** - Operaciones de archivos de Drive
+- **Dropbox** - Operaciones de archivos de Dropbox
+
+
+ Los archivos están disponibles automáticamente para los bloques posteriores. El motor de ejecución maneja toda la transferencia de archivos y conversión de formato.
+
+
+## Mejores prácticas
+
+1. **Usa objetos de archivo directamente** - Pasa el objeto de archivo completo en lugar de extraer propiedades individuales. Los bloques manejan la conversión automáticamente.
+
+2. **Verifica los tipos de archivo** - Asegúrate de que el tipo de archivo coincida con lo que espera el bloque receptor. El bloque Vision necesita imágenes, el bloque File maneja documentos.
+
+3. **Considera el tamaño del archivo** - Los archivos grandes aumentan el tiempo de ejecución. Para archivos muy grandes, considera usar bloques de almacenamiento (S3, Supabase) para almacenamiento intermedio.
diff --git a/apps/docs/content/docs/es/execution/form.mdx b/apps/docs/content/docs/es/execution/form.mdx
new file mode 100644
index 000000000..2baf26da3
--- /dev/null
+++ b/apps/docs/content/docs/es/execution/form.mdx
@@ -0,0 +1,142 @@
+---
+title: Despliegue de formulario
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+
+Despliega tu flujo de trabajo como un formulario embebible que los usuarios pueden completar en tu sitio web o compartir mediante enlace. Los envíos de formulario activan tu flujo de trabajo con el tipo de activador `form`.
+
+## Descripción general
+
+El despliegue de formulario convierte el formato de entrada de tu flujo de trabajo en un formulario responsivo que puede ser:
+- Compartido mediante un enlace directo (ej., `https://sim.ai/form/my-survey`)
+- Embebido en cualquier sitio web usando un iframe
+
+Cuando un usuario envía el formulario, activa tu flujo de trabajo con los datos del formulario.
+
+
+Los formularios derivan sus campos del formato de entrada del bloque de inicio de tu flujo de trabajo. Cada campo se convierte en una entrada de formulario con el tipo apropiado.
+
+
+## Crear un formulario
+
+1. Abre tu flujo de trabajo y haz clic en **Desplegar**
+2. Selecciona la pestaña **Formulario**
+3. Configura:
+ - **URL**: Identificador único (ej., `contact-form` → `sim.ai/form/contact-form`)
+ - **Título**: Encabezado del formulario
+ - **Descripción**: Subtítulo opcional
+ - **Campos del formulario**: Personaliza etiquetas y descripciones para cada campo
+ - **Autenticación**: Pública, protegida por contraseña o lista blanca de correos
+ - **Mensaje de agradecimiento**: Se muestra después del envío
+4. Haz clic en **Lanzar**
+
+## Mapeo de tipos de campo
+
+| Tipo de formato de entrada | Campo de formulario |
+|------------------|------------|
+| `string` | Entrada de texto |
+| `number` | Entrada numérica |
+| `boolean` | Interruptor de alternancia |
+| `object` | Editor JSON |
+| `array` | Editor de array JSON |
+| `files` | Carga de archivo |
+
+## Control de acceso
+
+| Modo | Descripción |
+|------|-------------|
+| **Público** | Cualquiera con el enlace puede enviar |
+| **Contraseña** | Los usuarios deben ingresar una contraseña |
+| **Lista blanca de correos** | Solo los correos/dominios especificados pueden enviar |
+
+Para lista blanca de correos:
+- Exacto: `user@example.com`
+- Dominio: `@example.com` (todos los correos del dominio)
+
+## Incrustación
+
+### Enlace directo
+
+```
+https://sim.ai/form/your-identifier
+```
+
+### Iframe
+
+```html
+
+```
+
+## Envío por API
+
+Envía formularios de forma programática:
+
+
+
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+ -H "Content-Type: application/json" \
+ -d '{
+ "formData": {
+ "name": "John Doe",
+ "email": "john@example.com"
+ }
+ }'
+```
+
+
+
+
+```typescript
+const response = await fetch('https://sim.ai/api/form/your-identifier', {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({
+ formData: {
+ name: 'John Doe',
+ email: 'john@example.com'
+ }
+ })
+});
+
+const result = await response.json();
+// { success: true, data: { executionId: '...' } }
+```
+
+
+
+
+### Formularios protegidos
+
+Para formularios protegidos con contraseña:
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+ -H "Content-Type: application/json" \
+ -d '{ "password": "secret", "formData": { "name": "John" } }'
+```
+
+Para formularios protegidos con correo:
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+ -H "Content-Type: application/json" \
+ -d '{ "email": "allowed@example.com", "formData": { "name": "John" } }'
+```
+
+## Solución de problemas
+
+**"No hay campos de entrada configurados"** - Añade campos de formato de entrada a tu bloque de inicio.
+
+**El formulario no se carga en el iframe** - Verifica que el CSP de tu sitio permita iframes desde `sim.ai`.
+
+**Los envíos fallan** - Verifica que el identificador sea correcto y que los campos obligatorios estén completos.
diff --git a/apps/docs/content/docs/es/quick-reference/index.mdx b/apps/docs/content/docs/es/quick-reference/index.mdx
new file mode 100644
index 000000000..f09a5397f
--- /dev/null
+++ b/apps/docs/content/docs/es/quick-reference/index.mdx
@@ -0,0 +1,394 @@
+---
+title: Referencia rápida
+description: Acciones esenciales para navegar y usar el editor de flujos de trabajo de Sim
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { ActionImage, ActionVideo } from '@/components/ui/action-media'
+
+Una consulta rápida para las acciones cotidianas en el editor de flujos de trabajo de Sim. Para atajos de teclado, consulta [Atajos de teclado](/keyboard-shortcuts).
+
+
+ **Mod** se refiere a `Cmd` en macOS y `Ctrl` en Windows/Linux.
+
+
+## Espacios de trabajo
+
+
+
+ Acción Cómo Vista previa
+ Crear un espacio de trabajo
+ Haz clic en el menú desplegable de espacio de trabajo → **Nuevo espacio de trabajo**
+
+
+ Cambiar de espacio de trabajo
+ Haz clic en el menú desplegable de espacio de trabajo → Selecciona el espacio de trabajo
+
+
+ Invitar miembros del equipo
+ Barra lateral → **Invitar**
+
+
+ Renombrar un espacio de trabajo
+ Haz clic derecho en el espacio de trabajo → **Renombrar**
+
+
+ Duplicar un espacio de trabajo
+ Haz clic derecho en el espacio de trabajo → **Duplicar**
+
+
+ Exportar un espacio de trabajo
+ Haz clic derecho en el espacio de trabajo → **Exportar**
+
+
+ Eliminar un espacio de trabajo
+ Haz clic derecho en el espacio de trabajo → **Eliminar**
+
+
+
+
+## Flujos de trabajo
+
+
+
+ Acción Cómo Vista previa
+ Crear un flujo de trabajo
+ Haz clic en el botón **+** en la barra lateral
+
+
+ Reordenar / mover flujos de trabajo
+ Arrastra el flujo de trabajo hacia arriba/abajo o sobre una carpeta
+
+
+ Importar un flujo de trabajo
+ Haz clic en el botón de importar en la barra lateral → Selecciona el archivo
+
+
+ Seleccionar múltiples flujos de trabajo
+ `Mod+Click` o `Shift+Click` flujos de trabajo en la barra lateral
+
+
+ Abrir en nueva pestaña
+ Haz clic derecho en el flujo de trabajo → **Abrir en nueva pestaña**
+
+
+ Renombrar un flujo de trabajo
+ Haz clic derecho en el flujo de trabajo → **Renombrar**
+
+
+ Asignar color al flujo de trabajo
+ Haz clic derecho en el flujo de trabajo → **Cambiar color**
+
+
+ Duplicar un flujo de trabajo
+ Haz clic derecho en el flujo de trabajo → **Duplicar**
+
+
+ Exportar un flujo de trabajo
+ Haz clic derecho en el flujo de trabajo → **Exportar**
+
+
+ Eliminar un flujo de trabajo
+ Haz clic derecho en el flujo de trabajo → **Eliminar**
+
+
+ Renombrar una carpeta
+ Haz clic derecho en la carpeta → **Renombrar**
+
+
+ Crear flujo de trabajo en carpeta
+ Haz clic derecho en la carpeta → **Crear flujo de trabajo**
+
+
+ Crear carpeta dentro de carpeta
+ Haz clic derecho en la carpeta → **Crear carpeta**
+
+
+ Duplicar una carpeta
+ Haz clic derecho en la carpeta → **Duplicar**
+
+
+ Exportar una carpeta
+ Haz clic derecho en la carpeta → **Exportar**
+
+
+ Eliminar una carpeta
+ Haz clic derecho en la carpeta → **Eliminar**
+
+
+
+
+## Bloques
+
+
+
+ Acción Cómo Vista previa
+ Añadir un bloque
+ Arrastra desde el panel de herramientas, o clic derecho en el lienzo → **Añadir bloque**
+
+
+ Seleccionar múltiples bloques
+ `Mod+Click` bloques adicionales, o arrastra con shift para dibujar un cuadro de selección
+
+
+ Copiar bloques
+ `Mod+C` con bloques seleccionados
+
+
+ Pegar bloques
+ `Mod+V` para pegar los bloques copiados
+
+
+ Duplicar bloques
+ Clic derecho → **Duplicar**
+
+
+ Eliminar bloques
+ Tecla `Delete` o `Backspace`, o clic derecho → **Eliminar**
+
+
+ Renombrar un bloque
+ Haz clic en el nombre del bloque en el encabezado, o edítalo en el panel del editor
+
+
+ Activar/desactivar un bloque
+ Clic derecho → **Activar/Desactivar**
+
+
+ Bloquear/desbloquear un bloque
+ Pasa el cursor sobre el bloque → Haz clic en el icono de candado (solo administrador)
+
+
+ Alternar orientación de los conectores
+ Clic derecho → **Alternar conectores**
+
+
+ Configurar un bloque
+ Selecciona el bloque → usa el panel del editor a la derecha
+
+
+
+
+## Conexiones
+
+
+
+ Acción Cómo Vista previa
+ Crear una conexión
+ Arrastra desde el conector de salida al conector de entrada
+
+
+ Eliminar una conexión
+ Haz clic en la línea para seleccionarla → tecla `Delete`
+
+
+ Usar salida en otro bloque
+ Arrastra la etiqueta de conexión al campo de entrada
+
+
+
+
+## Paneles y vistas
+
+
+
+ Acción Cómo Vista previa
+ Barra de búsqueda
+ `Mod+F`
+
+
+ Buscar todo
+ `Mod+K`
+
+
+ Alternar modo manual
+ Haz clic en el botón de alternancia para cambiar entre manual y selector
+
+
+ Contraer/expandir barra lateral
+ Haz clic en el botón de contraer en la barra lateral
+
+
+
+
+## Ejecución y pruebas
+
+
+
+ Acción Cómo Vista previa
+ Ejecutar flujo de trabajo
+ Haz clic en el botón Ejecutar flujo de trabajo o `Mod+Enter`
+
+
+ Detener flujo de trabajo
+ Haz clic en el botón Detener o `Mod+Enter` mientras se ejecuta
+
+
+ Probar con chat
+ Usa el panel de chat en el lado derecho
+
+
+ Seleccionar salida para ver
+ Haz clic en el menú desplegable en el panel de chat → Selecciona la salida del bloque
+
+
+ Limpiar historial de chat
+ Haz clic en el botón de limpiar en el panel de chat
+
+
+ Ejecutar desde bloque
+ Pasa el cursor sobre el bloque → Haz clic en el botón de reproducción, o clic derecho → **Ejecutar desde bloque**
+
+
+ Ejecutar hasta bloque
+ Clic derecho en el bloque → **Ejecutar hasta bloque**
+
+
+ Ver registros de ejecución
+ Abre el panel de terminal en la parte inferior, o `Mod+L`
+
+
+ Filtrar registros
+ Haz clic en el icono de filtro en el terminal → Filtra por bloque o estado
+
+
+ Buscar registros
+ Usa el campo de búsqueda en el terminal o clic derecho en la entrada de registro → **Buscar**
+
+
+ Copiar entrada de registro
+ Icono de portapapeles o clic derecho en la entrada de registro → **Copiar**
+
+
+ Limpiar terminal
+ Icono de papelera o `Mod+D`
+
+
+
+
+## Despliegue
+
+
+
+ Acción Cómo Vista previa
+ Desplegar un flujo de trabajo
+ Haz clic en el botón **Deploy** en el panel
+
+
+ Actualizar despliegue
+ Haz clic en **Update** cuando se detecten cambios
+
+
+ Ver estado del despliegue
+ Verifica el indicador de estado (Live/Update/Deploy) en la pestaña Deploy
+
+
+ Revertir despliegue
+ Accede a versiones anteriores en la pestaña Deploy → **Promote to live**
+
+
+ Añadir descripción de versión
+ Pestaña Deploy → Haz clic en el icono de descripción → Añade o genera una descripción
+
+
+ Copiar endpoint de API
+ Pestaña Deploy → API → Copy API cURL
+
+
+
+
+## Variables
+
+
+
+ Acción Cómo Vista previa
+ Añadir / Editar / Eliminar variable de flujo de trabajo
+ Panel -> Variables -> **Add Variable**, haz clic para editar o en el icono de eliminar
+
+
+ Añadir variable de entorno
+ Settings → **Environment Variables** → **Add**
+
+
+ Referenciar una variable de flujo de trabajo
+ Usa la sintaxis `` en las entradas de bloque
+
+
+ Referenciar una variable de entorno
+ Usa la sintaxis `{{ENV_VAR}}` en las entradas de bloque
+
+
+
diff --git a/apps/docs/content/docs/es/self-hosting/index.mdx b/apps/docs/content/docs/es/self-hosting/index.mdx
index 2b9c5c1ef..7acbcb4b4 100644
--- a/apps/docs/content/docs/es/self-hosting/index.mdx
+++ b/apps/docs/content/docs/es/self-hosting/index.mdx
@@ -56,3 +56,10 @@ Abre [http://localhost:3000](http://localhost:3000)
| realtime | 3002 | Servidor WebSocket |
| db | 5432 | PostgreSQL con pgvector |
| migrations | - | Migraciones de base de datos (se ejecuta una vez) |
+
+| Componente | Puerto | Descripción |
+|-----------|------|-------------|
+| simstudio | 3000 | Aplicación principal |
+| realtime | 3002 | Servidor WebSocket |
+| db | 5432 | PostgreSQL con pgvector |
+| migrations | - | Migraciones de base de datos (se ejecuta una vez) |
diff --git a/apps/docs/content/docs/es/skills/index.mdx b/apps/docs/content/docs/es/skills/index.mdx
new file mode 100644
index 000000000..daad66d6b
--- /dev/null
+++ b/apps/docs/content/docs/es/skills/index.mdx
@@ -0,0 +1,134 @@
+---
+title: Habilidades del agente
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+
+Las habilidades del agente son paquetes reutilizables de instrucciones que otorgan capacidades especializadas a tus agentes de IA. Basadas en el formato abierto [Agent Skills](https://agentskills.io), las habilidades te permiten capturar experiencia de dominio, flujos de trabajo y mejores prácticas que los agentes pueden cargar bajo demanda.
+
+## Cómo funcionan las habilidades
+
+Las habilidades utilizan **divulgación progresiva** para mantener el contexto del agente ligero:
+
+1. **Descubrimiento** — Solo los nombres y descripciones de las habilidades se incluyen en el prompt del sistema del agente (~50-100 tokens cada uno)
+2. **Activación** — Cuando el agente decide que una habilidad es relevante, llama a la herramienta `load_skill` para cargar las instrucciones completas en el contexto
+3. **Ejecución** — El agente sigue las instrucciones cargadas para completar la tarea
+
+Esto significa que puedes adjuntar muchas habilidades a un agente sin saturar su ventana de contexto. El agente solo carga lo que necesita.
+
+## Crear habilidades
+
+Ve a **Configuración** y selecciona **Habilidades** en la sección Herramientas.
+
+
+
+Haz clic en **Añadir** para crear una nueva habilidad con tres campos:
+
+| Campo | Descripción |
+|-------|-------------|
+| **Nombre** | Un identificador en formato kebab-case (p. ej. `sql-expert`, `code-reviewer`). Máximo 64 caracteres. |
+| **Descripción** | Una breve explicación de qué hace la habilidad y cuándo usarla. Esto es lo que el agente lee para decidir si activar la habilidad. Máximo 1024 caracteres. |
+| **Contenido** | Las instrucciones completas de la habilidad en markdown. Esto se carga cuando el agente activa la habilidad. |
+
+
+ La descripción es fundamental — es lo único que el agente ve antes de decidir cargar una habilidad. Sé específico sobre cuándo y por qué debe usarse la habilidad.
+
+
+### Escribir buen contenido de habilidades
+
+El contenido de habilidades sigue las mismas convenciones que los [archivos SKILL.md](https://agentskills.io/specification):
+
+```markdown
+# SQL Expert
+
+## When to use this skill
+Use when the user asks you to write, optimize, or debug SQL queries.
+
+## Instructions
+1. Always ask which database engine (PostgreSQL, MySQL, SQLite)
+2. Use CTEs over subqueries for readability
+3. Add index recommendations when relevant
+4. Explain query plans for optimization requests
+
+## Common Patterns
+...
+```
+
+**Estructura recomendada:**
+- **Cuándo usar** — Disparadores y escenarios específicos
+- **Instrucciones** — Guía paso a paso con listas numeradas
+- **Ejemplos** — Muestras de entrada/salida que muestran el comportamiento esperado
+- **Patrones comunes** — Enfoques reutilizables para tareas frecuentes
+- **Casos especiales** — Detalles importantes y consideraciones especiales
+
+Mantén las habilidades enfocadas y con menos de 500 líneas. Si una habilidad crece demasiado, divídela en múltiples habilidades especializadas.
+
+## Añadir habilidades a un agente
+
+Abre cualquier bloque de **Agente** y encuentra el menú desplegable **Habilidades** debajo de la sección de herramientas. Selecciona las habilidades a las que quieres que el agente tenga acceso.
+
+
+
+Las habilidades seleccionadas aparecen como tarjetas en las que puedes hacer clic para editar o eliminar.
+
+### Qué sucede en tiempo de ejecución
+
+Cuando se ejecuta el flujo de trabajo:
+
+1. El prompt del sistema del agente incluye una sección `` que enumera el nombre y la descripción de cada habilidad
+2. Una herramienta `load_skill` se añade automáticamente a las herramientas disponibles del agente
+3. Cuando el agente determina que una habilidad es relevante para la tarea actual, llama a `load_skill` con el nombre de la habilidad
+4. El contenido completo de la habilidad se devuelve como respuesta de herramienta, proporcionando al agente instrucciones detalladas
+
+Esto funciona en todos los proveedores de LLM compatibles: la herramienta `load_skill` utiliza llamadas de herramientas estándar, por lo que no se necesita configuración específica del proveedor.
+
+## Casos de uso comunes
+
+Las habilidades son más valiosas cuando los agentes necesitan conocimientos especializados o flujos de trabajo de múltiples pasos:
+
+**Experiencia de dominio**
+- `api-integration-expert` — Mejores prácticas para llamar a APIs específicas (autenticación, limitación de velocidad, manejo de errores)
+- `data-transformation` — Patrones ETL, limpieza de datos y reglas de validación
+- `code-reviewer` — Directrices de revisión de código específicas para los estándares de tu equipo
+
+**Plantillas de flujo de trabajo**
+- `bug-investigation` — Metodología de depuración paso a paso (reproducir → aislar → probar → corregir)
+- `feature-implementation` — Flujo de trabajo de desarrollo desde requisitos hasta despliegue
+- `document-generator` — Plantillas y reglas de formato para documentación técnica
+
+**Conocimiento específico de la empresa**
+- `our-architecture` — Diagramas de arquitectura del sistema, dependencias de servicios y procesos de despliegue
+- `style-guide` — Guías de marca, tono de escritura, patrones de UI/UX
+- `customer-onboarding` — Procedimientos estándar y preguntas frecuentes de clientes
+
+**Cuándo usar habilidades vs. instrucciones de agente:**
+- Usa **habilidades** para conocimiento que se aplica a múltiples flujos de trabajo o cambia frecuentemente
+- Usa **instrucciones de agente** para contexto específico de tareas que es único para un solo agente
+
+## Mejores prácticas
+
+**Escribir descripciones efectivas**
+- **Sé específico y rico en palabras clave** — En lugar de "Ayuda con SQL", escribe "Escribe consultas SQL optimizadas para PostgreSQL, MySQL y SQLite, incluyendo recomendaciones de índices y análisis de planes de consulta"
+- **Incluye disparadores de activación** — Menciona palabras o frases específicas que deberían activar la habilidad (ej., "Usar cuando el usuario mencione PDFs, formularios o extracción de documentos")
+- **Mantenlo bajo 200 palabras** — Los agentes escanean descripciones rápidamente; haz que cada palabra cuente
+
+**Alcance y organización de habilidades**
+- **Una habilidad por dominio** — Una habilidad enfocada en `sql-expert` funciona mejor que una habilidad amplia de `database-everything`
+- **Limita a 5-10 habilidades por agente** — Más habilidades = más sobrecarga de decisión; comienza pequeño y añade según sea necesario
+- **Divide habilidades grandes** — Si una habilidad supera las 500 líneas, divídela en sub-habilidades enfocadas
+
+**Estructura de contenido**
+- **Usa formato markdown** — Encabezados, listas y bloques de código ayudan a los agentes a analizar y seguir instrucciones
+- **Proporciona ejemplos** — Muestra pares de entrada/salida para que los agentes entiendan el comportamiento esperado
+- **Sé explícito sobre casos extremos** — No asumas que los agentes inferirán manejo especial
+
+**Pruebas e iteración**
+- **Prueba de activación** — Ejecuta tu flujo de trabajo y verifica que el agente cargue la habilidad cuando se espera
+- **Verifica falsos positivos** — Asegúrate de que las habilidades no se activen cuando no deberían
+- **Refina las descripciones** — Si una habilidad no se carga cuando es necesario, añade más palabras clave a la descripción
+
+## Más información
+
+- [Especificación de Agent Skills](https://agentskills.io) — El formato abierto para habilidades de agentes portátiles
+- [Ejemplos de habilidades](https://github.com/anthropics/skills) — Explora ejemplos de habilidades de la comunidad
+- [Mejores prácticas](https://agentskills.io/what-are-skills) — Cómo escribir habilidades efectivas
diff --git a/apps/docs/content/docs/es/tools/a2a.mdx b/apps/docs/content/docs/es/tools/a2a.mdx
new file mode 100644
index 000000000..9a5399da5
--- /dev/null
+++ b/apps/docs/content/docs/es/tools/a2a.mdx
@@ -0,0 +1,207 @@
+---
+title: A2A
+description: Interactúa con agentes externos compatibles con A2A
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+&l
- Trata el bloque Start como el único punto de entrada cuando quieras admitir tanto llamadas de API como de chat.
- Prefiere campos de Formato de Entrada con nombre en lugar de analizar JSON sin procesar en nodos posteriores; la conversión de tipos ocurre automáticamente.
+- Añade validación o enrutamiento inmediatamente después de Start si ciertos campos son necesarios para que tu flujo de trabajo tenga éxito.
+
+## Mejores prácticas
+
+- Trata el bloque Start como el único punto de entrada cuando quieras admitir tanto llamadas de API como de chat.
+- Prefiere campos de Input Format con nombre en lugar de analizar JSON sin procesar en nodos posteriores; la coerción de tipos ocurre automáticamente.
- Añade validación o enrutamiento inmediatamente después de Start si ciertos campos son necesarios para que tu flujo de trabajo tenga éxito.
\ No newline at end of file
diff --git a/apps/docs/content/docs/fr/blocks/agent.mdx b/apps/docs/content/docs/fr/blocks/agent.mdx
index b543ef4ff..c2252b1de 100644
--- a/apps/docs/content/docs/fr/blocks/agent.mdx
+++ b/apps/docs/content/docs/fr/blocks/agent.mdx
@@ -156,3 +156,9 @@ Input → Agent (Google Search, Notion) → Function (Compile Report)
- **Soyez précis dans les instructions système** : Définissez clairement le rôle, le ton et les limites de l'agent. Plus vos instructions sont spécifiques, mieux l'agent pourra remplir sa mission.
- **Choisissez le bon réglage de température** : Utilisez des réglages de température plus bas (0-0,3) lorsque la précision est importante, ou augmentez la température (0,7-2,0) pour des réponses plus créatives ou variées
- **Utilisez efficacement les outils** : Intégrez des outils qui complètent l'objectif de l'agent et améliorent ses capacités. Soyez sélectif dans le choix des outils pour éviter de surcharger l'agent. Pour les tâches avec peu de chevauchement, utilisez un autre bloc Agent pour obtenir les meilleurs résultats.
+
+## Bonnes pratiques
+
+- **Soyez précis dans les prompts système** : définissez clairement le rôle, le ton et les limites de l'agent. Plus vos instructions sont précises, mieux l'agent pourra remplir sa fonction prévue.
+- **Choisissez le bon réglage de température** : utilisez des réglages de température plus bas (0-0,3) lorsque la précision est importante, ou augmentez la température (0,7-2,0) pour des réponses plus créatives ou variées
+- **Exploitez les outils efficacement** : intégrez des outils qui complètent l'objectif de l'agent et améliorent ses capacités. Soyez sélectif quant aux outils que vous fournissez pour éviter de surcharger l'agent. Pour les tâches avec peu de chevauchement, utilisez un autre bloc Agent pour obtenir les meilleurs résultats.
diff --git a/apps/docs/content/docs/fr/blocks/loop.mdx b/apps/docs/content/docs/fr/blocks/loop.mdx
index e43d91713..04f38daef 100644
--- a/apps/docs/content/docs/fr/blocks/loop.mdx
+++ b/apps/docs/content/docs/fr/blocks/loop.mdx
@@ -255,3 +255,57 @@ return results;
- **Définir des limites raisonnables** : Gardez un nombre d'itérations raisonnable pour éviter des temps d'exécution longs
- **Utilisez ForEach pour les collections** : Lors du traitement de tableaux ou d'objets, utilisez les boucles ForEach plutôt que les boucles For
- **Gérez les erreurs avec élégance** : Envisagez d'ajouter une gestion des erreurs à l'intérieur des boucles pour des workflows robustes
+
+## Entrées et sorties
+
+
+
+
+ -
+ Type de boucle : choisissez entre 'for', 'forEach', 'while' ou 'doWhile'
+
+ -
+ Itérations : nombre de fois à exécuter (boucles for)
+
+ -
+ Collection : tableau ou objet sur lequel itérer (boucles forEach)
+
+ -
+ Condition : expression booléenne à évaluer (boucles while/do-while)
+
+
+
+
+ Disponible **à l'intérieur** de la boucle uniquement :
+
+ -
+ {"
"} : numéro d'itération actuel (base 0)
+
+ -
+ {"
"} : élément actuel en cours de traitement (forEach uniquement)
+
+ -
+ {"
"} : collection complète (forEach uniquement)
+
+
+
+
+
+ -
+ {"
"} : tableau de tous les résultats d'itération (accessible via le nom du bloc)
+
+ -
+ Structure : les résultats conservent l'ordre d'itération
+
+ -
+ Accès : disponible dans les blocs après la fin de la boucle
+
+
+
+
+
+## Bonnes pratiques
+
+- **Définissez des limites raisonnables** : maintenez des nombres d'itérations raisonnables pour éviter des temps d'exécution longs
+- **Utilisez forEach pour les collections** : lors du traitement de tableaux ou d'objets, utilisez forEach plutôt que des boucles for
+- **Gérez les erreurs avec élégance** : envisagez d'ajouter une gestion des erreurs à l'intérieur des boucles pour des workflows robustes
diff --git a/apps/docs/content/docs/fr/blocks/parallel.mdx b/apps/docs/content/docs/fr/blocks/parallel.mdx
index 1f196feee..127b4348e 100644
--- a/apps/docs/content/docs/fr/blocks/parallel.mdx
+++ b/apps/docs/content/docs/fr/blocks/parallel.mdx
@@ -189,3 +189,51 @@ Comprendre quand utiliser chacun :
- **Opérations indépendantes uniquement** : Assurez-vous que les opérations ne dépendent pas les unes des autres
- **Gérer les limites de taux** : Ajoutez des délais ou une limitation pour les workflows intensifs en API
- **Gestion des erreurs** : Chaque instance doit gérer ses propres erreurs avec élégance
+
+## Entrées et sorties
+
+
+
+
+ -
+ Type parallèle : choisissez entre « count » ou « collection »
+
+ -
+ Count : nombre d'instances à exécuter (basé sur le comptage)
+
+ -
+ Collection : tableau ou objet à distribuer (basé sur la collection)
+
+
+
+
+ Disponible **à l'intérieur** du parallèle uniquement :
+
+ -
+ {"
"} : numéro d'instance (base 0)
+
+ -
+ {"
"} : élément pour cette instance (collection uniquement)
+
+ -
+ {"
"} : collection complète (collection uniquement)
+
+
+
+
+
+ -
+ {"
"} : tableau de tous les résultats d'instance (accessible via le nom du bloc)
+
+ -
+ Accès : disponible dans les blocs après la fin du parallèle
+
+
+
+
+
+## Bonnes pratiques
+
+- **Opérations indépendantes uniquement** : assurez-vous que les opérations ne dépendent pas les unes des autres
+- **Gérer les limites de débit** : ajoutez des délais ou une limitation pour les workflows intensifs en API
+- **Gestion des erreurs** : chaque instance doit gérer ses propres erreurs de manière appropriée
diff --git a/apps/docs/content/docs/fr/blocks/router.mdx b/apps/docs/content/docs/fr/blocks/router.mdx
index 29f42dc6c..0ae078f10 100644
--- a/apps/docs/content/docs/fr/blocks/router.mdx
+++ b/apps/docs/content/docs/fr/blocks/router.mdx
@@ -100,3 +100,18 @@ Input (Lead) → Router → Agent (Enterprise Sales) or Workflow (Self-serve)
- **Tester avec diverses entrées** : Assurez-vous que le Routeur gère différents types d'entrées, cas limites et contenus inattendus
- **Surveiller les performances de routage** : Examinez régulièrement les décisions de routage et affinez les critères en fonction des modèles d'utilisation réels
- **Choisir des modèles appropriés** : Utilisez des modèles avec de fortes capacités de raisonnement pour les décisions de routage complexes
+
+Lorsque le routeur ne peut pas déterminer un itinéraire approprié pour le contexte donné, il redirigera vers le **chemin d'erreur** au lieu de sélectionner arbitrairement un itinéraire. Cela se produit lorsque :
+
+- Le contexte ne correspond clairement à aucune des descriptions d'itinéraire définies
+- L'IA détermine qu'aucun des itinéraires disponibles n'est approprié
+
+## Bonnes pratiques
+
+- **Rédigez des descriptions d'itinéraire claires** : chaque description d'itinéraire doit expliquer clairement quand cet itinéraire doit être sélectionné. Soyez précis sur les critères.
+- **Rendez les itinéraires mutuellement exclusifs** : dans la mesure du possible, assurez-vous que les descriptions d'itinéraire ne se chevauchent pas pour éviter les décisions de routage ambiguës.
+- **Connectez un chemin d'erreur** : gérez les cas où aucun itinéraire ne correspond en connectant un gestionnaire d'erreurs pour un comportement de repli élégant.
+- **Utilisez des titres d'itinéraire descriptifs** : les titres d'itinéraire apparaissent dans le canevas de workflow, rendez-les donc significatifs pour la lisibilité.
+- **Testez avec des entrées diverses** : assurez-vous que le routeur gère différents types d'entrée, cas limites et contenus inattendus.
+- **Surveillez les performances de routage** : examinez régulièrement les décisions de routage et affinez les descriptions d'itinéraire en fonction des modèles d'utilisation réels.
+- **Choisissez des modèles appropriés** : utilisez des modèles avec de solides capacités de raisonnement pour les décisions de routage complexes.
diff --git a/apps/docs/content/docs/fr/copilot/index.mdx b/apps/docs/content/docs/fr/copilot/index.mdx
index 59a9703ee..b092b26f0 100644
--- a/apps/docs/content/docs/fr/copilot/index.mdx
+++ b/apps/docs/content/docs/fr/copilot/index.mdx
@@ -169,3 +169,175 @@ copilotCost = (inputTokens × inputPrice + outputTokens × (outputPrice × 1.5))
Les prix des modèles sont par million de tokens. Le calcul divise par 1 000 000 pour obtenir le coût réel. Consultez la page de calcul des coûts pour plus d'informations et des exemples.
+
+Survolez n'importe lequel de vos messages et cliquez sur **Modifier** pour le modifier et le renvoyer. Ceci est utile pour affiner vos prompts.
+
+### File de messages
+
+Si vous envoyez un message pendant que Copilot répond encore, il est mis en file d'attente. Vous pouvez :
+- Voir les messages en attente dans le panneau de file d'attente extensible
+- Envoyer immédiatement un message en attente (interrompt la réponse actuelle)
+- Supprimer des messages de la file d'attente
+
+## Pièces jointes
+
+Cliquez sur l'icône de pièce jointe pour télécharger des fichiers avec votre message. Les types de fichiers pris en charge incluent :
+- Images (miniatures d'aperçu affichées)
+- PDF
+- Fichiers texte, JSON, XML
+- Autres formats de documents
+
+Les fichiers sont affichés sous forme de miniatures cliquables qui s'ouvrent dans un nouvel onglet.
+
+## Points de contrôle et modifications
+
+Lorsque Copilot apporte des modifications à votre workflow, il enregistre des points de contrôle afin que vous puissiez revenir en arrière si nécessaire.
+
+### Affichage des points de contrôle
+
+Survolez un message de Copilot et cliquez sur l'icône des points de contrôle pour voir les états de workflow enregistrés pour ce message.
+
+### Annulation des modifications
+
+Cliquez sur **Annuler** sur n'importe quel point de contrôle pour restaurer votre workflow à cet état. Une boîte de dialogue de confirmation vous avertira que cette action ne peut pas être annulée.
+
+### Acceptation des modifications
+
+Lorsque Copilot propose des modifications, vous pouvez :
+- **Accepter** : appliquer les modifications proposées (`Mod+Shift+Enter`)
+- **Rejeter** : ignorer les modifications et conserver votre workflow actuel
+
+## Blocs de réflexion
+
+Pour les demandes complexes, Copilot peut afficher son processus de raisonnement dans des blocs de réflexion extensibles :
+
+- Les blocs se développent automatiquement pendant que Copilot réfléchit
+- Cliquez pour développer/réduire manuellement
+- Affiche la durée du processus de réflexion
+- Vous aide à comprendre comment Copilot est arrivé à sa solution
+
+## Sélection d'options
+
+Lorsque Copilot présente plusieurs options, vous pouvez sélectionner en utilisant :
+
+| Contrôle | Action |
+|---------|--------|
+| **1-9** | Sélectionner l'option par numéro |
+| **Flèche haut/bas** | Naviguer entre les options |
+| **Entrée** | Sélectionner l'option en surbrillance |
+
+Les options sélectionnées sont en surbrillance ; les options non sélectionnées apparaissent barrées.
+
+## Raccourcis clavier
+
+| Raccourci | Action |
+|----------|--------|
+| `@` | Ouvrir le menu contextuel |
+| `/` | Ouvrir les commandes slash |
+| `Arrow Up/Down` | Naviguer dans les éléments du menu |
+| `Enter` | Sélectionner l'élément du menu |
+| `Esc` | Fermer les menus |
+| `Mod+Shift+Enter` | Accepter les modifications de Copilot |
+
+## Limites d'utilisation
+
+L'utilisation de Copilot est facturée par jeton du LLM sous-jacent. Si vous atteignez votre limite d'utilisation, Copilot vous invitera à augmenter votre limite. Vous pouvez ajouter de l'utilisation par incréments (50 $, 100 $) à partir de votre base actuelle.
+
+
+ Consultez la [page de calcul des coûts](/execution/costs) pour les détails de facturation.
+
+## Copilot MCP
+
+Vous pouvez utiliser Copilot comme serveur MCP dans votre éditeur ou client IA préféré. Cela vous permet de créer, tester, déployer et gérer des workflows Sim directement depuis des outils comme Cursor, Claude Code, Claude Desktop et VS Code.
+
+### Générer une clé API Copilot
+
+Pour vous connecter au serveur MCP Copilot, vous avez besoin d'une **clé API Copilot** :
+
+1. Rendez-vous sur [sim.ai](https://sim.ai) et connectez-vous
+2. Accédez à **Paramètres** → **Copilot**
+3. Cliquez sur **Générer une clé API**
+4. Copiez la clé — elle n'est affichée qu'une seule fois
+
+La clé ressemblera à `sk-sim-copilot-...`. Vous l'utiliserez dans la configuration ci-dessous.
+
+### Cursor
+
+Ajoutez ce qui suit à votre `.cursor/mcp.json` (niveau projet) ou aux paramètres MCP globaux de Cursor :
+
+```json
+{
+ "mcpServers": {
+ "sim-copilot": {
+ "url": "https://www.sim.ai/api/mcp/copilot",
+ "headers": {
+ "X-API-Key": "YOUR_COPILOT_API_KEY"
+ }
+ }
+ }
+}
+```
+
+Remplacez `YOUR_COPILOT_API_KEY` par la clé que vous avez générée ci-dessus.
+
+### Claude Code
+
+Exécutez la commande suivante pour ajouter le serveur MCP Copilot :
+
+```bash
+claude mcp add sim-copilot \
+ --transport http \
+ https://www.sim.ai/api/mcp/copilot \
+ --header "X-API-Key: YOUR_COPILOT_API_KEY"
+```
+
+Remplacez `YOUR_COPILOT_API_KEY` par votre clé.
+
+### Claude Desktop
+
+Claude Desktop nécessite [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) pour se connecter aux serveurs MCP basés sur HTTP. Ajoutez ce qui suit à votre fichier de configuration Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json` sur macOS) :
+
+```json
+{
+ "mcpServers": {
+ "sim-copilot": {
+ "command": "npx",
+ "args": [
+ "-y",
+ "mcp-remote",
+ "https://www.sim.ai/api/mcp/copilot",
+ "--header",
+ "X-API-Key: YOUR_COPILOT_API_KEY"
+ ]
+ }
+ }
+}
+```
+
+Remplacez `YOUR_COPILOT_API_KEY` par votre clé.
+
+### VS Code
+
+Ajoutez ce qui suit à votre `settings.json` VS Code ou à votre `.vscode/settings.json` d'espace de travail :
+
+```json
+{
+ "mcp": {
+ "servers": {
+ "sim-copilot": {
+ "type": "http",
+ "url": "https://www.sim.ai/api/mcp/copilot",
+ "headers": {
+ "X-API-Key": "YOUR_COPILOT_API_KEY"
+ }
+ }
+ }
+ }
+}
+```
+
+Remplacez `YOUR_COPILOT_API_KEY` par votre clé.
+
+
+ Pour les déploiements auto-hébergés, remplacez `https://www.sim.ai` par votre URL Sim auto-hébergée.
+
diff --git a/apps/docs/content/docs/fr/enterprise/index.mdx b/apps/docs/content/docs/fr/enterprise/index.mdx
index 3da50d476..55f010ce0 100644
--- a/apps/docs/content/docs/fr/enterprise/index.mdx
+++ b/apps/docs/content/docs/fr/enterprise/index.mdx
@@ -75,3 +75,40 @@ Pour les déploiements auto-hébergés, les fonctionnalités entreprise peuvent
BYOK est uniquement disponible sur Sim hébergé. Les déploiements auto-hébergés configurent les clés de fournisseur d'IA directement via les variables d'environnement.
+
+Lorsque la facturation est désactivée, utilisez l'API Admin pour gérer les organisations :
+
+```bash
+# Create an organization
+curl -X POST https://your-instance/api/v1/admin/organizations \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"name": "My Organization", "ownerId": "user-id-here"}'
+
+# Add a member
+curl -X POST https://your-instance/api/v1/admin/organizations/{orgId}/members \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"userId": "user-id-here", "role": "admin"}'
+```
+
+### Membres de l'espace de travail
+
+Lorsque les invitations sont désactivées, utilisez l'API Admin pour gérer directement les appartenances aux espaces de travail :
+
+```bash
+# Add a user to a workspace
+curl -X POST https://your-instance/api/v1/admin/workspaces/{workspaceId}/members \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"userId": "user-id-here", "permissions": "write"}'
+
+# Remove a user from a workspace
+curl -X DELETE "https://your-instance/api/v1/admin/workspaces/{workspaceId}/members?userId=user-id-here" \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY"
+```
+
+### Remarques
+
+- L'activation de `ACCESS_CONTROL_ENABLED` active automatiquement les organisations, car le contrôle d'accès nécessite l'appartenance à une organisation.
+- Lorsque `DISABLE_INVITATIONS` est défini, les utilisateurs ne peuvent pas envoyer d'invitations. Utilisez l'API Admin pour gérer les appartenances aux espaces de travail et aux organisations à la place.
diff --git a/apps/docs/content/docs/fr/execution/costs.mdx b/apps/docs/content/docs/fr/execution/costs.mdx
index e18e7b86a..f1235c6b1 100644
--- a/apps/docs/content/docs/fr/execution/costs.mdx
+++ b/apps/docs/content/docs/fr/execution/costs.mdx
@@ -241,4 +241,45 @@ Cela répartit les frais de dépassement importants tout au long du mois au lieu
- Consultez votre utilisation actuelle dans [Paramètres → Abonnement](https://sim.ai/settings/subscription)
- Découvrez la [journalisation](/execution/logging) pour suivre les détails d'exécution
- Explorez l'[API externe](/execution/api) pour la surveillance programmatique des coûts
+- Consultez les [techniques d'optimisation des workflows](/blocks) pour réduire les coûts
+
+**Forfait Pro (20 $/mois) :**
+- L'abonnement mensuel inclut 20 $ d'utilisation
+- Utilisation inférieure à 20 $ → Aucun frais supplémentaire
+- Utilisation supérieure à 20 $ → Paiement du dépassement en fin de mois
+- Exemple : 35 $ d'utilisation = 20 $ (abonnement) + 15 $ (dépassement)
+
+**Forfait Team (40 $/siège/mois) :**
+- Utilisation mutualisée entre tous les membres de l'équipe
+- Dépassement calculé sur l'utilisation totale de l'équipe
+- Le propriétaire de l'organisation reçoit une seule facture
+
+**Forfaits Enterprise :**
+- Prix mensuel fixe, sans dépassement
+- Limites d'utilisation personnalisées selon l'accord
+
+### Facturation par seuil
+
+Lorsque le dépassement non facturé atteint 50 $, Sim facture automatiquement le montant total non facturé.
+
+**Exemple :**
+- Jour 10 : 70 $ de dépassement → Facturation immédiate de 70 $
+- Jour 15 : 35 $ d'utilisation supplémentaire (105 $ au total) → Déjà facturé, aucune action
+- Jour 20 : 50 $ d'utilisation supplémentaire (155 $ au total, 85 $ non facturés) → Facturation immédiate de 85 $
+
+Cela répartit les frais de dépassement importants tout au long du mois au lieu d'une seule facture importante en fin de période.
+
+## Bonnes pratiques de gestion des coûts
+
+1. **Surveillez régulièrement** : Consultez fréquemment votre tableau de bord d'utilisation pour éviter les surprises
+2. **Définissez des budgets** : Utilisez les limites du forfait comme garde-fous pour vos dépenses
+3. **Optimisez les workflows** : Examinez les exécutions coûteuses et optimisez les prompts ou la sélection de modèles
+4. **Utilisez les modèles appropriés** : Adaptez la complexité du modèle aux exigences de la tâche
+5. **Regroupez les tâches similaires** : Combinez plusieurs requêtes lorsque c'est possible pour réduire les frais généraux
+
+## Prochaines étapes
+
+- Consultez votre utilisation actuelle dans [Paramètres → Abonnement](https://sim.ai/settings/subscription)
+- Découvrez la [journalisation](/execution/logging) pour suivre les détails d'exécution
+- Explorez l'[API externe](/execution/api) pour surveiller les coûts de manière programmatique
- Consultez les [techniques d'optimisation des workflows](/blocks) pour réduire les coûts
\ No newline at end of file
diff --git a/apps/docs/content/docs/fr/execution/files.mdx b/apps/docs/content/docs/fr/execution/files.mdx
new file mode 100644
index 000000000..6cde43cab
--- /dev/null
+++ b/apps/docs/content/docs/fr/execution/files.mdx
@@ -0,0 +1,172 @@
+---
+title: Transmission de fichiers
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+
+Sim facilite le travail avec les fichiers tout au long de vos workflows. Les blocs peuvent recevoir des fichiers, les traiter et les transmettre à d'autres blocs de manière transparente.
+
+## Objets fichier
+
+Lorsque les blocs génèrent des fichiers (comme des pièces jointes Gmail, des images générées ou des documents analysés), ils renvoient un objet fichier standardisé :
+
+```json
+{
+ "name": "report.pdf",
+ "url": "https://...",
+ "base64": "JVBERi0xLjQK...",
+ "type": "application/pdf",
+ "size": 245678
+}
+```
+
+Vous pouvez accéder à n'importe laquelle de ces propriétés lors du référencement de fichiers provenant de blocs précédents.
+
+## Le bloc fichier
+
+Le **bloc fichier** est le point d'entrée universel pour les fichiers dans vos workflows. Il accepte les fichiers de n'importe quelle source et génère des objets fichier standardisés qui fonctionnent avec toutes les intégrations.
+
+**Entrées :**
+- **Fichiers téléversés** - Glissez-déposez ou sélectionnez directement des fichiers
+- **URL externes** - N'importe quelle URL de fichier accessible publiquement
+- **Fichiers d'autres blocs** - Transmettez des fichiers provenant de pièces jointes Gmail, de téléchargements Slack, etc.
+
+**Sorties :**
+- Une liste d'objets `UserFile` avec une structure cohérente (`name`, `url`, `base64`, `type`, `size`)
+- `combinedContent` - Contenu textuel extrait de tous les fichiers (pour les documents)
+
+**Exemple d'utilisation :**
+
+```
+// Get all files from the File block
+
+
+// Get the first file
+
+
+// Get combined text content from parsed documents
+
+```
+
+Le bloc fichier effectue automatiquement :
+- La détection des types de fichiers à partir des URL et des extensions
+- L'extraction de texte des PDF, CSV et documents
+- La génération d'encodage base64 pour les fichiers binaires
+- La création d'URL présignées pour un accès sécurisé
+
+Utilisez le bloc fichier lorsque vous devez normaliser des fichiers provenant de différentes sources avant de les transmettre à d'autres blocs comme Vision, STT ou les intégrations email.
+
+## Transmission de fichiers entre blocs
+
+Référencez les fichiers des blocs précédents en utilisant le menu déroulant des balises. Cliquez dans n'importe quel champ de saisie de fichier et tapez `<` pour voir les sorties disponibles.
+
+**Modèles courants :**
+
+```
+// Single file from a block
+
+
+// Pass the whole file object
+
+
+// Access specific properties
+
+
+```
+
+La plupart des blocs acceptent l'objet fichier complet et extraient automatiquement ce dont ils ont besoin. Vous n'avez pas besoin d'extraire manuellement `base64` ou `url` dans la plupart des cas.
+
+## Déclencher des workflows avec des fichiers
+
+Lors de l'appel d'un workflow via API qui attend une entrée de fichier, incluez les fichiers dans votre requête :
+
+
+
+
+ ```bash
+ curl -X POST "https://sim.ai/api/workflows/YOUR_WORKFLOW_ID/execute" \
+ -H "Content-Type: application/json" \
+ -H "x-api-key: YOUR_API_KEY" \
+ -d '{
+ "document": {
+ "name": "report.pdf",
+ "base64": "JVBERi0xLjQK...",
+ "type": "application/pdf"
+ }
+ }'
+ ```
+
+
+
+
+ ```bash
+ curl -X POST "https://sim.ai/api/workflows/YOUR_WORKFLOW_ID/execute" \
+ -H "Content-Type: application/json" \
+ -H "x-api-key: YOUR_API_KEY" \
+ -d '{
+ "document": {
+ "name": "report.pdf",
+ "url": "https://example.com/report.pdf",
+ "type": "application/pdf"
+ }
+ }'
+ ```
+
+
+
+
+Le bloc de démarrage du workflow doit avoir un champ d'entrée configuré pour recevoir le paramètre de fichier.
+
+## Recevoir des fichiers dans les réponses API
+
+Lorsqu'un workflow génère des fichiers, ils sont inclus dans la réponse :
+
+```json
+{
+ "success": true,
+ "output": {
+ "generatedFile": {
+ "name": "output.png",
+ "url": "https://...",
+ "base64": "iVBORw0KGgo...",
+ "type": "image/png",
+ "size": 34567
+ }
+ }
+}
+```
+
+Utilisez `url` pour les téléchargements directs ou `base64` pour le traitement en ligne.
+
+## Blocs qui fonctionnent avec des fichiers
+
+**Entrées de fichiers :**
+- **File** - Analyser des documents, images et fichiers texte
+- **Vision** - Analyser des images avec des modèles IA
+- **Mistral Parser** - Extraire du texte depuis des PDF
+
+**Sorties de fichiers :**
+- **Gmail** - Pièces jointes d'e-mails
+- **Slack** - Fichiers téléchargés
+- **TTS** - Fichiers audio générés
+- **Video Generator** - Vidéos générées
+- **Image Generator** - Images générées
+
+**Stockage de fichiers :**
+- **Supabase** - Téléverser/télécharger depuis le stockage
+- **S3** - Opérations AWS S3
+- **Google Drive** - Opérations de fichiers Drive
+- **Dropbox** - Opérations de fichiers Dropbox
+
+
+ Les fichiers sont automatiquement disponibles pour les blocs en aval. Le moteur d'exécution gère tous les transferts de fichiers et conversions de format.
+
+
+## Bonnes pratiques
+
+1. **Utilisez directement les objets fichiers** - Transmettez l'objet fichier complet plutôt que d'extraire des propriétés individuelles. Les blocs gèrent automatiquement la conversion.
+
+2. **Vérifiez les types de fichiers** - Assurez-vous que le type de fichier correspond à ce que le bloc récepteur attend. Le bloc Vision nécessite des images, le bloc File gère les documents.
+
+3. **Tenir compte de la taille du fichier** - Les fichiers volumineux augmentent le temps d'exécution. Pour les très gros fichiers, envisagez d'utiliser des blocs de stockage (S3, Supabase) pour le stockage intermédiaire.
diff --git a/apps/docs/content/docs/fr/execution/form.mdx b/apps/docs/content/docs/fr/execution/form.mdx
new file mode 100644
index 000000000..505a04661
--- /dev/null
+++ b/apps/docs/content/docs/fr/execution/form.mdx
@@ -0,0 +1,142 @@
+---
+title: Déploiement de formulaire
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+
+Déployez votre workflow sous forme de formulaire intégrable que les utilisateurs peuvent remplir sur votre site web ou partager via un lien. Les soumissions de formulaire déclenchent votre workflow avec le type de déclencheur `form`.
+
+## Vue d'ensemble
+
+Le déploiement de formulaire transforme le format d'entrée de votre workflow en un formulaire responsive qui peut être :
+- Partagé via un lien direct (par exemple, `https://sim.ai/form/my-survey`)
+- Intégré dans n'importe quel site web à l'aide d'une iframe
+
+Lorsqu'un utilisateur soumet le formulaire, cela déclenche votre workflow avec les données du formulaire.
+
+
+Les formulaires dérivent leurs champs du format d'entrée du bloc de démarrage de votre workflow. Chaque champ devient une entrée de formulaire avec le type approprié.
+
+
+## Créer un formulaire
+
+1. Ouvrez votre workflow et cliquez sur **Déployer**
+2. Sélectionnez l'onglet **Formulaire**
+3. Configurez :
+ - **URL** : identifiant unique (par exemple, `contact-form` → `sim.ai/form/contact-form`)
+ - **Titre** : en-tête du formulaire
+ - **Description** : sous-titre optionnel
+ - **Champs du formulaire** : personnalisez les libellés et descriptions de chaque champ
+ - **Authentification** : publique, protégée par mot de passe ou liste blanche d'emails
+ - **Message de remerciement** : affiché après la soumission
+4. Cliquez sur **Lancer**
+
+## Correspondance des types de champs
+
+| Type de format d'entrée | Champ de formulaire |
+|------------------|------------|
+| `string` | Champ de texte |
+| `number` | Champ numérique |
+| `boolean` | Interrupteur |
+| `object` | Éditeur JSON |
+| `array` | Éditeur de tableau JSON |
+| `files` | Téléchargement de fichier |
+
+## Contrôle d'accès
+
+| Mode | Description |
+|------|-------------|
+| **Public** | Toute personne disposant du lien peut soumettre |
+| **Mot de passe** | Les utilisateurs doivent saisir un mot de passe |
+| **Liste blanche d'emails** | Seuls les emails/domaines spécifiés peuvent soumettre |
+
+Pour la liste blanche d'e-mails :
+- Exact : `user@example.com`
+- Domaine : `@example.com` (tous les e-mails du domaine)
+
+## Intégration
+
+### Lien direct
+
+```
+https://sim.ai/form/your-identifier
+```
+
+### Iframe
+
+```html
+
+```
+
+## Soumission par API
+
+Soumettre des formulaires par programmation :
+
+
+
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+ -H "Content-Type: application/json" \
+ -d '{
+ "formData": {
+ "name": "John Doe",
+ "email": "john@example.com"
+ }
+ }'
+```
+
+
+
+
+```typescript
+const response = await fetch('https://sim.ai/api/form/your-identifier', {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({
+ formData: {
+ name: 'John Doe',
+ email: 'john@example.com'
+ }
+ })
+});
+
+const result = await response.json();
+// { success: true, data: { executionId: '...' } }
+```
+
+
+
+
+### Formulaires protégés
+
+Pour les formulaires protégés par mot de passe :
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+ -H "Content-Type: application/json" \
+ -d '{ "password": "secret", "formData": { "name": "John" } }'
+```
+
+Pour les formulaires protégés par e-mail :
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+ -H "Content-Type: application/json" \
+ -d '{ "email": "allowed@example.com", "formData": { "name": "John" } }'
+```
+
+## Dépannage
+
+**« Aucun champ de saisie configuré »** - Ajoutez des champs de format de saisie à votre bloc de démarrage.
+
+**Le formulaire ne se charge pas dans l'iframe** - Vérifiez que la CSP de votre site autorise les iframes provenant de `sim.ai`.
+
+**Échec des soumissions** - Vérifiez que l'identifiant est correct et que les champs obligatoires sont remplis.
diff --git a/apps/docs/content/docs/fr/quick-reference/index.mdx b/apps/docs/content/docs/fr/quick-reference/index.mdx
new file mode 100644
index 000000000..e84f6acc9
--- /dev/null
+++ b/apps/docs/content/docs/fr/quick-reference/index.mdx
@@ -0,0 +1,394 @@
+---
+title: Référence rapide
+description: Actions essentielles pour naviguer et utiliser l'éditeur de workflow Sim
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { ActionImage, ActionVideo } from '@/components/ui/action-media'
+
+Une référence rapide pour les actions quotidiennes dans l'éditeur de workflow Sim. Pour les raccourcis clavier, consultez [Raccourcis clavier](/keyboard-shortcuts).
+
+
+ **Mod** fait référence à `Cmd` sur macOS et `Ctrl` sur Windows/Linux.
+
+
+## Espaces de travail
+
+
+
+ Action Comment Aperçu
+ Créer un espace de travail
+ Cliquez sur le menu déroulant de l'espace de travail → **Nouvel espace de travail**
+
+
+ Changer d'espace de travail
+ Cliquez sur le menu déroulant de l'espace de travail → Sélectionnez l'espace de travail
+
+
+ Inviter des membres de l'équipe
+ Barre latérale → **Inviter**
+
+
+ Renommer un espace de travail
+ Clic droit sur l'espace de travail → **Renommer**
+
+
+ Dupliquer un espace de travail
+ Clic droit sur l'espace de travail → **Dupliquer**
+
+
+ Exporter un espace de travail
+ Clic droit sur l'espace de travail → **Exporter**
+
+
+ Supprimer un espace de travail
+ Clic droit sur l'espace de travail → **Supprimer**
+
+
+
+
+## Workflows
+
+
+
+ Action Comment Aperçu
+ Créer un workflow
+ Cliquez sur le bouton **+** dans la barre latérale
+
+
+ Réorganiser / déplacer des workflows
+ Faites glisser le workflow vers le haut/bas ou dans un dossier
+
+
+ Importer un workflow
+ Cliquez sur le bouton d'importation dans la barre latérale → Sélectionnez le fichier
+
+
+ Sélectionner plusieurs workflows
+ `Mod+Click` ou `Shift+Click` les workflows dans la barre latérale
+
+
+ Ouvrir dans un nouvel onglet
+ Clic droit sur le workflow → **Ouvrir dans un nouvel onglet**
+
+
+ Renommer un workflow
+ Clic droit sur le workflow → **Renommer**
+
+
+ Attribuer une couleur au workflow
+ Clic droit sur le workflow → **Changer la couleur**
+
+
+ Dupliquer un workflow
+ Clic droit sur le workflow → **Dupliquer**
+
+
+ Exporter un workflow
+ Clic droit sur le workflow → **Exporter**
+
+
+ Supprimer un workflow
+ Clic droit sur le workflow → **Supprimer**
+
+
+ Renommer un dossier
+ Clic droit sur le dossier → **Renommer**
+
+
+ Créer un workflow dans un dossier
+ Clic droit sur le dossier → **Créer un workflow**
+
+
+ Créer un dossier dans un dossier
+ Clic droit sur le dossier → **Créer un dossier**
+
+
+ Dupliquer un dossier
+ Clic droit sur le dossier → **Dupliquer**
+
+
+ Exporter un dossier
+ Clic droit sur le dossier → **Exporter**
+
+
+ Supprimer un dossier
+ Clic droit sur le dossier → **Supprimer**
+
+
+
+
+## Blocs
+
+
+
+ Action Comment Aperçu
+ Ajouter un bloc
+ Glisser depuis le panneau Barre d'outils, ou clic droit sur le canevas → **Ajouter un bloc**
+
+
+ Sélectionner plusieurs blocs
+ `Mod+Click` des blocs supplémentaires, ou glisser avec Maj pour dessiner une zone de sélection
+
+
+ Copier des blocs
+ `Mod+C` avec des blocs sélectionnés
+
+
+ Coller des blocs
+ `Mod+V` pour coller les blocs copiés
+
+
+ Dupliquer des blocs
+ Clic droit → **Dupliquer**
+
+
+ Supprimer des blocs
+ Touche `Delete` ou `Backspace`, ou clic droit → **Supprimer**
+
+
+ Renommer un bloc
+ Cliquer sur le nom du bloc dans l'en-tête, ou modifier dans le panneau Éditeur
+
+
+ Activer/Désactiver un bloc
+ Clic droit → **Activer/Désactiver**
+
+
+ Verrouiller/Déverrouiller un bloc
+ Survoler le bloc → Cliquer sur l'icône de verrouillage (administrateur uniquement)
+
+
+ Basculer l'orientation des poignées
+ Clic droit → **Basculer les poignées**
+
+
+ Configurer un bloc
+ Sélectionner le bloc → utiliser le panneau Éditeur à droite
+
+
+
+
+## Connexions
+
+
+
+ Action Comment Aperçu
+ Créer une connexion
+ Glisser depuis la poignée de sortie vers la poignée d'entrée
+
+
+ Supprimer une connexion
+ Cliquer sur le lien pour le sélectionner → touche `Delete`
+
+
+ Utiliser une sortie dans un autre bloc
+ Glisser l'étiquette de connexion dans le champ d'entrée
+
+
+
+
+## Panneaux et vues
+
+
+
+ Action Comment Aperçu
+ Barre d'outils de recherche
+ `Mod+F`
+
+
+ Rechercher partout
+ `Mod+K`
+
+
+ Basculer en mode manuel
+ Cliquez sur le bouton de basculement pour passer du mode manuel au sélecteur
+
+
+ Réduire/développer la barre latérale
+ Cliquez sur le bouton de réduction dans la barre latérale
+
+
+
+
+## Exécution et tests
+
+
+
+ Action Comment Aperçu
+ Exécuter le workflow
+ Cliquez sur le bouton Exécuter le workflow ou `Mod+Enter`
+
+
+ Arrêter le workflow
+ Cliquez sur le bouton Arrêter ou `Mod+Enter` pendant l'exécution
+
+
+ Tester avec le chat
+ Utilisez le panneau Chat sur le côté droit
+
+
+ Sélectionner la sortie à afficher
+ Cliquez sur le menu déroulant dans le panneau Chat → Sélectionnez la sortie du bloc
+
+
+ Effacer l'historique du chat
+ Cliquez sur le bouton d'effacement dans le panneau Chat
+
+
+ Exécuter à partir du bloc
+ Survolez le bloc → Cliquez sur le bouton de lecture, ou clic droit → **Exécuter à partir du bloc**
+
+
+ Exécuter jusqu'au bloc
+ Clic droit sur le bloc → **Exécuter jusqu'au bloc**
+
+
+ Afficher les journaux d'exécution
+ Ouvrez le panneau terminal en bas, ou `Mod+L`
+
+
+ Filtrer les journaux
+ Cliquez sur l'icône de filtre dans le terminal → Filtrez par bloc ou statut
+
+
+ Rechercher dans les journaux
+ Utilisez le champ de recherche dans le terminal ou clic droit sur une entrée de journal → **Rechercher**
+
+
+ Copier une entrée de journal
+ Icône de presse-papiers ou clic droit sur une entrée de journal → **Copier**
+
+
+ Effacer le terminal
+ Icône de corbeille ou `Mod+D`
+
+
+
+
+## Déploiement
+
+
+
+ Action Comment Aperçu
+ Déployer un workflow
+ Cliquer sur le bouton **Déployer** dans le panneau
+
+
+ Mettre à jour le déploiement
+ Cliquer sur **Mettre à jour** lorsque des modifications sont détectées
+
+
+ Voir le statut du déploiement
+ Vérifier l'indicateur de statut (En ligne/Mettre à jour/Déployer) dans l'onglet Déployer
+
+
+ Revenir à un déploiement précédent
+ Accéder aux versions précédentes dans l'onglet Déployer → **Promouvoir en ligne**
+
+
+ Ajouter une description de version
+ Onglet Déployer → Cliquer sur l'icône de description → Ajouter ou générer une description
+
+
+ Copier le point de terminaison API
+ Onglet Déployer → API → Copier le cURL de l'API
+
+
+
+
+## Variables
+
+
+
+ Action Comment Aperçu
+ Ajouter / Modifier / Supprimer une variable de workflow
+ Panneau -> Variables -> **Ajouter une variable**, cliquer pour modifier, ou icône de suppression
+
+
+ Ajouter une variable d'environnement
+ Paramètres → **Variables d'environnement** → **Ajouter**
+
+
+ Référencer une variable de workflow
+ Utiliser la syntaxe `` dans les entrées de bloc
+
+
+ Référencer une variable d'environnement
+ Utiliser la syntaxe `{{ENV_VAR}}` dans les entrées de bloc
+
+
+
diff --git a/apps/docs/content/docs/fr/self-hosting/index.mdx b/apps/docs/content/docs/fr/self-hosting/index.mdx
index cfd0d49f8..824da9956 100644
--- a/apps/docs/content/docs/fr/self-hosting/index.mdx
+++ b/apps/docs/content/docs/fr/self-hosting/index.mdx
@@ -56,3 +56,10 @@ Ouvrez [http://localhost:3000](http://localhost:3000)
| realtime | 3002 | Serveur WebSocket |
| db | 5432 | PostgreSQL avec pgvector |
| migrations | - | Migrations de base de données (exécutées une seule fois) |
+
+| Composant | Port | Description |
+|-----------|------|-------------|
+| simstudio | 3000 | Application principale |
+| realtime | 3002 | Serveur WebSocket |
+| db | 5432 | PostgreSQL avec pgvector |
+| migrations | - | Migrations de base de données (s'exécute une fois) |
diff --git a/apps/docs/content/docs/fr/skills/index.mdx b/apps/docs/content/docs/fr/skills/index.mdx
new file mode 100644
index 000000000..28f680b78
--- /dev/null
+++ b/apps/docs/content/docs/fr/skills/index.mdx
@@ -0,0 +1,134 @@
+---
+title: Compétences d'agent
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+
+Les compétences d'agent sont des packages d'instructions réutilisables qui confèrent à vos agents IA des capacités spécialisées. Basées sur le format ouvert [Agent Skills](https://agentskills.io), les compétences vous permettent de capturer l'expertise métier, les flux de travail et les meilleures pratiques que les agents peuvent charger à la demande.
+
+## Fonctionnement des compétences
+
+Les compétences utilisent la **divulgation progressive** pour maintenir le contexte de l'agent léger :
+
+1. **Découverte** — Seuls les noms et descriptions des compétences sont inclus dans le prompt système de l'agent (~50-100 tokens chacun)
+2. **Activation** — Lorsque l'agent décide qu'une compétence est pertinente, il appelle l'outil `load_skill` pour charger les instructions complètes dans le contexte
+3. **Exécution** — L'agent suit les instructions chargées pour accomplir la tâche
+
+Cela signifie que vous pouvez attacher de nombreuses compétences à un agent sans surcharger sa fenêtre de contexte. L'agent ne charge que ce dont il a besoin.
+
+## Création de compétences
+
+Accédez à **Paramètres** et sélectionnez **Compétences** dans la section Outils.
+
+
+
+Cliquez sur **Ajouter** pour créer une nouvelle compétence avec trois champs :
+
+| Champ | Description |
+|-------|-------------|
+| **Nom** | Un identifiant en kebab-case (par ex. `sql-expert`, `code-reviewer`). Maximum 64 caractères. |
+| **Description** | Une brève explication de ce que fait la compétence et quand l'utiliser. C'est ce que l'agent lit pour décider d'activer ou non la compétence. Maximum 1024 caractères. |
+| **Contenu** | Les instructions complètes de la compétence en markdown. Ceci est chargé lorsque l'agent active la compétence. |
+
+
+ La description est essentielle — c'est la seule chose que l'agent voit avant de décider de charger une compétence. Soyez précis sur quand et pourquoi la compétence doit être utilisée.
+
+
+### Rédiger un bon contenu de compétence
+
+Le contenu des compétences suit les mêmes conventions que les [fichiers SKILL.md](https://agentskills.io/specification) :
+
+```markdown
+# SQL Expert
+
+## When to use this skill
+Use when the user asks you to write, optimize, or debug SQL queries.
+
+## Instructions
+1. Always ask which database engine (PostgreSQL, MySQL, SQLite)
+2. Use CTEs over subqueries for readability
+3. Add index recommendations when relevant
+4. Explain query plans for optimization requests
+
+## Common Patterns
+...
+```
+
+**Structure recommandée :**
+- **Quand l'utiliser** — Déclencheurs et scénarios spécifiques
+- **Instructions** — Guidance étape par étape avec listes numérotées
+- **Exemples** — Échantillons d'entrée/sortie montrant le comportement attendu
+- **Modèles courants** — Approches réutilisables pour les tâches fréquentes
+- **Cas limites** — Pièges et considérations spéciales
+
+Gardez les compétences ciblées et sous 500 lignes. Si une compétence devient trop volumineuse, divisez-la en plusieurs compétences spécialisées.
+
+## Ajouter des compétences à un agent
+
+Ouvrez n'importe quel bloc **Agent** et trouvez le menu déroulant **Compétences** sous la section des outils. Sélectionnez les compétences auxquelles vous souhaitez que l'agent ait accès.
+
+
+
+Les compétences sélectionnées apparaissent sous forme de cartes sur lesquelles vous pouvez cliquer pour les modifier ou les supprimer.
+
+### Ce qui se passe à l'exécution
+
+Lorsque le workflow s'exécute :
+
+1. Le prompt système de l'agent inclut une section `` listant le nom et la description de chaque compétence
+2. Un outil `load_skill` est automatiquement ajouté aux outils disponibles de l'agent
+3. Lorsque l'agent détermine qu'une compétence est pertinente pour la tâche en cours, il appelle `load_skill` avec le nom de la compétence
+4. Le contenu complet de la compétence est retourné comme réponse d'outil, donnant à l'agent des instructions détaillées
+
+Cela fonctionne avec tous les fournisseurs LLM pris en charge — l'outil `load_skill` utilise l'appel d'outil standard, donc aucune configuration spécifique au fournisseur n'est nécessaire.
+
+## Cas d'usage courants
+
+Les compétences sont particulièrement utiles lorsque les agents ont besoin de connaissances spécialisées ou de workflows en plusieurs étapes :
+
+**Expertise de domaine**
+- `api-integration-expert` — Bonnes pratiques pour appeler des API spécifiques (authentification, limitation de débit, gestion des erreurs)
+- `data-transformation` — Modèles ETL, nettoyage de données et règles de validation
+- `code-reviewer` — Directives de revue de code spécifiques aux standards de votre équipe
+
+**Modèles de flux de travail**
+- `bug-investigation` — Méthodologie de débogage étape par étape (reproduire → isoler → tester → corriger)
+- `feature-implementation` — Flux de travail de développement des exigences au déploiement
+- `document-generator` — Modèles et règles de formatage pour la documentation technique
+
+**Connaissances spécifiques à l'entreprise**
+- `our-architecture` — Diagrammes d'architecture système, dépendances de services et processus de déploiement
+- `style-guide` — Directives de marque, ton rédactionnel, modèles UI/UX
+- `customer-onboarding` — Procédures standard et questions courantes des clients
+
+**Quand utiliser les compétences plutôt que les instructions d'agent :**
+- Utilisez les **compétences** pour les connaissances qui s'appliquent à plusieurs flux de travail ou qui changent fréquemment
+- Utilisez les **instructions d'agent** pour le contexte spécifique à une tâche qui est propre à un seul agent
+
+## Bonnes pratiques
+
+**Rédiger des descriptions efficaces**
+- **Soyez précis et riche en mots-clés** — Au lieu de « Aide avec SQL », écrivez « Rédiger des requêtes SQL optimisées pour PostgreSQL, MySQL et SQLite, incluant des recommandations d'index et une analyse de plan de requête »
+- **Incluez des déclencheurs d'activation** — Mentionnez des mots ou expressions spécifiques qui devraient déclencher la compétence (par exemple, « Utiliser lorsque l'utilisateur mentionne des PDF, des formulaires ou l'extraction de documents »)
+- **Limitez à moins de 200 mots** — Les agents parcourent rapidement les descriptions ; chaque mot compte
+
+**Portée et organisation des compétences**
+- **Une compétence par domaine** — Une compétence `sql-expert` ciblée fonctionne mieux qu'une compétence `database-everything` générale
+- **Limitez à 5-10 compétences par agent** — Plus de compétences = plus de charge décisionnelle ; commencez petit et ajoutez au besoin
+- **Divisez les grandes compétences** — Si une compétence dépasse 500 lignes, divisez-la en sous-compétences ciblées
+
+**Structure du contenu**
+- **Utilisez le formatage markdown** — Les en-têtes, listes et blocs de code aident les agents à analyser et suivre les instructions
+- **Fournissez des exemples** — Montrez des paires entrée/sortie pour que les agents comprennent le comportement attendu
+- **Soyez explicite sur les cas limites** — Ne supposez pas que les agents déduiront une gestion spéciale
+
+**Tests et itération**
+- **Tester l'activation** — Exécutez votre workflow et vérifiez que l'agent charge la compétence au moment attendu
+- **Vérifier les faux positifs** — Assurez-vous que les compétences ne s'activent pas quand elles ne le devraient pas
+- **Affiner les descriptions** — Si une compétence ne se charge pas quand nécessaire, ajoutez plus de mots-clés à la description
+
+## En savoir plus
+
+- [Spécification Agent Skills](https://agentskills.io) — Le format ouvert pour les compétences d'agent portables
+- [Exemples de compétences](https://github.com/anthropics/skills) — Parcourir les exemples de compétences de la communauté
+- [Bonnes pratiques](https://agentskills.io/what-are-skills) — Rédiger des compétences efficaces
diff --git a/apps/docs/content/docs/fr/tools/a2a.mdx b/apps/docs/content/docs/fr/tools/a2a.mdx
new file mode 100644
index 000000000..710db5943
--- /dev/null
+++ b/apps/docs/content/docs/fr/tools/a2a.mdx
@@ -0,0 +1,207 @@
+---
+title: A2A
+description: Interagir avec des agents externes compatibles A2A
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+
+
+## 入力と出力
+
+
+
+
+ -
+ ループタイプ: 'for'、'forEach'、'while'、または'doWhile'から選択
+
+ -
+ 反復回数: 実行する回数(forループ)
+
+ -
+ コレクション: 反復処理する配列またはオブジェクト(forEachループ)
+
+ -
+ 条件: 評価するブール式(while/do-whileループ)
+
+
+
+
+ ループ**内**でのみ利用可能:
+
+ -
+ {"
"} : 現在の反復番号(0始まり)
+
+ -
+ {"
"} : 処理中の現在のアイテム(forEachのみ)
+
+ -
+ {"
"} : 完全なコレクション(forEachのみ)
+
+
+
+
+
+ -
+ {"
"} : すべての反復結果の配列(ブロック名経由でアクセス)
+
+ -
+ 構造: 結果は反復順序を維持
+
+ -
+ アクセス: ループ完了後のブロックで利用可能
+
+
+
+
+
+## ベストプラクティス
+
+- **適切な制限を設定**: 実行時間が長くならないよう、反復回数を適切に保つ
+- **コレクションにはForEachを使用**: 配列やオブジェクトを処理する場合は、Forループの代わりにForEachを使用
+- **エラーを適切に処理**: 堅牢なワークフローのため、ループ内にエラー処理の追加を検討
diff --git a/apps/docs/content/docs/ja/blocks/parallel.mdx b/apps/docs/content/docs/ja/blocks/parallel.mdx
index 98d352a5a..c509c678b 100644
--- a/apps/docs/content/docs/ja/blocks/parallel.mdx
+++ b/apps/docs/content/docs/ja/blocks/parallel.mdx
@@ -189,3 +189,51 @@ Parallel (["gpt-4o", "claude-3.7-sonnet", "gemini-2.5-pro"]) → Agent → Evalu
- **独立した操作のみ**：操作が互いに依存しないようにする
- **レート制限の処理**：API使用が多いワークフローには遅延やスロットリングを追加
- **エラー処理**：各インスタンスは自身のエラーを適切に処理すべき
+
+## 入力と出力
+
+
+
+
+ -
+ 並列タイプ: 'count'または'collection'を選択
+
+ -
+ カウント: 実行するインスタンスの数(カウントベース)
+
+ -
+ コレクション: 分散する配列またはオブジェクト(コレクションベース)
+
+
+
+
+ 並列処理の**内部**でのみ利用可能:
+
+ -
+ {"
"} : インスタンス番号(0始まり)
+
+ -
+ {"
"} : このインスタンスのアイテム(コレクションベースのみ)
+
+ -
+ {"
"} : 完全なコレクション(コレクションベースのみ)
+
+
+
+
+
+ -
+ {"
"} : すべてのインスタンス結果の配列(ブロック名経由でアクセス)
+
+ -
+ アクセス: 並列処理完了後のブロックで利用可能
+
+
+
+
+
+## ベストプラクティス
+
+- **独立した操作のみ**: 操作が相互に依存しないことを確認
+- **レート制限への対処**: API負荷の高いワークフローには遅延やスロットリングを追加
+- **エラーハンドリング**: 各インスタンスは独自のエラーを適切に処理する必要がある
diff --git a/apps/docs/content/docs/ja/blocks/router.mdx b/apps/docs/content/docs/ja/blocks/router.mdx
index 8cfc609ad..8aa16bfdf 100644
--- a/apps/docs/content/docs/ja/blocks/router.mdx
+++ b/apps/docs/content/docs/ja/blocks/router.mdx
@@ -100,3 +100,18 @@ Input (Lead) → Router → Agent (Enterprise Sales) or Workflow (Self-serve)
- **多様な入力でテストする**: ルーターが様々な入力タイプ、エッジケース、予期しないコンテンツを処理できることを確認する
- **ルーティングパフォーマンスを監視する**: ルーティングの決定を定期的に確認し、実際の使用パターンに基づいて基準を改善する
- **適切なモデルを選択する**: 複雑なルーティング決定には強力な推論能力を持つモデルを使用する
+
+ルーターが指定されたコンテキストに対して適切なルートを判断できない場合、任意にルートを選択するのではなく、**エラーパス**にルーティングします。これは次の場合に発生します：
+
+- コンテキストが定義されたルートの説明のいずれとも明確に一致しない
+- AIが利用可能なルートのいずれも適切でないと判断した
+
+## ベストプラクティス
+
+- **明確なルート説明を記述する**：各ルートの説明は、そのルートがいつ選択されるべきかを明確に説明する必要があります。基準を具体的に記述してください。
+- **ルートを相互排他的にする**：可能な限り、ルートの説明が重複しないようにして、曖昧なルーティング判断を防ぎます。
+- **エラーパスを接続する**：ルートが一致しない場合に備えて、適切なフォールバック動作のためのエラーハンドラーを接続してください。
+- **わかりやすいルートタイトルを使用する**：ルートタイトルはワークフローキャンバスに表示されるため、可読性のために意味のあるものにしてください。
+- **多様な入力でテストする**：ルーターがさまざまな入力タイプ、エッジケース、予期しないコンテンツを処理できることを確認してください。
+- **ルーティングパフォーマンスを監視する**：ルーティングの判断を定期的に確認し、実際の使用パターンに基づいてルートの説明を改善してください。
+- **適切なモデルを選択する**：複雑なルーティング判断には、優れた推論能力を持つモデルを使用してください。
diff --git a/apps/docs/content/docs/ja/copilot/index.mdx b/apps/docs/content/docs/ja/copilot/index.mdx
index 34a81cecf..4714411d6 100644
--- a/apps/docs/content/docs/ja/copilot/index.mdx
+++ b/apps/docs/content/docs/ja/copilot/index.mdx
@@ -169,3 +169,175 @@ copilotCost = (inputTokens × inputPrice + outputTokens × (outputPrice × 1.5))
モデル価格は100万トークンあたりの料金です。実際のコストを算出するには1,000,000で割ります。背景と例についてはコスト計算ページをご覧ください。
+
+メッセージにカーソルを合わせて**編集**をクリックすると、メッセージを修正して再送信できます。プロンプトを洗練させるのに便利です。
+
+### メッセージキュー
+
+Copilotが応答中にメッセージを送信すると、キューに追加されます。次のことができます:
+- 展開可能なキューパネルでキューに入っているメッセージを表示
+- キューに入っているメッセージをすぐに送信(現在の応答を中止)
+- キューからメッセージを削除
+
+## ファイル添付
+
+添付アイコンをクリックして、メッセージと一緒にファイルをアップロードできます。サポートされているファイル形式:
+- 画像(プレビューサムネイルが表示されます)
+- PDF
+- テキストファイル、JSON、XML
+- その他のドキュメント形式
+
+ファイルはクリック可能なサムネイルとして表示され、新しいタブで開きます。
+
+## チェックポイントと変更
+
+Copilotがワークフローに変更を加えると、必要に応じて元に戻せるようにチェックポイントが保存されます。
+
+### チェックポイントの表示
+
+Copilotのメッセージにカーソルを合わせてチェックポイントアイコンをクリックすると、そのメッセージに保存されたワークフローの状態を確認できます。
+
+### 変更の取り消し
+
+任意のチェックポイントで**元に戻す**をクリックすると、ワークフローをその状態に復元できます。この操作は元に戻せないことを警告する確認ダイアログが表示されます。
+
+### 変更の承認
+
+Copilotが変更を提案した場合、次のことができます:
+- **承認**: 提案された変更を適用(`Mod+Shift+Enter`)
+- **拒否**: 変更を却下して現在のワークフローを維持
+
+## 思考ブロック
+
+複雑なリクエストの場合、Copilotは展開可能な思考ブロックで推論プロセスを表示することがあります:
+
+- Copilotが思考中はブロックが自動的に展開されます
+- クリックして手動で展開/折りたたみ
+- 思考プロセスの所要時間を表示
+- Copilotがどのように解決策に到達したかを理解するのに役立ちます
+
+## オプション選択
+
+Copilotが複数のオプションを提示した場合、次の方法で選択できます:
+
+| 操作 | アクション |
+|---------|--------|
+| **1-9** | 番号でオプションを選択 |
+| **上下矢印キー** | オプション間を移動 |
+| **Enter** | ハイライトされたオプションを選択 |
+
+選択されたオプションはハイライト表示され、未選択のオプションは取り消し線で表示されます。
+
+## キーボードショートカット
+
+| ショートカット | アクション |
+|----------|--------|
+| `@` | コンテキストメニューを開く |
+| `/` | スラッシュコマンドを開く |
+| `Arrow Up/Down` | メニュー項目を移動 |
+| `Enter` | メニュー項目を選択 |
+| `Esc` | メニューを閉じる |
+| `Mod+Shift+Enter` | Copilotの変更を承認 |
+
+## 使用制限
+
+Copilotの使用量は、基盤となるLLMからのトークン単位で課金されます。使用制限に達すると、Copilotは制限の引き上げを促します。現在のベースから増分($50、$100)で使用量を追加できます。
+
+
+ 課金の詳細については、[コスト計算ページ](/execution/costs)を参照してください。
+
+## Copilot MCP
+
+お気に入りのエディタやAIクライアントで、CopilotをMCPサーバーとして使用できます。これにより、Cursor、Claude Code、Claude Desktop、VS Codeなどのツールから直接、Simワークフローの構築、テスト、デプロイ、管理が可能になります。
+
+### Copilot APIキーの生成
+
+Copilot MCPサーバーに接続するには、**Copilot APIキー**が必要です。
+
+1. [sim.ai](https://sim.ai)にアクセスしてサインイン
+2. **設定** → **Copilot**に移動
+3. **APIキーを生成**をクリック
+4. キーをコピー(一度のみ表示されます)
+
+キーは`sk-sim-copilot-...`のような形式です。以下の設定で使用します。
+
+### Cursor
+
+`.cursor/mcp.json`(プロジェクトレベル)またはグローバルなCursor MCP設定に以下を追加してください。
+
+```json
+{
+ "mcpServers": {
+ "sim-copilot": {
+ "url": "https://www.sim.ai/api/mcp/copilot",
+ "headers": {
+ "X-API-Key": "YOUR_COPILOT_API_KEY"
+ }
+ }
+ }
+}
+```
+
+`YOUR_COPILOT_API_KEY`を上記で生成したキーに置き換えてください。
+
+### Claude Code
+
+次のコマンドを実行してCopilot MCPサーバーを追加します:
+
+```bash
+claude mcp add sim-copilot \
+ --transport http \
+ https://www.sim.ai/api/mcp/copilot \
+ --header "X-API-Key: YOUR_COPILOT_API_KEY"
+```
+
+`YOUR_COPILOT_API_KEY`をあなたのキーに置き換えてください。
+
+### Claude Desktop
+
+Claude DesktopはHTTPベースのMCPサーバーに接続するために[`mcp-remote`](https://www.npmjs.com/package/mcp-remote)が必要です。Claude Desktopの設定ファイル(macOSでは`~/Library/Application Support/Claude/claude_desktop_config.json`)に以下を追加してください:
+
+```json
+{
+ "mcpServers": {
+ "sim-copilot": {
+ "command": "npx",
+ "args": [
+ "-y",
+ "mcp-remote",
+ "https://www.sim.ai/api/mcp/copilot",
+ "--header",
+ "X-API-Key: YOUR_COPILOT_API_KEY"
+ ]
+ }
+ }
+}
+```
+
+`YOUR_COPILOT_API_KEY`をあなたのキーに置き換えてください。
+
+### VS Code
+
+VS Codeの`settings.json`またはワークスペースの`.vscode/settings.json`に以下を追加してください:
+
+```json
+{
+ "mcp": {
+ "servers": {
+ "sim-copilot": {
+ "type": "http",
+ "url": "https://www.sim.ai/api/mcp/copilot",
+ "headers": {
+ "X-API-Key": "YOUR_COPILOT_API_KEY"
+ }
+ }
+ }
+ }
+}
+```
+
+`YOUR_COPILOT_API_KEY`をあなたのキーに置き換えてください。
+
+
+ セルフホスト型デプロイメントの場合は、`https://www.sim.ai`をあなたのセルフホスト型SimのURLに置き換えてください。
+
diff --git a/apps/docs/content/docs/ja/enterprise/index.mdx b/apps/docs/content/docs/ja/enterprise/index.mdx
index 701acaaf4..e2e4adfd9 100644
--- a/apps/docs/content/docs/ja/enterprise/index.mdx
+++ b/apps/docs/content/docs/ja/enterprise/index.mdx
@@ -74,3 +74,40 @@ Simのホストキーの代わりに、AIモデルプロバイダー用の独自
BYOKはホスト型Simでのみ利用可能です。セルフホスト型デプロイメントでは、環境変数を介してAIプロバイダーキーを直接設定します。
+
+請求が無効の場合、Admin APIを使用して組織を管理します:
+
+```bash
+# Create an organization
+curl -X POST https://your-instance/api/v1/admin/organizations \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"name": "My Organization", "ownerId": "user-id-here"}'
+
+# Add a member
+curl -X POST https://your-instance/api/v1/admin/organizations/{orgId}/members \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"userId": "user-id-here", "role": "admin"}'
+```
+
+### ワークスペースメンバー
+
+招待が無効の場合、Admin APIを使用してワークスペースメンバーシップを直接管理します:
+
+```bash
+# Add a user to a workspace
+curl -X POST https://your-instance/api/v1/admin/workspaces/{workspaceId}/members \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"userId": "user-id-here", "permissions": "write"}'
+
+# Remove a user from a workspace
+curl -X DELETE "https://your-instance/api/v1/admin/workspaces/{workspaceId}/members?userId=user-id-here" \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY"
+```
+
+### 注意事項
+
+- `ACCESS_CONTROL_ENABLED`を有効にすると、アクセス制御には組織メンバーシップが必要なため、組織が自動的に有効になります。
+- `DISABLE_INVITATIONS`が設定されている場合、ユーザーは招待を送信できません。代わりにAdmin APIを使用してワークスペースと組織のメンバーシップを管理してください。
diff --git a/apps/docs/content/docs/ja/execution/costs.mdx b/apps/docs/content/docs/ja/execution/costs.mdx
index 5c4f1def1..65c9dce60 100644
--- a/apps/docs/content/docs/ja/execution/costs.mdx
+++ b/apps/docs/content/docs/ja/execution/costs.mdx
@@ -241,4 +241,45 @@ Simは**基本サブスクリプション + 超過料金**の課金モデルを
- [設定 → サブスクリプション](https://sim.ai/settings/subscription)で現在の使用状況を確認する
- 実行の詳細を追跡するための[ログ記録](/execution/logging)について学ぶ
- プログラムによるコスト監視のための[外部API](/execution/api)を探索する
-- コストを削減するための[ワークフロー最適化テクニック](/blocks)を確認する
\ No newline at end of file
+- コストを削減するための[ワークフロー最適化テクニック](/blocks)を確認する
+
+**Proプラン（月額$20）:**
+- 月額サブスクリプションに$20分の使用量が含まれます
+- 使用量が$20未満 → 追加料金なし
+- 使用量が$20超過 → 月末に超過分を支払い
+- 例: $35の使用量 = $20（サブスクリプション）+ $15（超過分）
+
+**Teamプラン（月額$40/シート）:**
+- チームメンバー全体でプールされた使用量
+- チーム全体の使用量から超過分を計算
+- 組織のオーナーが一括請求を受け取ります
+
+**Enterpriseプラン:**
+- 固定月額料金、超過料金なし
+- 契約に基づくカスタム使用制限
+
+### 閾値請求
+
+未請求の超過分が$50に達すると、Simは自動的に未請求金額の全額を請求します。
+
+**例:**
+- 10日目: $70の超過 → 即座に$70を請求
+- 15日目: 追加で$35の使用（合計$105）→ すでに請求済み、アクションなし
+- 20日目: さらに$50の使用（合計$155、未請求$85）→ 即座に$85を請求
+
+これにより、期間終了時の一括請求ではなく、大きな超過料金を月内に分散できます。
+
+## コスト管理のベストプラクティス
+
+1. **定期的な監視**: 予期しない請求を避けるため、使用状況ダッシュボードを頻繁に確認してください
+2. **予算の設定**: プラン制限を支出のガードレールとして使用してください
+3. **ワークフローの最適化**: コストの高い実行を確認し、プロンプトやモデル選択を最適化してください
+4. **適切なモデルの使用**: タスク要件にモデルの複雑さを合わせてください
+5. **類似タスクのバッチ処理**: 可能な限り複数のリクエストを組み合わせてオーバーヘッドを削減してください
+
+## 次のステップ
+
+- [設定 → サブスクリプション](https://sim.ai/settings/subscription)で現在の使用状況を確認してください
+- 実行の詳細を追跡するための[ログ記録](/execution/logging)について学んでください
+- プログラムによるコスト監視のための[外部API](/execution/api)を探索してください
+- コストを削減するための[ワークフロー最適化テクニック](/blocks)をチェックしてください
\ No newline at end of file
diff --git a/apps/docs/content/docs/ja/execution/files.mdx b/apps/docs/content/docs/ja/execution/files.mdx
new file mode 100644
index 000000000..7e09558da
--- /dev/null
+++ b/apps/docs/content/docs/ja/execution/files.mdx
@@ -0,0 +1,172 @@
+---
+title: ファイルの受け渡し
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+
+Simを使用すると、ワークフロー全体でファイルを簡単に扱うことができます。ブロックはファイルを受け取り、処理し、他のブロックにシームレスに渡すことができます。
+
+## ファイルオブジェクト
+
+ブロックがファイル（Gmailの添付ファイル、生成された画像、解析されたドキュメントなど）を出力する場合、標準化されたファイルオブジェクトを返します。
+
+```json
+{
+ "name": "report.pdf",
+ "url": "https://...",
+ "base64": "JVBERi0xLjQK...",
+ "type": "application/pdf",
+ "size": 245678
+}
+```
+
+前のブロックからファイルを参照する際に、これらのプロパティにアクセスできます。
+
+## ファイルブロック
+
+**ファイルブロック**は、ワークフロー内のファイルの汎用エントリーポイントです。あらゆるソースからファイルを受け入れ、すべての統合で機能する標準化されたファイルオブジェクトを出力します。
+
+**入力:**
+- **アップロードされたファイル** - ドラッグ&ドロップまたは直接ファイルを選択
+- **外部URL** - 公開アクセス可能な任意のファイルURL
+- **他のブロックからのファイル** - Gmailの添付ファイル、Slackのダウンロードなどからファイルを渡す
+
+**出力:**
+- 一貫した構造を持つ`UserFile`オブジェクトのリスト（`name`、`url`、`base64`、`type`、`size`）
+- `combinedContent` - すべてのファイルから抽出されたテキストコンテンツ（ドキュメント用）
+
+**使用例:**
+
+```
+// Get all files from the File block
+
+
+// Get the first file
+
+
+// Get combined text content from parsed documents
+
+```
+
+ファイルブロックは自動的に以下を実行します:
+- URLと拡張子からファイルタイプを検出
+- PDF、CSV、ドキュメントからテキストを抽出
+- バイナリファイルのbase64エンコーディングを生成
+- 安全なアクセスのための署名付きURLを作成
+
+Vision、STT、メール統合などの他のブロックに渡す前に、異なるソースからのファイルを正規化する必要がある場合は、ファイルブロックを使用してください。
+
+## ブロック間でのファイルの受け渡し
+
+タグドロップダウンを使用して、前のブロックからファイルを参照します。任意のファイル入力フィールドをクリックし、`<`と入力すると、利用可能な出力が表示されます。
+
+**一般的なパターン:**
+
+```
+// Single file from a block
+
+
+// Pass the whole file object
+
+
+// Access specific properties
+
+
+```
+
+ほとんどのブロックは完全なファイルオブジェクトを受け取り、必要な情報を自動的に抽出します。ほとんどの場合、`base64`や`url`を手動で抽出する必要はありません。
+
+## ファイルを使用したワークフローのトリガー
+
+ファイル入力を期待するワークフローをAPI経由で呼び出す場合、リクエストにファイルを含めます:
+
+
+
+
+ ```bash
+ curl -X POST "https://sim.ai/api/workflows/YOUR_WORKFLOW_ID/execute" \
+ -H "Content-Type: application/json" \
+ -H "x-api-key: YOUR_API_KEY" \
+ -d '{
+ "document": {
+ "name": "report.pdf",
+ "base64": "JVBERi0xLjQK...",
+ "type": "application/pdf"
+ }
+ }'
+ ```
+
+
+
+
+ ```bash
+ curl -X POST "https://sim.ai/api/workflows/YOUR_WORKFLOW_ID/execute" \
+ -H "Content-Type: application/json" \
+ -H "x-api-key: YOUR_API_KEY" \
+ -d '{
+ "document": {
+ "name": "report.pdf",
+ "url": "https://example.com/report.pdf",
+ "type": "application/pdf"
+ }
+ }'
+ ```
+
+
+
+
+ワークフローのStartブロックには、ファイルパラメータを受け取るための入力フィールドを設定する必要があります。
+
+## APIレスポンスでのファイル受信
+
+ワークフローがファイルを出力する場合、それらはレスポンスに含まれます:
+
+```json
+{
+ "success": true,
+ "output": {
+ "generatedFile": {
+ "name": "output.png",
+ "url": "https://...",
+ "base64": "iVBORw0KGgo...",
+ "type": "image/png",
+ "size": 34567
+ }
+ }
+}
+```
+
+直接ダウンロードには`url`を、インライン処理には`base64`を使用します。
+
+## ファイルを扱うブロック
+
+**ファイル入力:**
+- **File** - ドキュメント、画像、テキストファイルを解析
+- **Vision** - AIモデルで画像を分析
+- **Mistral Parser** - PDFからテキストを抽出
+
+**ファイル出力:**
+- **Gmail** - メール添付ファイル
+- **Slack** - ダウンロードされたファイル
+- **TTS** - 生成された音声ファイル
+- **Video Generator** - 生成された動画
+- **Image Generator** - 生成された画像
+
+**ファイルストレージ:**
+- **Supabase** - ストレージへのアップロード/ダウンロード
+- **S3** - AWS S3操作
+- **Google Drive** - Driveファイル操作
+- **Dropbox** - Dropboxファイル操作
+
+
+ ファイルは下流のブロックで自動的に利用可能になります。実行エンジンがすべてのファイル転送とフォーマット変換を処理します。
+
+
+## ベストプラクティス
+
+1. **ファイルオブジェクトを直接使用する** - 個別のプロパティを抽出するのではなく、完全なファイルオブジェクトを渡します。ブロックが自動的に変換を処理します。
+
+2. **ファイルタイプを確認する** - ファイルタイプが受信ブロックの期待するものと一致することを確認します。VisionブロックにはイメージがFile、ブロックにはドキュメントが必要です。
+
+3. **ファイルサイズを考慮する** - 大きなファイルは実行時間を増加させます。非常に大きなファイルの場合は、中間ストレージとしてストレージブロック（S3、Supabase）の使用を検討してください。
diff --git a/apps/docs/content/docs/ja/execution/form.mdx b/apps/docs/content/docs/ja/execution/form.mdx
new file mode 100644
index 000000000..837ab15ff
--- /dev/null
+++ b/apps/docs/content/docs/ja/execution/form.mdx
@@ -0,0 +1,142 @@
+---
+title: フォームデプロイメント
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+
+ワークフローを埋め込み可能なフォームとしてデプロイし、ユーザーがウェブサイト上で入力したり、リンク経由で共有したりできます。フォーム送信は、`form`トリガータイプでワークフローを起動します。
+
+## 概要
+
+フォームデプロイメントは、ワークフローの入力フォーマットをレスポンシブなフォームに変換します。このフォームは次のように利用できます:
+- 直接リンクで共有(例: `https://sim.ai/form/my-survey`)
+- iframeを使用して任意のウェブサイトに埋め込み
+
+ユーザーがフォームを送信すると、フォームデータを使用してワークフローが起動されます。
+
+
+フォームのフィールドは、ワークフローのStartブロックの入力フォーマットから派生します。各フィールドは、適切なタイプのフォーム入力になります。
+
+
+## フォームの作成
+
+1. ワークフローを開き、**Deploy**をクリックします
+2. **Form**タブを選択します
+3. 設定:
+ - **URL**: 一意の識別子(例: `contact-form` → `sim.ai/form/contact-form`)
+ - **Title**: フォームの見出し
+ - **Description**: オプションのサブタイトル
+ - **Form Fields**: 各フィールドのラベルと説明をカスタマイズ
+ - **Authentication**: 公開、パスワード保護、またはメールホワイトリスト
+ - **Thank You Message**: 送信後に表示されるメッセージ
+4. **Launch**をクリックします
+
+## フィールドタイプのマッピング
+
+| 入力フォーマットタイプ | フォームフィールド |
+|------------------|------------|
+| `string` | テキスト入力 |
+| `number` | 数値入力 |
+| `boolean` | トグルスイッチ |
+| `object` | JSONエディタ |
+| `array` | JSON配列エディタ |
+| `files` | ファイルアップロード |
+
+## アクセス制御
+
+| モード | 説明 |
+|------|-------------|
+| **Public** | リンクを持つ誰でも送信可能 |
+| **Password** | ユーザーはパスワードを入力する必要があります |
+| **Email Whitelist** | 指定されたメール/ドメインのみ送信可能 |
+
+メールホワイトリストの場合：
+- 完全一致：`user@example.com`
+- ドメイン：`@example.com`（ドメインからのすべてのメール）
+
+## 埋め込み
+
+### 直接リンク
+
+```
+https://sim.ai/form/your-identifier
+```
+
+### Iframe
+
+```html
+
+```
+
+## API送信
+
+プログラムでフォームを送信：
+
+
+
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+ -H "Content-Type: application/json" \
+ -d '{
+ "formData": {
+ "name": "John Doe",
+ "email": "john@example.com"
+ }
+ }'
+```
+
+
+
+
+```typescript
+const response = await fetch('https://sim.ai/api/form/your-identifier', {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({
+ formData: {
+ name: 'John Doe',
+ email: 'john@example.com'
+ }
+ })
+});
+
+const result = await response.json();
+// { success: true, data: { executionId: '...' } }
+```
+
+
+
+
+### 保護されたフォーム
+
+パスワード保護されたフォームの場合：
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+ -H "Content-Type: application/json" \
+ -d '{ "password": "secret", "formData": { "name": "John" } }'
+```
+
+メール保護されたフォームの場合：
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+ -H "Content-Type: application/json" \
+ -d '{ "email": "allowed@example.com", "formData": { "name": "John" } }'
+```
+
+## トラブルシューティング
+
+**「入力フィールドが設定されていません」** - スタートブロックに入力フォーマットフィールドを追加してください。
+
+**iframeでフォームが読み込まれない** - サイトのCSPが`sim.ai`からのiframeを許可しているか確認してください。
+
+**送信が失敗する** - 識別子が正しく、必須フィールドが入力されているか確認してください。
diff --git a/apps/docs/content/docs/ja/quick-reference/index.mdx b/apps/docs/content/docs/ja/quick-reference/index.mdx
new file mode 100644
index 000000000..aa1cdd6ea
--- /dev/null
+++ b/apps/docs/content/docs/ja/quick-reference/index.mdx
@@ -0,0 +1,394 @@
+---
+title: クイックリファレンス
+description: Simワークフローエディタのナビゲーションと使用に必要な基本操作
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { ActionImage, ActionVideo } from '@/components/ui/action-media'
+
+Simワークフローエディタの日常的な操作のクイックルックアップです。キーボードショートカットについては、[キーボードショートカット](/keyboard-shortcuts)を参照してください。
+
+
+ **Mod**は、macOSでは`Cmd`、Windows/Linuxでは`Ctrl`を指します。
+
+
+## ワークスペース
+
+
+
+ 操作 方法 プレビュー
+ ワークスペースを作成
+ ワークスペースドロップダウンをクリック → **新規ワークスペース**
+
+
+ ワークスペースを切り替え
+ ワークスペースドロップダウンをクリック → ワークスペースを選択
+
+
+ チームメンバーを招待
+ サイドバー → **招待**
+
+
+ ワークスペースの名前を変更
+ ワークスペースを右クリック → **名前を変更**
+
+
+ ワークスペースを複製
+ ワークスペースを右クリック → **複製**
+
+
+ ワークスペースをエクスポート
+ ワークスペースを右クリック → **エクスポート**
+
+
+ ワークスペースを削除
+ ワークスペースを右クリック → **削除**
+
+
+
+
+## ワークフロー
+
+
+
+ 操作 方法 プレビュー
+ ワークフローを作成
+ サイドバーの**+**ボタンをクリック
+
+
+ ワークフローを並べ替え/移動
+ ワークフローを上下にドラッグ、またはフォルダにドラッグ
+
+
+ ワークフローをインポート
+ サイドバーのインポートボタンをクリック → ファイルを選択
+
+
+ ワークフローを複数選択
+ サイドバーで`Mod+Click`または`Shift+Click`でワークフローを選択
+
+
+ 新しいタブで開く
+ ワークフローを右クリック → **新しいタブで開く**
+
+
+ ワークフローの名前を変更
+ ワークフローを右クリック → **名前を変更**
+
+
+ ワークフローの色を設定
+ ワークフローを右クリック → **色を変更**
+
+
+ ワークフローを複製
+ ワークフローを右クリック → **複製**
+
+
+ ワークフローをエクスポート
+ ワークフローを右クリック → **エクスポート**
+
+
+ ワークフローを削除
+ ワークフローを右クリック → **削除**
+
+
+ フォルダの名前を変更
+ フォルダを右クリック → **名前を変更**
+
+
+ フォルダ内にワークフローを作成
+ フォルダを右クリック → **ワークフローを作成**
+
+
+ フォルダ内にフォルダを作成
+ フォルダを右クリック → **フォルダを作成**
+
+
+ フォルダを複製
+ フォルダを右クリック → **複製**
+
+
+ フォルダをエクスポート
+ フォルダを右クリック → **エクスポート**
+
+
+ フォルダを削除
+ フォルダを右クリック → **削除**
+
+
+
+
+## ブロック
+
+
+
+ 操作 方法 プレビュー
+ ブロックを追加
+ ツールバーパネルからドラッグ、またはキャンバスを右クリック → **ブロックを追加**
+
+
+ ブロックを複数選択
+ `Mod+Click` 追加のブロック、またはShiftキーを押しながらドラッグして選択ボックスを描画
+
+
+ ブロックをコピー
+ ブロックを選択した状態で `Mod+C`
+
+
+ ブロックを貼り付け
+ `Mod+V` でコピーしたブロックを貼り付け
+
+
+ ブロックを複製
+ 右クリック → **複製**
+
+
+ ブロックを削除
+ `Delete` または `Backspace` キー、または右クリック → **削除**
+
+
+ ブロック名を変更
+ ヘッダーのブロック名をクリック、またはエディターパネルで編集
+
+
+ ブロックを有効化/無効化
+ 右クリック → **有効化/無効化**
+
+
+ ブロックをロック/ロック解除
+ ブロックにカーソルを合わせる → ロックアイコンをクリック(管理者のみ)
+
+
+ ハンドルの向きを切り替え
+ 右クリック → **ハンドルを切り替え**
+
+
+ ブロックを設定
+ ブロックを選択 → 右側のエディターパネルを使用
+
+
+
+
+## 接続
+
+
+
+ 操作 方法 プレビュー
+ 接続を作成
+ 出力ハンドルから入力ハンドルへドラッグ
+
+
+ 接続を削除
+ エッジをクリックして選択 → `Delete` キー
+
+
+ 別のブロックで出力を使用
+ 接続タグを入力フィールドにドラッグ
+
+
+
+
+## パネルとビュー
+
+
+
+ 操作 方法 プレビュー
+ ツールバーを検索
+ `Mod+F`
+
+
+ すべてを検索
+ `Mod+K`
+
+
+ 手動モードを切り替え
+ トグルボタンをクリックして手動モードとセレクターを切り替え
+
+
+ サイドバーを折りたたむ/展開
+ サイドバーの折りたたみボタンをクリック
+
+
+
+
+## 実行とテスト
+
+
+
+ 操作 方法 プレビュー
+ ワークフローを実行
+ ワークフローを実行ボタンをクリック、または`Mod+Enter`
+
+
+ ワークフローを停止
+ 停止ボタンをクリック、または実行中に`Mod+Enter`
+
+
+ チャットでテスト
+ 右側のチャットパネルを使用
+
+
+ 表示する出力を選択
+ チャットパネルのドロップダウンをクリック → ブロック出力を選択
+
+
+ チャット履歴をクリア
+ チャットパネルのクリアボタンをクリック
+
+
+ ブロックから実行
+ ブロックにカーソルを合わせて再生ボタンをクリック、または右クリック → **ブロックから実行**
+
+
+ ブロックまで実行
+ ブロックを右クリック → **ブロックまで実行**
+
+
+ 実行ログを表示
+ 下部のターミナルパネルを開く、または`Mod+L`
+
+
+ ログをフィルター
+ ターミナルのフィルターアイコンをクリック → ブロックまたはステータスでフィルター
+
+
+ ログを検索
+ ターミナルの検索フィールドを使用、またはログエントリーを右クリック → **検索**
+
+
+ ログエントリーをコピー
+ クリップボードアイコン、またはログエントリーを右クリック → **コピー**
+
+
+ ターミナルをクリア
+ ゴミ箱アイコン、または`Mod+D`
+
+
+
+
+## デプロイ
+
+
+
+ 操作 方法 プレビュー
+ ワークフローをデプロイする
+ パネルの**デプロイ**ボタンをクリック
+
+
+ デプロイを更新する
+ 変更が検出されたら**更新**をクリック
+
+
+ デプロイステータスを表示する
+ デプロイタブでステータスインジケーター(Live/Update/Deploy)を確認
+
+
+ デプロイを元に戻す
+ デプロイタブで以前のバージョンにアクセス → **本番環境に昇格**
+
+
+ バージョン説明を追加する
+ デプロイタブ → 説明アイコンをクリック → 説明を追加または生成
+
+
+ APIエンドポイントをコピーする
+ デプロイタブ → API → API cURLをコピー
+
+
+
+
+## 変数
+
+
+
+ 操作 方法 プレビュー
+ ワークフロー変数を追加/編集/削除する
+ パネル -> 変数 -> **変数を追加**、クリックして編集、または削除アイコン
+
+
+ 環境変数を追加する
+ 設定 → **環境変数** → **追加**
+
+
+ ワークフロー変数を参照する
+ ブロック入力で``構文を使用
+
+
+ 環境変数を参照する
+ ブロック入力で`{{ENV_VAR}}`構文を使用
+
+
+
diff --git a/apps/docs/content/docs/ja/self-hosting/index.mdx b/apps/docs/content/docs/ja/self-hosting/index.mdx
index 18aea7e7d..7a6483c9e 100644
--- a/apps/docs/content/docs/ja/self-hosting/index.mdx
+++ b/apps/docs/content/docs/ja/self-hosting/index.mdx
@@ -56,3 +56,10 @@ docker compose -f docker-compose.prod.yml up -d
| realtime | 3002 | WebSocketサーバー |
| db | 5432 | pgvector搭載のPostgreSQL |
| migrations | - | データベースマイグレーション（一度だけ実行） |
+
+| コンポーネント | ポート | 説明 |
+|-----------|------|-------------|
+| simstudio | 3000 | メインアプリケーション |
+| realtime | 3002 | WebSocketサーバー |
+| db | 5432 | pgvector付きPostgreSQL |
+| migrations | - | データベースマイグレーション（1回実行） |
diff --git a/apps/docs/content/docs/ja/skills/index.mdx b/apps/docs/content/docs/ja/skills/index.mdx
new file mode 100644
index 000000000..35254ea84
--- /dev/null
+++ b/apps/docs/content/docs/ja/skills/index.mdx
@@ -0,0 +1,134 @@
+---
+title: エージェントスキル
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+
+エージェントスキルは、AIエージェントに専門的な機能を提供する再利用可能な指示パッケージです。オープンな[Agent Skills](https://agentskills.io)フォーマットに基づいており、スキルを使用することで、エージェントが必要に応じて読み込める専門知識、ワークフロー、ベストプラクティスを記録できます。
+
+## スキルの仕組み
+
+スキルは**段階的開示**を使用して、エージェントのコンテキストを軽量に保ちます。
+
+1. **発見** — スキル名と説明のみがエージェントのシステムプロンプトに含まれます(各約50〜100トークン)
+2. **アクティベーション** — エージェントがスキルが関連すると判断すると、`load_skill`ツールを呼び出して完全な指示をコンテキストに読み込みます
+3. **実行** — エージェントは読み込まれた指示に従ってタスクを完了します
+
+つまり、コンテキストウィンドウを肥大化させることなく、多くのスキルをエージェントに添付できます。エージェントは必要なものだけを読み込みます。
+
+## スキルの作成
+
+**設定**に移動し、ツールセクションの下にある**スキル**を選択します。
+
+
+
+**追加**をクリックして、3つのフィールドを持つ新しいスキルを作成します。
+
+| フィールド | 説明 |
+|-------|-------------|
+| **名前** | ケバブケースの識別子(例: `sql-expert`、`code-reviewer`)。最大64文字。 |
+| **説明** | スキルが何をするか、いつ使用するかについての簡単な説明。これは、エージェントがスキルをアクティベートするかどうかを決定するために読むものです。最大1024文字。 |
+| **コンテンツ** | マークダウン形式の完全なスキル指示。これは、エージェントがスキルをアクティベートしたときに読み込まれます。 |
+
+
+ 説明は重要です。これは、エージェントがスキルを読み込むかどうかを決定する前に見る唯一のものです。スキルをいつ、なぜ使用すべきかについて具体的に記述してください。
+
+
+### 優れたスキルコンテンツの作成
+
+スキルコンテンツは[SKILL.mdファイル](https://agentskills.io/specification)と同じ規則に従います。
+
+```markdown
+# SQL Expert
+
+## When to use this skill
+Use when the user asks you to write, optimize, or debug SQL queries.
+
+## Instructions
+1. Always ask which database engine (PostgreSQL, MySQL, SQLite)
+2. Use CTEs over subqueries for readability
+3. Add index recommendations when relevant
+4. Explain query plans for optimization requests
+
+## Common Patterns
+...
+```
+
+**推奨される構造:**
+- **使用するタイミング** — 特定のトリガーとシナリオ
+- **手順** — 番号付きリストによる段階的なガイダンス
+- **例** — 期待される動作を示す入出力サンプル
+- **一般的なパターン** — 頻繁なタスクに対する再利用可能なアプローチ
+- **エッジケース** — 注意点と特別な考慮事項
+
+スキルは焦点を絞り、500行以内に収めてください。スキルが大きくなりすぎた場合は、複数の専門的なスキルに分割してください。
+
+## エージェントへのスキルの追加
+
+任意の**エージェント**ブロックを開き、ツールセクションの下にある**スキル**ドロップダウンを見つけます。エージェントにアクセスさせたいスキルを選択してください。
+
+
+
+選択されたスキルはカードとして表示され、クリックして編集または削除できます。
+
+### 実行時の動作
+
+ワークフローが実行されると:
+
+1. エージェントのシステムプロンプトには、各スキルの名前と説明をリストした``セクションが含まれます
+2. `load_skill`ツールがエージェントの利用可能なツールに自動的に追加されます
+3. エージェントが現在のタスクに関連するスキルがあると判断すると、スキル名を指定して`load_skill`を呼び出します
+4. 完全なスキルコンテンツがツールレスポンスとして返され、エージェントに詳細な手順が提供されます
+
+これはサポートされているすべてのLLMプロバイダーで機能します。`load_skill`ツールは標準のツール呼び出しを使用するため、プロバイダー固有の設定は不要です。
+
+## 一般的な使用例
+
+スキルは、エージェントが専門知識や複数ステップのワークフローを必要とする場合に最も価値があります。
+
+**ドメインの専門知識**
+- `api-integration-expert` — 特定のAPIを呼び出すためのベストプラクティス(認証、レート制限、エラー処理)
+- `data-transformation` — ETLパターン、データクリーニング、検証ルール
+- `code-reviewer` — チームの基準に特化したコードレビューガイドライン
+
+**ワークフローテンプレート**
+- `bug-investigation` — 段階的なデバッグ手法（再現 → 分離 → テスト → 修正）
+- `feature-implementation` — 要件から展開までの開発ワークフロー
+- `document-generator` — 技術文書のテンプレートとフォーマットルール
+
+**企業固有の知識**
+- `our-architecture` — システムアーキテクチャ図、サービス依存関係、デプロイプロセス
+- `style-guide` — ブランドガイドライン、文章のトーン、UI/UXパターン
+- `customer-onboarding` — 標準手順と一般的な顧客からの質問
+
+**スキルとエージェント指示の使い分け:**
+- **スキル**は、複数のワークフローに適用される知識や頻繁に変更される知識に使用します
+- **エージェント指示**は、単一のエージェントに固有のタスク固有のコンテキストに使用します
+
+## ベストプラクティス
+
+**効果的な説明の書き方**
+- **具体的でキーワードを豊富に含める** — 「SQLを支援」ではなく、「PostgreSQL、MySQL、SQLite向けに最適化されたSQLクエリを作成し、インデックスの推奨事項とクエリプラン分析を含む」と記述します
+- **アクティベーショントリガーを含める** — スキルを促す特定の単語やフレーズを記載します（例:「ユーザーがPDF、フォーム、文書抽出について言及した場合に使用」）
+- **200語以内に収める** — エージェントは説明を素早くスキャンするため、すべての単語を重要にします
+
+**スキルの範囲と整理**
+- **ドメインごとに1つのスキル** — 焦点を絞った`sql-expert`スキルは、広範な`database-everything`スキルよりも効果的です
+- **エージェントごとに5〜10個のスキルに制限** — スキルが多いほど意思決定のオーバーヘッドが増加します。小さく始めて必要に応じて追加します
+- **大きなスキルを分割** — スキルが500行を超える場合は、焦点を絞ったサブスキルに分割します
+
+**コンテンツ構造**
+- **マークダウン形式を使用** — 見出し、リスト、コードブロックは、エージェントが指示を解析して従うのに役立ちます
+- **例を提供** — 入力/出力のペアを示して、エージェントが期待される動作を理解できるようにします
+- **エッジケースについて明示的に記述** — エージェントが特別な処理を推測すると想定しないでください
+
+**テストと反復**
+- **アクティベーションのテスト** — ワークフローを実行し、エージェントが期待通りにスキルを読み込むことを確認する
+- **誤検知の確認** — スキルが不要な場面でアクティブ化されていないことを確認する
+- **説明の改善** — 必要な時にスキルが読み込まれない場合は、説明にキーワードを追加する
+
+## 詳細情報
+
+- [Agent Skillsの仕様](https://agentskills.io) — ポータブルなエージェントスキルのオープンフォーマット
+- [スキルの例](https://github.com/anthropics/skills) — コミュニティのスキル例を閲覧する
+- [ベストプラクティス](https://agentskills.io/what-are-skills) — 効果的なスキルの作成方法
diff --git a/apps/docs/content/docs/ja/tools/a2a.mdx b/apps/docs/content/docs/ja/tools/a2a.mdx
new file mode 100644
index 000000000..cf845ecc1
--- /dev/null
+++ b/apps/docs/content/docs/ja/tools/a2a.mdx
@@ -0,0 +1,207 @@
+---
+title: A2A
+description: 外部のA2A互換エージェントと連携
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+
+
+
+ -
+ 循环类型：可选择 'for'、'forEach'、'while' 或 'doWhile'
+
+ -
+ 迭代次数：执行的次数（适用于 for 循环）
+
+ -
+ 集合：要遍历的数组或对象（适用于 forEach 循环）
+
+ -
+ 条件：要判断的布尔表达式（适用于 while/do-while 循环）
+
+
+
+
+ 仅在循环**内部**可用：
+
+ -
+ {"
"} ：当前迭代次数（从 0 开始）
+
+ -
+ {"
"} ：当前正在处理的项（仅适用于 forEach）
+
+ -
+ {"
"} ：完整集合（仅适用于 forEach）
+
+
+
+
+
+ -
+ {"
"} ：所有迭代结果的数组（通过区块名访问）
+
+ -
+ 结构：结果保持迭代顺序
+
+ -
+ 访问：循环结束后可在后续区块中访问
+
+
+
+
+
+## 最佳实践
+
+- **设置合理的限制**：保持迭代次数适中，避免执行时间过长
+- **集合处理优先用 ForEach**：处理数组或对象时，优先使用 ForEach 而不是 For 循环
+- **优雅处理错误**：建议在循环内部添加错误处理，使流程更健壮
diff --git a/apps/docs/content/docs/zh/blocks/parallel.mdx b/apps/docs/content/docs/zh/blocks/parallel.mdx
index a8a36d4c1..dde186570 100644
--- a/apps/docs/content/docs/zh/blocks/parallel.mdx
+++ b/apps/docs/content/docs/zh/blocks/parallel.mdx
@@ -193,3 +193,51 @@ const allResults = input.parallel.results;
- **仅限独立操作**：确保操作之间没有依赖关系
- **处理速率限制**：为 API 密集型工作流添加延迟或节流
- **错误处理**：每个实例应优雅地处理自己的错误
+
+## 输入与输出
+
+
+
+
+ -
+ 并行类型：在 'count' 或 'collection' 之间选择
+
+ -
+ Count：要运行的实例数量（基于 count）
+
+ -
+ Collection：要分发的数组或对象（基于 collection）
+
+
+
+
+ 仅在并行内部可用：
+
+ -
+ {"
"} ：实例编号（从 0 开始）
+
+ -
+ {"
"} ：该实例对应的项（仅限 collection 模式）
+
+ -
+ {"
"} ：完整集合（仅限 collection 模式）
+
+
+
+
+
+ -
+ {"
"} ：所有实例结果的数组（通过区块名访问）
+
+ -
+ 访问：并行执行完成后可在后续区块中访问
+
+
+
+
+
+## 最佳实践
+
+- **仅限独立操作**：确保各操作之间互不依赖
+- **处理速率限制**：对于大量 API 操作的流程，添加延迟或限流
+- **错误处理**：每个实例应能优雅地处理自身错误
diff --git a/apps/docs/content/docs/zh/blocks/router.mdx b/apps/docs/content/docs/zh/blocks/router.mdx
index e7162fe3e..b8efa1c8f 100644
--- a/apps/docs/content/docs/zh/blocks/router.mdx
+++ b/apps/docs/content/docs/zh/blocks/router.mdx
@@ -100,3 +100,18 @@ Input (Lead) → Router → Agent (Enterprise Sales) or Workflow (Self-serve)
- **使用多样化输入进行测试**：确保路由器能够处理各种输入类型、边界情况和意外内容
- **监控路由性能**：定期审查路由决策，并根据实际使用模式优化标准
- **选择合适的模型**：对于复杂的路由决策，使用具有强大推理能力的模型
+
+当 Router 无法根据当前上下文确定合适的路由时，会跳转到**错误路径**，而不是随意选择一个路由。出现这种情况的原因包括：
+
+- 上下文与任何已定义的路由描述都不明确匹配
+- AI 判断没有任何可用路由是合适的
+
+## 最佳实践
+
+- **编写清晰的路由描述**：每个路由描述都应明确说明在什么情况下应选择该路由，具体说明选择标准。
+- **确保路由互斥**：尽量避免路由描述重叠，以防止出现歧义的路由决策。
+- **连接错误路径**：为未匹配到任何路由的情况配置错误处理器，实现平滑回退。
+- **使用有描述性的路由标题**：路由标题会显示在工作流画布中，请确保其具有可读性和意义。
+- **用多样化输入进行测试**：确保 Router 能处理各种输入类型、边界情况和意外内容。
+- **监控路由表现**：定期回顾路由决策，并根据实际使用情况优化路由描述。
+- **选择合适的模型**：对于复杂的路由决策，建议使用具备强大推理能力的模型。
diff --git a/apps/docs/content/docs/zh/copilot/index.mdx b/apps/docs/content/docs/zh/copilot/index.mdx
index 41c63f63a..b3b54d134 100644
--- a/apps/docs/content/docs/zh/copilot/index.mdx
+++ b/apps/docs/content/docs/zh/copilot/index.mdx
@@ -169,3 +169,175 @@ copilotCost = (inputTokens × inputPrice + outputTokens × (outputPrice × 1.5))
模型价格以每百万标记为单位。计算公式将其除以 1,000,000 以获得实际成本。请参阅成本计算页面了解背景和示例。
+
+将鼠标悬停在任意消息上，点击 **编辑** 以修改并重新发送。这有助于优化你的提示。
+
+### 消息队列
+
+如果你在 Copilot 仍在回复时发送消息，该消息会被加入队列。你可以：
+- 在可展开的队列面板中查看排队的消息
+- 立即发送排队消息（会中止当前回复）
+- 从队列中移除消息
+
+## 文件附件
+
+点击附件图标即可随消息上传文件。支持的文件类型包括：
+- 图片（显示预览缩略图）
+- PDF
+- 文本文件、 JSON 、 XML
+- 其他文档格式
+
+文件会以可点击的缩略图形式展示，点击后将在新标签页中打开。
+
+## 检查点与更改
+
+当 Copilot 对你的工作流进行更改时，会保存检查点，方便你在需要时回退。
+
+### 查看检查点
+
+将鼠标悬停在 Copilot 消息上，点击检查点图标即可查看该消息保存的工作流状态。
+
+### 撤销更改
+
+点击任意检查点的 **撤销**，即可将工作流恢复到该状态。确认对话框会提示此操作无法撤销。
+
+### 接受更改
+
+当 Copilot 提出更改时，你可以：
+- **接受**：应用建议的更改（`Mod+Shift+Enter`）
+- **拒绝**：忽略更改，保留当前工作流
+
+## 思考块
+
+对于复杂请求， Copilot 可能会在可展开的思考块中展示其推理过程：
+
+- Copilot 思考时，思考块会自动展开
+- 点击可手动展开/收起
+- 显示思考过程的持续时间
+- 帮助你理解 Copilot 如何得出解决方案
+
+## 选项选择
+
+当 Copilot 提供多个选项时，你可以通过以下方式选择：
+
+| 控制键 | 操作 |
+|---------|--------|
+| **1-9** | 通过数字选择选项 |
+| **向上/向下箭头** | 在选项间导航 |
+| **Enter** | 选择高亮选项 |
+
+已选中的选项会高亮显示，未选中的选项会显示删除线。
+
+## 键盘快捷键
+
+| 快捷键 | 操作 |
+|----------|--------|
+| `@` | 打开上下文菜单 |
+| `/` | 打开斜杠命令 |
+| `Arrow Up/Down` | 菜单项导航 |
+| `Enter` | 选择菜单项 |
+| `Esc` | 关闭菜单 |
+| `Mod+Shift+Enter` | 接受 Copilot 更改 |
+
+## 使用限制
+
+Copilot 的使用按底层 LLM 的 token 计费。如果达到使用上限，Copilot 会提示你增加额度。你可以以 $50、$100 为增量，基于当前基础额度增加使用量。
+
+
+ 计费详情请参见 [成本计算页面](/execution/costs)。
+
+## Copilot MCP
+
+你可以在常用编辑器或 AI 客户端中将 Copilot 作为 MCP 服务器使用。这样可以直接在 Cursor、Claude Code、Claude Desktop 和 VS Code 等工具中构建、测试、部署和管理 Sim 工作流。
+
+### 生成 Copilot API 密钥
+
+要连接 Copilot MCP 服务器，你需要一个 **Copilot API 密钥**：
+
+1. 访问 [sim.ai](https://sim.ai) 并登录
+2. 进入 **设置** → **Copilot**
+3. 点击 **生成 API 密钥**
+4. 复制密钥 — 该密钥只显示一次
+
+密钥类似于 `sk-sim-copilot-...`。你将在下方配置中用到它。
+
+### Cursor
+
+将以下内容添加到你的 `.cursor/mcp.json`（项目级）或全局 Cursor MCP 设置中：
+
+```json
+{
+ "mcpServers": {
+ "sim-copilot": {
+ "url": "https://www.sim.ai/api/mcp/copilot",
+ "headers": {
+ "X-API-Key": "YOUR_COPILOT_API_KEY"
+ }
+ }
+ }
+}
+```
+
+将 `YOUR_COPILOT_API_KEY` 替换为你上面生成的密钥。
+
+### Claude Code
+
+运行以下命令以添加 Copilot MCP 服务器：
+
+```bash
+claude mcp add sim-copilot \
+ --transport http \
+ https://www.sim.ai/api/mcp/copilot \
+ --header "X-API-Key: YOUR_COPILOT_API_KEY"
+```
+
+将 `YOUR_COPILOT_API_KEY` 替换为你的密钥。
+
+### Claude Desktop
+
+Claude Desktop 需要 [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) 以连接基于 HTTP 的 MCP 服务器。请将以下内容添加到你的 Claude Desktop 配置文件（macOS 上为 `~/Library/Application Support/Claude/claude_desktop_config.json`）：
+
+```json
+{
+ "mcpServers": {
+ "sim-copilot": {
+ "command": "npx",
+ "args": [
+ "-y",
+ "mcp-remote",
+ "https://www.sim.ai/api/mcp/copilot",
+ "--header",
+ "X-API-Key: YOUR_COPILOT_API_KEY"
+ ]
+ }
+ }
+}
+```
+
+将 `YOUR_COPILOT_API_KEY` 替换为你的密钥。
+
+### VS Code
+
+请将以下内容添加到你的 VS Code `settings.json` 或工作区 `.vscode/settings.json`：
+
+```json
+{
+ "mcp": {
+ "servers": {
+ "sim-copilot": {
+ "type": "http",
+ "url": "https://www.sim.ai/api/mcp/copilot",
+ "headers": {
+ "X-API-Key": "YOUR_COPILOT_API_KEY"
+ }
+ }
+ }
+ }
+}
+```
+
+将 `YOUR_COPILOT_API_KEY` 替换为你的密钥。
+
+
+ 对于自托管部署，请将 `https://www.sim.ai` 替换为你的自托管 Sim URL。
+
diff --git a/apps/docs/content/docs/zh/enterprise/index.mdx b/apps/docs/content/docs/zh/enterprise/index.mdx
index 520210509..39be4309e 100644
--- a/apps/docs/content/docs/zh/enterprise/index.mdx
+++ b/apps/docs/content/docs/zh/enterprise/index.mdx
@@ -74,3 +74,40 @@ Sim 企业版为需要更高安全性、合规性和管理能力的组织提供
BYOK 仅适用于托管版 Sim。自托管部署需通过环境变量直接配置 AI 提供商密钥。
+
+当计费被禁用时，请使用 Admin API 管理组织：
+
+```bash
+# Create an organization
+curl -X POST https://your-instance/api/v1/admin/organizations \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"name": "My Organization", "ownerId": "user-id-here"}'
+
+# Add a member
+curl -X POST https://your-instance/api/v1/admin/organizations/{orgId}/members \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"userId": "user-id-here", "role": "admin"}'
+```
+
+### 工作区成员
+
+当邀请被禁用时，请直接使用 Admin API 管理工作区成员资格：
+
+```bash
+# Add a user to a workspace
+curl -X POST https://your-instance/api/v1/admin/workspaces/{workspaceId}/members \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"userId": "user-id-here", "permissions": "write"}'
+
+# Remove a user from a workspace
+curl -X DELETE "https://your-instance/api/v1/admin/workspaces/{workspaceId}/members?userId=user-id-here" \
+ -H "x-admin-key: YOUR_ADMIN_API_KEY"
+```
+
+### 注意事项
+
+- 启用 `ACCESS_CONTROL_ENABLED` 会自动启用组织，因为访问控制需要组织成员身份。
+- 设置 `DISABLE_INVITATIONS` 后，用户无法发送邀请。请改用 Admin API 管理工作区和组织成员资格。
diff --git a/apps/docs/content/docs/zh/execution/costs.mdx b/apps/docs/content/docs/zh/execution/costs.mdx
index 349039c19..c83757d00 100644
--- a/apps/docs/content/docs/zh/execution/costs.mdx
+++ b/apps/docs/content/docs/zh/execution/costs.mdx
@@ -241,4 +241,45 @@ Sim 采用**基础订阅 + 超额**计费模式：
- 在 [设置 → 订阅](https://sim.ai/settings/subscription) 中查看您当前的使用情况
- 了解 [日志记录](/execution/logging)，以跟踪执行详情
- 探索 [外部 API](/execution/api)，实现程序化成本监控
-- 查看 [工作流优化技巧](/blocks)，以降低成本
\ No newline at end of file
+- 查看 [工作流优化技巧](/blocks)，以降低成本
+
+**Pro 计划（$20/月）：**
+- 月度订阅包含 $20 用量
+- 用量低于 $20 → 无额外费用
+- 用量超过 $20 → 月底结算超出部分
+- 示例：$35 用量 = $20（订阅）+ $15（超出部分）
+
+**团队计划（$40/席位/月）：**
+- 团队成员用量合并计算
+- 超出部分按团队总用量计算
+- 组织所有者收到一张账单
+
+**企业计划：**
+- 固定月费，无超出费用
+- 用量上限可按协议定制
+
+### 阈值计费
+
+当未结算的超出费用达到 $50 时，Sim 会自动结算全部未结算金额。
+
+**示例：**
+- 第 10 天：超出 $70 → 立即结算 $70
+- 第 15 天：新增 $35 用量（累计 $105）→ 已结算，无需操作
+- 第 20 天：再用 $50（累计 $155，未结算 $85）→ 立即结算 $85
+
+这样可以将大额超出费用分摊到每月各个时间点，而不是期末一次性结算。
+
+## 成本管理最佳实践
+
+1. **定期监控**：经常查看用量仪表盘，避免意外支出
+2. **设置预算**：利用套餐限额作为支出参考
+3. **优化工作流**：检查高成本执行，优化提示词或模型选择
+4. **选择合适模型**：根据任务需求匹配模型复杂度
+5. **批量处理相似任务**：尽量合并请求，减少开销
+
+## 下一步
+
+- 在 [设置 → 订阅](https://sim.ai/settings/subscription) 查看当前用量
+- 了解 [日志记录](/execution/logging) 以追踪执行详情
+- 探索 [外部 API](/execution/api) 以编程方式监控成本
+- 查看 [工作流优化技巧](/blocks) 以降低成本
\ No newline at end of file
diff --git a/apps/docs/content/docs/zh/execution/files.mdx b/apps/docs/content/docs/zh/execution/files.mdx
new file mode 100644
index 000000000..fe3526b85
--- /dev/null
+++ b/apps/docs/content/docs/zh/execution/files.mdx
@@ -0,0 +1,172 @@
+---
+title: 传递文件
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+
+Sim 让你可以在整个工作流中轻松处理文件。各个区块可以接收文件、处理文件，并无缝地将其传递给其他区块。
+
+## 文件对象
+
+当区块输出文件（如 Gmail 附件、生成的图片或解析后的文档）时，会返回一个标准化的文件对象：
+
+```json
+{
+ "name": "report.pdf",
+ "url": "https://...",
+ "base64": "JVBERi0xLjQK...",
+ "type": "application/pdf",
+ "size": 245678
+}
+```
+
+引用前面区块的文件时，你可以访问这些属性中的任意一个。
+
+## 文件区块
+
+**文件区块** 是你工作流中文件的通用入口。它可以接收来自任何来源的文件，并输出适用于所有集成的标准化文件对象。
+
+**输入：**
+- **上传的文件** - 直接拖拽或选择文件
+- **外部 URL** - 任何可公开访问的文件 URL
+- **来自其他区块的文件** - 传递 Gmail 附件、Slack 下载等文件
+
+**输出：**
+- 一组结构一致的 `UserFile` 对象（`name`、`url`、`base64`、`type`、`size`）
+- `combinedContent` - 从所有文件中提取的文本内容（适用于文档）
+
+**用法示例：**
+
+```
+// Get all files from the File block
+
+
+// Get the first file
+
+
+// Get combined text content from parsed documents
+
+```
+
+文件区块会自动：
+- 根据 URL 和扩展名检测文件类型
+- 从 PDF、CSV 和文档中提取文本
+- 为二进制文件生成 base64 编码
+- 创建预签名 URL 以实现安全访问
+
+当你需要在将文件传递给 Vision、STT 或邮件集成等其他区块之前，对来自不同来源的文件进行标准化时，请使用文件区块。
+
+## 区块间传递文件
+
+通过标签下拉菜单引用前面区块的文件。在任意文件输入框中点击并输入 `<`，即可查看可用输出。
+
+**常见模式：**
+
+```
+// Single file from a block
+
+
+// Pass the whole file object
+
+
+// Access specific properties
+
+
+```
+
+大多数区块都可以接收完整的文件对象，并自动提取所需内容。大多数情况下，你无需手动提取 `base64` 或 `url`。
+
+## 通过文件触发工作流
+
+通过 API 调用需要文件输入的工作流时，请在请求中包含文件：
+
+
+
+
+ ```bash
+ curl -X POST "https://sim.ai/api/workflows/YOUR_WORKFLOW_ID/execute" \
+ -H "Content-Type: application/json" \
+ -H "x-api-key: YOUR_API_KEY" \
+ -d '{
+ "document": {
+ "name": "report.pdf",
+ "base64": "JVBERi0xLjQK...",
+ "type": "application/pdf"
+ }
+ }'
+ ```
+
+
+
+
+ ```bash
+ curl -X POST "https://sim.ai/api/workflows/YOUR_WORKFLOW_ID/execute" \
+ -H "Content-Type: application/json" \
+ -H "x-api-key: YOUR_API_KEY" \
+ -d '{
+ "document": {
+ "name": "report.pdf",
+ "url": "https://example.com/report.pdf",
+ "type": "application/pdf"
+ }
+ }'
+ ```
+
+
+
+
+工作流的 Start 区块应配置输入字段以接收文件参数。
+
+## 在 API 响应中接收文件
+
+当工作流输出文件时，这些文件会包含在响应中：
+
+```json
+{
+ "success": true,
+ "output": {
+ "generatedFile": {
+ "name": "output.png",
+ "url": "https://...",
+ "base64": "iVBORw0KGgo...",
+ "type": "image/png",
+ "size": 34567
+ }
+ }
+}
+```
+
+使用 `url` 进行直接下载，或使用 `base64` 进行内联处理。
+
+## 支持文件操作的区块
+
+**文件输入：**
+- **File** - 解析文档、图片和文本文件
+- **Vision** - 使用 AI 模型分析图片
+- **Mistral Parser** - 从 PDF 中提取文本
+
+**文件输出：**
+- **Gmail** - 邮件附件
+- **Slack** - 下载的文件
+- **TTS** - 生成的音频文件
+- **Video Generator** - 生成的视频
+- **Image Generator** - 生成的图片
+
+**文件存储：**
+- **Supabase** - 存储上传/下载
+- **S3** - AWS S3 操作
+- **Google Drive** - Drive 文件操作
+- **Dropbox** - Dropbox 文件操作
+
+
+ 文件会自动传递给下游区块。执行引擎会处理所有文件传输和格式转换。
+
+
+## 最佳实践
+
+1. **直接使用文件对象** - 传递完整的文件对象，而不是单独提取属性。区块会自动处理转换。
+
+2. **检查文件类型** - 确保文件类型与接收区块的要求一致。Vision 区块需要图片，File 区块处理文档。
+
+3. **考虑文件大小** — 大文件会增加执行时间。对于非常大的文件，建议使用存储块（如 S3、Supabase）进行中间存储。
diff --git a/apps/docs/content/docs/zh/execution/form.mdx b/apps/docs/content/docs/zh/execution/form.mdx
new file mode 100644
index 000000000..3b5df2846
--- /dev/null
+++ b/apps/docs/content/docs/zh/execution/form.mdx
@@ -0,0 +1,142 @@
+---
+title: 表单部署
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+
+将你的工作流部署为可嵌入的表单，用户可以在你的网站上填写，或通过链接分享。表单提交后会以 `form` 触发类型启动你的工作流。
+
+## 概述
+
+表单部署会将你的工作流输入格式转化为响应式表单，可用于：
+- 通过直接链接分享（如：`https://sim.ai/form/my-survey`）
+- 通过 iframe 嵌入到任意网站
+
+当用户提交表单时，会携带表单数据触发你的工作流。
+
+
+表单字段来源于你工作流的 Start 块输入格式。每个字段都会变成对应类型的表单输入项。
+
+
+## 创建表单
+
+1. 打开你的工作流并点击 **Deploy**
+2. 选择 **Form** 标签页
+3. 配置：
+ - **URL**：唯一标识符（如：`contact-form` → `sim.ai/form/contact-form`）
+ - **Title**：表单标题
+ - **Description**：可选副标题
+ - **Form Fields**：自定义每个字段的标签和描述
+ - **Authentication**：公开、密码保护或邮箱白名单
+ - **Thank You Message**：提交后显示的感谢信息
+4. 点击 **Launch**
+
+## 字段类型映射
+
+| 输入格式类型 | 表单字段 |
+|------------------|------------|
+| `string` | 文本输入 |
+| `number` | 数字输入 |
+| `boolean` | 开关切换 |
+| `object` | JSON 编辑器 |
+| `array` | JSON 数组编辑器 |
+| `files` | 文件上传 |
+
+## 访问控制
+
+| 模式 | 说明 |
+|------|-------------|
+| **Public** | 任何拥有链接的人都可提交 |
+| **Password** | 用户需输入密码 |
+| **Email Whitelist** | 仅指定邮箱/域名可提交 |
+
+对于邮箱白名单：
+- 精确匹配：`user@example.com`
+- 域名匹配：`@example.com`（该域名下所有邮箱）
+
+## 嵌入
+
+### 直接链接
+
+```
+https://sim.ai/form/your-identifier
+```
+
+### Iframe
+
+```html
+
+```
+
+## API 提交
+
+以编程方式提交表单：
+
+
+
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+ -H "Content-Type: application/json" \
+ -d '{
+ "formData": {
+ "name": "John Doe",
+ "email": "john@example.com"
+ }
+ }'
+```
+
+
+
+
+```typescript
+const response = await fetch('https://sim.ai/api/form/your-identifier', {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({
+ formData: {
+ name: 'John Doe',
+ email: 'john@example.com'
+ }
+ })
+});
+
+const result = await response.json();
+// { success: true, data: { executionId: '...' } }
+```
+
+
+
+
+### 受保护的表单
+
+对于密码保护的表单：
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+ -H "Content-Type: application/json" \
+ -d '{ "password": "secret", "formData": { "name": "John" } }'
+```
+
+对于邮箱保护的表单：
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+ -H "Content-Type: application/json" \
+ -d '{ "email": "allowed@example.com", "formData": { "name": "John" } }'
+```
+
+## 故障排查
+
+**“未配置输入字段”** - 请在 Start 块中添加 Input Format 字段。
+
+**表单无法在 iframe 中加载** - 请检查你的网站 CSP 是否允许来自 `sim.ai` 的 iframe。
+
+**提交失败** - 请确认标识符正确且所有必填项已填写。
diff --git a/apps/docs/content/docs/zh/quick-reference/index.mdx b/apps/docs/content/docs/zh/quick-reference/index.mdx
new file mode 100644
index 000000000..b3d12ae90
--- /dev/null
+++ b/apps/docs/content/docs/zh/quick-reference/index.mdx
@@ -0,0 +1,394 @@
+---
+title: 快速参考
+description: 在 Sim 工作流编辑器中导航和使用的基本操作
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { ActionImage, ActionVideo } from '@/components/ui/action-media'
+
+在 Sim 工作流编辑器中，日常操作的快速查找。有关键盘快捷键，请参见 [键盘快捷键](/keyboard-shortcuts)。
+
+
+ **Mod** 指的是在 macOS 上为 `Cmd`，在 Windows/Linux 上为 `Ctrl`。
+
+
+## 工作区
+
+
+
+ 操作 方法 预览
+ 创建工作区
+ 点击工作区下拉菜单 → **新建工作区**
+
+
+ 切换工作区
+ 点击工作区下拉菜单 → 选择工作区
+
+
+ 邀请团队成员
+ 侧边栏 → **邀请**
+
+
+ 重命名工作区
+ 右键点击工作区 → **重命名**
+
+
+ 复制工作区
+ 右键点击工作区 → **复制**
+
+
+ 导出工作区
+ 右键点击工作区 → **导出**
+
+
+ 删除工作区
+ 右键点击工作区 → **删除**
+
+
+
+
+## 工作流
+
+
+
+ 操作 方法 预览
+ 创建工作流
+ 点击侧边栏中的 **+** 按钮
+
+
+ 重新排序 / 移动工作流
+ 拖动工作流上下移动或拖到文件夹中
+
+
+ 导入工作流
+ 点击侧边栏的导入按钮 → 选择文件
+
+
+ 多选工作流
+ 在侧边栏中使用 `Mod+Click` 或 `Shift+Click` 选择多个工作流
+
+
+ 在新标签页中打开
+ 右键点击工作流 → **在新标签页中打开**
+
+
+ 重命名工作流
+ 右键点击工作流 → **重命名**
+
+
+ 分配工作流颜色
+ 右键点击工作流 → **更改颜色**
+
+
+ 复制工作流
+ 右键点击工作流 → **复制**
+
+
+ 导出工作流
+ 右键点击工作流 → **导出**
+
+
+ 删除工作流
+ 右键点击工作流 → **删除**
+
+
+ 重命名文件夹
+ 右键点击文件夹 → **重命名**
+
+
+ 在文件夹中创建工作流
+ 右键点击文件夹 → **创建工作流**
+
+
+ 在文件夹中创建文件夹
+ 右键点击文件夹 → **创建文件夹**
+
+
+ 复制文件夹
+ 右键点击文件夹 → **复制**
+
+
+ 导出文件夹
+ 右键点击文件夹 → **导出**
+
+
+ 删除文件夹
+ 右键点击文件夹 → **删除**
+
+
+
+
+## 区块
+
+
+
+ 操作 方法 预览
+ 添加区块
+ 从 Toolbar 面板拖动，或右键点击画布 → **添加区块**
+
+
+ 多选区块
+ `Mod+Click` 选择其他区块，或按住 shift 拖动绘制选择框
+
+
+ 复制区块
+ `Mod+C` 选中区块后
+
+
+ 粘贴区块
+ `Mod+V` 粘贴已复制的区块
+
+
+ 重复区块
+ 右键点击 → **重复**
+
+
+ 删除区块
+ `Delete` 或 `Backspace` 键，或右键点击 → **删除**
+
+
+ 重命名区块
+ 点击标题中的区块名称，或在 Editor 面板中编辑
+
+
+ 启用/禁用区块
+ 右键点击 → **启用/禁用**
+
+
+ 锁定/解锁区块
+ 鼠标悬停区块 → 点击锁图标（仅限管理员）
+
+
+ 切换手柄方向
+ 右键点击 → **切换手柄**
+
+
+ 配置区块
+ 选择区块 → 使用右侧 Editor 面板
+
+
+
+
+## 连接
+
+
+
+ 操作 方法 预览
+ 创建连接
+ 从输出手柄拖动到输入手柄
+
+
+ 删除连接
+ 点击边缘以选中 → `Delete` 键
+
+
+ 在其他区块中使用输出
+ 将连接标签拖入输入字段
+
+
+
+
+## 面板与视图
+
+
+
+ 操作 方法 预览
+ 搜索工具栏
+ `Mod+F`
+
+
+ 全局搜索
+ `Mod+K`
+
+
+ 切换手动模式
+ 点击切换按钮，在手动与选择器之间切换
+
+
+ 收起/展开侧边栏
+ 点击侧边栏上的收起按钮
+
+
+
+
+## 运行与测试
+
+
+
+ 操作 方法 预览
+ 运行工作流
+ 点击“运行工作流”按钮或 `Mod+Enter`
+
+
+ 停止工作流
+ 运行时点击“停止”按钮或 `Mod+Enter`
+
+
+ 聊天测试
+ 使用右侧的 Chat 面板
+
+
+ 选择输出查看
+ 点击 Chat 面板中的下拉菜单 → 选择区块输出
+
+
+ 清除聊天记录
+ 点击 Chat 面板中的清除按钮
+
+
+ 从区块运行
+ 悬停区块 → 点击播放按钮，或右键 → **从区块运行**
+
+
+ 运行至区块
+ 右键区块 → **运行至区块**
+
+
+ 查看执行日志
+ 打开底部终端面板，或 `Mod+L`
+
+
+ 筛选日志
+ 点击终端中的筛选图标 → 按区块或状态筛选
+
+
+ 搜索日志
+ 在终端中使用搜索框，或右键日志条目 → **搜索**
+
+
+ 复制日志条目
+ 点击剪贴板图标或右键日志条目 → **复制**
+
+
+ 清空终端
+ 点击垃圾桶图标或 `Mod+D`
+
+
+
+
+## 部署
+
+
+
+ 操作 方法 预览
+ 部署工作流
+ 在面板中点击 **Deploy** 按钮
+
+
+ 更新部署
+ 检测到更改时点击 **Update**
+
+
+ 查看部署状态
+ 在 Deploy 标签页查看状态指示器（Live/Update/Deploy）
+
+
+ 回滚部署
+ 在 Deploy 标签页访问历史版本 → **Promote to live**
+
+
+ 添加版本描述
+ Deploy 标签页 → 点击描述图标 → 添加或生成描述
+
+
+ 复制 API endpoint
+ Deploy 标签页 → API → 复制 API cURL
+
+
+
+
+## 变量
+
+
+
+ 操作 方法 预览
+ 添加 / 编辑 / 删除工作流变量
+ 面板 -> 变量 -> **Add Variable**，点击编辑或删除图标
+
+
+ 添加环境变量
+ 设置 → **Environment Variables** → **Add**
+
+
+ 引用工作流变量
+ 在区块输入中使用 `` 语法
+
+
+ 引用环境变量
+ 在区块输入中使用 `{{ENV_VAR}}` 语法
+
+
+
diff --git a/apps/docs/content/docs/zh/self-hosting/index.mdx b/apps/docs/content/docs/zh/self-hosting/index.mdx
index de56839a1..609cd9f25 100644
--- a/apps/docs/content/docs/zh/self-hosting/index.mdx
+++ b/apps/docs/content/docs/zh/self-hosting/index.mdx
@@ -56,3 +56,10 @@ docker compose -f docker-compose.prod.yml up -d
| realtime | 3002 | WebSocket 服务器 |
| db | 5432 | 带有 pgvector 的 PostgreSQL |
| migrations | - | 数据库迁移（运行一次） |
+
+| 组件 | 端口 | 描述 |
+|-----------|------|-------------|
+| simstudio | 3000 | 主应用程序 |
+| realtime | 3002 | WebSocket 服务器 |
+| db | 5432 | PostgreSQL（带 pgvector） |
+| migrations | - | 数据库迁移（仅运行一次） |
diff --git a/apps/docs/content/docs/zh/skills/index.mdx b/apps/docs/content/docs/zh/skills/index.mdx
new file mode 100644
index 000000000..bd9f8bf9f
--- /dev/null
+++ b/apps/docs/content/docs/zh/skills/index.mdx
@@ -0,0 +1,134 @@
+---
+title: Agent Skills
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+
+Agent Skills 是可复用的指令包，为你的 AI agent 提供专门的能力。基于开放的 [Agent Skills](https://agentskills.io) 格式，技能可以帮助你沉淀领域知识、工作流程和最佳实践，agent 可按需加载。
+
+## 技能如何工作
+
+技能采用**渐进式披露**，让 agent 的上下文保持精简：
+
+1. **发现** — 在 agent 的系统提示中只包含技能名称和描述（每项约 50-100 个 token）
+2. **激活** — 当 agent 判断某项技能相关时，会调用 `load_skill` 工具，将完整指令加载到上下文中
+3. **执行** — agent 按照加载的指令完成任务
+
+这意味着你可以为 agent 关联许多技能，而不会让上下文窗口膨胀。agent 只会加载所需内容。
+
+## 创建技能
+
+进入 **设置**，在工具部分选择 **技能**。
+
+
+
+点击 **添加**，创建一个包含三个字段的新技能：
+
+| 字段 | 描述 |
+|-------|-------------|
+| **名称** | 使用 kebab-case 的标识符（如 `sql-expert`、`code-reviewer`）。最多 64 个字符。 |
+| **描述** | 简要说明技能的作用及使用场景。agent 会根据此内容判断是否激活技能。最多 1024 个字符。 |
+| **内容** | 技能的完整 markdown 指令。agent 激活技能时加载。 |
+
+
+ 描述非常关键——这是 agent 在决定是否加载技能前唯一可见的信息。请明确说明技能的使用时机和原因。
+
+
+### 如何编写优质技能内容
+
+技能内容遵循与 [SKILL.md 文件](https://agentskills.io/specification) 相同的规范：
+
+```markdown
+# SQL Expert
+
+## When to use this skill
+Use when the user asks you to write, optimize, or debug SQL queries.
+
+## Instructions
+1. Always ask which database engine (PostgreSQL, MySQL, SQLite)
+2. Use CTEs over subqueries for readability
+3. Add index recommendations when relevant
+4. Explain query plans for optimization requests
+
+## Common Patterns
+...
+```
+
+**推荐结构：**
+- **使用时机** — 具体触发条件和场景
+- **操作指南** — 按步骤编号的详细指导
+- **示例** — 展示预期行为的输入/输出样例
+- **常见模式** — 适用于高频任务的可复用方法
+- **边界情况** — 注意事项和特殊情况
+
+技能应保持专注，且不超过 500 行。如果技能内容过大，请拆分为多个专用技能。
+
+## 向代理添加技能
+
+打开任意 **Agent** 区块，在工具部分下方找到 **Skills** 下拉菜单。选择你希望该代理具备的技能。
+
+
+
+已选技能会以卡片形式显示，你可以点击进行编辑或移除。
+
+### 运行时会发生什么
+
+当工作流运行时：
+
+1. 代理的系统提示中会包含一个 `` 区域，列出每个技能的名称和描述
+2. 一个 `load_skill` 工具会自动添加到代理可用工具中
+3. 当代理判断某个技能与当前任务相关时，会用技能名称调用 `load_skill`
+4. 完整的技能内容会作为工具响应返回，向代理提供详细指令
+
+这适用于所有支持的 LLM 提供商 — `load_skill` 工具采用标准工具调用方式，无需针对不同提供商进行配置。
+
+## 常见用例
+
+当代理需要专业知识或多步骤工作流时，技能最具价值：
+
+**领域专长**
+- `api-integration-expert` — 调用特定 API 的最佳实践（认证、限流、错误处理）
+- `data-transformation` — ETL 模式、数据清洗与校验规则
+- `code-reviewer` — 针对你团队标准的代码评审指南
+
+**工作流模板**
+- `bug-investigation` — 步骤式调试方法（复现 → 定位 → 测试 → 修复）
+- `feature-implementation` — 从需求到部署的开发工作流
+- `document-generator` — 技术文档的模板与格式规范
+
+**公司专属知识**
+- `our-architecture` — 系统架构图、服务依赖和部署流程
+- `style-guide` — 品牌规范、写作风格、UI/UX 模式
+- `customer-onboarding` — 标准操作流程与常见客户问题
+
+**何时使用技能与代理指令：**
+- **技能** 适用于多个工作流通用或经常变动的知识
+- **代理指令** 适用于仅针对单一代理、任务专属的上下文
+
+## 最佳实践
+
+**撰写高效描述**
+- **具体且关键词丰富** — 不要只写“帮助 SQL”，而要写“为 PostgreSQL、MySQL 和 SQLite 编写优化的 SQL 查询，包括索引推荐和查询计划分析”
+- **包含激活触发词** — 明确指出应触发技能的具体词语或短语（如“当用户提到 PDF、表单或文档提取时使用”）
+- **控制在 200 字以内** — 代理会快速浏览描述，每个字都要有价值
+
+**技能范围与组织**
+- **每个领域一个技能** — 聚焦的 `sql-expert` 技能比宽泛的 `database-everything` 技能效果更好
+- **每个代理限 5-10 个技能** — 技能越多，决策负担越大；建议从少量开始，按需增加
+- **拆分大型技能** — 如果技能超过 500 行，建议拆分为更聚焦的子技能
+
+**内容结构**
+- **使用 markdown 格式** — 标题、列表和代码块有助于代理理解和执行指令
+- **提供示例** — 展示输入/输出对，帮助代理理解预期行为
+- **明确边界情况** — 不要假设代理会自行推断特殊处理
+
+**测试与迭代**
+- **测试激活** — 运行你的工作流，确认代理在预期时加载技能
+- **检查误报** — 确保技能不会在不该激活时被激活
+- **优化描述** — 如果技能未能在需要时加载，请在描述中添加更多关键词
+
+## 了解更多
+
+- [Agent Skills 规范](https://agentskills.io) — 便携式代理技能的开放格式
+- [示例技能](https://github.com/anthropics/skills) — 浏览社区技能示例
+- [最佳实践](https://agentskills.io/what-are-skills) — 编写高效技能
diff --git a/apps/docs/content/docs/zh/tools/a2a.mdx b/apps/docs/content/docs/zh/tools/a2a.mdx
new file mode 100644
index 000000000..f7c9b55bc
--- /dev/null
+++ b/apps/docs/content/docs/zh/tools/a2a.mdx
@@ -0,0 +1,207 @@
+---
+title: A2A
+description: 与外部 A2A 兼容代理进行交互
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+