Skip to content

Commit 3ff6509

Browse files
waleedlatif1waleedlatif1
authored
feat(i18n): update translations (#1465)
* feat(i18n): update translations * fixed french i18n error ---------
1 parent 2ae30f1 commit 3ff6509

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

41 files changed

+1631
-864
lines changed

‎apps/docs/content/docs/de/blocks/workflow.mdx‎

Lines changed: 21 additions & 149 deletions
Original file line numberDiff line numberDiff line change
@@ -1,168 +1,40 @@
11
---
2-
title: Workflow
2+
title: Workflow-Block
3+
description: Führe einen anderen Workflow innerhalb des aktuellen Ablaufs aus
34
---
45

56
import { Callout } from 'fumadocs-ui/components/callout'
6-
import { Step, Steps } from 'fumadocs-ui/components/steps'
7-
import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
87
import { Image } from '@/components/ui/image'
98

10-
Der Workflow-Block ermöglicht es, andere Workflows als wiederverwendbare Komponenten innerhalb deines aktuellen Workflows auszuführen. Dies ermöglicht modulares Design, Codewiederverwendung und die Erstellung komplexer verschachtelter Workflows, die aus kleineren, fokussierten Workflows zusammengesetzt werden können.
9+
## Was er macht
1110

12-
<div className="flex justify-center my-6">
11+
<div className='flex justify-center my-6'>
1312
<Image
14-
src="/static/blocks/workflow.png"
15-
alt="Workflow-Block"
13+
src='/static/blocks/workflow.png'
14+
alt='Workflow-Block-Konfiguration'
1615
width={400}
1716
height={280}
18-
className="rounded-xl border border-border shadow-sm"
17+
className='rounded-xl border border-border shadow-sm'
1918
/>
2019
</div>
2120

22-
<Callout type="info">
23-
Workflow-Blöcke ermöglichen modulares Design, indem sie es erlauben, komplexe Workflows aus kleineren, wiederverwendbaren Komponenten zusammenzusetzen.
24-
</Callout>
25-
26-
## Überblick
27-
28-
Der Workflow-Block dient als Brücke zwischen Workflows und ermöglicht es dir:
29-
30-
<Steps>
31-
<Step>
32-
<strong>Bestehende Workflows wiederzuverwenden</strong>: Führe zuvor erstellte Workflows als Komponenten innerhalb neuer Workflows aus
33-
</Step>
34-
<Step>
35-
<strong>Modulare Designs zu erstellen</strong>: Zerlege komplexe Prozesse in kleinere, überschaubare Workflows
36-
</Step>
37-
<Step>
38-
<strong>Trennung der Zuständigkeiten beizubehalten</strong>: Halte verschiedene Geschäftslogik in separaten Workflows isoliert
39-
</Step>
40-
<Step>
41-
<strong>Teamzusammenarbeit zu ermöglichen</strong>: Teile und verwende Workflows über verschiedene Projekte und Teammitglieder hinweg wieder
42-
</Step>
43-
</Steps>
44-
45-
## Funktionsweise
46-
47-
Der Workflow-Block:
21+
Füge einen Workflow-Block hinzu, wenn du einen untergeordneten Workflow als Teil eines größeren Ablaufs aufrufen möchtest. Der Block führt die neueste bereitgestellte Version dieses Workflows aus, wartet auf dessen Abschluss und setzt dann mit dem übergeordneten Workflow fort.
4822

49-
1. Nimmt eine Referenz zu einem anderen Workflow in deinem Workspace
50-
2. Übergibt Eingabedaten vom aktuellen Workflow an den untergeordneten Workflow (verfügbar über start.input)
51-
3. Führt den untergeordneten Workflow in einem isolierten Kontext aus
52-
4. Gibt das Ergebnis zur weiteren Verarbeitung an den übergeordneten Workflow zurück
23+
## Konfiguration
5324

54-
## Konfigurationsoptionen
25+
1. **Wähle einen Workflow** aus dem Dropdown-Menü (Selbstreferenzen sind blockiert, um Schleifen zu verhindern).
26+
2. **Eingaben zuordnen**: Wenn der untergeordnete Workflow einen Eingabeformular-Trigger hat, siehst du jedes Feld und kannst übergeordnete Variablen verbinden. Die zugeordneten Werte sind das, was der untergeordnete Workflow erhält.
27+
3. **Ausgaben**: Nach Abschluss des untergeordneten Workflows stellt der Block folgendes bereit:
28+
- `result` – die endgültige Antwort des untergeordneten Workflows
29+
- `success` – ob er ohne Fehler ausgeführt wurde
30+
- `error` – Nachricht, wenn die Ausführung fehlschlägt
5531

56-
### Workflow-Auswahl
32+
## Ausführungshinweise
5733

58-
Wähle aus einer Dropdown-Liste der verfügbaren Workflows in deinem Workspace aus, welcher Workflow ausgeführt werden soll. Die Liste umfasst:
34+
- Untergeordnete Workflows laufen im gleichen Workspace-Kontext, sodass Umgebungsvariablen und Tools übernommen werden.
35+
- Der Block verwendet Deployment-Versionierung: Jede API-, Zeitplan-, Webhook-, manuelle oder Chat-Ausführung ruft den bereitgestellten Snapshot auf. Stelle den untergeordneten Workflow neu bereit, wenn du ihn änderst.
36+
- Wenn der untergeordnete Workflow fehlschlägt, löst der Block einen Fehler aus, es sei denn, du behandelst ihn nachgelagert.
5937

60-
- Alle Workflows, auf die du im aktuellen Workspace Zugriff hast
61-
- Workflows, die von anderen Teammitgliedern mit dir geteilt wurden
62-
- Sowohl aktivierte als auch deaktivierte Workflows (obwohl nur aktivierte Workflows ausgeführt werden können)
63-
64-
### Ausführungskontext
65-
66-
Der untergeordnete Workflow wird ausgeführt mit:
67-
68-
- Seinem eigenen isolierten Ausführungskontext
69-
- Zugriff auf dieselben Workspace-Ressourcen (API-Schlüssel, Umgebungsvariablen)
70-
- Korrekten Workspace-Mitgliedschafts- und Berechtigungsprüfungen
71-
- Verschachteltem Tracespan im Ausführungsprotokoll
72-
73-
<Callout type="warning">
74-
**Zykluserkennung**: Das System erkennt und verhindert automatisch zirkuläre Abhängigkeiten zwischen Workflows, um Endlosschleifen zu vermeiden.
38+
<Callout>
39+
Halte untergeordnete Workflows fokussiert. Kleine, wiederverwendbare Abläufe machen es einfacher, sie zu kombinieren, ohne tiefe Verschachtelungen zu erzeugen.
7540
</Callout>
76-
77-
## Eingaben und Ausgaben
78-
79-
<Tabs items={['Configuration', 'Variables', 'Results']}>
80-
<Tab>
81-
<ul className="list-disc space-y-2 pl-6">
82-
<li>
83-
<strong>Workflow-Auswahl</strong>: Wählen Sie aus, welcher Workflow ausgeführt werden soll
84-
</li>
85-
<li>
86-
<strong>Eingabedaten</strong>: Variable oder Blockreferenz, die an den untergeordneten Workflow übergeben wird
87-
</li>
88-
<li>
89-
<strong>Ausführungskontext</strong>: Isolierte Umgebung mit Workspace-Ressourcen
90-
</li>
91-
</ul>
92-
</Tab>
93-
<Tab>
94-
<ul className="list-disc space-y-2 pl-6">
95-
<li>
96-
<strong>workflow.success</strong>: Boolescher Wert, der den Abschlussstatus angibt
97-
</li>
98-
<li>
99-
<strong>workflow.childWorkflowName</strong>: Name des ausgeführten untergeordneten Workflows
100-
</li>
101-
<li>
102-
<strong>workflow.result</strong>: Vom untergeordneten Workflow zurückgegebenes Ergebnis
103-
</li>
104-
<li>
105-
<strong>workflow.error</strong>: Fehlerdetails, falls der Workflow fehlgeschlagen ist
106-
</li>
107-
</ul>
108-
</Tab>
109-
<Tab>
110-
<ul className="list-disc space-y-2 pl-6">
111-
<li>
112-
<strong>Workflow-Antwort</strong>: Primäre Ausgabe des untergeordneten Workflows
113-
</li>
114-
<li>
115-
<strong>Ausführungsstatus</strong>: Erfolgsstatus und Fehlerinformationen
116-
</li>
117-
<li>
118-
<strong>Zugriff</strong>: Verfügbar in Blöcken nach dem Workflow
119-
</li>
120-
</ul>
121-
</Tab>
122-
</Tabs>
123-
124-
## Beispielanwendungsfälle
125-
126-
### Modulares Kunden-Onboarding
127-
128-
<div className="mb-4 rounded-md border p-4">
129-
<h4 className="font-medium">Szenario: Komplexes Onboarding in wiederverwendbare Komponenten aufteilen</h4>
130-
<ol className="list-decimal pl-5 text-sm">
131-
<li>Hauptworkflow empfängt Kundendaten</li>
132-
<li>Workflow-Block führt Validierungs-Workflow aus</li>
133-
<li>Workflow-Block führt Kontoeinrichtungs-Workflow aus</li>
134-
<li>Workflow-Block führt Willkommens-E-Mail-Workflow aus</li>
135-
</ol>
136-
</div>
137-
138-
### Microservice-Architektur
139-
140-
<div className="mb-4 rounded-md border p-4">
141-
<h4 className="font-medium">Szenario: Unabhängige Service-Workflows erstellen</h4>
142-
<ol className="list-decimal pl-5 text-sm">
143-
<li>Zahlungsabwicklungs-Workflow verarbeitet Transaktionen</li>
144-
<li>Bestandsverwaltungs-Workflow aktualisiert den Lagerbestand</li>
145-
<li>Benachrichtigungs-Workflow sendet Bestätigungen</li>
146-
<li>Hauptworkflow orchestriert alle Dienste</li>
147-
</ol>
148-
</div>
149-
150-
### Bedingte Verarbeitung
151-
152-
<div className="mb-4 rounded-md border p-4">
153-
<h4 className="font-medium">Szenario: Führe verschiedene Workflows basierend auf Bedingungen aus</h4>
154-
<ol className="list-decimal pl-5 text-sm">
155-
<li>Bedingungsblock bewertet den Benutzertyp</li>
156-
<li>Enterprise-Benutzer → Komplexer Genehmigungsworkflow</li>
157-
<li>Standard-Benutzer → Einfacher Genehmigungsworkflow</li>
158-
<li>Kostenlose Benutzer → Grundlegender Verarbeitungsworkflow</li>
159-
</ol>
160-
</div>
161-
162-
## Bewährte Praktiken
163-
164-
- **Workflows fokussiert halten**: Gestalte untergeordnete Workflows für spezifische, klar definierte Aufgaben mit eindeutigen Ein- und Ausgaben
165-
- **Verschachtelungstiefe minimieren**: Vermeide tief verschachtelte Workflow-Hierarchien für bessere Wartbarkeit und Leistung
166-
- **Fehler elegant behandeln**: Implementiere eine ordnungsgemäße Fehlerbehandlung für Fehler in untergeordneten Workflows und stelle Fallback-Mechanismen bereit
167-
- **Unabhängig testen**: Stelle sicher, dass untergeordnete Workflows unabhängig von übergeordneten Workflows getestet und validiert werden können
168-
- **Semantische Benennung verwenden**: Gib Workflows beschreibende Namen, die ihren Zweck und ihre Funktionalität klar angeben

‎apps/docs/content/docs/de/execution/index.mdx‎

Lines changed: 29 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ title: Ausführung
44

55
import { Callout } from 'fumadocs-ui/components/callout'
66
import { Card, Cards } from 'fumadocs-ui/components/card'
7+
import { Image } from '@/components/ui/image'
78

89
Die Ausführungs-Engine von Sim bringt Ihre Workflows zum Leben, indem sie Blöcke in der richtigen Reihenfolge verarbeitet, den Datenfluss verwaltet und Fehler elegant behandelt, sodass Sie genau verstehen können, wie Workflows in Sim ausgeführt werden.
910

@@ -89,9 +90,25 @@ Die Chat-Bereitstellung erstellt eine Konversationsschnittstelle für Ihren Work
8990

9091
Jede Bereitstellungsmethode übergibt Daten an den Starter-Block Ihres Workflows und beginnt so den Ausführungsfluss.
9192

93+
## Deployment-Snapshots
94+
95+
Alle öffentlichen Einstiegspunkte—API, Chat, Zeitplan, Webhook und manuelle Ausführungen—führen den aktiven Deployment-Snapshot des Workflows aus. Veröffentliche ein neues Deployment, wann immer du die Arbeitsfläche änderst, damit jeder Trigger die aktualisierte Version verwendet.
96+
97+
<div className='flex justify-center my-6'>
98+
<Image
99+
src='/static/execution/deployment-versions-light.png'
100+
alt='Tabelle mit Deployment-Versionen'
101+
width={500}
102+
height={280}
103+
className='rounded-xl border border-border shadow-sm'
104+
/>
105+
</div>
106+
107+
Das Deploy-Modal behält eine vollständige Versionshistorie bei—inspiziere jeden Snapshot, vergleiche ihn mit deinem Entwurf und führe Upgrades oder Rollbacks mit einem Klick durch, wenn du eine frühere Version wiederherstellen musst.
108+
92109
## Programmatische Ausführung
93110

94-
Führen Sie Workflows aus Ihren Anwendungen mit unseren offiziellen SDKs aus:
111+
Führe Workflows aus deinen Anwendungen mit unseren offiziellen SDKs aus:
95112

96113
```bash
97114
# TypeScript/JavaScript
@@ -116,21 +133,21 @@ const result = await client.executeWorkflow('workflow-id', {
116133

117134
## Best Practices
118135

119-
### Für Zuverlässigkeit entwickeln
120-
- Fehler elegant mit geeigneten Fallback-Pfaden behandeln
121-
- Umgebungsvariablen für sensible Daten verwenden
122-
- Logging zu Funktionsblöcken für Debugging hinzufügen
136+
### Design für Zuverlässigkeit
137+
- Behandle Fehler elegant mit geeigneten Fallback-Pfaden
138+
- Verwende Umgebungsvariablen für sensible Daten
139+
- Füge Logging zu Funktionsblöcken für Debugging hinzu
123140

124141
### Leistung optimieren
125-
- Externe API-Aufrufe wenn möglich minimieren
126-
- Parallele Ausführung für unabhängige Operationen nutzen
127-
- Ergebnisse mit Memory-Blöcken bei Bedarf zwischenspeichern
142+
- Minimiere externe API-Aufrufe wo möglich
143+
- Nutze parallele Ausführung für unabhängige Operationen
144+
- Cache Ergebnisse mit Memory-Blöcken, wenn angemessen
128145

129146
### Ausführungen überwachen
130-
- Logs regelmäßig überprüfen, um Leistungsmuster zu verstehen
131-
- Kosten für KI-Modellnutzung verfolgen
132-
- Workflow-Snapshots zur Fehlerbehebung verwenden
147+
- Überprüfe Logs regelmäßig, um Leistungsmuster zu verstehen
148+
- Verfolge Kosten für KI-Modellnutzung
149+
- Verwende Workflow-Snapshots zur Fehlerbehebung
133150

134151
## Was kommt als nächstes?
135152

136-
Beginnen Sie mit [Ausführungsgrundlagen](/execution/basics), um zu verstehen, wie Workflows ausgeführt werden, und erkunden Sie dann [Protokollierung](/execution/logging), um Ihre Ausführungen zu überwachen, sowie [Kostenberechnung](/execution/costs), um Ihre Ausgaben zu optimieren.
153+
Beginne mit [Ausführungsgrundlagen](/execution/basics), um zu verstehen, wie Workflows laufen, und erkunde dann [Logging](/execution/logging), um deine Ausführungen zu überwachen, sowie [Kostenberechnung](/execution/costs), um deine Ausgaben zu optimieren.

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

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
---
2+
title: API-Trigger
3+
description: Starten Sie einen Workflow über eine authentifizierte HTTP-Anfrage
4+
---
5+
6+
import { Callout } from 'fumadocs-ui/components/callout'
7+
import { Image } from '@/components/ui/image'
8+
9+
## Übersicht
10+
11+
Der API-Trigger stellt Ihren Workflow als sicheren HTTP-Endpunkt bereit. Senden Sie JSON-Daten an den Endpunkt und Ihr Workflow verarbeitet diese sofort. API-Aufrufe werden immer gegen Ihre neueste Bereitstellung ausgeführt.
12+
13+
## Eingabeformat konfigurieren
14+
15+
<div className='flex justify-center my-6'>
16+
<Image
17+
src='/static/triggers/api-trigger-light.png'
18+
alt='API-Trigger Eingabeformat'
19+
width={400}
20+
height={250}
21+
className='rounded-xl border border-border shadow-sm'
22+
/>
23+
</div>
24+
25+
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.
26+
27+
```yaml
28+
- type: string
29+
name: userId
30+
value: demo-user # optional manual test value
31+
- type: number
32+
name: maxTokens
33+
```
34+
35+
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>`.
36+
37+
## Anfrage-Beispiel
38+
39+
```bash
40+
curl -X POST \
41+
https://sim.ai/api/workflows/WORKFLOW_ID/execute \
42+
-H 'Content-Type: application/json' \
43+
-H 'X-API-Key: YOUR_KEY' \
44+
-d '{"userId":"demo-user","maxTokens":1024}'
45+
```
46+
47+
Erfolgreiche Antworten geben das serialisierte Ausführungsergebnis vom Executor zurück. Fehler zeigen Validierungs-, Authentifizierungs- oder Workflow-Fehler an.
48+
49+
## Ausgabe-Referenz
50+
51+
| Referenz | Beschreibung |
52+
|-----------|-------------|
53+
| `<api.field>` | Im Eingabeformat definiertes Feld |
54+
| `<api.input>` | Gesamter strukturierter Anfragekörper |
55+
56+
Wenn kein Eingabeformat definiert ist, stellt der Executor das rohe JSON nur unter `<api.input>` bereit.
57+
58+
<Callout type="warning">
59+
Ein Workflow kann nur einen API-Trigger enthalten. Veröffentlichen Sie eine neue Bereitstellung nach Änderungen, damit der Endpunkt aktuell bleibt.
60+
</Callout>

‎apps/docs/content/docs/de/triggers/chat.mdx‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
---
2+
title: Chat-Auslöser
3+
description: Starten Sie einen Workflow aus einer Chat-Bereitstellung
4+
---
5+
6+
import { Callout } from 'fumadocs-ui/components/callout'
7+
import { Image } from '@/components/ui/image'
8+
9+
## Übersicht
10+
11+
Der Chat-Auslöser erstellt eine Konversationsschnittstelle für Ihren Workflow. Stellen Sie Ihren Workflow als Chat bereit, und Benutzer können über eine teilbare URL damit interagieren. Jede Nachricht startet eine neue Workflow-Ausführung mit Ihrer neuesten Bereitstellung.
12+
13+
## Laufzeit-Ausgaben
14+
15+
<div className='flex justify-center my-6'>
16+
<Image
17+
src='/static/triggers/chat-trigger-light.png'
18+
alt='Chat-Bereitstellungskonversation'
19+
width={400}
20+
height={250}
21+
className='rounded-xl border border-border shadow-sm'
22+
/>
23+
</div>
24+
25+
Der Auslöser schreibt drei Felder, auf die nachfolgende Blöcke verweisen können:
26+
27+
| Referenz | Beschreibung |
28+
|-----------|-------------|
29+
| `<chat.input>` | Neueste Benutzernachricht |
30+
| `<chat.conversationId>` | Konversations-Thread-ID |
31+
| `<chat.files>` | Optionale hochgeladene Dateien |
32+
33+
Dateien enthalten `name`, `mimeType` und einen signierten Download `url`.
34+
35+
## Nutzungshinweise
36+
37+
1. Fügen Sie einen Chat-Auslöser-Block pro Workflow hinzu.
38+
2. Stellen Sie den Workflow im Chat-Modus bereit.
39+
3. Teilen Sie den Bereitstellungslink – jede Antwort verwendet die Konversations-ID wieder, sodass der Workflow den Kontext beibehalten kann.
40+
41+
<Callout type="info">
42+
Der Builder blockiert mehrere Chat-Auslöser-Blöcke im selben Workflow.
43+
</Callout>

0 commit comments

Comments
 (0)