Skip to content
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
chore: updated content
  • Loading branch information
adithyaakrishna committed Mar 27, 2026
commit 11d2f7d70bde5813bdc4c5254de1a7d3097a1145
65 changes: 65 additions & 0 deletions apps/docs/content/docs/de/blocks/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,9 @@ description: Die Bausteine deiner KI-Workflows
import { Card, Cards } from 'fumadocs-ui/components/card'
import { Step, Steps } from 'fumadocs-ui/components/steps'
import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
import { Callout } from 'fumadocs-ui/components/callout'
import { Video } from '@/components/ui/video'
import { FAQ } from '@/components/ui/faq'

Blöcke sind die Bausteine, die du miteinander verbindest, um KI-Workflows zu erstellen. Betrachte sie als spezialisierte Module, die jeweils eine bestimmte Aufgabe übernehmen – vom Chatten mit KI-Modellen über API-Aufrufe bis hin zur Datenverarbeitung.

Expand All @@ -22,6 +24,7 @@ Sim bietet wesentliche Blocktypen, die die Kernfunktionen von KI-Workflows abdec
- **[Agent](/blocks/agent)** - Chatte mit KI-Modellen (OpenAI, Anthropic, Google, lokale Modelle)
- **[Function](/blocks/function)** - Führe benutzerdefinierten JavaScript/TypeScript-Code aus
- **[API](/blocks/api)** - Verbinde dich mit externen Diensten über HTTP-Anfragen
- **[Memory](/blocks/memory)** - Speichere und rufe Gesprächsgedächtnisse für KI-Agenten ab

### Logikblöcke
- **[Condition](/blocks/condition)** - Verzweige Workflow-Pfade basierend auf booleschen Ausdrücken
Expand All @@ -35,6 +38,38 @@ Sim bietet wesentliche Blocktypen, die die Kernfunktionen von KI-Workflows abdec

### Ausgabeblöcke
- **[Antwort](/blocks/response)** - Formatieren und Zurückgeben der endgültigen Ergebnisse aus Ihrem Workflow
- **[Webhook (ausgehend)](/blocks/webhook-request)** - HTTP POST-Anfragen an externe Webhooks mit optionaler HMAC-Signatur versenden

### Dokumentations- & Utility-Blöcke
- **[Notiz](/blocks/note)** - Kontextbezogene Anmerkungen und Anweisungen direkt auf der Workflow-Leinwand hinzufügen

## Den richtigen Block auswählen

| Ich möchte... | Verwende diesen Block |
|---|---|
| Mit einem KI-Modell chatten oder LLM-Antworten erhalten | [Agent](/blocks/agent) |
| Benutzerdefinierten JavaScript- oder Python-Code ausführen | [Function](/blocks/function) |
| Eine externe REST-API aufrufen | [API](/blocks/api) |
| Verzweigungen basierend auf Wahr/Falsch-Bedingungen erstellen | [Condition](/blocks/condition) |
| Anfragen mit KI-Urteil weiterleiten | [Router](/blocks/router) |
| Inhalt bewerten oder Qualität beurteilen | [Evaluator](/blocks/evaluator) |
| Menschliche Genehmigung vor dem Fortfahren erfordern | [Human in the Loop](/blocks/human-in-the-loop) |
| Eine Zeitverzögerung zwischen Schritten hinzufügen | [Wait](/blocks/wait) |
| Workflow-Variablen setzen oder aktualisieren | [Variables](/blocks/variables) |
| Endgültige Ausgabe aus einem Workflow zurückgeben | [Response](/blocks/response) |
| HTTP POST-Anfrage an Webhook versenden | [Webhook](/blocks/webhook-request) |
| Einen anderen Workflow als untergeordnetes Element ausführen | [Workflow](/blocks/workflow) |
| Gesprächsgedächtnis speichern/abrufen | [Memory](/blocks/memory) |
| Anmerkungen oder Dokumentation auf der Leinwand hinzufügen | [Note](/blocks/note) |
| Inhalt auf Sicherheit oder PII validieren | [Guardrails](/blocks/guardrails) |
| Blöcke in einer Schleife ausführen | [Loop](/blocks/loop) |
| Blöcke parallel ausführen | [Parallel](/blocks/parallel) |

<Callout type="info">
Für Third-Party-Service-Integrationen (Gmail, Slack, GitHub usw.) durchsuchen Sie den [Tools & Integrations](/tools)-Katalog. Jede Integration hat ihren eigenen dedizierten Block.

Der [Thinking](/blocks/thinking)-Block ist für fortgeschrittene Reasoning-Workflows verfügbar, ist aber in der Standardblock-Symbolleiste verborgen.
</Callout>

## Wie Blöcke funktionieren

Expand Down Expand Up @@ -141,3 +176,33 @@ Jeder Blocktyp hat spezifische Konfigurationsoptionen:
Workflow-Ausführung für bestimmte Zeitverzögerungen pausieren
</Card>
</Cards>

## Block-Versionen

Während sich Sim weiterentwickelt, erhalten Blöcke Updates und Verbesserungen. Um die Rückwärtskompatibilität zu gewährleisten, werden bedeutende Updates neue Versionen von Blöcken (v2, v3 usw.) anstelle von Ersetzungen erstellen.

### Wie Versionierung funktioniert

Wenn ein Block größere Feature-Updates oder API-Änderungen erhält, wird eine neue Version mit einem Versionsufffix erstellt (z. B. wird `file` zu `file_v2`). Die ursprüngliche Version bleibt für bestehende Workflows verfügbar.

### Welche Version sollte verwendet werden

- **Neue Workflows**: Copilot wählt automatisch die neueste Version beim Aufbau von Workflows aus
- **Bestehende Workflows**: Verwenden Sie weiterhin die Version, mit der sie erstellt wurden – es sind keine Änderungen erforderlich, es sei denn, Sie aktualisieren explizit
- **Manuelle Upgrades**: Sie können einen Block auf eine neuere Version aktualisieren, indem Sie die Workflow-Konfiguration bearbeiten

### Versionierte Blöcke

Die folgenden Blöcke haben mehrere verfügbare Versionen:

Confluence (v2) · Cursor (v2) · File (v2, v3) · Fireflies (v2) · GitHub (v2) · Gmail (v2) · Google Calendar (v2) · Google Sheets (v2) · Google Slides (v2) · Intercom (v2) · Kalshi (v2) · Microsoft Excel (v2) · Mistral Parse (v2, v3) · Notion (v2) · Pulse (v2) · Reducto (v2) · Router (v2) · Speech-to-Text (v2) · Textract (v2) · Video Generator (v2) · Vision (v2)

<FAQ items={[
{ question: "Wie viele Block-Typen sind in Sim verfügbar?", answer: "Sim hat über 190 Blöcke in seiner Registry, die Kern-Workflow-Blöcke (Agent, Function, Condition, Router usw.), Integrations-Blöcke für Third-Party-Dienste (Gmail, Slack, GitHub, Notion und viele weitere) sowie Trigger-Blöcke umfassen, die Workflows von externen Ereignissen wie Webhooks oder Zeitplänen starten. Loop und Parallel-Ausführung sind als Container-Konstrukte auf der Leinwand in die Ausführungs-Engine integriert, anstatt eigenständige Registry-Blöcke zu sein." },
{ question: "Kann die Ausgabe eines Blocks mit mehreren nachgelagerten Blöcken verbunden werden?", answer: "Ja. Ein einzelner Ausgabeport kann mit mehreren Eingabeports auf verschiedenen Blöcken verbunden werden. Dies ermöglicht es Ihnen, Daten von einem Verarbeitungsschritt auf mehrere parallele Pfade zu verteilen, ohne den Block duplizieren zu müssen." },
{ question: "Was passiert, wenn ein Block in der Mitte eines Workflows fehlschlägt?", answer: "Wenn ein Block auf einen Fehler trifft, stoppt der Workflow die Ausführung entlang dieses Pfads. Blöcke, die Fehlerbehandlung unterstützen (wie der Router), können zu einem Fehlerpfad weiterleiten, damit Sie Fehler elegant behandeln können, anstatt den gesamten Workflow zu unterbrechen." },
{ question: "Was ist der Unterschied zwischen Verarbeitungs- und Logikblöcken?", answer: "Verarbeitungsblöcke (Agent, Function, API) transformieren oder generieren Daten – sie führen die eigentliche Arbeit aus. Logikblöcke (Condition, Router, Evaluator) treffen Entscheidungen darüber, welchen Pfad der Workflow basierend auf den Daten einschlagen sollte, ohne die Daten selbst zu verändern." },
{ question: "Kann ich Blöcke aus verschiedenen Kategorien zusammen in einem Workflow verwenden?", answer: "Absolut. Ein typischer Workflow kombiniert Blöcke aus mehreren Kategorien. Sie könnten beispielsweise einen Trigger-Block verwenden, um den Workflow zu starten, einen Agent-Block zur Verarbeitung von Eingaben, einen Condition-Block zur Verzweigung der Logik und einen Integrations-Block wie Gmail, um Ergebnisse zu senden." },
{ question: "Gibt es Container-Blöcke, die andere Blöcke darin halten können?", answer: "Ja. Loop und Parallel sind Ausführungs-Engine-Konstrukte, die als Container-Bereiche auf der Leinwand erscheinen. Sie ziehen andere Blöcke darin ein. Loop-Container führen ihre enthaltenen Blöcke wiederholt aus, während Parallel-Container ihre enthaltenen Blöcke gleichzeitig über mehrere Branches ausführen. Im Gegensatz zu Registry-Blöcken werden diese direkt von der Ausführungs-Engine behandelt." },
]} />

98 changes: 98 additions & 0 deletions apps/docs/content/docs/de/blocks/memory.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
---
title: Memory
---

import { Callout } from 'fumadocs-ui/components/callout'
import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
import { Image } from '@/components/ui/image'
import { FAQ } from '@/components/ui/faq'

Der Memory-Block speichert und ruft Gesprächsgedächtnisse für KI-Agenten ab. Er ermöglicht es dir, Gesprächseinträge hinzuzufügen, abzurufen, zu aktualisieren und zu löschen, was statushafte Multi-Turn-Interaktionen über die integrierten Speichermodi des Agent-Blocks hinaus ermöglicht.

<div className="flex justify-center">
<Image
src="/static/blocks/memory.png"
alt="Memory Block Configuration"
width={500}
height={400}
className="my-6"
/>
</div>

<Callout type="warning">
Verwende den Memory-Block nicht, es sei denn, er wird explizit benötigt. Für natürliche Gespräche verwendest du die integrierten Speichermodi des Agent-Blocks (Conversation, Sliding Window by messages oder Sliding Window by tokens). Der Memory-Block ist für das Einfügen von künstlichem Gedächtnis in Workflows gedacht, wenn die native Speicherbehandlung des Agent-Blocks unzureichend ist.
</Callout>

## Konfigurationsoptionen

### Operation

Wählen Sie die Memory-Operation aus, die ausgeführt werden soll:

- **Add Memory**: Füge eine neue Nachricht zum Gesprächsgedächtnis hinzu
- **Get Memory**: Rufe einen bestimmten Memory-Eintrag nach seiner ID ab
- **Get All Memories**: Rufe alle Memories für ein Gespräch ab
- **Delete Memory**: Entferne einen Memory-Eintrag aus dem Speicher

### Conversation ID

Der eindeutige Bezeichner für das Gespräch. Dieser Schlüssel behält das Gedächtnis über Workflow-Ausführungen bei und ermöglicht die Kontextfreigabe zwischen mehreren Ausführungen.

- **Erforderlich**: Ja
- **Typ**: String
- **Beispiel**: `chat-session-123`, `user-456`, `conversation-abc`

### Role (nur Add Memory)

Gibt die Sprecherrolle für den Memory-Eintrag an, wenn du die Operation "Add Memory" verwendest:

- **user**: Nachricht vom Endbenutzer
- **assistant**: Nachricht vom KI-Modell
- **system**: System-Level-Anweisung oder Kontext

### Content (nur Add Memory)

Der Nachrichteninhalt, der gespeichert werden soll, wenn du die Operation "Add Memory" verwendest:

- **Typ**: String (Markdown unterstützt)
- **Maximale Länge**: Keine harte Grenze, aber halten Sie es angemessen groß für die Leistung

## Outputs

- **`<memory.memories>`**: JSON-Array aller Memories im Gespräch (für Get All Memories)
- **`<memory.memory>`**: Der spezifische Memory-Eintrag, der abgerufen wurde (für Get Memory)
- **`<memory.success>`**: Boolean, der anzeigt, ob die Operation erfolgreich abgeschlossen wurde
- **`<memory.id>`**: Die Gesprächs-ID, die für die Operation verwendet wurde

## Beispiel-Anwendungsfälle

**Multi-Turn-Gespräch mit Kontextsicherung**
```
User Input → Memory (Get All) → Agent (w/ history) → Memory (Add user msg) → Agent → Memory (Add assistant msg) → Response
```

**Aufbau persistenter Benutzerprofile**
```
API (User Data) → Memory (Add) → Agent (Enhanced w/ user context) → API (Update Profile)
```

**Gesprächsanalyse**
```
Trigger (Scheduled) → Memory (Get All, conversationId) → Function (Analyze sentiment) → API (Log analytics)
```

## Best Practices

- **Verwende zuerst das Agent-Gedächtnis**: Die integrierten Speichermodi des Agent-Blocks handhaben die meisten Gesprächsszenarien ohne den Memory-Block
- **Verwalte das Gedächtnis-Wachstum**: Bereinige regelmäßig alte Memories, um übermäßigen Speicher und langsame Abrufe zu vermeiden
- **Konsistente Gesprächs-IDs**: Verwende aussagekräftige, konsistente IDs, um sicherzustellen, dass Memories richtig gruppiert und abrufbar sind
- **Kombiniere mit Agent-Block**: Für beste Ergebnisse verwendest du Memory neben dem Agent-Block, um vollständigen Gesprächskontext zu erstellen

<FAQ items={[
{ question: "Wann sollte ich den Memory-Block verwenden, wenn dem Agent-Gedächtnis Modus vorziehen?", answer: "Verwende die integrierten Speichermodi des Agent-Blocks (Conversation, Sliding Window by messages, Sliding Window by tokens) für standardmäßige Multi-Turn-Gespräche – sie sind einfacher und handhaben die meisten Fälle. Verwende den Memory-Block nur, wenn du explizite Kontrolle über Memory-Operationen benötigst, wie das Einfügen von künstlicher Gesprächshistorie, das Verwalten von Memories außerhalb von Agent-Aufrufen oder das Erstellen von benutzerdefinierter Gesprächslogik." },
{ question: "Kann ich Memories zwischen verschiedenen Agenten teilen?", answer: "Ja. Durch die Verwendung derselben Gesprächs-ID über mehrere Agent- und Memory-Blöcke hinweg kannst du Gesprächshistorie und Kontext zwischen verschiedenen Agenten im selben Workflow teilen." },
{ question: "Was passiert, wenn ich Memory mit demselben Inhalt zweimal hinzufüge?", answer: "Doppelte Einträge sind zulässig. Jeder Aufruf zu Add Memory erstellt einen neuen Eintrag, auch wenn der Inhalt identisch ist. Wenn du Duplikate verhindern möchtest, füge Deduplizierungslogik in vorgelagerten Blöcken hinzu (z. B. einen Function-Block)." },
{ question: "Bleiben Memories über Workflow-Ausführungen hinweg erhalten?", answer: "Ja. Memories werden im Backend gespeichert und bleiben über mehrere Workflow-Ausführungen bestehen, solange du dieselbe Gesprächs-ID verwendest. Dies ermöglicht statushafte Interaktionen im Laufe der Zeit." },
{ question: "Kann ich einen spezifischen Memory-Eintrag löschen?", answer: "Ja. Verwende die Delete Memory-Operation mit der Gesprächs-ID. Wenn du bestimmte Einträge löschen möchtest, musst du möglicherweise alle Memories abrufen, sie in einem Function-Block filtern und Einträge selektiv löschen." },
{ question: "Wie incluye ich Gesprächshistorie in einen Agent-Prompt?", answer: "Verwende Memory (Get All), um alle Memories für das Gespräch abzurufen, dann übergibe die Ergebnisse an den Agent-Block. Du kannst die Memories im System-Prompt oder Benutzer-Prompt als Kontext für den Agenten einfügen, den er berücksichtigen sollte." },
]} />
84 changes: 84 additions & 0 deletions apps/docs/content/docs/de/blocks/note.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
---
title: Notiz
---

import { Callout } from 'fumadocs-ui/components/callout'
import { Image } from '@/components/ui/image'
import { FAQ } from '@/components/ui/faq'

Der Notiz-Block fügt kontextbezogene Anmerkungen direkt auf deine Workflow-Leinwand ein. Verwende ihn, um Entscheidungen zu dokumentieren, Anweisungen zu teilen oder kolaborativen Kontext zu hinterlassen, ohne die Workflow-Ausführung zu beeinflussen.

<div className="flex justify-center">
<Image
src="/static/blocks/note.png"
alt="Note Block Configuration"
width={500}
height={400}
className="my-6"
/>
</div>

<Callout type="info">
Notiz-Blöcke sind ausschließlich für Dokumentation und Zusammenarbeit – sie werden nicht während Workflow-Ausführungen ausgeführt und beeinflussen nicht die Workflow-Logik oder Ausgabe.
</Callout>

## Konfigurationsoptionen

### Content

Der Notizeninhalt, der auf der Leinwand angezeigt wird. Notizen unterstützen vollständiges Markdown-Rendering, einschließlich:

- **Textformatierung**: Fett, Kursiv, Links, Inline-Code
- **Listen**: Aufzählungspunkte und nummerierte Listen
- **Code-Blöcke**: Syntaxhervorgehobene Code-Beispiele
- **Überschriften**: Mehrere Überschriftsebenen für Organisation
- **YouTube-Einbettungen**: Embed-Videos direkt mit Standard-Embed-Syntax
- **Block-Referenzen**: Verlinke andere Blöcke im Workflow mit Blocknamen

### Markdown-Beispiel

```markdown
## Verarbeitungsstrategie

Dieser Workflow behandelt Kundenservice-Tickets mit:
1. Route nach Absicht (FAQ vs. Eskalation)
2. Generiere Antwort mit Agent
3. Protokolliere in Datenbank für Analytik

**Wichtig**: Ticketnummer immer in Antwort einschließen.

[Mehr Informationen](https://docs.example.com)
```

## Anwendungsfälle

**Dokumentation von Workflow-Entscheidungen**
```
Füge eine Notiz hinzu, die erklärt, warum spezifische Routing-Logik verwendet wird, Geschäftsregeln oder Entscheidungspunkte, die andere Teamkollegen verstehen sollten
```

**Anweisungen für Mitarbeiter**
```
Hinterlasse Notizen mit Setup-Anweisungen, Konfigurationsanforderungen oder Voraussetzungen vor bestimmten Blöcken
```

**Eingebettete Lernressourcen**
```
Füge Links zu Dokumentation, YouTube-Tutorials oder Beispielen ein, die neuen Teamkollegen helfen, den Workflow zu verstehen
```

## Best Practices

- **Halte Notizen prägnant**: Verwende Notizen zur Ergänzung, nicht zum Ersetzen klarer Workflow-Gestaltung. Wenn du umfangreiche Dokumentation schreibst, ziehe externe Ressourcen in Betracht
- **Aktualisiere bei Workflow-Änderungen**: Wenn du Workflow-Logik änderst, aktualisiere zugehörige Notizen, um die Änderungen widerzuspiegeln
- **Verwende zur Team-Kommunikation**: Notizen sind für alle Mitarbeiter sichtbar – verwende sie, um nicht-offensichtliche Designentscheidungen zu erklären
- **Verlinke zu Ressourcen**: Füge Links zu externer Dokumentation, FAQs oder Entscheidungsprotokollen für mehr Kontext ein

<FAQ items={[
{ question: "Beeinflussen Notiz-Blöcke die Workflow-Ausführung?", answer: "Nein. Notiz-Blöcke sind ausschließlich für Dokumentation und Visualisierung auf der Leinwand. Sie werden nicht ausgeführt, beeinflussen die Workflow-Logik nicht und produzieren keine Ausgaben." },
{ question: "Kann ich Text in einem Notiz-Block formatieren?", answer: "Ja. Notiz-Blöcke unterstützen vollständige Markdown-Syntax einschließlich Fett, Kursiv, Listen, Code-Blöcke, Überschriften, Links und Bilder. Du kannst auch YouTube-Videos mit Standard-Embed-Syntax einbetten." },
{ question: "Kann ich Referenzen zu anderen Blöcken in einer Notiz einfügen?", answer: "Ja. Du kannst Blöcke nach Namen in deinem Markdown referenzieren. Du kannst auch auf externe Ressourcen mit Standard-Markdown-Link-Syntax verlinken." },
{ question: "Sind Notizen für alle Mitarbeiter sichtbar?", answer: "Ja. Notizen sind Teil der Workflow-Leinwand und sind für alle sichtbar, die Zugriff auf den Workflow haben." },
{ question: "Kann ich Notizen in Loop- oder Parallel-Blöcke verschachteln?", answer: "Ja. Notizen können überall auf der Leinwand platziert werden, einschließlich innerhalb von Container-Blöcken wie Loop und Parallel, um Kontext für diese Bereiche zu geben." },
{ question: "Wie lang darf eine Notiz maximal sein?", answer: "Es gibt keine strikte Maximallänge. Für Lesbarkeit und Leistung halte Notizen jedoch angemessen groß. Wenn du umfangreich dokumentieren musst, erwäge die Verwendung externer Dokumentation, auf die von der Notiz verlinkt wird." },
]} />
Loading