feat(i18n): update translations (#1496)

Author: waleedlatif1

apps/docs/content/docs/de/blocks/agent.mdx

@@ -175,56 +175,30 @@ Verwenden Sie einen `Memory`Block mit einer konsistenten `id` (zum Beispiel `cha
 - Lesen Sie den Gesprächsverlauf für den Kontext
 - Hängen Sie die Antwort des Agenten nach dessen Ausführung an
 
-```yaml
-# 1) Add latest user message
-- Memory (operation: add)
-  id: chat
-  role: user
-  content: {{input}}
-
-# 2) Load conversation history
-- Memory (operation: get)
-  id: chat
-
-# 3) Run the agent with prior messages available
-- Agent
-  System Prompt: ...
-  User Prompt: |
-    Use the conversation so far:
-    {{memory_get.memories}}
-    Current user message: {{input}}
-
-# 4) Store the agent reply
-- Memory (operation: add)
-  id: chat
-  role: assistant
-  content: {{agent.content}}
-```
-
-Siehe die `Memory`Block-Referenz für Details: [/tools/memory](/tools/memory).
+Siehe die [`Memory`](/tools/memory) Blockreferenz für Details.
 
 ## Eingaben und Ausgaben
 
-<Tabs items={['Configuration', 'Variables', 'Results']}>
+<Tabs items={['Konfiguration', 'Variablen', 'Ergebnisse']}>
   <Tab>
     <ul className="list-disc space-y-2 pl-6">
       <li>
-        <strong>System Prompt</strong>: Anweisungen, die das Verhalten und die Rolle des Agenten definieren
+        <strong>System-Prompt</strong>: Anweisungen, die das Verhalten und die Rolle des Agenten definieren
       </li>
       <li>
-        <strong>User Prompt</strong>: Eingabetext oder -daten zur Verarbeitung
+        <strong>Benutzer-Prompt</strong>: Eingabetext oder zu verarbeitende Daten
       </li>
       <li>
-        <strong>Model</strong>: KI-Modellauswahl (OpenAI, Anthropic, Google, etc.)
+        <strong>Modell</strong>: KI-Modellauswahl (OpenAI, Anthropic, Google, usw.)
       </li>
       <li>
-        <strong>Temperature</strong>: Steuerung der Antwort-Zufälligkeit (0-2)
+        <strong>Temperatur</strong>: Steuerung der Zufälligkeit der Antwort (0-2)
       </li>
       <li>
         <strong>Tools</strong>: Array verfügbarer Tools für Funktionsaufrufe
       </li>
       <li>
-        <strong>Response Format</strong>: JSON-Schema für strukturierte Ausgabe
+        <strong>Antwortformat</strong>: JSON-Schema für strukturierte Ausgabe
       </li>
     </ul>
   </Tab>
@@ -261,17 +235,17 @@ Siehe die `Memory`Block-Referenz für Details: [/tools/memory](/tools/memory).
 
 ## Beispielanwendungsfälle
 
-### Automatisierung des Kundendienstes
+### Automatisierung des Kundenservice
 
 <div className="mb-4 rounded-md border p-4">
   <h4 className="font-medium">Szenario: Bearbeitung von Kundenanfragen mit Datenbankzugriff</h4>
   <ol className="list-decimal pl-5 text-sm">
     <li>Benutzer reicht ein Support-Ticket über den API-Block ein</li>
     <li>Agent prüft Bestellungen/Abonnements in Postgres und durchsucht die Wissensdatenbank nach Anleitungen</li>
     <li>Falls eine Eskalation erforderlich ist, erstellt der Agent ein Linear-Ticket mit relevantem Kontext</li>
-    <li>Agent verfasst eine klare E-Mail-Antwort</li>
+    <li>Agent erstellt eine klare E-Mail-Antwort</li>
     <li>Gmail sendet die Antwort an den Kunden</li>
-    <li>Konversation wird im Speicher gesichert, um den Verlauf für zukünftige Nachrichten zu erhalten</li>
+    <li>Konversation wird im Memory gespeichert, um den Verlauf für zukünftige Nachrichten beizubehalten</li>
   </ol>
 </div>
 
@@ -287,20 +261,20 @@ Siehe die `Memory`Block-Referenz für Details: [/tools/memory](/tools/memory).
   </ol>
 </div>
 
-### Werkzeuggestützter Rechercheassistent
+### Werkzeuggestützter Forschungsassistent
 
 <div className="mb-4 rounded-md border p-4">
-  <h4 className="font-medium">Szenario: Rechercheassistent mit Websuche und Dokumentenzugriff</h4>
+  <h4 className="font-medium">Szenario: Forschungsassistent mit Websuche und Dokumentenzugriff</h4>
   <ol className="list-decimal pl-5 text-sm">
     <li>Benutzeranfrage über Eingabe erhalten</li>
-    <li>Agent durchsucht das Web mit dem Google Search-Tool</li>
+    <li>Agent durchsucht das Web mit dem Google-Suchwerkzeug</li>
     <li>Agent greift auf Notion-Datenbank für interne Dokumente zu</li>
-    <li>Agent erstellt umfassenden Recherchebericht</li>
+    <li>Agent erstellt umfassenden Forschungsbericht</li>
   </ol>
 </div>
 
-## Best Practices
+## Bewährte Praktiken
 
-- **Sei spezifisch in System-Prompts**: Definiere die Rolle, den Tonfall und die Einschränkungen des Agenten klar. Je spezifischer deine Anweisungen sind, desto besser kann der Agent seinen vorgesehenen Zweck erfüllen.
+- **Sei spezifisch in System-Prompts**: Definiere die Rolle, den Ton und die Einschränkungen des Agenten klar. Je spezifischer deine Anweisungen sind, desto besser kann der Agent seinen vorgesehenen Zweck erfüllen.
 - **Wähle die richtige Temperatureinstellung**: Verwende niedrigere Temperatureinstellungen (0-0,3), wenn Genauigkeit wichtig ist, oder erhöhe die Temperatur (0,7-2,0) für kreativere oder abwechslungsreichere Antworten
-- **Nutze Tools effektiv**: Integriere Tools, die den Zweck des Agenten ergänzen und seine Fähigkeiten erweitern. Sei selektiv bei der Auswahl der Tools, um den Agenten nicht zu überfordern. Für Aufgaben mit wenig Überschneidung verwende einen anderen Agent-Block für die besten Ergebnisse.
+- **Nutze Werkzeuge effektiv**: Integriere Werkzeuge, die den Zweck des Agenten ergänzen und seine Fähigkeiten verbessern. Sei selektiv bei der Auswahl der Werkzeuge, um den Agenten nicht zu überfordern. Für Aufgaben mit wenig Überschneidung verwende einen anderen Agent-Block für die besten Ergebnisse.

apps/docs/content/docs/de/triggers/api.mdx

@@ -24,15 +24,7 @@ Der API-Trigger stellt Ihren Workflow als sicheren HTTP-Endpunkt bereit. Senden
 
 Fügen Sie für jeden Parameter ein Feld **Eingabeformat** hinzu. Die Ausgabeschlüssel zur Laufzeit spiegeln das Schema wider und sind auch unter `<api.input>` verfügbar.
 
-```yaml
-- type: string
-  name: userId
-  value: demo-user # optional manual test value
-- type: number
-  name: maxTokens
-```
-
-Manuelle Ausführungen im Editor verwenden die Spalte `value`, damit Sie testen können, ohne eine Anfrage zu senden. Während der Ausführung füllt der Resolver sowohl `<api.userId>` als auch `<api.input.userId>`.
+Manuelle Ausführungen im Editor verwenden die Spalte `value`, damit Sie testen können, ohne eine Anfrage zu senden. Während der Ausführung füllt der Resolver sowohl `<api.userId>` als auch `<api.input.userId>` aus.
 
 ## Anfrage-Beispiel
 
@@ -56,5 +48,5 @@ Erfolgreiche Antworten geben das serialisierte Ausführungsergebnis vom Executor
 Wenn kein Eingabeformat definiert ist, stellt der Executor das rohe JSON nur unter `<api.input>` bereit.
 
 <Callout type="warning">
-Ein Workflow kann nur einen API-Trigger enthalten. Veröffentlichen Sie eine neue Bereitstellung nach Änderungen, damit der Endpunkt aktuell bleibt.
+Ein Workflow kann nur einen API-Trigger enthalten. Veröffentlichen Sie nach Änderungen eine neue Bereitstellung, damit der Endpunkt aktuell bleibt.
 </Callout>

apps/docs/content/docs/de/yaml/blocks/loop.mdx

@@ -10,7 +10,6 @@ type: object
 required:
   - type
   - name
-  - inputs
   - connections
 properties:
   type:
@@ -22,21 +21,23 @@ properties:
     description: Display name for this loop block
   inputs:
     type: object
-    required:
-      - loopType
+    description: Optional. If omitted, defaults will be applied.
     properties:
       loopType:
         type: string
         enum: [for, forEach]
         description: Type of loop to execute
+        default: for
       iterations:
         type: number
         description: Number of iterations (for 'for' loops)
+        default: 5
         minimum: 1
         maximum: 1000
       collection:
         type: string
         description: Collection to iterate over (for 'forEach' loops)
+        default: ""
       maxConcurrency:
         type: number
         description: Maximum concurrent executions
@@ -45,40 +46,48 @@ properties:
         maximum: 10
   connections:
     type: object
-    required:
-      - loop
     properties:
+      # Nested format (recommended)
       loop:
         type: object
-        required:
-          - start
         properties:
           start:
             type: string
             description: Target block ID to execute inside the loop
           end:
             type: string
             description: Target block ID for loop completion (optional)
+      # Direct handle format (alternative)
+      loop-start-source:
+        type: string | string[]
+        description: Target block ID to execute inside the loop (direct format)
+      loop-end-source:
+        type: string | string[]
+        description: Target block ID for loop completion (direct format, optional)
       error:
         type: string
         description: Target block ID for error handling
+    note: Use either the nested 'loop' format OR the direct 'loop-start-source' format, not both
 ```
 
 ## Verbindungskonfiguration
 
-Loop-Blöcke verwenden ein spezielles Verbindungsformat mit einem `loop`Abschnitt:
+Loop-Blöcke unterstützen zwei Verbindungsformate:
+
+### Direktes Handle-Format (Alternative)
 
 ```yaml
 connections:
-  loop:
-    start: <string>                     # Target block ID to execute inside the loop
-    end: <string>                       # Target block ID after loop completion (optional)
+  loop-start-source: <string>           # Target block ID to execute inside the loop
+  loop-end-source: <string>             # Target block ID after loop completion (optional)
   error: <string>                       # Target block ID for error handling (optional)
 ```
 
+Beide Formate funktionieren identisch. Verwenden Sie das Format, das Ihnen besser gefällt.
+
 ## Konfiguration von untergeordneten Blöcken
 
-Blöcke innerhalb einer Schleife müssen ihre `parentId` auf die Loop-Block-ID setzen:
+Blöcke innerhalb einer Schleife müssen ihre `parentId` auf die Loop-Block-ID gesetzt haben. Die Eigenschaft `extent` wird automatisch auf `'parent'` gesetzt und muss nicht angegeben werden:
 
 ```yaml
 loop-1:
@@ -106,7 +115,7 @@ process-item:
 
 ## Beispiele
 
-### For-Schleife (feste Iterationen)
+### For-Schleife (feste Anzahl von Iterationen)
 
 ```yaml
 countdown-loop:
@@ -227,7 +236,7 @@ store-analysis:
       };
 ```
 
-### Schleife mit paralleler Verarbeitung
+### Schleife für parallele Verarbeitung
 
 ```yaml
 parallel-processing-loop:
@@ -261,9 +270,62 @@ process-task:
     success: task-completed
 ```
 
+### Beispiel für direktes Handle-Format
+
+Dieselbe Schleife kann mit dem direkten Handle-Format geschrieben werden:
+
+```yaml
+my-loop:
+  type: loop
+  name: "Process Items"
+  inputs:
+    loopType: forEach
+    collection: <start.items>
+  connections:
+    loop-start-source: process-item      # Direct handle format
+    loop-end-source: final-results       # Direct handle format
+    error: handle-error
+
+process-item:
+  type: agent
+  name: "Process Item"
+  parentId: my-loop
+  inputs:
+    systemPrompt: "Process this item"
+    userPrompt: <loop.currentItem>
+    model: gpt-4o
+    apiKey: '{{OPENAI_API_KEY}}'
+```
+
+### Minimales Schleifenbeispiel (mit Standardwerten)
+
+Sie können den Abschnitt `inputs` vollständig weglassen, dann werden Standardwerte angewendet:
+
+```yaml
+simple-loop:
+  type: loop
+  name: "Simple Loop"
+  # No inputs section - defaults to loopType: 'for', iterations: 5
+  connections:
+    loop-start-source: process-step
+    loop-end-source: complete
+
+process-step:
+  type: agent
+  name: "Process Step"
+  parentId: simple-loop
+  inputs:
+    systemPrompt: "Execute step"
+    userPrompt: "Step <loop.index>"
+    model: gpt-4o
+    apiKey: '{{OPENAI_API_KEY}}'
+```
+
+Diese Schleife führt standardmäßig 5 Iterationen aus.
+
 ## Schleifenvariablen
 
-Innerhalb von untergeordneten Schleifenblöcken sind diese speziellen Variablen verfügbar:
+Innerhalb von Schleifenunterblöcken sind diese speziellen Variablen verfügbar:
 
 ```yaml
 # Available in all child blocks of the loop
@@ -290,6 +352,6 @@ final-processor:
 - Verwenden Sie forEach für die Verarbeitung von Sammlungen, for-Schleifen für feste Iterationen
 - Erwägen Sie die Verwendung von maxConcurrency für I/O-gebundene Operationen
 - Integrieren Sie Fehlerbehandlung für eine robuste Schleifenausführung
-- Verwenden Sie aussagekräftige Namen für Schleifen-Unterblöcke
+- Verwenden Sie aussagekräftige Namen für Schleifenunterblöcke
 - Testen Sie zuerst mit kleinen Sammlungen
-- Überwachen Sie die Ausführungszeit bei großen Sammlungen
+- Überwachen Sie die Ausführungszeit für große Sammlungen