feat(i18n): change lockfile (#3216)

* fix: update i18n.lock * feat(docs): enhance documentation with new sections on file handling, form deployment, quick reference, agent skills, and A2A integration
2026-04-06 03:00:16 -04:00 · 2026-02-16 08:41:56 +01:00
parent 92b4f77228
commit d1d43b27bd
732 changed files with 52591 additions and 8180 deletions
--- a/apps/docs/content/docs/de/execution/costs.mdx
+++ b/apps/docs/content/docs/de/execution/costs.mdx
@@ -241,4 +241,45 @@ Dies verteilt große Mehrverbrauchsgebühren über den Monat, anstatt einer gro
 - Überprüfen Sie Ihre aktuelle Nutzung unter [Einstellungen → Abonnement](https://sim.ai/settings/subscription)
 - Erfahren Sie mehr über [Protokollierung](/execution/logging), um Ausführungsdetails zu verfolgen
 - Entdecken Sie die [externe API](/execution/api) für programmatische Kostenüberwachung
- Sehen Sie sich [Workflow-Optimierungstechniken](/blocks) an, um Kosten zu reduzieren
+- Sehen Sie sich [Workflow-Optimierungstechniken](/blocks) an, um Kosten zu reduzieren
+
+**Pro-Tarif (20 $/Monat):**
+- Monatliches Abonnement beinhaltet 20 $ Nutzung
+- Nutzung unter 20 $ → Keine zusätzlichen Gebühren
+- Nutzung über 20 $ → Mehrverbrauch wird am Monatsende abgerechnet
+- Beispiel: 35 $ Nutzung = 20 $ (Abonnement) + 15 $ (Mehrverbrauch)
+
+**Team-Tarif (40 $/Platz/Monat):**
+- Gemeinsame Nutzung über alle Teammitglieder hinweg
+- Mehrverbrauch wird aus der gesamten Teamnutzung berechnet
+- Der Organisationsinhaber erhält eine Rechnung
+
+**Enterprise-Tarife:**
+- Fester Monatspreis, keine Mehrverbräuche
+- Individuelle Nutzungslimits gemäß Vereinbarung
+
+### Schwellenwertabrechnung
+
+Wenn der nicht abgerechnete Mehrverbrauch 50 $ erreicht, rechnet Sim automatisch den gesamten nicht abgerechneten Betrag ab.
+
+**Beispiel:**
+- Tag 10: 70 $ Mehrverbrauch → 70 $ sofort abrechnen
+- Tag 15: Weitere 35 $ Nutzung (105 $ gesamt) → Bereits abgerechnet, keine Aktion
+- Tag 20: Weitere 50 $ Nutzung (155 $ gesamt, 85 $ nicht abgerechnet) → 85 $ sofort abrechnen
+
+Dies verteilt hohe Mehrverbrauchsgebühren über den Monat hinweg, anstatt einer großen Rechnung am Periodenende.
+
+## Best Practices für das Kostenmanagement
+
+1. **Regelmäßig überwachen**: Überprüfen Sie Ihr Nutzungs-Dashboard häufig, um Überraschungen zu vermeiden
+2. **Budgets festlegen**: Nutzen Sie Tariflimits als Leitplanken für Ihre Ausgaben
+3. **Workflows optimieren**: Überprüfen Sie kostenintensive Ausführungen und optimieren Sie Prompts oder Modellauswahl
+4. **Passende Modelle verwenden**: Stimmen Sie die Modellkomplexität auf die Aufgabenanforderungen ab
+5. **Ähnliche Aufgaben bündeln**: Kombinieren Sie mehrere Anfragen, wenn möglich, um den Overhead zu reduzieren
+
+## Nächste Schritte
+
+- Überprüfen Sie Ihre aktuelle Nutzung unter [Einstellungen → Abonnement](https://sim.ai/settings/subscription)
+- Erfahren Sie mehr über [Protokollierung](/execution/logging), um Ausführungsdetails zu verfolgen
+- Erkunden Sie die [externe API](/execution/api) für programmatische Kostenüberwachung
+- Informieren Sie sich über [Workflow-Optimierungstechniken](/blocks), um Kosten zu reduzieren
--- a/apps/docs/content/docs/de/execution/files.mdx
+++ b/apps/docs/content/docs/de/execution/files.mdx
@@ -0,0 +1,172 @@
+---
+title: Dateien übergeben
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+
+Sim macht es einfach, mit Dateien in Ihren Workflows zu arbeiten. Blöcke können Dateien empfangen, verarbeiten und nahtlos an andere Blöcke weitergeben.
+
+## Dateiobjekte
+
+Wenn Blöcke Dateien ausgeben (wie Gmail-Anhänge, generierte Bilder oder geparste Dokumente), geben sie ein standardisiertes Dateiobjekt zurück:
+
+```json
+{
+  "name": "report.pdf",
+  "url": "https://...",
+  "base64": "JVBERi0xLjQK...",
+  "type": "application/pdf",
+  "size": 245678
+}
+```
+
+Sie können auf alle diese Eigenschaften zugreifen, wenn Sie auf Dateien aus vorherigen Blöcken verweisen.
+
+## Der Datei-Block
+
+Der **Datei-Block** ist der universelle Einstiegspunkt für Dateien in Ihren Workflows. Er akzeptiert Dateien aus jeder Quelle und gibt standardisierte Dateiobjekte aus, die mit allen Integrationen funktionieren.
+
+**Eingaben:**
+- **Hochgeladene Dateien** - Dateien direkt per Drag & Drop oder Auswahl hinzufügen
+- **Externe URLs** - Jede öffentlich zugängliche Datei-URL
+- **Dateien von anderen Blöcken** - Dateien von Gmail-Anhängen, Slack-Downloads usw. übergeben
+
+**Ausgaben:**
+- Eine Liste von `UserFile`-Objekten mit konsistenter Struktur (`name`, `url`, `base64`, `type`, `size`)
+- `combinedContent` - Extrahierter Textinhalt aus allen Dateien (für Dokumente)
+
+**Beispielverwendung:**
+
+```
+// Get all files from the File block
+<file.files>
+
+// Get the first file
+<file.files[0]>
+
+// Get combined text content from parsed documents
+<file.combinedContent>
+```
+
+Der Datei-Block führt automatisch folgende Aktionen aus:
+- Erkennt Dateitypen aus URLs und Erweiterungen
+- Extrahiert Text aus PDFs, CSVs und Dokumenten
+- Generiert Base64-Kodierung für Binärdateien
+- Erstellt vorsignierte URLs für sicheren Zugriff
+
+Verwenden Sie den Datei-Block, wenn Sie Dateien aus verschiedenen Quellen normalisieren müssen, bevor Sie sie an andere Blöcke wie Vision, STT oder E-Mail-Integrationen übergeben.
+
+## Dateien zwischen Blöcken übergeben
+
+Verweisen Sie auf Dateien aus vorherigen Blöcken über das Tag-Dropdown. Klicken Sie in ein beliebiges Dateieingabefeld und geben Sie `<` ein, um verfügbare Ausgaben anzuzeigen.
+
+**Häufige Muster:**
+
+```
+// Single file from a block
+<gmail.attachments[0]>
+
+// Pass the whole file object
+<file_parser.files[0]>
+
+// Access specific properties
+<gmail.attachments[0].name>
+<gmail.attachments[0].base64>
+```
+
+Die meisten Blöcke akzeptieren das vollständige Dateiobjekt und extrahieren automatisch, was sie benötigen. Sie müssen `base64` oder `url` in den meisten Fällen nicht manuell extrahieren.
+
+## Workflows mit Dateien auslösen
+
+Wenn Sie einen Workflow über die API aufrufen, der Dateieingaben erwartet, fügen Sie Dateien in Ihre Anfrage ein:
+
+<Tabs items={['Base64', 'URL']}>
+  <Tab value="Base64">
+
+    ```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"
+        }
+      }'
+    ```
+
+  </Tab>
+  <Tab value="URL">
+
+    ```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"
+        }
+      }'
+    ```
+
+  </Tab>
+</Tabs>
+
+Der Start-Block des Workflows sollte ein Eingabefeld haben, das für den Empfang des Dateiparameters konfiguriert ist.
+
+## Dateien in API-Antworten empfangen
+
+Wenn ein Workflow Dateien ausgibt, sind diese in der Antwort enthalten:
+
+```json
+{
+  "success": true,
+  "output": {
+    "generatedFile": {
+      "name": "output.png",
+      "url": "https://...",
+      "base64": "iVBORw0KGgo...",
+      "type": "image/png",
+      "size": 34567
+    }
+  }
+}
+```
+
+Verwenden Sie `url` für direkte Downloads oder `base64` für Inline-Verarbeitung.
+
+## Blöcke, die mit Dateien arbeiten
+
+**Dateieingaben:**
+- **File** - Dokumente, Bilder und Textdateien parsen
+- **Vision** - Bilder mit KI-Modellen analysieren
+- **Mistral Parser** - Text aus PDFs extrahieren
+
+**Dateiausgaben:**
+- **Gmail** - E-Mail-Anhänge
+- **Slack** - Heruntergeladene Dateien
+- **TTS** - Generierte Audiodateien
+- **Video Generator** - Generierte Videos
+- **Image Generator** - Generierte Bilder
+
+**Dateispeicherung:**
+- **Supabase** - Upload/Download aus dem Speicher
+- **S3** - AWS S3-Operationen
+- **Google Drive** - Drive-Dateioperationen
+- **Dropbox** - Dropbox-Dateioperationen
+
+<Callout type="info">
+  Dateien sind automatisch für nachgelagerte Blöcke verfügbar. Die Ausführungs-Engine übernimmt die gesamte Dateiübertragung und Formatkonvertierung.
+</Callout>
+
+## Best Practices
+
+1. **Dateiobjekte direkt verwenden** - Übergeben Sie das vollständige Dateiobjekt, anstatt einzelne Eigenschaften zu extrahieren. Blöcke übernehmen die Konvertierung automatisch.
+
+2. **Dateitypen prüfen** - Stellen Sie sicher, dass der Dateityp mit dem übereinstimmt, was der empfangende Block erwartet. Der Vision-Block benötigt Bilder, der File-Block verarbeitet Dokumente.
+
+3. **Dateigröße beachten** – Große Dateien erhöhen die Ausführungszeit. Bei sehr großen Dateien sollten Sie Storage-Blöcke (S3, Supabase) für die Zwischenspeicherung verwenden.
--- a/apps/docs/content/docs/de/execution/form.mdx
+++ b/apps/docs/content/docs/de/execution/form.mdx
@@ -0,0 +1,142 @@
+---
+title: Formular-Bereitstellung
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+
+Stellen Sie Ihren Workflow als einbettbares Formular bereit, das Benutzer auf Ihrer Website ausfüllen oder per Link teilen können. Formularübermittlungen lösen Ihren Workflow mit dem `form` Trigger-Typ aus.
+
+## Übersicht
+
+Die Formular-Bereitstellung verwandelt das Eingabeformat Ihres Workflows in ein responsives Formular, das:
+- Per Direktlink geteilt werden kann (z. B. `https://sim.ai/form/my-survey`)
+- Mit einem iframe in jede Website eingebettet werden kann
+
+Wenn ein Benutzer das Formular absendet, wird Ihr Workflow mit den Formulardaten ausgelöst.
+
+<Callout type="info">
+Formulare leiten ihre Felder vom Eingabeformat des Start-Blocks Ihres Workflows ab. Jedes Feld wird zu einer Formulareingabe mit dem entsprechenden Typ.
+</Callout>
+
+## Erstellen eines Formulars
+
+1. Öffnen Sie Ihren Workflow und klicken Sie auf **Bereitstellen**
+2. Wählen Sie den Tab **Formular**
+3. Konfigurieren Sie:
+   - **URL**: Eindeutige Kennung (z. B. `contact-form` → `sim.ai/form/contact-form`)
+   - **Titel**: Formularüberschrift
+   - **Beschreibung**: Optionaler Untertitel
+   - **Formularfelder**: Passen Sie Beschriftungen und Beschreibungen für jedes Feld an
+   - **Authentifizierung**: Öffentlich, passwortgeschützt oder E-Mail-Whitelist
+   - **Dankesnachricht**: Wird nach der Übermittlung angezeigt
+4. Klicken Sie auf **Starten**
+
+## Feldzuordnung
+
+| Eingabeformat-Typ | Formularfeld |
+|------------------|------------|
+| `string` | Texteingabe |
+| `number` | Zahleneingabe |
+| `boolean` | Umschalter |
+| `object` | JSON-Editor |
+| `array` | JSON-Array-Editor |
+| `files` | Datei-Upload |
+
+## Zugriffskontrolle
+
+| Modus | Beschreibung |
+|------|-------------|
+| **Öffentlich** | Jeder mit dem Link kann absenden |
+| **Passwort** | Benutzer müssen ein Passwort eingeben |
+| **E-Mail-Whitelist** | Nur angegebene E-Mails/Domains können absenden |
+
+Für E-Mail-Whitelist:
+- Exakt: `user@example.com`
+- Domain: `@example.com` (alle E-Mails von der Domain)
+
+## Einbettung
+
+### Direkter Link
+
+```
+https://sim.ai/form/your-identifier
+```
+
+### Iframe
+
+```html
+<iframe
+  src="https://sim.ai/form/your-identifier"
+  width="100%"
+  height="600"
+  frameborder="0"
+  title="Form"
+></iframe>
+```
+
+## API-Übermittlung
+
+Formulare programmatisch übermitteln:
+
+<Tabs items={['cURL', 'TypeScript']}>
+  <Tab value="cURL">
+
+```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"
+    }
+  }'
+```
+
+  </Tab>
+  <Tab value="TypeScript">
+
+```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: '...' } }
+```
+
+  </Tab>
+</Tabs>
+
+### Geschützte Formulare
+
+Für passwortgeschützte Formulare:
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+  -H "Content-Type: application/json" \
+  -d '{ "password": "secret", "formData": { "name": "John" } }'
+```
+
+Für E-Mail-geschützte Formulare:
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+  -H "Content-Type: application/json" \
+  -d '{ "email": "allowed@example.com", "formData": { "name": "John" } }'
+```
+
+## Fehlerbehebung
+
+**"Keine Eingabefelder konfiguriert"** - Fügen Sie Eingabeformat-Felder zu Ihrem Start-Block hinzu.
+
+**Formular lädt nicht im Iframe** - Überprüfen Sie, ob die CSP Ihrer Website Iframes von `sim.ai` erlaubt.
+
+**Übermittlungen schlagen fehl** - Überprüfen Sie, ob die Kennung korrekt ist und erforderliche Felder ausgefüllt sind.