feat(i18n): update translations (#1756)

This commit is contained in:
Waleed
2025-10-28 12:43:33 -07:00
committed by GitHub
parent 368576b082
commit aef1f18c1e
26 changed files with 1787 additions and 220 deletions
+27 -17
View File
@@ -16,7 +16,7 @@ Blöcke sind die Bausteine, die du miteinander verbindest, um KI-Workflows zu er
## Grundlegende Blocktypen
Sim bietet sieben grundlegende Blocktypen, die die wesentlichen Funktionen von KI-Workflows abdecken:
Sim bietet wesentliche Blocktypen, die die Kernfunktionen von KI-Workflows abdecken:
### Verarbeitungsblöcke
- **[Agent](/blocks/agent)** - Chatte mit KI-Modellen (OpenAI, Anthropic, Google, lokale Modelle)
@@ -28,16 +28,20 @@ Sim bietet sieben grundlegende Blocktypen, die die wesentlichen Funktionen von K
- **[Router](/blocks/router)** - Nutze KI, um Anfragen intelligent auf verschiedene Pfade zu leiten
- **[Evaluator](/blocks/evaluator)** - Bewerte und beurteile die Inhaltsqualität mit KI
### Ablaufsteuerungsblöcke
- **[Variablen](/blocks/variables)** - Workflow-bezogene Variablen setzen und verwalten
- **[Warten](/blocks/wait)** - Workflow-Ausführung für eine bestimmte Zeitverzögerung pausieren
### Ausgabeblöcke
- **[Response](/blocks/response)** - Formatiere und gib endgültige Ergebnisse aus deinem Workflow zurück
- **[Antwort](/blocks/response)** - Formatieren und Zurückgeben der endgültigen Ergebnisse aus Ihrem Workflow
## Wie Blöcke funktionieren
Jeder Block hat drei Hauptkomponenten:
**Eingaben**: Daten, die in den Block von anderen Blöcken oder Benutzereingaben kommen
**Konfiguration**: Einstellungen, die das Verhalten des Blocks steuern
**Ausgaben**: Daten, die der Block für andere Blöcke produziert
**Konfiguration**: Einstellungen, die steuern, wie der Block sich verhält
**Ausgaben**: Daten, die der Block für andere Blöcke zur Verwendung erzeugt
<Steps>
<Step>
@@ -56,7 +60,7 @@ Jeder Block hat drei Hauptkomponenten:
Sie erstellen Workflows, indem Sie Blöcke miteinander verbinden. Die Ausgabe eines Blocks wird zur Eingabe eines anderen:
- **Ziehen zum Verbinden**: Ziehen Sie von einem Ausgabeport zu einem Eingabeport
- **Mehrfachverbindungen**: Eine Ausgabe kann mit mehreren Eingängen verbunden werden
- **Mehrfachverbindungen**: Eine Ausgabe kann mit mehreren Eingaben verbunden werden
- **Verzweigende Pfade**: Einige Blöcke können basierend auf Bedingungen zu verschiedenen Pfaden weiterleiten
<div className="w-full max-w-2xl mx-auto overflow-hidden rounded-lg">
@@ -73,7 +77,7 @@ User Input → Agent → Function → Response
```
### Bedingte Verzweigung
Verwenden Sie Bedingungsblöcke oder Router-Blöcke, um verschiedene Pfade zu erstellen:
Verwenden Sie Bedingung- oder Router-Blöcke, um verschiedene Pfade zu erstellen:
```
User Input → Router → Agent A (for questions)
@@ -93,37 +97,43 @@ Agent → Evaluator → Condition → Response (if good)
Jeder Blocktyp hat spezifische Konfigurationsoptionen:
**Alle Blöcke**:
- Ein-/Ausgabeverbindungen
- Eingabe-/Ausgabeverbindungen
- Fehlerbehandlungsverhalten
- Zeitüberschreitungseinstellungen für die Ausführung
- Einstellungen für Ausführungs-Timeout
**KI-Blöcke** (Agent, Router, Evaluator):
- Modellauswahl (OpenAI, Anthropic, Google, lokal)
- API-Schlüssel und Authentifizierung
- Temperature und andere Modellparameter
- Temperatur und andere Modellparameter
- Systemaufforderungen und Anweisungen
**Logikblöcke** (Bedingung, Funktion):
**Logik-Blöcke** (Bedingung, Funktion):
- Benutzerdefinierte Ausdrücke oder Code
- Variablenreferenzen
- Einstellungen für die Ausführungsumgebung
- Einstellungen für Ausführungsumgebung
**Integrationsblöcke** (API, Antwort):
**Integrations-Blöcke** (API, Response):
- Endpunktkonfiguration
- Header und Authentifizierung
- Anfrage-/Antwortformatierung
<Cards>
<Card title="Agent Block" href="/blocks/agent">
Verbindung zu KI-Modellen herstellen und intelligente Antworten erzeugen
<Card title="Agent-Block" href="/blocks/agent">
Verbindung zu KI-Modellen herstellen und intelligente Antworten erstellen
</Card>
<Card title="Function Block" href="/blocks/function">
<Card title="Funktions-Block" href="/blocks/function">
Benutzerdefinierten Code ausführen, um Daten zu verarbeiten und zu transformieren
</Card>
<Card title="API Block" href="/blocks/api">
<Card title="API-Block" href="/blocks/api">
Integration mit externen Diensten und APIs
</Card>
<Card title="Condition Block" href="/blocks/condition">
<Card title="Bedingungs-Block" href="/blocks/condition">
Verzweigende Logik basierend auf Datenbewertung erstellen
</Card>
<Card title="Variablen-Block" href="/blocks/variables">
Workflow-bezogene Variablen setzen und verwalten
</Card>
<Card title="Warte-Block" href="/blocks/wait">
Workflow-Ausführung für bestimmte Zeitverzögerungen pausieren
</Card>
</Cards>
+89 -21
View File
@@ -9,7 +9,7 @@ import { Image } from '@/components/ui/image'
Der Loop-Block ist ein Container-Block in Sim, der es ermöglicht, iterative Workflows zu erstellen, indem eine Gruppe von Blöcken wiederholt ausgeführt wird. Loops ermöglichen iterative Verarbeitung in deinen Workflows.
Der Loop-Block unterstützt zwei Arten der Iteration:
Der Schleifenblock unterstützt vier Arten der Iteration:
<Callout type="info">
Loop-Blöcke sind Container-Knoten, die andere Blöcke enthalten können. Die Blöcke innerhalb einer Schleife werden basierend auf deiner Konfiguration mehrfach ausgeführt.
@@ -27,10 +27,10 @@ Der Loop-Block ermöglicht dir:
<strong>Operationen wiederholen</strong>: Blöcke eine festgelegte Anzahl von Malen ausführen
</Step>
<Step>
<strong>Sequentielle Verarbeitung</strong>: Datentransformation in geordneten Iterationen durchführen
<strong>Auf Bedingungen basierte Schleifen</strong>: Ausführung fortsetzen, während oder bis eine Bedingung erfüllt ist
</Step>
<Step>
<strong>Ergebnisse aggregieren</strong>: Ausgaben aus allen Schleifeniterationen sammeln
<strong>Ergebnisse aggregieren</strong>: Ausgaben aus allen Schleifendurchläufen sammeln
</Step>
</Steps>
@@ -47,23 +47,23 @@ Der Loop-Block führt enthaltene Blöcke durch sequentielle Iteration aus:
### Schleifentyp
Wähle zwischen zwei Arten von Schleifen:
Wähle zwischen vier Arten von Schleifen:
<Tabs items={['For Loop', 'ForEach Loop']}>
<Tabs items={['For-Schleife', 'ForEach-Schleife', 'While-Schleife', 'Do-While-Schleife']}>
<Tab>
**For Loop (Iterationen)** - Eine numerische Schleife, die eine feste Anzahl von Malen ausgeführt wird:
**For-Schleife (Iterationen)** - Eine numerische Schleife, die eine festgelegte Anzahl von Malen ausgeführt wird:
<div className="flex justify-center">
<Image
src="/static/blocks/loop-1.png"
alt="For Loop mit Iterationen"
alt="For-Schleife mit Iterationen"
width={500}
height={400}
className="my-6"
/>
</div>
Verwende diese Option, wenn du eine Operation eine bestimmte Anzahl von Malen wiederholen musst.
Verwende diese, wenn du eine Operation eine bestimmte Anzahl von Malen wiederholen musst.
```
@@ -100,6 +100,58 @@ Wähle zwischen zwei Arten von Schleifen:
```
</Tab>
<Tab>
**While-Schleife (Bedingungsbasiert)** - Wird weiter ausgeführt, solange eine Bedingung als wahr ausgewertet wird:
<div className="flex justify-center">
<Image
src="/static/blocks/loop-3.png"
alt="While-Schleife mit Bedingung"
width={500}
height={400}
className="my-6"
/>
</div>
Verwende diese, wenn du eine Schleife benötigst, die läuft, bis eine bestimmte Bedingung erfüllt ist. Die Bedingung wird **vor** jeder Iteration überprüft.
```
Example: While <variable.i> < 10
- Check condition → Execute if true
- Inside loop: Increment <variable.i>
- Inside loop: Variables assigns i = <variable.i> + 1
- Check condition → Execute if true
- Check condition → Exit if false
```
</Tab>
<Tab>
**Do-While-Schleife (Bedingungsbasiert)** - Wird mindestens einmal ausgeführt und dann fortgesetzt, solange eine Bedingung wahr ist:
<div className="flex justify-center">
<Image
src="/static/blocks/loop-3.png"
alt="Do-While-Schleife mit Bedingung"
width={500}
height={400}
className="my-6"
/>
</div>
Verwende diese, wenn du mindestens eine Ausführung benötigst und dann eine Schleife, bis eine Bedingung erfüllt ist. Die Bedingung wird **nach** jeder Iteration überprüft.
```
Example: Do-while <variable.i> < 10
- Execute blocks
- Inside loop: Increment <variable.i>
- Inside loop: Variables assigns i = <variable.i> + 1
- Check condition → Continue if true
- Check condition → Exit if false
```
</Tab>
</Tabs>
## Wie man Schleifen verwendet
@@ -113,9 +165,9 @@ Wähle zwischen zwei Arten von Schleifen:
### Auf Ergebnisse zugreifen
Nach Abschluss einer Schleife kannst du auf aggregierte Ergebnisse zugreifen:
Nach Abschluss einer Schleife können Sie auf die aggregierten Ergebnisse zugreifen:
- **`<loop.results>`**: Array von Ergebnissen aus allen Schleifendurchläufen
- **`<loop.results>`**: Array mit Ergebnissen aus allen Schleifendurchläufen
## Beispielanwendungsfälle
@@ -143,17 +195,30 @@ Nach Abschluss einer Schleife kannst du auf aggregierte Ergebnisse zugreifen:
</ol>
</div>
### Zähler mit While-Schleife
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Szenario: Elemente mit zählerbasierter Schleife verarbeiten</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Workflow-Variable initialisieren: `i = 0`</li>
<li>While-Schleife mit Bedingung: `<variable.i>` \< 10</li>
<li>Innerhalb der Schleife: Agent verarbeitet Element am Index `<variable.i>`</li>
<li>Innerhalb der Schleife: Variable erhöht `i = <variable.i> + 1`</li>
<li>Schleife wird fortgesetzt, solange i kleiner als 10 ist</li>
</ol>
</div>
## Erweiterte Funktionen
### Einschränkungen
<Callout type="warning">
Container-Blöcke (Schleifen und Parallele) können nicht ineinander verschachtelt werden. Das bedeutet:
- Du kannst keinen Schleifenblock in einen anderen Schleifenblock platzieren
- Du kannst keinen Parallelblock in einen Schleifenblock platzieren
- Du kannst keinen Container-Block in einen anderen Container-Block platzieren
- Sie können keinen Schleifenblock in einem anderen Schleifenblock platzieren
- Sie können keinen Parallelblock in einem Schleifenblock platzieren
- Sie können keinen Container-Block in einem anderen Container-Block platzieren
Wenn du mehrdimensionale Iterationen benötigst, erwäge eine Umstrukturierung deines Workflows, um sequentielle Schleifen zu verwenden oder Daten in Stufen zu verarbeiten.
Wenn Sie mehrdimensionale Iterationen benötigen, sollten Sie Ihren Workflow umstrukturieren, um sequentielle Schleifen zu verwenden oder Daten in Stufen zu verarbeiten.
</Callout>
<Callout type="info">
@@ -162,17 +227,20 @@ Nach Abschluss einer Schleife kannst du auf aggregierte Ergebnisse zugreifen:
## Eingaben und Ausgaben
<Tabs items={['Konfiguration', 'Variablen', 'Ergebnisse']}>
<Tabs items={['Configuration', 'Variables', 'Results']}>
<Tab>
<ul className="list-disc space-y-2 pl-6">
<li>
<strong>Schleifentyp</strong>: Wählen Sie zwischen 'for' oder 'forEach'
<strong>Schleifentyp</strong>: Wählen Sie zwischen 'for', 'forEach', 'while' oder 'doWhile'
</li>
<li>
<strong>Iterationen</strong>: Anzahl der Ausführungen (für for-Schleifen)
</li>
<li>
<strong>Sammlung</strong>: Array oder Objekt zum Durchlaufen (für forEach-Schleifen)
<strong>Sammlung</strong>: Array oder Objekt, über das iteriert werden soll (forEach-Schleifen)
</li>
<li>
<strong>Bedingung</strong>: Boolescher Ausdruck zur Auswertung (while/do-while-Schleifen)
</li>
</ul>
</Tab>
@@ -204,8 +272,8 @@ Nach Abschluss einer Schleife kannst du auf aggregierte Ergebnisse zugreifen:
</Tab>
</Tabs>
## Best Practices
## Bewährte Praktiken
- **Setzen Sie vernünftige Grenzen**: Halten Sie die Anzahl der Iterationen in einem vernünftigen Rahmen, um lange Ausführungszeiten zu vermeiden
- **Verwenden Sie ForEach für Sammlungen**: Verwenden Sie ForEach statt For-Schleifen, wenn Sie Arrays oder Objekte verarbeiten
- **Behandeln Sie Fehler angemessen**: Erwägen Sie, Fehlerbehandlung innerhalb von Schleifen einzubauen, um robuste Workflows zu gewährleisten
- **Vernünftige Grenzen setzen**: Halten Sie die Anzahl der Iterationen in einem vernünftigen Rahmen, um lange Ausführungszeiten zu vermeiden
- **ForEach für Sammlungen verwenden**: Verwenden Sie ForEach statt For-Schleifen, wenn Sie Arrays oder Objekte verarbeiten
- **Fehler elegant behandeln**: Erwägen Sie, Fehlerbehandlung innerhalb von Schleifen einzubauen, um robuste Workflows zu gewährleisten
@@ -0,0 +1,123 @@
---
title: Variablen
---
import { Callout } from 'fumadocs-ui/components/callout'
import { Step, Steps } from 'fumadocs-ui/components/steps'
import { Image } from '@/components/ui/image'
Der Variablen-Block aktualisiert Workflow-Variablen während der Ausführung. Variablen müssen zuerst im Variablen-Bereich deines Workflows initialisiert werden, dann kannst du diesen Block verwenden, um ihre Werte während der Ausführung deines Workflows zu aktualisieren.
<div className="flex justify-center">
<Image
src="/static/blocks/variables.png"
alt="Variablen-Block"
width={500}
height={350}
className="my-6"
/>
</div>
<Callout>
Greife überall in deinem Workflow auf Variablen zu, indem du die `<variable.variableName>` Syntax verwendest.
</Callout>
## Überblick
Der Variablen-Block ermöglicht dir:
<Steps>
<Step>
<strong>Workflow-Variablen aktualisieren</strong>: Ändere Variablenwerte während der Ausführung
</Step>
<Step>
<strong>Dynamische Daten speichern</strong>: Erfasse Block-Ausgaben in Variablen
</Step>
<Step>
<strong>Zustand beibehalten</strong>: Verfolge Zähler, Flags und Zwischenergebnisse
</Step>
</Steps>
## Wie man Variablen verwendet
### 1. Im Workflow-Variablenbereich initialisieren
Erstelle zunächst deine Variablen im Variablen-Bereich des Workflows (zugänglich über die Workflow-Einstellungen):
```
customerEmail = ""
retryCount = 0
currentStatus = "pending"
```
### 2. Mit dem Variablen-Block aktualisieren
Verwende den Variablen-Block, um diese Werte während der Ausführung zu aktualisieren:
```
customerEmail = <api.email>
retryCount = <variable.retryCount> + 1
currentStatus = "processing"
```
### 3. Überall zugreifen
Referenziere Variablen in jedem Block:
```
Agent prompt: "Send email to <variable.customerEmail>"
Condition: <variable.retryCount> < 5
API body: {"status": "<variable.currentStatus>"}
```
## Beispielanwendungsfälle
### Schleifenzähler und Zustand
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Szenario: Fortschritt durch Schleifeniterationen verfolgen</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Im Workflow initialisieren: `itemsProcessed = 0`, `lastResult = ""`</li>
<li>Schleife iteriert über Elemente</li>
<li>Innerhalb der Schleife: Agent verarbeitet aktuelles Element</li>
<li>Innerhalb der Schleife: Variablen aktualisieren `itemsProcessed = <variable.itemsProcessed> + 1`</li>
<li>Innerhalb der Schleife: Variablen aktualisieren `lastResult = <agent.content>`</li>
<li>Nächste Iteration: Auf `<variable.lastResult>` zugreifen, um mit aktuellem Ergebnis zu vergleichen</li>
</ol>
</div>
### Wiederholungslogik
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Szenario: API-Wiederholungsversuche verfolgen</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Im Workflow initialisieren: `retryCount = 0`</li>
<li>API-Block versucht Anfrage</li>
<li>Bei Fehlschlag erhöht Variablen: `retryCount = <variable.retryCount> + 1`</li>
<li>Bedingung prüft, ob `<variable.retryCount>` \< 3 ist, um zu wiederholen oder abzubrechen</li>
</ol>
</div>
### Dynamische Konfiguration
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Szenario: Benutzerkontext für Workflow speichern</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Im Workflow initialisieren: `userId = ""`, `userTier = ""`</li>
<li>API ruft Benutzerprofil ab</li>
<li>Variablen speichern: `userId = <api.id>`, `userTier = <api.tier>`</li>
<li>Agent personalisiert Antwort mit `<variable.userTier>`</li>
<li>API verwendet `<variable.userId>` für Logging</li>
</ol>
</div>
## Ausgaben
- **`<variables.assignments>`**: JSON-Objekt mit allen Variablenzuweisungen aus diesem Block
## Bewährte Praktiken
- **Im Workflow-Einstellungen initialisieren**: Erstellen Sie Variablen immer im Workflow-Variablenbereich, bevor Sie sie verwenden
- **Dynamisch aktualisieren**: Verwenden Sie Variablenblöcke, um Werte basierend auf Blockausgaben oder Berechnungen zu aktualisieren
- **In Schleifen verwenden**: Perfekt für die Zustandsverfolgung über Iterationen hinweg
- **Beschreibend benennen**: Verwenden Sie klare Namen wie `currentIndex`, `totalProcessed` oder `lastError`
+99
View File
@@ -0,0 +1,99 @@
---
title: Warten
---
import { Callout } from 'fumadocs-ui/components/callout'
import { Step, Steps } from 'fumadocs-ui/components/steps'
import { Image } from '@/components/ui/image'
Der Warten-Block pausiert deinen Workflow für eine bestimmte Zeit, bevor er mit dem nächsten Block fortfährt. Verwende ihn, um Verzögerungen zwischen Aktionen einzufügen, API-Ratenbegrenzungen einzuhalten oder Operationen zeitlich zu verteilen.
<div className="flex justify-center">
<Image
src="/static/blocks/wait.png"
alt="Warten-Block"
width={500}
height={350}
className="my-6"
/>
</div>
## Übersicht
Mit dem Warten-Block kannst du:
<Steps>
<Step>
<strong>Zeitverzögerungen hinzufügen</strong>: Ausführung zwischen Workflow-Schritten pausieren
</Step>
<Step>
<strong>Ratenbegrenzungen einhalten</strong>: API-Aufrufe zeitlich verteilen, um innerhalb der Limits zu bleiben
</Step>
<Step>
<strong>Sequenzen planen</strong>: Zeitgesteuerte Workflows mit Verzögerungen zwischen Aktionen erstellen
</Step>
</Steps>
## Konfiguration
### Wartezeit
Gib die Dauer der Ausführungspause ein:
- **Eingabe**: Positive Zahl
- **Maximum**: 600 Sekunden (10 Minuten) oder 10 Minuten
### Einheit
Wähle die Zeiteinheit:
- **Sekunden**: Für kurze, präzise Verzögerungen
- **Minuten**: Für längere Pausen
<Callout type="info">
Warten-Blöcke können durch Stoppen des Workflows abgebrochen werden. Die maximale Wartezeit beträgt 10 Minuten.
</Callout>
## Ausgaben
- **`<wait.waitDuration>`**: Die Wartezeit in Millisekunden
- **`<wait.status>`**: Status des Wartens ('waiting', 'completed' oder 'cancelled')
## Beispielanwendungsfälle
### API-Ratenbegrenzung
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Szenario: Innerhalb der API-Ratenbegrenzungen bleiben</h4>
<ol className="list-decimal pl-5 text-sm">
<li>API-Block macht erste Anfrage</li>
<li>Warten-Block pausiert für 2 Sekunden</li>
<li>API-Block macht zweite Anfrage</li>
<li>Prozess läuft weiter, ohne Ratenbegrenzungen zu überschreiten</li>
</ol>
</div>
### Zeitgesteuerte Benachrichtigungen
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Szenario: Folgenachrichten senden</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Funktion sendet erste E-Mail</li>
<li>Warten-Block pausiert für 5 Minuten</li>
<li>Funktion sendet Folge-E-Mail</li>
</ol>
</div>
### Verarbeitungsverzögerungen
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Szenario: Warten auf externes System</h4>
<ol className="list-decimal pl-5 text-sm">
<li>API-Block löst Job im externen System aus</li>
<li>Warte-Block pausiert für 30 Sekunden</li>
<li>API-Block prüft den Abschlussstatus des Jobs</li>
</ol>
</div>
## Bewährte Praktiken
- **Halte Wartezeiten angemessen**: Verwende Warten für Verzögerungen bis zu 10 Minuten. Für längere Verzögerungen solltest du geplante Workflows in Betracht ziehen
- **Überwache die Ausführungszeit**: Denke daran, dass Wartezeiten die Gesamtdauer des Workflows verlängern
+6 -5
View File
@@ -50,7 +50,7 @@ In Sim ermöglicht die OneDrive-Integration Ihren Agenten die direkte Interaktio
## Nutzungsanweisungen
Integriert OneDrive in den Workflow. Kann Dateien erstellen, hochladen und auflisten. Erfordert OAuth.
OneDrive in den Workflow integrieren. Kann Text- und Excel-Dateien erstellen, Dateien hochladen und Dateien auflisten.
## Tools
@@ -63,10 +63,11 @@ Eine Datei auf OneDrive hochladen
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `fileName` | string | Ja | Der Name der hochzuladenden Datei |
| `file` | file | Nein | Die hochzuladende Datei (binär) |
| `content` | string | Nein | Der hochzuladende Textinhalt (falls keine Datei bereitgestellt wird) |
| `folderSelector` | string | Nein | Wählen Sie den Ordner aus, in den die Datei hochgeladen werden soll |
| `manualFolderId` | string | Nein | Manuell eingegebene Ordner-ID (erweiterter Modus) |
| `file` | file | Nein | Die hochzuladende Datei \(binär\) |
| `content` | string | Nein | Der hochzuladende Textinhalt \(falls keine Datei bereitgestellt wird\) |
| `mimeType` | string | Nein | Der MIME-Typ der zu erstellenden Datei \(z.B. text/plain für .txt, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet für .xlsx\) |
| `folderSelector` | string | Nein | Ordner auswählen, in den die Datei hochgeladen werden soll |
| `manualFolderId` | string | Nein | Manuell eingegebene Ordner-ID \(erweiterter Modus\) |
#### Ausgabe
+16 -6
View File
@@ -16,7 +16,7 @@ Los bloques son los componentes de construcción que conectas para crear flujos
## Tipos de bloques principales
Sim proporciona siete tipos de bloques principales que manejan las funciones esenciales de los flujos de trabajo de IA:
Sim proporciona tipos de bloques esenciales que manejan las funciones principales de los flujos de trabajo de IA:
### Bloques de procesamiento
- **[Agente](/blocks/agent)** - Chatea con modelos de IA (OpenAI, Anthropic, Google, modelos locales)
@@ -28,14 +28,18 @@ Sim proporciona siete tipos de bloques principales que manejan las funciones ese
- **[Enrutador](/blocks/router)** - Usa IA para dirigir inteligentemente las solicitudes a diferentes caminos
- **[Evaluador](/blocks/evaluator)** - Puntúa y evalúa la calidad del contenido usando IA
### Bloques de flujo de control
- **[Variables](/blocks/variables)** - Establecer y gestionar variables con alcance de flujo de trabajo
- **[Espera](/blocks/wait)** - Pausar la ejecución del flujo de trabajo durante un tiempo específico
### Bloques de salida
- **[Respuesta](/blocks/response)** - Formatea y devuelve resultados finales de tu flujo de trabajo
- **[Respuesta](/blocks/response)** - Formatear y devolver resultados finales desde tu flujo de trabajo
## Cómo funcionan los bloques
Cada bloque tiene tres componentes principales:
**Entradas**: Datos que llegan al bloque desde otros bloques o entrada del usuario
**Entradas**: Datos que ingresan al bloque desde otros bloques o entrada del usuario
**Configuración**: Ajustes que controlan cómo se comporta el bloque
**Salidas**: Datos que el bloque produce para que otros bloques los utilicen
@@ -55,8 +59,8 @@ Cada bloque tiene tres componentes principales:
Creas flujos de trabajo conectando bloques entre sí. La salida de un bloque se convierte en la entrada de otro:
- **Arrastra para conectar**: Arrastra desde un puerto de salida a un puerto de entrada
- **Conexiones múltiples**: Una salida puede conectarse a múltiples entradas
- **Arrastrar para conectar**: Arrastra desde un puerto de salida a un puerto de entrada
- **Múltiples conexiones**: Una salida puede conectarse a múltiples entradas
- **Rutas ramificadas**: Algunos bloques pueden dirigir a diferentes rutas según las condiciones
<div className="w-full max-w-2xl mx-auto overflow-hidden rounded-lg">
@@ -110,7 +114,7 @@ Cada tipo de bloque tiene opciones de configuración específicas:
**Bloques de integración** (API, Respuesta):
- Configuración de endpoint
- Cabeceras y autenticación
- Encabezados y autenticación
- Formato de solicitud/respuesta
<Cards>
@@ -126,4 +130,10 @@ Cada tipo de bloque tiene opciones de configuración específicas:
<Card title="Bloque de condición" href="/blocks/condition">
Crea lógica de ramificación basada en evaluación de datos
</Card>
<Card title="Bloque de variables" href="/blocks/variables">
Establece y gestiona variables con alcance de flujo de trabajo
</Card>
<Card title="Bloque de espera" href="/blocks/wait">
Pausa la ejecución del flujo de trabajo durante retrasos de tiempo específicos
</Card>
</Cards>
+81 -13
View File
@@ -9,7 +9,7 @@ import { Image } from '@/components/ui/image'
El bloque Loop es un bloque contenedor en Sim que permite crear flujos de trabajo iterativos ejecutando un grupo de bloques repetidamente. Los bucles permiten el procesamiento iterativo en tus flujos de trabajo.
El bloque Loop admite dos tipos de iteración:
El bloque Loop admite cuatro tipos de iteración:
<Callout type="info">
Los bloques Loop son nodos contenedores que pueden albergar otros bloques dentro de ellos. Los bloques dentro de un bucle se ejecutarán múltiples veces según tu configuración.
@@ -27,7 +27,7 @@ El bloque Loop te permite:
<strong>Repetir operaciones</strong>: Ejecutar bloques un número fijo de veces
</Step>
<Step>
<strong>Procesamiento secuencial</strong>: Manejar transformación de datos en iteraciones ordenadas
<strong>Bucles con condiciones</strong>: Continuar ejecutando mientras o hasta que se cumpla una condición
</Step>
<Step>
<strong>Agregar resultados</strong>: Recopilar salidas de todas las iteraciones del bucle
@@ -47,11 +47,11 @@ El bloque Loop ejecuta los bloques contenidos a través de iteración secuencial
### Tipo de bucle
Elige entre dos tipos de bucles:
Elige entre cuatro tipos de bucles:
<Tabs items={['For Loop', 'ForEach Loop']}>
<Tabs items={['For Loop', 'ForEach Loop', 'While Loop', 'Do-While Loop']}>
<Tab>
**For Loop (Iteraciones)** - Un bucle numérico que se ejecuta un número fijo de veces:
**Bucle For (Iteraciones)** - Un bucle numérico que se ejecuta un número fijo de veces:
<div className="flex justify-center">
<Image
@@ -100,13 +100,65 @@ Elige entre dos tipos de bucles:
```
</Tab>
<Tab>
**Bucle While (Basado en condición)** - Continúa ejecutándose mientras una condición se evalúe como verdadera:
<div className="flex justify-center">
<Image
src="/static/blocks/loop-3.png"
alt="Bucle While con condición"
width={500}
height={400}
className="my-6"
/>
</div>
Úsalo cuando necesites hacer un bucle hasta que se cumpla una condición específica. La condición se comprueba **antes** de cada iteración.
```
Example: While <variable.i> < 10
- Check condition → Execute if true
- Inside loop: Increment <variable.i>
- Inside loop: Variables assigns i = <variable.i> + 1
- Check condition → Execute if true
- Check condition → Exit if false
```
</Tab>
<Tab>
**Bucle Do-While (Basado en condición)** - Se ejecuta al menos una vez, luego continúa mientras una condición sea verdadera:
<div className="flex justify-center">
<Image
src="/static/blocks/loop-3.png"
alt="Bucle Do-While con condición"
width={500}
height={400}
className="my-6"
/>
</div>
Úsalo cuando necesites ejecutar al menos una vez, luego hacer un bucle hasta que se cumpla una condición. La condición se comprueba **después** de cada iteración.
```
Example: Do-while <variable.i> < 10
- Execute blocks
- Inside loop: Increment <variable.i>
- Inside loop: Variables assigns i = <variable.i> + 1
- Check condition → Continue if true
- Check condition → Exit if false
```
</Tab>
</Tabs>
## Cómo usar los bucles
### Creación de un bucle
### Creando un bucle
1. Arrastra un bloque de bucle desde la barra de herramientas a tu lienzo
1. Arrastra un bloque Loop desde la barra de herramientas a tu lienzo
2. Configura el tipo de bucle y los parámetros
3. Arrastra otros bloques dentro del contenedor del bucle
4. Conecta los bloques según sea necesario
@@ -136,19 +188,32 @@ Después de que un bucle se completa, puedes acceder a los resultados agregados:
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Escenario: Generar múltiples variaciones</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Configurar el bucle For para 5 iteraciones</li>
<li>Configurar bucle For para 5 iteraciones</li>
<li>Dentro del bucle: El agente genera una variación de contenido</li>
<li>Dentro del bucle: El evaluador puntúa el contenido</li>
<li>Después del bucle: La función selecciona la mejor variación</li>
</ol>
</div>
### Contador con bucle While
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Escenario: Procesar elementos con bucle basado en contador</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Inicializar variable de flujo de trabajo: `i = 0`</li>
<li>Bucle While con condición: `<variable.i>` \< 10</li>
<li>Dentro del bucle: El agente procesa el elemento en el índice `<variable.i>`</li>
<li>Dentro del bucle: La variable incrementa `i = <variable.i> + 1`</li>
<li>El bucle continúa mientras i sea menor que 10</li>
</ol>
</div>
## Características avanzadas
### Limitaciones
<Callout type="warning">
Los bloques contenedores (Bucles y Paralelos) no pueden anidarse unos dentro de otros. Esto significa:
Los bloques contenedores (Bucles y Paralelos) no pueden anidarse dentro de otros. Esto significa:
- No puedes colocar un bloque de Bucle dentro de otro bloque de Bucle
- No puedes colocar un bloque Paralelo dentro de un bloque de Bucle
- No puedes colocar ningún bloque contenedor dentro de otro bloque contenedor
@@ -157,7 +222,7 @@ Después de que un bucle se completa, puedes acceder a los resultados agregados:
</Callout>
<Callout type="info">
Los bucles se ejecutan secuencialmente, no en paralelo. Si necesitas ejecución concurrente, utiliza el bloque Paralelo en su lugar.
Los bucles se ejecutan secuencialmente, no en paralelo. Si necesitas ejecución concurrente, usa el bloque Paralelo en su lugar.
</Callout>
## Entradas y salidas
@@ -166,7 +231,7 @@ Después de que un bucle se completa, puedes acceder a los resultados agregados:
<Tab>
<ul className="list-disc space-y-2 pl-6">
<li>
<strong>Tipo de bucle</strong>: Elige entre 'for' o 'forEach'
<strong>Tipo de bucle</strong>: Elige entre 'for', 'forEach', 'while', o 'doWhile'
</li>
<li>
<strong>Iteraciones</strong>: Número de veces a ejecutar (bucles for)
@@ -174,6 +239,9 @@ Después de que un bucle se completa, puedes acceder a los resultados agregados:
<li>
<strong>Colección</strong>: Array u objeto sobre el que iterar (bucles forEach)
</li>
<li>
<strong>Condición</strong>: Expresión booleana a evaluar (bucles while/do-while)
</li>
</ul>
</Tab>
<Tab>
@@ -192,7 +260,7 @@ Después de que un bucle se completa, puedes acceder a los resultados agregados:
<Tab>
<ul className="list-disc space-y-2 pl-6">
<li>
<strong>loop.results</strong>: Array con todos los resultados de las iteraciones
<strong>loop.results</strong>: Array de todos los resultados de iteración
</li>
<li>
<strong>Estructura</strong>: Los resultados mantienen el orden de iteración
@@ -206,6 +274,6 @@ Después de que un bucle se completa, puedes acceder a los resultados agregados:
## Mejores prácticas
- **Establece límites razonables**: Mantén un número razonable de iteraciones para evitar tiempos de ejecución largos
- **Establece límites razonables**: Mantén el número de iteraciones razonable para evitar tiempos de ejecución largos
- **Usa ForEach para colecciones**: Cuando proceses arrays u objetos, usa 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
@@ -0,0 +1,123 @@
---
title: Variables
---
import { Callout } from 'fumadocs-ui/components/callout'
import { Step, Steps } from 'fumadocs-ui/components/steps'
import { Image } from '@/components/ui/image'
El bloque Variables actualiza las variables del flujo de trabajo durante la ejecución. Las variables deben inicializarse primero en la sección Variables de tu flujo de trabajo, luego puedes usar este bloque para actualizar sus valores mientras se ejecuta tu flujo de trabajo.
<div className="flex justify-center">
<Image
src="/static/blocks/variables.png"
alt="Bloque de Variables"
width={500}
height={350}
className="my-6"
/>
</div>
<Callout>
Accede a las variables en cualquier parte de tu flujo de trabajo usando la sintaxis `<variable.variableName>`.
</Callout>
## Descripción general
El bloque Variables te permite:
<Steps>
<Step>
<strong>Actualizar variables del flujo de trabajo</strong>: Cambiar valores de variables durante la ejecución
</Step>
<Step>
<strong>Almacenar datos dinámicos</strong>: Capturar salidas de bloques en variables
</Step>
<Step>
<strong>Mantener el estado</strong>: Seguir contadores, indicadores y resultados intermedios
</Step>
</Steps>
## Cómo usar Variables
### 1. Inicializar en Variables del flujo de trabajo
Primero, crea tus variables en la sección Variables del flujo de trabajo (accesible desde la configuración del flujo de trabajo):
```
customerEmail = ""
retryCount = 0
currentStatus = "pending"
```
### 2. Actualizar con el bloque Variables
Usa el bloque Variables para actualizar estos valores durante la ejecución:
```
customerEmail = <api.email>
retryCount = <variable.retryCount> + 1
currentStatus = "processing"
```
### 3. Acceder desde cualquier lugar
Referencia variables en cualquier bloque:
```
Agent prompt: "Send email to <variable.customerEmail>"
Condition: <variable.retryCount> < 5
API body: {"status": "<variable.currentStatus>"}
```
## Ejemplos de casos de uso
### Contador de bucle y estado
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Escenario: Seguimiento del progreso a través de iteraciones de bucle</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Inicializar en el flujo de trabajo: `itemsProcessed = 0`, `lastResult = ""`</li>
<li>El bucle itera sobre elementos</li>
<li>Dentro del bucle: El agente procesa el elemento actual</li>
<li>Dentro del bucle: Variables actualiza `itemsProcessed = <variable.itemsProcessed> + 1`</li>
<li>Dentro del bucle: Variables actualiza `lastResult = <agent.content>`</li>
<li>Siguiente iteración: Accede a `<variable.lastResult>` para comparar con el resultado actual</li>
</ol>
</div>
### Lógica de reintentos
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Escenario: Seguimiento de intentos de reintento de API</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Inicializar en el flujo de trabajo: `retryCount = 0`</li>
<li>El bloque API intenta realizar la solicitud</li>
<li>Si falla, Variables incrementa: `retryCount = <variable.retryCount> + 1`</li>
<li>La condición verifica si `<variable.retryCount>` \< 3 para reintentar o fallar</li>
</ol>
</div>
### Configuración dinámica
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Escenario: Almacenar contexto de usuario para el flujo de trabajo</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Inicializar en el flujo de trabajo: `userId = ""`, `userTier = ""`</li>
<li>La API obtiene el perfil del usuario</li>
<li>Variables almacena: `userId = <api.id>`, `userTier = <api.tier>`</li>
<li>El agente personaliza la respuesta usando `<variable.userTier>`</li>
<li>La API usa `<variable.userId>` para el registro</li>
</ol>
</div>
## Salidas
- **`<variables.assignments>`**: Objeto JSON con todas las asignaciones de variables de este bloque
## Mejores prácticas
- **Inicializar en la configuración del flujo de trabajo**: Siempre crea variables en la sección Variables del flujo de trabajo antes de usarlas
- **Actualizar dinámicamente**: Usa bloques de Variables para actualizar valores basados en salidas de bloques o cálculos
- **Usar en bucles**: Perfecto para rastrear el estado a través de iteraciones
- **Nombrar descriptivamente**: Usa nombres claros como `currentIndex`, `totalProcessed`, o `lastError`
+99
View File
@@ -0,0 +1,99 @@
---
title: Espera
---
import { Callout } from 'fumadocs-ui/components/callout'
import { Step, Steps } from 'fumadocs-ui/components/steps'
import { Image } from '@/components/ui/image'
El bloque Espera pausa tu flujo de trabajo durante un tiempo específico antes de continuar con el siguiente bloque. Úsalo para añadir retrasos entre acciones, respetar límites de frecuencia de API o espaciar operaciones.
<div className="flex justify-center">
<Image
src="/static/blocks/wait.png"
alt="Bloque de Espera"
width={500}
height={350}
className="my-6"
/>
</div>
## Descripción general
El bloque Espera te permite:
<Steps>
<Step>
<strong>Añadir retrasos de tiempo</strong>: Pausar la ejecución entre pasos del flujo de trabajo
</Step>
<Step>
<strong>Respetar límites de frecuencia</strong>: Espaciar llamadas a API para mantenerse dentro de los límites
</Step>
<Step>
<strong>Programar secuencias</strong>: Crear flujos de trabajo temporizados con retrasos entre acciones
</Step>
</Steps>
## Configuración
### Cantidad de espera
Introduce la duración para pausar la ejecución:
- **Entrada**: Número positivo
- **Máximo**: 600 segundos (10 minutos) o 10 minutos
### Unidad
Elige la unidad de tiempo:
- **Segundos**: Para retrasos cortos y precisos
- **Minutos**: Para pausas más largas
<Callout type="info">
Los bloques de espera pueden cancelarse deteniendo el flujo de trabajo. El tiempo máximo de espera es de 10 minutos.
</Callout>
## Salidas
- **`<wait.waitDuration>`**: La duración de la espera en milisegundos
- **`<wait.status>`**: Estado de la espera ('waiting', 'completed', o 'cancelled')
## Ejemplos de casos de uso
### Limitación de frecuencia de API
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Escenario: Mantenerse dentro de los límites de frecuencia de API</h4>
<ol className="list-decimal pl-5 text-sm">
<li>El bloque API realiza la primera solicitud</li>
<li>El bloque Espera pausa durante 2 segundos</li>
<li>El bloque API realiza la segunda solicitud</li>
<li>El proceso continúa sin alcanzar los límites de frecuencia</li>
</ol>
</div>
### Notificaciones temporizadas
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Escenario: Enviar mensajes de seguimiento</h4>
<ol className="list-decimal pl-5 text-sm">
<li>La función envía el correo electrónico inicial</li>
<li>El bloque Espera pausa durante 5 minutos</li>
<li>La función envía el correo electrónico de seguimiento</li>
</ol>
</div>
### Retrasos de procesamiento
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Escenario: Espera para sistema externo</h4>
<ol className="list-decimal pl-5 text-sm">
<li>El bloque API activa un trabajo en el sistema externo</li>
<li>El bloque de espera pausa durante 30 segundos</li>
<li>El bloque API verifica el estado de finalización del trabajo</li>
</ol>
</div>
## Mejores prácticas
- **Mantén esperas razonables**: Usa Espera para retrasos de hasta 10 minutos. Para retrasos más largos, considera flujos de trabajo programados
- **Monitorea el tiempo de ejecución**: Recuerda que las esperas extienden la duración total del flujo de trabajo
+4 -3
View File
@@ -50,7 +50,7 @@ En Sim, la integración con OneDrive permite a tus agentes interactuar directame
## Instrucciones de uso
Integra OneDrive en el flujo de trabajo. Puede crear, subir y listar archivos. Requiere OAuth.
Integra OneDrive en el flujo de trabajo. Puede crear archivos de texto y Excel, subir archivos y listar archivos.
## Herramientas
@@ -61,12 +61,13 @@ Subir un archivo a OneDrive
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| --------- | ---- | -------- | ----------- |
| `fileName` | string | Sí | El nombre del archivo a subir |
| `file` | file | No | El archivo a subir \(binario\) |
| `content` | string | No | El contenido de texto a subir \(si no se proporciona un archivo\) |
| `mimeType` | string | No | El tipo MIME del archivo a crear \(p. ej., text/plain para .txt, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet para .xlsx\) |
| `folderSelector` | string | No | Seleccionar la carpeta donde subir el archivo |
| `manualFolderId` | string | No | ID de carpeta ingresado manualmente \(modo avanzado\) |
| `manualFolderId` | string | No | ID de carpeta introducido manualmente \(modo avanzado\) |
#### Salida
+22 -12
View File
@@ -16,7 +16,7 @@ Les blocs sont les composants de construction que vous connectez pour créer des
## Types de blocs principaux
Sim propose sept types de blocs principaux qui gèrent les fonctions essentielles des flux de travail d'IA :
Sim fournit des types de blocs essentiels qui gèrent les fonctions principales des flux de travail IA :
### Blocs de traitement
- **[Agent](/blocks/agent)** - Dialoguez avec des modèles d'IA (OpenAI, Anthropic, Google, modèles locaux)
@@ -28,8 +28,12 @@ Sim propose sept types de blocs principaux qui gèrent les fonctions essentielle
- **[Router](/blocks/router)** - Utilisez l'IA pour acheminer intelligemment les requêtes vers différents chemins
- **[Evaluator](/blocks/evaluator)** - Notez et évaluez la qualité du contenu à l'aide de l'IA
### Blocs de flux de contrôle
- **[Variables](/blocks/variables)** - Définir et gérer des variables à portée de flux de travail
- **[Wait](/blocks/wait)** - Mettre en pause l'exécution du flux de travail pendant un délai spécifié
### Blocs de sortie
- **[Response](/blocks/response)** - Formatez et renvoyez les résultats finaux de votre flux de travail
- **[Response](/blocks/response)** - Formater et renvoyer les résultats finaux de votre flux de travail
## Comment fonctionnent les blocs
@@ -37,7 +41,7 @@ Chaque bloc comporte trois composants principaux :
**Entrées** : données entrant dans le bloc depuis d'autres blocs ou saisies utilisateur
**Configuration** : paramètres qui contrôlent le comportement du bloc
**Sorties** : données que le bloc produit pour être utilisées par d'autres blocs
**Sorties** : données produites par le bloc pour être utilisées par d'autres blocs
<Steps>
<Step>
@@ -55,9 +59,9 @@ Chaque bloc comporte trois composants principaux :
Vous créez des flux de travail en connectant des blocs entre eux. La sortie d'un bloc devient l'entrée d'un autre :
- **Glisser pour connecter** : Faites glisser d'un port de sortie vers un port d'entrée
- **Connexions multiples** : Une sortie peut se connecter à plusieurs entrées
- **Chemins de ramification** : Certains blocs peuvent acheminer vers différents chemins selon les conditions
- **Glisser pour connecter** : faites glisser d'un port de sortie vers un port d'entrée
- **Connexions multiples** : une sortie peut se connecter à plusieurs entrées
- **Chemins de branchement** : certains blocs peuvent acheminer vers différents chemins selon les conditions
<div className="w-full max-w-2xl mx-auto overflow-hidden rounded-lg">
<Video src="connections.mp4" width={700} height={450} />
@@ -72,8 +76,8 @@ Connectez les blocs en chaîne où chaque bloc traite la sortie du précédent :
User Input → Agent → Function → Response
```
### Ramification conditionnelle
Utilisez des blocs de Condition ou de Routeur pour créer différents chemins :
### Branchement conditionnel
Utilisez des blocs Condition ou Router pour créer différents chemins :
```
User Input → Router → Agent A (for questions)
@@ -81,7 +85,7 @@ User Input → Router → Agent A (for questions)
```
### Contrôle qualité
Utilisez des blocs Évaluateur pour évaluer et filtrer les sorties :
Utilisez des blocs Evaluator pour évaluer et filtrer les sorties :
```
Agent → Evaluator → Condition → Response (if good)
@@ -101,7 +105,7 @@ Chaque type de bloc possède des options de configuration spécifiques :
- Sélection du modèle (OpenAI, Anthropic, Google, local)
- Clés API et authentification
- Température et autres paramètres du modèle
- Prompts système et instructions
- Instructions et prompts système
**Blocs logiques** (Condition, Fonction) :
- Expressions ou code personnalisés
@@ -109,7 +113,7 @@ Chaque type de bloc possède des options de configuration spécifiques :
- Paramètres d'environnement d'exécution
**Blocs d'intégration** (API, Réponse) :
- Configuration des points de terminaison
- Configuration du point de terminaison
- En-têtes et authentification
- Formatage des requêtes/réponses
@@ -124,6 +128,12 @@ Chaque type de bloc possède des options de configuration spécifiques :
Intégrez des services externes et des API
</Card>
<Card title="Bloc Condition" href="/blocks/condition">
Créez une logique de ramification basée sur l'évaluation des données
Créez une logique de branchement basée sur l'évaluation des données
</Card>
<Card title="Bloc Variables" href="/blocks/variables">
Définissez et gérez des variables à portée de workflow
</Card>
<Card title="Bloc Attente" href="/blocks/wait">
Mettez en pause l'exécution du workflow pour des délais spécifiés
</Card>
</Cards>
+86 -18
View File
@@ -9,7 +9,7 @@ import { Image } from '@/components/ui/image'
Le bloc Loop est un bloc conteneur dans Sim qui vous permet de créer des flux de travail itératifs en exécutant un groupe de blocs de façon répétée. Les boucles permettent un traitement itératif dans vos flux de travail.
Le bloc Loop prend en charge deux types d'itération :
Le bloc Boucle prend en charge quatre types d'itération :
<Callout type="info">
Les blocs Loop sont des nœuds conteneurs qui peuvent contenir d'autres blocs. Les blocs à l'intérieur d'une boucle s'exécuteront plusieurs fois selon votre configuration.
@@ -21,16 +21,16 @@ Le bloc Loop vous permet de :
<Steps>
<Step>
<strong>Itérer sur des collections</strong> : traiter des tableaux ou des objets un élément à la fois
<strong>Itérer sur des collections</strong> : Traiter des tableaux ou des objets un élément à la fois
</Step>
<Step>
<strong>Répéter des opérations</strong> : exécuter des blocs un nombre fixe de fois
<strong>Répéter des opérations</strong> : Exécuter des blocs un nombre fixe de fois
</Step>
<Step>
<strong>Traitement séquentiel</strong> : gérer la transformation des données dans des itérations ordonnées
<strong>Boucler sur des conditions</strong> : Continuer l'exécution tant qu'une condition est remplie ou jusqu'à ce qu'elle le soit
</Step>
<Step>
<strong>Agréger les résultats</strong> : collecter les sorties de toutes les itérations de la boucle
<strong>Agréger des résultats</strong> : Collecter les sorties de toutes les itérations de la boucle
</Step>
</Steps>
@@ -47,11 +47,11 @@ Le bloc Loop exécute les blocs contenus par itération séquentielle :
### Type de boucle
Choisissez entre deux types de boucles :
Choisissez parmi quatre types de boucles :
<Tabs items={['For Loop', 'ForEach Loop']}>
<Tabs items={['Boucle For', 'Boucle ForEach', 'Boucle While', 'Boucle Do-While']}>
<Tab>
**For Loop (Itérations)** - Une boucle numérique qui s'exécute un nombre fixe de fois :
**Boucle For (Itérations)** - Une boucle numérique qui s'exécute un nombre fixe de fois :
<div className="flex justify-center">
<Image
@@ -100,6 +100,58 @@ Choisissez entre deux types de boucles :
```
</Tab>
<Tab>
**Boucle While (Basée sur condition)** - Continue l'exécution tant qu'une condition est évaluée à vrai :
<div className="flex justify-center">
<Image
src="/static/blocks/loop-3.png"
alt="Boucle While avec condition"
width={500}
height={400}
className="my-6"
/>
</div>
Utilisez cette option lorsque vous devez boucler jusqu'à ce qu'une condition spécifique soit remplie. La condition est vérifiée **avant** chaque itération.
```
Example: While <variable.i> < 10
- Check condition → Execute if true
- Inside loop: Increment <variable.i>
- Inside loop: Variables assigns i = <variable.i> + 1
- Check condition → Execute if true
- Check condition → Exit if false
```
</Tab>
<Tab>
**Boucle Do-While (Basée sur condition)** - S'exécute au moins une fois, puis continue tant qu'une condition est vraie :
<div className="flex justify-center">
<Image
src="/static/blocks/loop-3.png"
alt="Boucle Do-While avec condition"
width={500}
height={400}
className="my-6"
/>
</div>
Utilisez cette option lorsque vous devez exécuter au moins une fois, puis boucler jusqu'à ce qu'une condition soit remplie. La condition est vérifiée **après** chaque itération.
```
Example: Do-while <variable.i> < 10
- Execute blocks
- Inside loop: Increment <variable.i>
- Inside loop: Variables assigns i = <variable.i> + 1
- Check condition → Continue if true
- Check condition → Exit if false
```
</Tab>
</Tabs>
## Comment utiliser les boucles
@@ -113,16 +165,16 @@ Choisissez entre deux types de boucles :
### Accès aux résultats
Une fois qu'une boucle est terminée, vous pouvez accéder aux résultats agrégés :
Après la fin d'une boucle, vous pouvez accéder aux résultats agrégés :
- **`<loop.results>`** : tableau des résultats de toutes les itérations de la boucle
- **`<loop.results>`** : Tableau des résultats de toutes les itérations de la boucle
## Exemples de cas d'utilisation
### Traitement des résultats d'API
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Scénario : traiter plusieurs enregistrements clients</h4>
<h4 className="font-medium">Scénario : Traiter plusieurs enregistrements clients</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Le bloc API récupère la liste des clients</li>
<li>La boucle ForEach itère sur chaque client</li>
@@ -134,15 +186,28 @@ Une fois qu'une boucle est terminée, vous pouvez accéder aux résultats agrég
### Génération itérative de contenu
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Scénario : générer plusieurs variations</h4>
<h4 className="font-medium">Scénario : Générer plusieurs variations</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Définir une boucle For à 5 itérations</li>
<li>Configurer la boucle For à 5 itérations</li>
<li>À l'intérieur de la boucle : l'agent génère une variation de contenu</li>
<li>À l'intérieur de la boucle : l'évaluateur note le contenu</li>
<li>Après la boucle : la fonction sélectionne la meilleure variation</li>
</ol>
</div>
### Compteur avec boucle While
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Scénario : Traiter des éléments avec une boucle basée sur un compteur</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Initialiser la variable de workflow : `i = 0`</li>
<li>Boucle While avec condition : `<variable.i>` \< 10</li>
<li>À l'intérieur de la boucle : l'agent traite l'élément à l'index `<variable.i>`</li>
<li>À l'intérieur de la boucle : la variable incrémente `i = <variable.i> + 1`</li>
<li>La boucle continue tant que i est inférieur à 10</li>
</ol>
</div>
## Fonctionnalités avancées
### Limitations
@@ -153,7 +218,7 @@ Une fois qu'une boucle est terminée, vous pouvez accéder aux résultats agrég
- Vous ne pouvez pas placer un bloc Parallèle à l'intérieur d'un bloc Boucle
- Vous ne pouvez pas placer un bloc conteneur à l'intérieur d'un autre bloc conteneur
Si vous avez besoin d'une itération multidimensionnelle, envisagez de restructurer votre flux de travail pour utiliser des boucles séquentielles ou traiter les données par étapes.
Si vous avez besoin d'une itération multidimensionnelle, envisagez de restructurer votre workflow pour utiliser des boucles séquentielles ou traiter les données par étapes.
</Callout>
<Callout type="info">
@@ -166,13 +231,16 @@ Une fois qu'une boucle est terminée, vous pouvez accéder aux résultats agrég
<Tab>
<ul className="list-disc space-y-2 pl-6">
<li>
<strong>Type de boucle</strong> : choisissez entre 'for' ou 'forEach'
<strong>Type de boucle</strong> : choisissez entre 'for', 'forEach', 'while' ou 'doWhile'
</li>
<li>
<strong>Itérations</strong> : nombre de fois à exécuter (pour les boucles for)
<strong>Itérations</strong> : nombre de fois à exécuter (boucles for)
</li>
<li>
<strong>Collection</strong> : tableau ou objet à parcourir (pour les boucles forEach)
<strong>Collection</strong> : tableau ou objet à parcourir (boucles forEach)
</li>
<li>
<strong>Condition</strong> : expression booléenne à évaluer (boucles while/do-while)
</li>
</ul>
</Tab>
@@ -208,4 +276,4 @@ Une fois qu'une boucle est terminée, vous pouvez accéder aux résultats agrég
- **Définir des limites raisonnables** : gardez un nombre d'itérations raisonnable pour éviter des temps d'exécution longs
- **Utiliser ForEach pour les collections** : lors du traitement de tableaux ou d'objets, utilisez les boucles ForEach plutôt que les boucles For
- **Gérer les erreurs avec élégance** : envisagez d'ajouter une gestion des erreurs à l'intérieur des boucles pour des flux de travail robustes
- **Gérer les erreurs avec élégance** : envisagez d'ajouter une gestion des erreurs à l'intérieur des boucles pour des workflows robustes
@@ -0,0 +1,123 @@
---
title: Variables
---
import { Callout } from 'fumadocs-ui/components/callout'
import { Step, Steps } from 'fumadocs-ui/components/steps'
import { Image } from '@/components/ui/image'
Le bloc Variables met à jour les variables du workflow pendant l'exécution. Les variables doivent d'abord être initialisées dans la section Variables de votre workflow, puis vous pouvez utiliser ce bloc pour mettre à jour leurs valeurs pendant l'exécution de votre workflow.
<div className="flex justify-center">
<Image
src="/static/blocks/variables.png"
alt="Bloc Variables"
width={500}
height={350}
className="my-6"
/>
</div>
<Callout>
Accédez aux variables n'importe où dans votre workflow en utilisant la syntaxe `<variable.variableName>`.
</Callout>
## Aperçu
Le bloc Variables vous permet de :
<Steps>
<Step>
<strong>Mettre à jour les variables du workflow</strong> : modifier les valeurs des variables pendant l'exécution
</Step>
<Step>
<strong>Stocker des données dynamiques</strong> : capturer les sorties de blocs dans des variables
</Step>
<Step>
<strong>Maintenir l'état</strong> : suivre les compteurs, les indicateurs et les résultats intermédiaires
</Step>
</Steps>
## Comment utiliser les variables
### 1. Initialiser dans les variables du workflow
Tout d'abord, créez vos variables dans la section Variables du workflow (accessible depuis les paramètres du workflow) :
```
customerEmail = ""
retryCount = 0
currentStatus = "pending"
```
### 2. Mettre à jour avec le bloc Variables
Utilisez le bloc Variables pour mettre à jour ces valeurs pendant l'exécution :
```
customerEmail = <api.email>
retryCount = <variable.retryCount> + 1
currentStatus = "processing"
```
### 3. Accéder n'importe où
Référencez les variables dans n'importe quel bloc :
```
Agent prompt: "Send email to <variable.customerEmail>"
Condition: <variable.retryCount> < 5
API body: {"status": "<variable.currentStatus>"}
```
## Exemples de cas d'utilisation
### Compteur de boucle et état
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Scénario : suivre la progression à travers les itérations de boucle</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Initialisation dans le workflow : `itemsProcessed = 0`, `lastResult = ""`</li>
<li>La boucle itère sur les éléments</li>
<li>Dans la boucle : l'agent traite l'élément actuel</li>
<li>Dans la boucle : Variables met à jour `itemsProcessed = <variable.itemsProcessed> + 1`</li>
<li>Dans la boucle : Variables met à jour `lastResult = <agent.content>`</li>
<li>Itération suivante : accès à `<variable.lastResult>` pour comparer avec le résultat actuel</li>
</ol>
</div>
### Logique de nouvelle tentative
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Scénario : suivre les tentatives de nouvelle requête API</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Initialisation dans le workflow : `retryCount = 0`</li>
<li>Le bloc API tente une requête</li>
<li>En cas d'échec, Variables incrémente : `retryCount = <variable.retryCount> + 1`</li>
<li>La condition vérifie si `<variable.retryCount>` \< 3 pour réessayer ou échouer</li>
</ol>
</div>
### Configuration dynamique
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Scénario : stocker le contexte utilisateur pour le workflow</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Initialisation dans le workflow : `userId = ""`, `userTier = ""`</li>
<li>L'API récupère le profil utilisateur</li>
<li>Les variables stockent : `userId = <api.id>`, `userTier = <api.tier>`</li>
<li>L'agent personnalise la réponse en utilisant `<variable.userTier>`</li>
<li>L'API utilise `<variable.userId>` pour la journalisation</li>
</ol>
</div>
## Sorties
- **`<variables.assignments>`** : objet JSON avec toutes les affectations de variables de ce bloc
## Bonnes pratiques
- **Initialiser dans les paramètres du workflow** : toujours créer des variables dans la section Variables du workflow avant de les utiliser
- **Mettre à jour dynamiquement** : utiliser les blocs Variables pour mettre à jour les valeurs en fonction des sorties de blocs ou des calculs
- **Utiliser dans les boucles** : parfait pour suivre l'état à travers les itérations
- **Nommer de façon descriptive** : utiliser des noms clairs comme `currentIndex`, `totalProcessed`, ou `lastError`
+99
View File
@@ -0,0 +1,99 @@
---
title: Attente
---
import { Callout } from 'fumadocs-ui/components/callout'
import { Step, Steps } from 'fumadocs-ui/components/steps'
import { Image } from '@/components/ui/image'
Le bloc Attente met en pause votre flux de travail pendant une durée spécifiée avant de continuer vers le bloc suivant. Utilisez-le pour ajouter des délais entre les actions, respecter les limites de taux des API ou espacer les opérations.
<div className="flex justify-center">
<Image
src="/static/blocks/wait.png"
alt="Bloc d'attente"
width={500}
height={350}
className="my-6"
/>
</div>
## Aperçu
Le bloc Attente vous permet de :
<Steps>
<Step>
<strong>Ajouter des délais</strong> : mettre en pause l'exécution entre les étapes du flux de travail
</Step>
<Step>
<strong>Respecter les limites de taux</strong> : espacer les appels API pour rester dans les limites
</Step>
<Step>
<strong>Planifier des séquences</strong> : créer des flux de travail chronométrés avec des délais entre les actions
</Step>
</Steps>
## Configuration
### Durée d'attente
Saisissez la durée de mise en pause de l'exécution :
- **Entrée** : nombre positif
- **Maximum** : 600 secondes (10 minutes) ou 10 minutes
### Unité
Choisissez l'unité de temps :
- **Secondes** : pour des délais courts et précis
- **Minutes** : pour des pauses plus longues
<Callout type="info">
Les blocs d'attente peuvent être annulés en arrêtant le flux de travail. La durée d'attente maximale est de 10 minutes.
</Callout>
## Sorties
- **`<wait.waitDuration>`** : la durée d'attente en millisecondes
- **`<wait.status>`** : statut de l'attente ('waiting', 'completed', ou 'cancelled')
## Exemples de cas d'utilisation
### Limitation du taux d'API
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Scénario : rester dans les limites de taux d'API</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Le bloc API effectue la première requête</li>
<li>Le bloc Attente fait une pause de 2 secondes</li>
<li>Le bloc API effectue la deuxième requête</li>
<li>Le processus continue sans atteindre les limites de taux</li>
</ol>
</div>
### Notifications chronométrées
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Scénario : envoyer des messages de suivi</h4>
<ol className="list-decimal pl-5 text-sm">
<li>La fonction envoie l'email initial</li>
<li>Le bloc Attente fait une pause de 5 minutes</li>
<li>La fonction envoie l'email de suivi</li>
</ol>
</div>
### Retards de traitement
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">Scénario : Attente d'un système externe</h4>
<ol className="list-decimal pl-5 text-sm">
<li>Le bloc API déclenche une tâche dans un système externe</li>
<li>Le bloc d'attente fait une pause de 30 secondes</li>
<li>Le bloc API vérifie l'état d'achèvement de la tâche</li>
</ol>
</div>
## Bonnes pratiques
- **Gardez des attentes raisonnables** : utilisez l'attente pour des délais jusqu'à 10 minutes. Pour des délais plus longs, envisagez des workflows programmés
- **Surveillez le temps d'exécution** : n'oubliez pas que les attentes prolongent la durée totale du workflow
+3 -2
View File
@@ -50,7 +50,7 @@ Dans Sim, l'intégration OneDrive permet à vos agents d'interagir directement a
## Instructions d'utilisation
Intégrez OneDrive dans le flux de travail. Permet de créer, téléverser et lister des fichiers. Nécessite OAuth.
Intégrer OneDrive dans le flux de travail. Peut créer des fichiers texte et Excel, télécharger des fichiers et lister des fichiers.
## Outils
@@ -65,7 +65,8 @@ Télécharger un fichier vers OneDrive
| `fileName` | string | Oui | Le nom du fichier à télécharger |
| `file` | file | Non | Le fichier à télécharger \(binaire\) |
| `content` | string | Non | Le contenu textuel à télécharger \(si aucun fichier n'est fourni\) |
| `folderSelector` | string | Non | Sélectionner le dossier dans lequel télécharger le fichier |
| `mimeType` | string | Non | Le type MIME du fichier à créer \(par exemple, text/plain pour .txt, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet pour .xlsx\) |
| `folderSelector` | string | Non | Sélectionner le dossier où télécharger le fichier |
| `manualFolderId` | string | Non | ID de dossier saisi manuellement \(mode avancé\) |
#### Sortie
+27 -17
View File
@@ -16,7 +16,7 @@ import { Video } from '@/components/ui/video'
## 主要ブロックタイプ
Simは、AIワークフローの基本機能を処理する7つの主要ブロックタイプを提供しています:
Simは、AIワークフローの中核機能を処理する必須のブロックタイプを提供します:
### 処理ブロック
- **[エージェント](/blocks/agent)** - AIモデル(OpenAI、Anthropic、Google、ローカルモデル)とチャット
@@ -28,6 +28,10 @@ Simは、AIワークフローの基本機能を処理する7つの主要ブロ
- **[ルーター](/blocks/router)** - AIを使用してリクエストを異なるパスにインテリジェントにルーティング
- **[評価者](/blocks/evaluator)** - AIを使用してコンテンツの品質を評価・採点
### 制御フローブロック
- **[変数](/blocks/variables)** - ワークフロースコープの変数を設定・管理
- **[待機](/blocks/wait)** - 指定した時間だけワークフロー実行を一時停止
### 出力ブロック
- **[レスポンス](/blocks/response)** - ワークフローからの最終結果をフォーマットして返す
@@ -35,9 +39,9 @@ Simは、AIワークフローの基本機能を処理する7つの主要ブロ
各ブロックには3つの主要コンポーネントがあります:
**入力**:他のブロックまたはユーザー入力からブロックに入ってくるデータ
**入力**:他のブロックやユーザー入力からブロックに入ってくるデータ
**設定**:ブロックの動作を制御する設定
**出力**:他のブロックが使用するためにブロックが生成するデータ
**出力**:ブロックが生成し、他のブロックが使用するデータ
<Steps>
<Step>
@@ -47,17 +51,17 @@ Simは、AIワークフローの基本機能を処理する7つの主要ブロ
<strong>処理</strong>:ブロックは設定に従って入力を処理します
</Step>
<Step>
<strong>結果を出力</strong>:ブロックはワークフロー内の次のブロックのために出力データを生成します
<strong>結果を出力</strong>:ブロックはワークフロー内の次のブロックのための出力データを生成します
</Step>
</Steps>
## ブロックの接続
ブロックを接続することでワークフローを作成します。あるブロックの出力は、別のブロックの入力になります:
ブロックを接続してワークフローを作成します。あるブロックの出力は、別のブロックの入力になります:
- **ドラッグして接続**: 出力ポートから入力ポートへドラッグします
- **複数の接続**: 一つの出力を複数の入力に接続できます
- **分岐パス**: 一部のブロックは条件に基づいて異なるパスにルーティングできます
- **ドラッグして接続**:出力ポートから入力ポートにドラッグ
- **複数の接続**:1つの出力を複数の入力に接続可能
- **分岐パス**:一部のブロックは条件に基づいて異なるパスにルーティング可能
<div className="w-full max-w-2xl mx-auto overflow-hidden rounded-lg">
<Video src="connections.mp4" width={700} height={450} />
@@ -73,7 +77,7 @@ User Input → Agent → Function → Response
```
### 条件分岐
条件ブロックやルーターブロックを使用して異なるパスを作成します:
条件またはルーターブロックを使用して異なるパスを作成します:
```
User Input → Router → Agent A (for questions)
@@ -88,19 +92,19 @@ Agent → Evaluator → Condition → Response (if good)
→ Agent (retry if bad)
```
## ブロックの設定
## ブロック設定
各ブロックタイプには特定の設定オプションがあります:
**すべてのブロック**:
- 入力/出力の接続
- 入出力接続
- エラー処理の動作
- 実行タイムアウト設定
**AIブロック** (エージェント、ルーター、評価者):
- モデル選択(OpenAI、Anthropic、Google、ローカル)
- APIキーと認証
- 温度などのモデルパラメータ
- 温度やその他のモデルパラメータ
- システムプロンプトと指示
**ロジックブロック** (条件、関数):
@@ -109,21 +113,27 @@ Agent → Evaluator → Condition → Response (if good)
- 実行環境設定
**統合ブロック** (API、レスポンス):
- エンドポイント設定
- エンドポイント構成
- ヘッダーと認証
- リクエスト/レスポンスのフォーマット
<Cards>
<Card title="エージェントブロック" href="/blocks/agent">
AIモデルに接続し、インテリジェントな応答を作成する
AIモデルに接続し、インテリジェントな応答を作成
</Card>
<Card title="関数ブロック" href="/blocks/function">
カスタムコードを実行してデータを処理および変換する
カスタムコードを実行してデータを処理・変換
</Card>
<Card title="APIブロック" href="/blocks/api">
外部サービスやAPIと統合する
外部サービスやAPIと統合
</Card>
<Card title="条件ブロック" href="/blocks/condition">
データ評価に基づいた分岐ロジックを作成する
データ評価に基づく分岐ロジックを作成
</Card>
<Card title="変数ブロック" href="/blocks/variables">
ワークフロースコープの変数を設定・管理
</Card>
<Card title="待機ブロック" href="/blocks/wait">
指定した時間だけワークフロー実行を一時停止
</Card>
</Cards>
+84 -16
View File
@@ -9,7 +9,7 @@ import { Image } from '@/components/ui/image'
ループブロックはSimの中のコンテナブロックで、ブロックのグループを繰り返し実行することで反復的なワークフローを作成できます。ループを使用することで、ワークフロー内で反復処理が可能になります。
ループブロックは2種類の反復をサポートしています:
ループブロックは4種類の反復処理をサポートしています:
<Callout type="info">
ループブロックは他のブロックを内部に保持できるコンテナノードです。ループ内のブロックは設定に基づいて複数回実行されます。
@@ -21,13 +21,13 @@ import { Image } from '@/components/ui/image'
<Steps>
<Step>
<strong>コレクションの反復処理</strong>:配列やオブジェクトを一項目ずつ処理する
<strong>コレクションの反復処理</strong>:配列やオブジェクトを1アイテムずつ処理する
</Step>
<Step>
<strong>操作の繰り返し</strong>:ブロックを固定回数実行する
</Step>
<Step>
<strong>順次処理</strong>:順序付けられた反復でデータ変換を処理する
<strong>条件付きループ</strong>:条件が満たされている間、または満たされるまで実行を継続する
</Step>
<Step>
<strong>結果の集約</strong>:すべてのループ反復からの出力を収集する
@@ -47,16 +47,16 @@ import { Image } from '@/components/ui/image'
### ループタイプ
2種類のループから選択できます:
4種類のループから選択できます:
<Tabs items={['For Loop', 'ForEach Loop']}>
<Tabs items={['For ループ', 'ForEach ループ', 'While ループ', 'Do-While ループ']}>
<Tab>
**Forループ(反復回数)** - 固定回数実行する数値ループ:
**For ループ(反復回数)** - 固定回数実行する数値ループ:
<div className="flex justify-center">
<Image
src="/static/blocks/loop-1.png"
alt="反復回数を指定するForループ"
alt="反復回数を使用したFor ループ"
width={500}
height={400}
className="my-6"
@@ -100,6 +100,58 @@ import { Image } from '@/components/ui/image'
```
</Tab>
<Tab>
**While ループ(条件ベース)** - 条件がtrueと評価される間、実行を継続します:
<div className="flex justify-center">
<Image
src="/static/blocks/loop-3.png"
alt="条件付きWhile ループ"
width={500}
height={400}
className="my-6"
/>
</div>
特定の条件が満たされるまでループする必要がある場合に使用します。条件は各反復の**前に**チェックされます。
```
Example: While <variable.i> < 10
- Check condition → Execute if true
- Inside loop: Increment <variable.i>
- Inside loop: Variables assigns i = <variable.i> + 1
- Check condition → Execute if true
- Check condition → Exit if false
```
</Tab>
<Tab>
**Do-While ループ(条件ベース)** - 少なくとも1回実行し、その後条件がtrueの間継続します:
<div className="flex justify-center">
<Image
src="/static/blocks/loop-3.png"
alt="条件付きDo-While ループ"
width={500}
height={400}
className="my-6"
/>
</div>
少なくとも1回実行し、その後条件が満たされるまでループする必要がある場合に使用します。条件は各反復の**後に**チェックされます。
```
Example: Do-while <variable.i> < 10
- Execute blocks
- Inside loop: Increment <variable.i>
- Inside loop: Variables assigns i = <variable.i> + 1
- Check condition → Continue if true
- Check condition → Exit if false
```
</Tab>
</Tabs>
## ループの使い方
@@ -107,13 +159,13 @@ import { Image } from '@/components/ui/image'
### ループの作成
1. ツールバーからループブロックをキャンバスにドラッグします
2. ループタイプとパラメータを設定します
3. ループコンテナ内に他のブロックをドラッグします
2. ループの種類とパラメータを設定します
3. 他のブロックをループコンテナ内にドラッグします
4. 必要に応じてブロックを接続します
### 結果へのアクセス
ループが完了すると、集計された結果にアクセスできます:
ループが完了した後、集計された結果にアクセスできます:
- **`<loop.results>`**: すべてのループ反復からの結果の配列
@@ -143,12 +195,25 @@ import { Image } from '@/components/ui/image'
</ol>
</div>
### Whileループによるカウンター
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">シナリオ:カウンターベースのループでアイテムを処理する</h4>
<ol className="list-decimal pl-5 text-sm">
<li>ワークフロー変数を初期化:`i = 0`</li>
<li>条件付きWhileループ:`<variable.i>` \< 10</li>
<li>ループ内:エージェントがインデックス `<variable.i>` のアイテムを処理</li>
<li>ループ内:変数がインクリメント `i = <variable.i> + 1`</li>
<li>iが10未満である限りループは継続</li>
</ol>
</div>
## 高度な機能
### 制限事項
<Callout type="warning">
コンテナブロック(ループと並列処理)は互いに入れ子にすることができません。つまり:
コンテナブロック(ループと並列)は互いに入れ子にすることができません。つまり:
- ループブロック内に別のループブロックを配置できません
- ループブロック内に並列ブロックを配置できません
- どのコンテナブロック内にも別のコンテナブロックを配置できません
@@ -157,16 +222,16 @@ import { Image } from '@/components/ui/image'
</Callout>
<Callout type="info">
ループは並列ではなく、順次実行されます。並行実行が必要な場合は、代わりにParallelブロックを使用してください。
ループは並列ではなく、順次実行されます。同時実行が必要な場合は、代わりに並列ブロックを使用してください。
</Callout>
## 入力と出力
<Tabs items={['設定', '変数', '結果']}>
<Tabs items={['Configuration', 'Variables', 'Results']}>
<Tab>
<ul className="list-disc space-y-2 pl-6">
<li>
<strong>ループタイプ</strong>: 'for'または'forEach'から選択
<strong>ループタイプ</strong>: 'for'、'forEach'、'while'、または'doWhile'から選択
</li>
<li>
<strong>繰り返し回数</strong>: 実行する回数(forループ)
@@ -174,6 +239,9 @@ import { Image } from '@/components/ui/image'
<li>
<strong>コレクション</strong>: 反復処理する配列またはオブジェクト(forEachループ)
</li>
<li>
<strong>条件</strong>: 評価するブール式(while/do-whileループ)
</li>
</ul>
</Tab>
<Tab>
@@ -206,6 +274,6 @@ import { Image } from '@/components/ui/image'
## ベストプラクティス
- **適切な制限を設定する**: 実行時間が長くならないよう、繰り返し回数を適切に保つ
- **コレクションにはForEachを使用する**: 配列やオブジェクトを処理する場合は、Forループの代わりにForEachを使用する
- **適切な制限を設定する**: 長い実行時間を避けるため、繰り返し回数を適切に保つ
- **コレクションにはForEachを使用する**: 配列やオブジェクトを処理する場合、Forループの代わりにForEachを使用する
- **エラーを適切に処理する**: 堅牢なワークフローのために、ループ内にエラー処理を追加することを検討する
@@ -0,0 +1,123 @@
---
title: 変数
---
import { Callout } from 'fumadocs-ui/components/callout'
import { Step, Steps } from 'fumadocs-ui/components/steps'
import { Image } from '@/components/ui/image'
変数ブロックは実行中にワークフロー変数を更新します。変数はまずワークフローの変数セクションで初期化する必要があり、その後このブロックを使用してワークフロー実行中に値を更新できます。
<div className="flex justify-center">
<Image
src="/static/blocks/variables.png"
alt="変数ブロック"
width={500}
height={350}
className="my-6"
/>
</div>
<Callout>
ワークフロー内のどこからでも `<variable.variableName>` 構文を使用して変数にアクセスできます。
</Callout>
## 概要
変数ブロックでは以下のことが可能です:
<Steps>
<Step>
<strong>ワークフロー変数の更新</strong>:実行中に変数値を変更する
</Step>
<Step>
<strong>動的データの保存</strong>:ブロック出力を変数に取り込む
</Step>
<Step>
<strong>状態の維持</strong>:カウンター、フラグ、中間結果を追跡する
</Step>
</Steps>
## 変数の使用方法
### 1. ワークフロー変数での初期化
まず、ワークフローの変数セクション(ワークフロー設定からアクセス可能)で変数を作成します:
```
customerEmail = ""
retryCount = 0
currentStatus = "pending"
```
### 2. 変数ブロックでの更新
変数ブロックを使用して実行中にこれらの値を更新します:
```
customerEmail = <api.email>
retryCount = <variable.retryCount> + 1
currentStatus = "processing"
```
### 3. どこからでもアクセス
任意のブロックで変数を参照します:
```
Agent prompt: "Send email to <variable.customerEmail>"
Condition: <variable.retryCount> < 5
API body: {"status": "<variable.currentStatus>"}
```
## 使用例
### ループカウンターと状態
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">シナリオ:ループ反復の進行状況を追跡する</h4>
<ol className="list-decimal pl-5 text-sm">
<li>ワークフローで初期化:`itemsProcessed = 0`、`lastResult = ""`</li>
<li>ループがアイテムを反復処理</li>
<li>ループ内:エージェントが現在のアイテムを処理</li>
<li>ループ内:変数が `itemsProcessed = <variable.itemsProcessed> + 1` を更新</li>
<li>ループ内:変数が `lastResult = <agent.content>` を更新</li>
<li>次の反復:`<variable.lastResult>` にアクセスして現在の結果と比較</li>
</ol>
</div>
### リトライロジック
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">シナリオ:APIリトライ試行を追跡する</h4>
<ol className="list-decimal pl-5 text-sm">
<li>ワークフローで初期化:`retryCount = 0`</li>
<li>APIブロックがリクエストを試行</li>
<li>失敗した場合、変数がインクリメント:---INLINE-CODE-PLACEHOLDER-e289a5ca49f66a6001d9263f3b890a8d---</li>
<li>条件が `<variable.retryCount>` \< 3 をチェックしてリトライするか失敗するか</li>
</ol>
</div>
### 動的設定
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">シナリオ:ワークフロー用のユーザーコンテキストを保存する</h4>
<ol className="list-decimal pl-5 text-sm">
<li>ワークフローで初期化:`userId = ""`, `userTier = ""`</li>
<li>APIがユーザープロファイルを取得</li>
<li>変数が保存:`userId = <api.id>`, `userTier = <api.tier>`</li>
<li>エージェントが`<variable.userTier>`を使用してレスポンスをパーソナライズ</li>
<li>APIがログ記録に`<variable.userId>`を使用</li>
</ol>
</div>
## 出力
- **`<variables.assignments>`**:このブロックからのすべての変数割り当てを含むJSONオブジェクト
## ベストプラクティス
- **ワークフロー設定で初期化**:使用する前に必ずワークフローの変数セクションで変数を作成する
- **動的に更新**:ブロック出力や計算に基づいて値を更新するために変数ブロックを使用する
- **ループで使用**:反復処理間で状態を追跡するのに最適
- **わかりやすい名前を付ける**:`currentIndex`、`totalProcessed`、または`lastError`のような明確な名前を使用する
+99
View File
@@ -0,0 +1,99 @@
---
title: 待機
---
import { Callout } from 'fumadocs-ui/components/callout'
import { Step, Steps } from 'fumadocs-ui/components/steps'
import { Image } from '@/components/ui/image'
待機ブロックは、次のブロックに進む前に指定された時間だけワークフローを一時停止します。アクション間に遅延を追加したり、APIレート制限を尊重したり、操作の間隔を空けたりするために使用します。
<div className="flex justify-center">
<Image
src="/static/blocks/wait.png"
alt="待機ブロック"
width={500}
height={350}
className="my-6"
/>
</div>
## 概要
待機ブロックでは以下のことが可能です:
<Steps>
<Step>
<strong>時間遅延の追加</strong>:ワークフローステップ間で実行を一時停止する
</Step>
<Step>
<strong>レート制限の尊重</strong>:制限内に収まるようにAPI呼び出しの間隔を空ける
</Step>
<Step>
<strong>シーケンスのスケジュール</strong>:アクション間に遅延を持つタイムドワークフローを作成する
</Step>
</Steps>
## 設定
### 待機時間
実行を一時停止する時間を入力します:
- **入力**:正の数値
- **最大値**:600秒(10分)または10分
### 単位
時間単位を選択します:
- **秒**:短く正確な遅延のため
- **分**:より長い一時停止のため
<Callout type="info">
待機ブロックはワークフローを停止することでキャンセルできます。最大待機時間は10分です。
</Callout>
## 出力
- **`<wait.waitDuration>`**: ミリ秒単位の待機時間
- **`<wait.status>`**: 待機のステータス('waiting'、'completed'、または'cancelled')
## 使用例
### APIレート制限
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">シナリオ:APIレート制限内に収める</h4>
<ol className="list-decimal pl-5 text-sm">
<li>APIブロックが最初のリクエストを行う</li>
<li>待機ブロックが2秒間一時停止する</li>
<li>APIブロックが2番目のリクエストを行う</li>
<li>レート制限に達することなくプロセスが続行される</li>
</ol>
</div>
### タイムド通知
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">シナリオ:フォローアップメッセージを送信する</h4>
<ol className="list-decimal pl-5 text-sm">
<li>関数が初期メールを送信する</li>
<li>待機ブロックが5分間一時停止する</li>
<li>関数がフォローアップメールを送信する</li>
</ol>
</div>
### 処理の遅延
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">シナリオ:外部システムを待機</h4>
<ol className="list-decimal pl-5 text-sm">
<li>APIブロックが外部システムでジョブをトリガー</li>
<li>待機ブロックが30秒間一時停止</li>
<li>APIブロックがジョブの完了状態を確認</li>
</ol>
</div>
## ベストプラクティス
- **待機時間を適切に保つ**:最大10分までの遅延には待機を使用。より長い遅延にはスケジュールされたワークフローを検討
- **実行時間を監視する**:待機によってワークフローの合計所要時間が延長されることに注意
+4 -3
View File
@@ -50,7 +50,7 @@ Simでは、OneDrive統合によりエージェントがクラウドストレー
## 使用方法
OneDriveをワークフローに統合します。ファイルの作成、アップロード、一覧表示が可能です。OAuthが必要です。
OneDriveをワークフローに統合します。テキストファイルやExcelファイルの作成、ファイルのアップロード、ファイルの一覧表示が可能です。
## ツール
@@ -60,11 +60,12 @@ OneDriveにファイルをアップロードする
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| パラメータ | 種類 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `fileName` | string | はい | アップロードするファイルの名前 |
| `file` | file | いいえ | アップロードするファイル(バイナリ) |
| `content` | string | いいえ | アップロードするテキストコンテンツ(ファイルが提供されていない場合) |
| `content` | string | いいえ | アップロードするテキスト内容(ファイルが提供されていない場合) |
| `mimeType` | string | いいえ | 作成するファイルのMIMEタイプ(例:.txtの場合はtext/plain、.xlsxの場合はapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheet) |
| `folderSelector` | string | いいえ | ファイルをアップロードするフォルダを選択 |
| `manualFolderId` | string | いいえ | 手動で入力したフォルダID(高度なモード) |
+26 -16
View File
@@ -16,7 +16,7 @@ import { Video } from '@/components/ui/video'
## 核心模块类型
Sim 提供了七种核心模块类型,用于处理 AI 工作流的基本功能:
Sim 提供了处理 AI 工作流核心功能的基本模块类型:
### 处理模块
- **[Agent](/blocks/agent)** - 与 AI 模型(OpenAI、Anthropic、Google、本地模型)聊天
@@ -28,16 +28,20 @@ Sim 提供了七种核心模块类型,用于处理 AI 工作流的基本功能
- **[Router](/blocks/router)** - 使用 AI 智能路由请求到不同路径
- **[Evaluator](/blocks/evaluator)** - 使用 AI 评分并评估内容质量
### 输出模块
- **[Response](/blocks/response)** - 格式化并返回工作流的最终结果
### 控制流模块
- **[变量](/blocks/variables)** - 设置和管理工作流范围内的变量
- **[等待](/blocks/wait)** - 暂停工作流执行指定的时间延迟
## 模块如何工作
### 输出模块
- **[响应](/blocks/response)** - 格式化并返回工作流的最终结果
## 模块的工作原理
每个模块有三个主要组成部分:
**输入**:从其他模块或用户输入接收的数据
**配置**:控制模块行为的设置
**输出**:模块为其他模块使用而生成的数据
**输出**:模块为其他模块生成的数据
<Steps>
<Step>
@@ -66,14 +70,14 @@ Sim 提供了七种核心模块类型,用于处理 AI 工作流的基本功能
## 常见模式
### 顺序处理
将模块按链式连接,每个模块处理前一个模块的输出:
将模块连接成链,每个模块处理前一个模块的输出:
```
User Input → Agent → Function → Response
```
### 条件分支
使用条件模块或路由模块创建不同的路径:
使用条件或路由模块创建不同的路径:
```
User Input → Router → Agent A (for questions)
@@ -81,7 +85,7 @@ User Input → Router → Agent A (for questions)
```
### 质量控制
使用评估模块评估和过滤输出:
使用评估模块评估和筛选输出:
```
Agent → Evaluator → Condition → Response (if good)
@@ -97,33 +101,39 @@ Agent → Evaluator → Condition → Response (if good)
- 错误处理行为
- 执行超时设置
**AI 模块**(代理、路由、评估):
**AI 模块**(Agent、Router、Evaluator):
- 模型选择(OpenAI、Anthropic、Google、本地)
- API 密钥和认证
- API 密钥和身份验证
- 温度及其他模型参数
- 系统提示和指令
**逻辑模块**(条件、函数):
**逻辑模块**(Condition、Function):
- 自定义表达式或代码
- 变量引用
- 执行环境设置
**集成模块**(API、响应):
**集成模块**(API、Response):
- 端点配置
- 请求头和认证
- 请求头和身份验证
- 请求/响应格式化
<Cards>
<Card title="代理模块" href="/blocks/agent">
<Card title="Agent 模块" href="/blocks/agent">
连接 AI 模型并创建智能响应
</Card>
<Card title="函数模块" href="/blocks/function">
<Card title="Function 模块" href="/blocks/function">
运行自定义代码以处理和转换数据
</Card>
<Card title="API 模块" href="/blocks/api">
与外部服务和 API 集成
</Card>
<Card title="条件模块" href="/blocks/condition">
<Card title="Condition 模块" href="/blocks/condition">
基于数据评估创建分支逻辑
</Card>
<Card title="Variables 模块" href="/blocks/variables">
设置和管理工作流范围的变量
</Card>
<Card title="Wait 模块" href="/blocks/wait">
暂停工作流执行指定的时间延迟
</Card>
</Cards>
+87 -19
View File
@@ -9,7 +9,7 @@ import { Image } from '@/components/ui/image'
循环块是 Sim 中的一个容器块,它允许您通过重复执行一组块来创建迭代工作流。循环使您的工作流能够进行迭代处理。
循环块支持两种类型的迭代:
循环块支持四种类型的迭代:
<Callout type="info">
循环块是容器节点,可以在其中包含其他块。根据您的配置,循环中的块将多次执行。
@@ -21,13 +21,13 @@ import { Image } from '@/components/ui/image'
<Steps>
<Step>
<strong>迭代集合</strong>:逐项处理数组或对象
<strong>遍历集合</strong>:逐一处理数组或对象中的项目
</Step>
<Step>
<strong>重复操作</strong>:执行固定次数的块
<strong>重复操作</strong>:执行块固定次数
</Step>
<Step>
<strong>顺序处理</strong>:按顺序迭代处理数据转换
<strong>基于条件循环</strong>:在满足或直到满足条件时继续执行
</Step>
<Step>
<strong>汇总结果</strong>:收集所有循环迭代的输出
@@ -47,23 +47,23 @@ import { Image } from '@/components/ui/image'
### 循环类型
选择两种循环类型之一:
选择四种循环类型之一:
<Tabs items={['For 循环', 'ForEach 循环']}>
<Tabs items={['For Loop', 'ForEach Loop', 'While Loop', 'Do-While Loop']}>
<Tab>
**For 循环(迭代次数)** - 一种执行固定次数的数字循环:
**For 循环(迭代)** - 一个执行固定次数的数字循环:
<div className="flex justify-center">
<Image
src="/static/blocks/loop-1.png"
alt="具有迭代次数的 For 循环"
alt="带有迭代的 For 循环"
width={500}
height={400}
className="my-6"
/>
</div>
当您需要重复操作特定次数时使用此选项。
当需要重复操作特定次数时使用此方法。
```
@@ -100,11 +100,63 @@ import { Image } from '@/components/ui/image'
```
</Tab>
<Tab>
**While 循环(基于条件)** - 当条件为真时继续执行:
<div className="flex justify-center">
<Image
src="/static/blocks/loop-3.png"
alt="带有条件的 While 循环"
width={500}
height={400}
className="my-6"
/>
</div>
当需要循环直到满足特定条件时使用此方法。条件在每次迭代**之前**检查。
```
Example: While <variable.i> < 10
- Check condition → Execute if true
- Inside loop: Increment <variable.i>
- Inside loop: Variables assigns i = <variable.i> + 1
- Check condition → Execute if true
- Check condition → Exit if false
```
</Tab>
<Tab>
**Do-While 循环(基于条件)** - 至少执行一次,然后在条件为真时继续:
<div className="flex justify-center">
<Image
src="/static/blocks/loop-3.png"
alt="带有条件的 Do-While 循环"
width={500}
height={400}
className="my-6"
/>
</div>
当需要至少执行一次,然后循环直到满足条件时使用此方法。条件在每次迭代**之后**检查。
```
Example: Do-while <variable.i> < 10
- Execute blocks
- Inside loop: Increment <variable.i>
- Inside loop: Variables assigns i = <variable.i> + 1
- Check condition → Continue if true
- Check condition → Exit if false
```
</Tab>
</Tabs>
## 如何使用循环
### 创建循环
### 创建一个循环
1. 从工具栏中拖动一个循环块到画布上
2. 配置循环类型和参数
@@ -113,9 +165,9 @@ import { Image } from '@/components/ui/image'
### 访问结果
循环完成后,您可以访问聚合结果:
循环完成后,您可以访问汇总结果:
- **`<loop.results>`**:来自所有循环迭代的结果数组
- **`<loop.results>`**:所有循环迭代的结果数组
## 示例用例
@@ -143,21 +195,34 @@ import { Image } from '@/components/ui/image'
</ol>
</div>
### 使用 While 循环的计数器
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">场景:使用基于计数器的循环处理项目</h4>
<ol className="list-decimal pl-5 text-sm">
<li>初始化工作流变量:`i = 0`</li>
<li>While 循环条件:`<variable.i>` \< 10</li>
<li>循环内:代理处理索引为 `<variable.i>` 的项目</li>
<li>循环内:变量递增 `i = <variable.i> + 1`</li>
<li>循环在 i 小于 10 时继续</li>
</ol>
</div>
## 高级功能
### 限制
<Callout type="warning">
容器块(循环和并行)不能嵌套在彼此内部。这意味着:
- 您不能将一个循环块放入另一个循环块中
- 您不能将一个并行块放入循环块中
- 您不能将循环块放入另一个循环块中
- 您不能将并行块放入循环块中
- 您不能将任何容器块放入另一个容器块中
如果需要多维迭代,请考虑重构您的工作流程以使用顺序循环或分阶段处理数据。
如果您需要多维迭代,请考虑重构您的工作流以使用顺序循环或分阶段处理数据。
</Callout>
<Callout type="info">
循环是按顺序执行的,而不是并行执行。如果需要并发执行,请改用 Parallel 块。
循环是按顺序执行的,而不是并行执行。如果您需要并发执行,请改用并行块。
</Callout>
## 输入和输出
@@ -166,7 +231,7 @@ import { Image } from '@/components/ui/image'
<Tab>
<ul className="list-disc space-y-2 pl-6">
<li>
<strong>循环类型</strong>:选择 'for' 或 'forEach'
<strong>循环类型</strong>:选择 'for'、'forEach'、'while' 或 'doWhile'
</li>
<li>
<strong>迭代次数</strong>:执行的次数(适用于 for 循环)
@@ -174,6 +239,9 @@ import { Image } from '@/components/ui/image'
<li>
<strong>集合</strong>:要迭代的数组或对象(适用于 forEach 循环)
</li>
<li>
<strong>条件</strong>:要评估的布尔表达式(适用于 while/do-while 循环)
</li>
</ul>
</Tab>
<Tab>
@@ -198,7 +266,7 @@ import { Image } from '@/components/ui/image'
<strong>结构</strong>:结果保持迭代顺序
</li>
<li>
<strong>访问</strong>:可在循环后的块中使用
<strong>访问</strong>:在循环后的块中可用
</li>
</ul>
</Tab>
@@ -206,6 +274,6 @@ import { Image } from '@/components/ui/image'
## 最佳实践
- **设置合理的限制**:保持迭代次数在合理范围内,以避免长时间执行
- **设置合理的限制**:保持迭代次数在合理范围内,以避免长时间的执行
- **对集合使用 ForEach**:在处理数组或对象时,使用 ForEach 而不是 For 循环
- **优雅地处理错误**:考虑在循环中添加错误处理,以实现更健壮的工作流
@@ -0,0 +1,123 @@
---
title: 变量
---
import { Callout } from 'fumadocs-ui/components/callout'
import { Step, Steps } from 'fumadocs-ui/components/steps'
import { Image } from '@/components/ui/image'
变量模块在执行过程中更新工作流变量。变量必须首先在工作流的变量部分中初始化,然后您可以使用此模块在工作流运行时更新其值。
<div className="flex justify-center">
<Image
src="/static/blocks/variables.png"
alt="变量模块"
width={500}
height={350}
className="my-6"
/>
</div>
<Callout>
在工作流中的任何地方使用 `<variable.variableName>` 语法访问变量。
</Callout>
## 概述
变量模块使您能够:
<Steps>
<Step>
<strong>更新工作流变量</strong>:在执行过程中更改变量值
</Step>
<Step>
<strong>存储动态数据</strong>:将模块输出捕获到变量中
</Step>
<Step>
<strong>维护状态</strong>:跟踪计数器、标志和中间结果
</Step>
</Steps>
## 如何使用变量
### 1. 在工作流变量中初始化
首先,在工作流的变量部分(可通过工作流设置访问)中创建您的变量:
```
customerEmail = ""
retryCount = 0
currentStatus = "pending"
```
### 2. 使用变量模块更新
使用变量模块在执行过程中更新这些值:
```
customerEmail = <api.email>
retryCount = <variable.retryCount> + 1
currentStatus = "processing"
```
### 3. 随处访问
在任何模块中引用变量:
```
Agent prompt: "Send email to <variable.customerEmail>"
Condition: <variable.retryCount> < 5
API body: {"status": "<variable.currentStatus>"}
```
## 示例用例
### 循环计数器和状态
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">场景:跟踪循环迭代的进度</h4>
<ol className="list-decimal pl-5 text-sm">
<li>在工作流中初始化:`itemsProcessed = 0`, `lastResult = ""`</li>
<li>循环迭代项目</li>
<li>在循环内:代理处理当前项目</li>
<li>在循环内:变量模块更新 `itemsProcessed = <variable.itemsProcessed> + 1`</li>
<li>在循环内:变量模块更新 `lastResult = <agent.content>`</li>
<li>下一次迭代:访问 `<variable.lastResult>` 与当前结果进行比较</li>
</ol>
</div>
### 重试逻辑
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">场景:跟踪 API 重试尝试</h4>
<ol className="list-decimal pl-5 text-sm">
<li>在工作流中初始化:`retryCount = 0`</li>
<li>API 模块尝试请求</li>
<li>如果失败,变量递增:`retryCount = <variable.retryCount> + 1`</li>
<li>条件检查 `<variable.retryCount>` \< 3 以重试或失败</li>
</ol>
</div>
### 动态配置
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">场景:为工作流存储用户上下文</h4>
<ol className="list-decimal pl-5 text-sm">
<li>在工作流中初始化:`userId = ""`,`userTier = ""`</li>
<li>API 获取用户资料</li>
<li>变量存储:`userId = <api.id>`,`userTier = <api.tier>`</li>
<li>代理使用 `<variable.userTier>` 个性化响应</li>
<li>API 使用 `<variable.userId>` 进行日志记录</li>
</ol>
</div>
## 输出
- **`<variables.assignments>`**:包含此块中所有变量分配的 JSON 对象
## 最佳实践
- **在工作流设置中初始化**:在使用变量之前,始终在工作流的变量部分创建它们
- **动态更新**:使用变量块根据块输出或计算结果更新值
- **在循环中使用**:非常适合在迭代中跟踪状态
- **命名清晰**:使用明确的名称,例如 `currentIndex`,`totalProcessed`,或 `lastError`
+99
View File
@@ -0,0 +1,99 @@
---
title: 等待
---
import { Callout } from 'fumadocs-ui/components/callout'
import { Step, Steps } from 'fumadocs-ui/components/steps'
import { Image } from '@/components/ui/image'
等待模块会在继续执行下一个模块之前暂停您的工作流一段指定的时间。使用它可以在操作之间添加延迟、遵守 API 速率限制或间隔操作。
<div className="flex justify-center">
<Image
src="/static/blocks/wait.png"
alt="等待模块"
width={500}
height={350}
className="my-6"
/>
</div>
## 概述
等待模块可以让您:
<Steps>
<Step>
<strong>添加时间延迟</strong>:在工作流步骤之间暂停执行
</Step>
<Step>
<strong>遵守速率限制</strong>:间隔 API 调用以保持在限制范围内
</Step>
<Step>
<strong>安排序列</strong>:创建带有操作间延迟的定时工作流
</Step>
</Steps>
## 配置
### 等待时间
输入暂停执行的时长:
- **输入**:正数
- **最大值**:600 秒(10 分钟)或 10 分钟
### 单位
选择时间单位:
- **秒**:用于短时间、精确的延迟
- **分钟**:用于较长时间的暂停
<Callout type="info">
等待模块可以通过停止工作流来取消。最大等待时间为 10 分钟。
</Callout>
## 输出
- **`<wait.waitDuration>`**:等待时长(以毫秒为单位)
- **`<wait.status>`**:等待状态(“等待中”、“已完成”或“已取消”)
## 示例用例
### API 速率限制
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">场景:保持在 API 速率限制范围内</h4>
<ol className="list-decimal pl-5 text-sm">
<li>API 模块发出第一个请求</li>
<li>等待模块暂停 2 秒</li>
<li>API 模块发出第二个请求</li>
<li>流程继续而不会触发速率限制</li>
</ol>
</div>
### 定时通知
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">场景:发送后续消息</h4>
<ol className="list-decimal pl-5 text-sm">
<li>函数发送初始电子邮件</li>
<li>等待模块暂停 5 分钟</li>
<li>函数发送后续电子邮件</li>
</ol>
</div>
### 处理延迟
<div className="mb-4 rounded-md border p-4">
<h4 className="font-medium">场景:等待外部系统</h4>
<ol className="list-decimal pl-5 text-sm">
<li>API 块触发外部系统中的作业</li>
<li>等待块暂停 30 秒</li>
<li>API 块检查作业完成状态</li>
</ol>
</div>
## 最佳实践
- **保持合理的等待时间**:使用等待块处理最长 10 分钟的延迟。对于更长的延迟,请考虑使用计划的工作流
- **监控执行时间**:请记住,等待会延长工作流的总持续时间
+3 -2
View File
@@ -50,7 +50,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
## 使用说明
将 OneDrive 集成到工作流程中。可以创建、上传和列出文件。需要 OAuth。
将 OneDrive 集成到工作流程中。可以创建文本和 Excel 文件、上传文件以及列出文件。
## 工具
@@ -62,9 +62,10 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `fileName` | string | 是 | 要上传文件的名称 |
| `fileName` | string | 是 | 要上传的文件名称 |
| `file` | file | 否 | 要上传的文件 \(二进制\) |
| `content` | string | 否 | 要上传的文本内容 \(如果未提供文件\) |
| `mimeType` | string | 否 | 要创建文件的 MIME 类型 \(例如,.txt 的 text/plain,.xlsx 的 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\) |
| `folderSelector` | string | 否 | 选择上传文件的文件夹 |
| `manualFolderId` | string | 否 | 手动输入的文件夹 ID \(高级模式\) |
+112 -50
View File
@@ -1153,12 +1153,12 @@ checksums:
content/5: bcd65b6873b071b2831821ae39804ba9
content/6: 517dd4ba787691643cb3e929ca662fa9
content/7: 821e6394b0a953e2b0842b04ae8f3105
content/8: b012f506c5556814c599055fa2e85d74
content/8: 614f192a01b39eb448d70a6145488cbb
content/9: 9c8aa3f09c9b2bd50ea4cdff3598ea4e
content/10: 6df7e096bafa5efda818db1ab65841fd
content/11: 646990da68ff77ca02dd172f830f12f0
content/12: 371d0e46b4bd2c23f559b8bc112f6955
content/13: 6979ff1359b3ede098d71e35fabd6a05
content/13: 9e3bb4c4c9137273d566b7fcecf9c709
content/14: bcadfc362b69078beee0088e5936c98b
content/15: c25b7418fd96b560b79af512cba4e7f1
content/16: 3d44fa28ed12c73c2c9178b8570e516d
@@ -3336,41 +3336,47 @@ checksums:
meta/title: da9b3a204aa0532ac89b6fc018a6088f
content/0: d091aba168f368dcc4e9073c000f47af
content/1: 6f23aafaba6973476878aad143531249
content/2: 66beea36102c469e9a4b0c4f6df2ef06
content/2: dbfc415f822ff29c7fba2b44828aa6e8
content/3: 72ec5e4349dd8b9190b3f5ba8c70b87f
content/4: 5e26527ccf8fddebe14c951e6c950b48
content/5: 8366332b5a0bc44ac3468318d0c047ae
content/6: 1f1cf237845492bda14417ce584f0cd6
content/6: 1dbfd0c9c8eb5043cfbb6201adbe8a26
content/7: ad8638a3473c909dbcb1e1d9f4f26381
content/8: 1037c579ddeb82c7e130d91ae0885aae
content/9: 9a191f11cf167e5ed4019265d08fd96f
content/10: b2e603592f9c01f26bd7bd067f52ccd5
content/11: 0d5676ac9c717c7b639058f110765766
content/12: f8c89a2a3c5cc99e36a1a9917a9c0a0a
content/13: e413d471a8836ac90cc1501f83ec6240
content/12: 361b9fc0f6dbf7a6700a12da76abb1d7
content/13: 015cebc2b43a12e676f3af592f6a6285
content/14: 9d70f66d1a9451ed3eca4a736f16a25b
content/15: 0a512adcf936e341d82edf37bdabaf67
content/16: 84099eb0c2a3d63fbce666ed70737c1a
content/17: 3304a33dfb626c6e2267c062e8956a9d
content/18: b55a33d2662babda7b0601dce90d70c3
content/19: 2b707960797476b5fa8e135995c6b92c
content/20: 823ce3d44e90732027dceefe2a5c5633
content/21: 371db0900e0875577984b49f0c5e3214
content/22: fbcfa72f8b5538ebc7f908ca03060f77
content/23: e16b2a72aab3de182650bb61af16e849
content/24: 9c2f91f89a914bf4661512275e461104
content/25: 0b021f37144b855e8d728de216ae09ab
content/26: 84fc28dd289f65cf73402d5d2fbf7d94
content/27: fc603cd3f47e4aec4125adcc53807dca
content/28: c674375bad4c2cffb3667da3aa8ec8a6
content/29: 3bd6888cdd2b4cef832b5acd5f89c1c5
content/30: 4f3a8d797101437e2055b5acdf203e8c
content/31: 9116dbdefb76beb5ec1d070bc3c3215d
content/32: bcd2d150d82ba8c183824472f6a55dd5
content/33: d72903dda50a36b12ec050a06ef23a1b
content/34: 5c06231162da4192c80ea9b118bda441
content/35: b2a4a0c279f47d58a2456f25a1e1c6f9
content/36: b5f5c14d7cbc9345dbf969cfdbf32b4f
content/17: ac9cd91daa3c1394b1cbb566e4bf9424
content/18: 395c4ae0f314e84860c80f05cd46417f
content/19: b2626759e544397209c078238b43a040
content/20: 04593f5a99891adb9e221b1f6909b920
content/21: 3304a33dfb626c6e2267c062e8956a9d
content/22: b55a33d2662babda7b0601dce90d70c3
content/23: 2b707960797476b5fa8e135995c6b92c
content/24: 823ce3d44e90732027dceefe2a5c5633
content/25: 371db0900e0875577984b49f0c5e3214
content/26: fbcfa72f8b5538ebc7f908ca03060f77
content/27: e16b2a72aab3de182650bb61af16e849
content/28: 9c2f91f89a914bf4661512275e461104
content/29: 0b021f37144b855e8d728de216ae09ab
content/30: 84fc28dd289f65cf73402d5d2fbf7d94
content/31: fc603cd3f47e4aec4125adcc53807dca
content/32: c674375bad4c2cffb3667da3aa8ec8a6
content/33: 7eefc40faa6a579e65f9435b45a8b28b
content/34: 243cb6175abb075290231b0f7dcddc72
content/35: 3bd6888cdd2b4cef832b5acd5f89c1c5
content/36: 4f3a8d797101437e2055b5acdf203e8c
content/37: 9116dbdefb76beb5ec1d070bc3c3215d
content/38: bcd2d150d82ba8c183824472f6a55dd5
content/39: d72903dda50a36b12ec050a06ef23a1b
content/40: 14aeb85bcaca9285bad1550f247d6db0
content/41: b2a4a0c279f47d58a2456f25a1e1c6f9
content/42: b5f5c14d7cbc9345dbf969cfdbf32b4f
7974f994606f20da7b037a31b5524f1a:
meta/title: 30c54e4dc4ce599b87d94be34a8617f5
meta/description: 6dfb33b1ef65f07a4668924d92ddae05
@@ -3378,32 +3384,33 @@ checksums:
content/1: b07b4d76205aecd961d26b8011680922
content/2: 4ac7e8c7573e5c90718d3b34bb0ab576
content/3: 5e6cc42bd620144cd715874334f32a60
content/4: cb9e81c1aa31b320ef00da8c70963669
content/4: 035dc0050a36815fa0f618162714c82f
content/5: 3dc06522a36a692ad4c60610e5315b40
content/6: 6332edca4ab88324a894dcbad3c3916f
content/7: fb61b15efd051d3593b47bc722467e5b
content/8: 30a8dc0a6418f9a249ccce582b4f0055
content/9: 650c42ca4d4408057ddc7eec121c844c
content/10: 87905d7f320e3e1f3e40042a5d8d6a4a
content/11: d434857c136b47cfca096760863fd480
content/12: de63e1da975a115ba3e1398bbad4763d
content/13: ac589c052d06d2177fb4586115a5fb45
content/14: 4e1fec28b8218c6a7edcc9be4113ff23
content/15: 4ac7e8c7573e5c90718d3b34bb0ab576
content/16: 499c18b2d417e5b3817cbebb70252433
content/17: b86916709d15285f9a1778621fb6ca77
content/18: b2a3d56b45454f660662aa17b36c6de8
content/19: a13da4a942222c7a35dc776d5ee1a7fe
content/20: ea7bfdec25c4fe41f76f4d5bce1e8411
content/21: 6feca454fe6e8f9cd06d4949271107dd
content/22: 39658e3ca9692e995d6539f09d454a7d
content/23: ac5b61b9b2833847096f3cee07f0ae59
content/24: 440a308d872dc0278b7a8c6301dd7023
content/25: 73c5b117f6c11c927cfd4597cf16ed1e
content/26: 3ea122283f55d43dcc0d315a345b41c8
content/27: bee19e2f048432154a31dbc202a33355
content/28: 26313cad0f9c05314cacee0eb170b03a
content/29: 7918b3b8e62ed0af8b178b420b683ced
content/7: 0878e8ad6d07c0f6f77c7c5071f383c3
content/8: fb61b15efd051d3593b47bc722467e5b
content/9: 30a8dc0a6418f9a249ccce582b4f0055
content/10: 650c42ca4d4408057ddc7eec121c844c
content/11: 87905d7f320e3e1f3e40042a5d8d6a4a
content/12: d434857c136b47cfca096760863fd480
content/13: de63e1da975a115ba3e1398bbad4763d
content/14: ac589c052d06d2177fb4586115a5fb45
content/15: 4e1fec28b8218c6a7edcc9be4113ff23
content/16: 4ac7e8c7573e5c90718d3b34bb0ab576
content/17: 499c18b2d417e5b3817cbebb70252433
content/18: b86916709d15285f9a1778621fb6ca77
content/19: b2a3d56b45454f660662aa17b36c6de8
content/20: a13da4a942222c7a35dc776d5ee1a7fe
content/21: ea7bfdec25c4fe41f76f4d5bce1e8411
content/22: 6feca454fe6e8f9cd06d4949271107dd
content/23: 39658e3ca9692e995d6539f09d454a7d
content/24: ac5b61b9b2833847096f3cee07f0ae59
content/25: 440a308d872dc0278b7a8c6301dd7023
content/26: 73c5b117f6c11c927cfd4597cf16ed1e
content/27: 3ea122283f55d43dcc0d315a345b41c8
content/28: bee19e2f048432154a31dbc202a33355
content/29: 26313cad0f9c05314cacee0eb170b03a
content/30: 2cc1bd906a9963c622182b63962e68d2
97f536e153f08352d6e8fe5d5160b471:
meta/title: 78f81382850e1c3bb6a3b404c55d3dc2
content/0: d091aba168f368dcc4e9073c000f47af
@@ -4404,3 +4411,58 @@ checksums:
content/38: 4fe4260da2f137679ce2fa42cffcf56a
content/39: b3f310d5ef115bea5a8b75bf25d7ea9a
content/40: 89bdbd886b24f2aaec635a2b4119660a
7442fe5651739568ceae8717ccd19c97:
meta/title: 014d18ade977bf08d75b995076596708
content/0: 565c20898ed207b9d41acb879bfe0e7e
content/1: b0771df06e1e3ec4cc1a8a611267c18d
content/2: 1e69e6e8038366d33134e5ed47e4ace9
content/3: 5e26527ccf8fddebe14c951e6c950b48
content/4: b1967652ccc7d01200491361a07d3a57
content/5: 0a2402c612cd7fd8fe5a6f6593de2781
content/6: 0441638444240cd20a6c69ea1d3afbb1
content/7: 4b7f6428e660f075365eef024e669367
content/8: 0dd57639f82640542a1de91850f7f4b4
content/9: 97f7bae15897e85fd9b4d376906e41f1
content/10: 4809730d95a4082452eacf68491c5ac9
content/11: 57aa42a75bed4f16b92cfefb46c70a6f
content/12: 987932038f4e9442bd89f0f8ed3c5319
content/13: 3efb251bb666cf27cbafe4de2a14fc01
content/14: 9c2f91f89a914bf4661512275e461104
content/15: e7b5a54669c71394370e3ef03dffbc1b
content/16: abd4a3e02b972784acfbecc6055ff8ac
content/17: c2331652cdff070a92265c88a6b2d106
content/18: a2d992c919482cd0519812c5a5d09d89
content/19: 7c8026ddc12b76aa3da2c295ba44bcbf
content/20: 23a3541e85451a0e49f4ae6e950d8660
content/21: b2a4a0c279f47d58a2456f25a1e1c6f9
content/22: 83290b8ac463358705cec69c7d987a29
6e1791636125a4985d9ca95dd8a07740:
meta/title: ffd3eec5497af36d7b4e4185bad1313a
content/0: 565c20898ed207b9d41acb879bfe0e7e
content/1: 1cfca41a0c1aa4715e6c0f64fe205066
content/2: 19e8fbb1cbc4f5a53dd7b023fbbbf4f5
content/3: ed7ad7d82efc34f46da16b015a037d9e
content/4: 5e26527ccf8fddebe14c951e6c950b48
content/5: 59f027061416ba416e003ad385992d66
content/6: d8e0bd79b8e940e24b380a53f66cc67b
content/7: f4f20249ebc3b92bab44dafcfb350010
content/8: 40825cb95c0deb46172afbd3b0a410bf
content/9: b7d4a2fb7d38059bb4b1ce277eee6ca2
content/10: f89e1c2b5480f2adaa63f81d821d196f
content/11: f6b47588c4c28dbaf901f270c39dde9b
content/12: f0a22a97c5d870dc8ec85a03c1fccd19
content/13: 5e821ef1dc069c976ff6608848636651
content/14: 4f114c2449c678a13307a1e19c01c790
content/15: fd319abccf09a7030255028ed088fd61
content/16: 998443546a4d71afb8c4cb4944e6da72
content/17: 9c2f91f89a914bf4661512275e461104
content/18: f5a13e891d63bf2380fd1e40ff6f15e3
content/19: 49b3bf3cb8439c8dfd9db5d2d0d2d7a0
content/20: 36c90f0c08589bb2713dff659fa83800
content/21: c176302bc5537499dd94913761afd457
content/22: 8789d2cb14735e9d3d4d9454c2284ddc
content/23: 24b5b45bb497d609e275734955be3cbc
content/24: 987932038f4e9442bd89f0f8ed3c5319
content/25: bfd457397ec2c8033475c7c7a89a4d5d
content/26: b2a4a0c279f47d58a2456f25a1e1c6f9
content/27: 7e48b5958215f904462276e31cb8cc10