@@ -7,10 +7,10 @@ import { Card, Cards } from 'fumadocs-ui/components/card'
77import { Step , Steps } from ' fumadocs-ui/components/steps'
88import { Tab , Tabs } from ' fumadocs-ui/components/tabs'
99
10- Das offizielle Python SDK für Sim ermöglicht es Ihnen, Workflows programmatisch aus Ihren Python-Anwendungen mithilfe des offiziellen Python SDKs auszuführen.
10+ Das offizielle Python SDK für Sim ermöglicht es Ihnen, Workflows programmatisch aus Ihren Python-Anwendungen heraus mit dem offiziellen Python SDK auszuführen.
1111
1212<Callout type = " info" >
13- Das Python SDK unterstützt Python 3.8+ mit asynchroner Ausführungsunterstützung , automatischer Ratenbegrenzung mit exponentiellem Backoff und Nutzungsverfolgung.
13+ Das Python SDK unterstützt Python 3.8+ mit Unterstützung für asynchrone Ausführung , automatischer Ratenbegrenzung mit exponentiellem Backoff und Nutzungsverfolgung.
1414</Callout >
1515
1616## Installation
@@ -75,16 +75,16 @@ result = client.execute_workflow(
7575- ` input_data ` (dict, optional): Eingabedaten, die an den Workflow übergeben werden
7676- ` timeout ` (float, optional): Timeout in Sekunden (Standard: 30.0)
7777- ` stream ` (bool, optional): Streaming-Antworten aktivieren (Standard: False)
78- - ` selected_outputs ` (list[ str] , optional): Block-Ausgaben, die im ` blockName.attribute ` Format gestreamt werden sollen (z.B. ` ["agent1.content"] ` )
78+ - ` selected_outputs ` (list[ str] , optional): Block-Ausgaben zum Streamen im Format ` blockName.attribute ` (z. B. ` ["agent1.content"] ` )
7979- ` async_execution ` (bool, optional): Asynchron ausführen (Standard: False)
8080
81- ** Rückgabe :** ` WorkflowExecutionResult | AsyncExecutionResult `
81+ ** Rückgabewert :** ` WorkflowExecutionResult | AsyncExecutionResult `
8282
83- Wenn ` async_execution=True ` , wird sofort mit einer Task-ID zum Abfragen zurückgegeben. Andernfalls wird auf den Abschluss gewartet.
83+ Wenn ` async_execution=True ` , wird sofort mit einer Task-ID zum Polling zurückgegeben. Andernfalls wird auf die Fertigstellung gewartet.
8484
8585##### get_workflow_status()
8686
87- Den Status eines Workflows abrufen (Bereitstellungsstatus usw.).
87+ Ruft den Status eines Workflows ab (Deployment-Status usw.).
8888
8989``` python
9090status = client.get_workflow_status(" workflow-id" )
@@ -98,7 +98,7 @@ print("Is deployed:", status.is_deployed)
9898
9999##### validate_workflow()
100100
101- Überprüfen , ob ein Workflow für die Ausführung bereit ist.
101+ Überprüft , ob ein Workflow zur Ausführung bereit ist.
102102
103103``` python
104104is_ready = client.validate_workflow(" workflow-id" )
@@ -114,7 +114,7 @@ if is_ready:
114114
115115##### get_job_status()
116116
117- Den Status einer asynchronen Job-Ausführung abrufen .
117+ Ruft den Status einer asynchronen Job-Ausführung ab .
118118
119119``` python
120120status = client.get_job_status(" task-id-from-async-execution" )
@@ -131,15 +131,15 @@ if status["status"] == "completed":
131131** Antwortfelder:**
132132- ` success ` (bool): Ob die Anfrage erfolgreich war
133133- ` taskId ` (str): Die Task-ID
134- - ` status ` (str): Einer der Werte ` 'queued' ` , ` 'processing' ` , ` 'completed' ` , ` 'failed' ` , ` 'cancelled' `
134+ - ` status ` (str): Einer von ` 'queued' ` , ` 'processing' ` , ` 'completed' ` , ` 'failed' ` , ` 'cancelled' `
135135- ` metadata ` (dict): Enthält ` startedAt ` , ` completedAt ` und ` duration `
136136- ` output ` (any, optional): Die Workflow-Ausgabe (wenn abgeschlossen)
137137- ` error ` (any, optional): Fehlerdetails (wenn fehlgeschlagen)
138138- ` estimatedDuration ` (int, optional): Geschätzte Dauer in Millisekunden (wenn in Bearbeitung/in Warteschlange)
139139
140140##### execute_with_retry()
141141
142- Einen Workflow mit automatischer Wiederholung bei Ratenbegrenzungsfehlern unter Verwendung von exponentiellem Backoff ausführen .
142+ Führt einen Workflow mit automatischer Wiederholung bei Rate-Limit-Fehlern unter Verwendung von exponentiellem Backoff aus .
143143
144144``` python
145145result = client.execute_with_retry(
@@ -161,13 +161,13 @@ result = client.execute_with_retry(
161161- ` selected_outputs ` (list, optional): Block-Ausgaben zum Streamen
162162- ` async_execution ` (bool, optional): Asynchron ausführen
163163- ` max_retries ` (int, optional): Maximale Anzahl von Wiederholungen (Standard: 3)
164- - ` initial_delay ` (float, optional): Anfängliche Verzögerung in Sekunden (Standard: 1.0)
164+ - ` initial_delay ` (float, optional): Anfangsverzögerung in Sekunden (Standard: 1.0)
165165- ` max_delay ` (float, optional): Maximale Verzögerung in Sekunden (Standard: 30.0)
166166- ` backoff_multiplier ` (float, optional): Backoff-Multiplikator (Standard: 2.0)
167167
168- ** Rückgabewert :** ` WorkflowExecutionResult | AsyncExecutionResult `
168+ ** Rückgabe :** ` WorkflowExecutionResult | AsyncExecutionResult `
169169
170- Die Wiederholungslogik verwendet exponentielles Backoff (1s → 2s → 4s → 8s...) mit ±25% Jitter, um den Thundering- Herd-Effekt zu vermeiden . Wenn die API einen ` retry-after ` Header bereitstellt, wird dieser stattdessen verwendet.
170+ Die Wiederholungslogik verwendet exponentielles Backoff (1s → 2s → 4s → 8s...) mit ±25% Jitter, um Thundering Herd zu verhindern . Wenn die API einen ` retry-after ` - Header bereitstellt, wird dieser stattdessen verwendet.
171171
172172##### get_rate_limit_info()
173173
@@ -185,7 +185,7 @@ if rate_limit_info:
185185
186186##### get_usage_limits()
187187
188- Ruft aktuelle Nutzungslimits und Kontingentinformationen für dein Konto ab.
188+ Ruft aktuelle Nutzungslimits und Kontingentinformationen für Ihr Konto ab.
189189
190190``` python
191191limits = client.get_usage_limits()
@@ -320,9 +320,9 @@ class SimStudioError(Exception):
320320
321321** Häufige Fehlercodes:**
322322- ` UNAUTHORIZED ` : Ungültiger API-Schlüssel
323- - ` TIMEOUT ` : Zeitüberschreitung bei der Anfrage
324- - ` RATE_LIMIT_EXCEEDED ` : Ratengrenze überschritten
325- - ` USAGE_LIMIT_EXCEEDED ` : Nutzungsgrenze überschritten
323+ - ` TIMEOUT ` : Zeitüberschreitung der Anfrage
324+ - ` RATE_LIMIT_EXCEEDED ` : Ratenlimit überschritten
325+ - ` USAGE_LIMIT_EXCEEDED ` : Nutzungslimit überschritten
326326- ` EXECUTION_ERROR ` : Workflow-Ausführung fehlgeschlagen
327327
328328## Beispiele
@@ -334,7 +334,7 @@ class SimStudioError(Exception):
334334 Richten Sie den SimStudioClient mit Ihrem API-Schlüssel ein.
335335 </Step >
336336 <Step title = " Workflow validieren" >
337- Prüfen Sie, ob der Workflow bereitgestellt und für die Ausführung bereit ist.
337+ Prüfen Sie, ob der Workflow bereitgestellt und zur Ausführung bereit ist.
338338 </Step >
339339 <Step title = " Workflow ausführen" >
340340 Führen Sie den Workflow mit Ihren Eingabedaten aus.
@@ -386,7 +386,7 @@ Behandeln Sie verschiedene Fehlertypen, die während der Workflow-Ausführung au
386386from simstudio import SimStudioClient, SimStudioError
387387import os
388388
389- client = SimStudioClient(api_key = os.getenv(" SIM_API_KEY" ))
389+ client = SimStudioClient(api_key = os.getenv(" SIM_API_KEY" ))
390390
391391def execute_with_error_handling ():
392392 try :
@@ -409,11 +409,20 @@ def execute_with_error_handling():
409409 raise
410410```
411411
412- ### Verwendung des Kontextmanagers
412+ ### Verwendung des Context-Managers
413+
414+ Verwenden Sie den Client als Context-Manager, um die Ressourcenbereinigung automatisch zu handhaben:
413415
414- Verwenden Sie den Client als Kontextmanager, um die Ressourcenbereinigung automatisch zu handhaben:
416+ ``` python
417+ from simstudio import SimStudioClient
418+ import os
415419
416- ---CODE-PLACEHOLDER-ef99d3dd509e04865d5b6b0e0e03d3f8---
420+ # Using context manager to automatically close the session
421+ with SimStudioClient(api_key = os.getenv(" SIM_API_KEY" )) as client:
422+ result = client.execute_workflow(" workflow-id" )
423+ print (" Result:" , result)
424+ # Session is automatically closed here
425+ ```
417426
418427### Batch-Workflow-Ausführung
419428
@@ -466,7 +475,7 @@ for result in results:
466475
467476### Asynchrone Workflow-Ausführung
468477
469- Führen Sie Workflows asynchron für lang laufende Aufgaben aus:
478+ Führen Sie Workflows asynchron für langwierige Aufgaben aus:
470479
471480``` python
472481import os
@@ -510,9 +519,9 @@ def execute_async():
510519execute_async()
511520```
512521
513- ### Rate-Limiting und Wiederholungsversuche
522+ ### Ratenlimitierung und Wiederholung
514523
515- Behandle Rate-Limits automatisch mit exponentiellem Backoff:
524+ Behandeln Sie Ratenbegrenzungen automatisch mit exponentiellem Backoff:
516525
517526``` python
518527import os
@@ -549,7 +558,7 @@ execute_with_retry_handling()
549558
550559### Nutzungsüberwachung
551560
552- Überwache deine Kontonutzung und -limits :
561+ Überwachen Sie die Nutzung und Limits Ihres Kontos :
553562
554563``` python
555564import os
@@ -593,13 +602,13 @@ check_usage()
593602
594603### Streaming-Workflow-Ausführung
595604
596- Führe Workflows mit Echtzeit-Streaming-Antworten aus:
605+ Führen Sie Workflows mit Echtzeit-Streaming-Antworten aus:
597606
598607``` python
599608from simstudio import SimStudioClient
600609import os
601610
602- client = SimStudioClient(api_key = os.getenv(" SIM_API_KEY" ))
611+ client = SimStudioClient(api_key = os.getenv(" SIM_API_KEY" ))
603612
604613def execute_with_streaming ():
605614 """ Execute workflow with streaming enabled."""
@@ -619,7 +628,7 @@ def execute_with_streaming():
619628execute_with_streaming()
620629```
621630
622- Die Streaming-Antwort folgt dem Server-Sent Events (SSE) Format:
631+ Die Streaming-Antwort folgt dem Server-Sent- Events- (SSE- ) Format:
623632
624633```
625634data: {"blockId":"7b7735b9-19e5-4bd6-818b-46aae2596e9f","chunk":"One"}
@@ -688,9 +697,9 @@ if __name__ == '__main__':
688697 app.run(debug = True )
689698```
690699
691- ### Umgebungskonfiguration
700+ ### Umgebungskonfiguration
692701
693- Konfiguriere den Client mit Umgebungsvariablen:
702+ Konfigurieren Sie den Client mit Umgebungsvariablen:
694703
695704<Tabs items = { [' Development' , ' Production' ]} >
696705 <Tab value = " Development" >
@@ -727,27 +736,27 @@ Konfiguriere den Client mit Umgebungsvariablen:
727736 </Tab >
728737</Tabs >
729738
730- ## API-Schlüssel erhalten
739+ ## Ihren API-Schlüssel erhalten
731740
732741<Steps >
733742 <Step title = " Bei Sim anmelden" >
734- Navigiere zu [ Sim] ( https://sim.ai ) und melde dich bei deinem Konto an.
743+ Navigieren Sie zu [ Sim] ( https://sim.ai ) und melden Sie sich in Ihrem Konto an.
735744 </Step >
736- <Step title = " Öffne deinen Workflow" >
737- Navigiere zu dem Workflow, den du programmatisch ausführen möchtest .
745+ <Step title = " Workflow öffnen " >
746+ Navigieren Sie zu dem Workflow, den Sie programmatisch ausführen möchten .
738747 </Step >
739- <Step title = " Deploye deinen Workflow" >
740- Klicke auf "Deploy ", um deinen Workflow zu deployen , falls dies noch nicht geschehen ist.
748+ <Step title = " Workflow bereitstellen " >
749+ Klicken Sie auf "Bereitstellen ", um Ihren Workflow bereitzustellen , falls dies noch nicht geschehen ist.
741750 </Step >
742- <Step title = " Erstelle oder wähle einen API-Schlüssel" >
743- Wähle während des Deployment-Prozesses einen API-Schlüssel aus oder erstelle einen neuen .
751+ <Step title = " API-Schlüssel erstellen oder auswählen " >
752+ Wählen oder erstellen Sie während des Bereitstellungsprozesses einen API-Schlüssel.
744753 </Step >
745- <Step title = " Kopiere den API-Schlüssel" >
746- Kopiere den API-Schlüssel zur Verwendung in deiner Python-Anwendung.
754+ <Step title = " API-Schlüssel kopieren " >
755+ Kopieren Sie den API-Schlüssel, um ihn in Ihrer Python-Anwendung zu verwenden .
747756 </Step >
748757</Steps >
749758
750- ## Anforderungen
759+ ## Voraussetzungen
751760
752761- Python 3.8+
753762- requests >= 2.25.0
0 commit comments