Skip to content

Commit e01d4cb

Browse files
feat(i18n): update translations (#2530)
Co-authored-by: icecrasher321 <[email protected]>
1 parent 8c2c49e commit e01d4cb

File tree

7 files changed

+229
-239
lines changed

7 files changed

+229
-239
lines changed
Lines changed: 39 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Memory
3-
description: Speicher hinzufügen
3+
description: Konversationsverlauf speichern und abrufen
44
---
55

66
import { BlockInfoCard } from "@/components/ui/block-info-card"
@@ -10,96 +10,94 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
1010
color="#F64F9E"
1111
/>
1212

13-
## Gebrauchsanweisung
13+
## Übersicht
1414

15-
Memory in den Workflow integrieren. Kann Erinnerungen hinzufügen, eine Erinnerung abrufen, alle Erinnerungen abrufen und Erinnerungen löschen.
15+
Der Memory-Block speichert den Konversationsverlauf für Agenten. Jede Erinnerung wird durch eine `conversationId` identifiziert, die Sie bereitstellen. Mehrere Agenten können denselben Speicher nutzen, indem sie dieselbe `conversationId` verwenden.
16+
17+
Der Speicher speichert nur Benutzer- und Assistentennachrichten. Systemnachrichten werden nicht gespeichert – sie werden im Agent-Block konfiguriert und zur Laufzeit vorangestellt.
1618

1719
## Tools
1820

1921
### `memory_add`
2022

21-
Füge eine neue Erinnerung zur Datenbank hinzu oder ergänze bestehende Erinnerungen mit derselben ID.
23+
Eine Nachricht zum Speicher hinzufügen. Erstellt einen neuen Speicher, wenn die `conversationId` nicht existiert, oder hängt an einen bestehenden Speicher an.
2224

2325
#### Eingabe
2426

2527
| Parameter | Typ | Erforderlich | Beschreibung |
2628
| --------- | ---- | -------- | ----------- |
27-
| `conversationId` | string | Nein | Konversationskennung (z.B. user-123, session-abc). Wenn bereits eine Erinnerung mit dieser conversationId für diesen Block existiert, wird die neue Nachricht angehängt. |
28-
| `id` | string | Nein | Legacy-Parameter für die Konversationskennung. Verwenden Sie stattdessen conversationId. Für Abwärtskompatibilität bereitgestellt. |
29-
| `role` | string | Ja | Rolle für Agent-Erinnerung (user, assistant oder system) |
30-
| `content` | string | Ja | Inhalt für Agent-Erinnerung |
31-
| `blockId` | string | Nein | Optionale Block-ID. Wenn nicht angegeben, wird die aktuelle Block-ID aus dem Ausführungskontext verwendet oder standardmäßig "default" gesetzt. |
29+
| `conversationId` | string | Ja | Eindeutige Kennung für die Konversation (z. B. `user-123`, `session-abc`) |
30+
| `role` | string | Ja | Nachrichtenrolle: `user` oder `assistant` |
31+
| `content` | string | Ja | Nachrichteninhalt |
3232

3333
#### Ausgabe
3434

3535
| Parameter | Typ | Beschreibung |
3636
| --------- | ---- | ----------- |
37-
| `success` | boolean | Ob der Speicher erfolgreich hinzugefügt wurde |
38-
| `memories` | array | Array von Speicherobjekten einschließlich des neuen oder aktualisierten Speichers |
39-
| `error` | string | Fehlermeldung, falls der Vorgang fehlgeschlagen ist |
37+
| `success` | boolean | Ob der Vorgang erfolgreich war |
38+
| `memories` | array | Aktualisiertes Speicher-Array |
39+
| `error` | string | Fehlermeldung, falls fehlgeschlagen |
4040

4141
### `memory_get`
4242

43-
Erinnerungen nach conversationId, blockId, blockName oder einer Kombination abrufen. Gibt alle übereinstimmenden Erinnerungen zurück.
43+
Speicher nach Konversations-ID abrufen.
4444

4545
#### Eingabe
4646

4747
| Parameter | Typ | Erforderlich | Beschreibung |
4848
| --------- | ---- | -------- | ----------- |
49-
| `conversationId` | string | Nein | Konversationskennung (z.B. user-123, session-abc). Wenn allein angegeben, werden alle Erinnerungen für diese Konversation über alle Blöcke hinweg zurückgegeben. |
50-
| `id` | string | Nein | Legacy-Parameter für die Konversationskennung. Verwenden Sie stattdessen conversationId. Für Abwärtskompatibilität bereitgestellt. |
51-
| `blockId` | string | Nein | Block-Kennung. Wenn allein angegeben, werden alle Erinnerungen für diesen Block über alle Konversationen hinweg zurückgegeben. Wenn mit conversationId angegeben, werden Erinnerungen für diese spezifische Konversation in diesem Block zurückgegeben. |
52-
| `blockName` | string | Nein | Blockname. Alternative zu blockId. Wenn allein angegeben, werden alle Erinnerungen für Blöcke mit diesem Namen zurückgegeben. Wenn mit conversationId angegeben, werden Erinnerungen für diese Konversation in Blöcken mit diesem Namen zurückgegeben. |
49+
| `conversationId` | string | Ja | Konversationskennung |
5350

5451
#### Ausgabe
5552

5653
| Parameter | Typ | Beschreibung |
5754
| --------- | ---- | ----------- |
58-
| `success` | boolean | Ob die Erinnerung erfolgreich abgerufen wurde |
59-
| `memories` | array | Array von Speicherobjekten mit conversationId, blockId, blockName und data-Feldern |
60-
| `message` | string | Erfolgs- oder Fehlermeldung |
61-
| `error` | string | Fehlermeldung, wenn der Vorgang fehlgeschlagen ist |
55+
| `success` | boolean | Ob der Vorgang erfolgreich war |
56+
| `memories` | array | Array von Nachrichten mit `role` und `content` |
57+
| `error` | string | Fehlermeldung, falls fehlgeschlagen |
6258

6359
### `memory_get_all`
6460

65-
Alle Speicher aus der Datenbank abrufen
66-
67-
#### Eingabe
68-
69-
| Parameter | Typ | Erforderlich | Beschreibung |
70-
| --------- | ---- | -------- | ----------- |
61+
Alle Erinnerungen für den aktuellen Workspace abrufen.
7162

7263
#### Ausgabe
7364

7465
| Parameter | Typ | Beschreibung |
7566
| --------- | ---- | ----------- |
76-
| `success` | boolean | Ob alle Erinnerungen erfolgreich abgerufen wurden |
77-
| `memories` | array | Array aller Speicherobjekte mit key, conversationId, blockId, blockName und data-Feldern |
78-
| `message` | string | Erfolgs- oder Fehlermeldung |
79-
| `error` | string | Fehlermeldung, wenn der Vorgang fehlgeschlagen ist |
67+
| `success` | boolean | Ob der Vorgang erfolgreich war |
68+
| `memories` | array | Alle Erinnerungsobjekte mit `conversationId` und `data` Feldern |
69+
| `error` | string | Fehlermeldung, falls fehlgeschlagen |
8070

8171
### `memory_delete`
8272

83-
Löschen von Erinnerungen nach conversationId, blockId, blockName oder einer Kombination davon. Unterstützt Massenlöschung.
73+
Erinnerung nach Konversations-ID löschen.
8474

8575
#### Eingabe
8676

8777
| Parameter | Typ | Erforderlich | Beschreibung |
8878
| --------- | ---- | -------- | ----------- |
89-
| `conversationId` | string | Nein | Konversationskennung (z.B. user-123, session-abc). Wenn allein angegeben, werden alle Erinnerungen für diese Konversation über alle Blöcke hinweg gelöscht. |
90-
| `id` | string | Nein | Legacy-Parameter für die Konversationskennung. Verwenden Sie stattdessen conversationId. Für Abwärtskompatibilität bereitgestellt. |
91-
| `blockId` | string | Nein | Block-Kennung. Wenn allein angegeben, werden alle Erinnerungen für diesen Block über alle Konversationen hinweg gelöscht. Wenn mit conversationId angegeben, werden Erinnerungen für diese spezifische Konversation in diesem Block gelöscht. |
92-
| `blockName` | string | Nein | Blockname. Alternative zu blockId. Wenn allein angegeben, werden alle Erinnerungen für Blöcke mit diesem Namen gelöscht. Wenn mit conversationId angegeben, werden Erinnerungen für diese Konversation in Blöcken mit diesem Namen gelöscht. |
79+
| `conversationId` | string | Ja | Konversationskennung zum Löschen |
9380

9481
#### Ausgabe
9582

9683
| Parameter | Typ | Beschreibung |
9784
| --------- | ---- | ----------- |
98-
| `success` | boolean | Ob die Erinnerung erfolgreich gelöscht wurde |
99-
| `message` | string | Erfolgs- oder Fehlermeldung |
100-
| `error` | string | Fehlermeldung, wenn der Vorgang fehlgeschlagen ist |
85+
| `success` | boolean | Ob der Vorgang erfolgreich war |
86+
| `message` | string | Bestätigungsnachricht |
87+
| `error` | string | Fehlermeldung, falls fehlgeschlagen |
88+
89+
## Agent-Erinnerungstypen
90+
91+
Bei der Verwendung von Erinnerungen mit einem Agent-Block können Sie konfigurieren, wie der Konversationsverlauf verwaltet wird:
92+
93+
| Typ | Beschreibung |
94+
| ---- | ----------- |
95+
| **Vollständige Konversation** | Speichert alle Nachrichten, begrenzt durch das Kontextfenster des Modells (verwendet 90%, um Platz für die Antwort zu lassen) |
96+
| **Gleitendes Fenster (Nachrichten)** | Behält die letzten N Nachrichten (Standard: 10) |
97+
| **Gleitendes Fenster (Tokens)** | Behält Nachrichten, die in ein Token-Limit passen (Standard: 4000) |
10198

10299
## Hinweise
103100

104-
- Kategorie: `blocks`
105-
- Typ: `memory`
101+
- Erinnerungen sind pro Workspace begrenzt – Workflows im selben Workspace teilen sich den Erinnerungsspeicher
102+
- Verwenden Sie eindeutige `conversationId` Werte, um Konversationen getrennt zu halten (z.B. Session-IDs, Benutzer-IDs oder UUIDs)
103+
- Systemnachrichten gehören in die Agent-Block-Konfiguration, nicht in die Erinnerung
Lines changed: 37 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Memoria
3-
description: Añadir almacén de memoria
3+
description: Almacena y recupera el historial de conversaciones
44
---
55

66
import { BlockInfoCard } from "@/components/ui/block-info-card"
@@ -10,96 +10,94 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
1010
color="#F64F9E"
1111
/>
1212

13-
## Instrucciones de uso
13+
## Descripción general
1414

15-
Integra la Memoria en el flujo de trabajo. Puede añadir, obtener una memoria, obtener todas las memorias y eliminar memorias.
15+
El bloque Memory almacena el historial de conversaciones para agentes. Cada memoria se identifica mediante un `conversationId` que proporcionas. Múltiples agentes pueden compartir la misma memoria usando el mismo `conversationId`.
16+
17+
Memory almacena solo mensajes de usuario y asistente. Los mensajes del sistema no se almacenan, se configuran en el bloque Agent y se añaden como prefijo en tiempo de ejecución.
1618

1719
## Herramientas
1820

1921
### `memory_add`
2022

21-
Añade una nueva memoria a la base de datos o agrega a una memoria existente con el mismo ID.
23+
Añade un mensaje a la memoria. Crea una nueva memoria si el `conversationId` no existe, o añade al final de la memoria existente.
2224

2325
#### Entrada
2426

2527
| Parámetro | Tipo | Obligatorio | Descripción |
2628
| --------- | ---- | ----------- | ----------- |
27-
| `conversationId` | string | No | Identificador de conversación (p. ej., user-123, session-abc). Si ya existe una memoria con este conversationId para este bloque, el nuevo mensaje se añadirá a ella. |
28-
| `id` | string | No | Parámetro heredado para el identificador de conversación. Use conversationId en su lugar. Proporcionado para compatibilidad con versiones anteriores. |
29-
| `role` | string || Rol para la memoria del agente (user, assistant o system) |
30-
| `content` | string || Contenido para la memoria del agente |
31-
| `blockId` | string | No | ID de bloque opcional. Si no se proporciona, utiliza el ID del bloque actual del contexto de ejecución, o por defecto "default". |
29+
| `conversationId` | string || Identificador único para la conversación (ej., `user-123`, `session-abc`) |
30+
| `role` | string || Rol del mensaje: `user` o `assistant` |
31+
| `content` | string || Contenido del mensaje |
3232

3333
#### Salida
3434

3535
| Parámetro | Tipo | Descripción |
3636
| --------- | ---- | ----------- |
37-
| `success` | boolean | Indica si la memoria se añadió correctamente |
38-
| `memories` | array | Array de objetos de memoria incluyendo la memoria nueva o actualizada |
39-
| `error` | string | Mensaje de error si la operación falló |
37+
| `success` | boolean | Si la operación tuvo éxito |
38+
| `memories` | array | Array de memoria actualizado |
39+
| `error` | string | Mensaje de error si falló |
4040

4141
### `memory_get`
4242

43-
Recuperar memoria por conversationId, blockId, blockName o una combinación. Devuelve todas las memorias coincidentes.
43+
Recupera la memoria por ID de conversación.
4444

4545
#### Entrada
4646

4747
| Parámetro | Tipo | Obligatorio | Descripción |
4848
| --------- | ---- | ----------- | ----------- |
49-
| `conversationId` | string | No | Identificador de conversación (p. ej., user-123, session-abc). Si se proporciona solo, devuelve todas las memorias para esta conversación en todos los bloques. |
50-
| `id` | string | No | Parámetro heredado para el identificador de conversación. Use conversationId en su lugar. Proporcionado para compatibilidad con versiones anteriores. |
51-
| `blockId` | string | No | Identificador de bloque. Si se proporciona solo, devuelve todas las memorias para este bloque en todas las conversaciones. Si se proporciona con conversationId, devuelve las memorias para esa conversación específica en este bloque. |
52-
| `blockName` | string | No | Nombre del bloque. Alternativa a blockId. Si se proporciona solo, devuelve todas las memorias para bloques con este nombre. Si se proporciona con conversationId, devuelve las memorias para esa conversación en bloques con este nombre. |
49+
| `conversationId` | string || Identificador de conversación |
5350

5451
#### Salida
5552

5653
| Parámetro | Tipo | Descripción |
5754
| --------- | ---- | ----------- |
58-
| `success` | boolean | Si la memoria fue recuperada con éxito |
59-
| `memories` | array | Array de objetos de memoria con campos conversationId, blockId, blockName y data |
60-
| `message` | string | Mensaje de éxito o error |
61-
| `error` | string | Mensaje de error si la operación falló |
55+
| `success` | boolean | Si la operación tuvo éxito |
56+
| `memories` | array | Array de mensajes con `role` y `content` |
57+
| `error` | string | Mensaje de error si falló |
6258

6359
### `memory_get_all`
6460

65-
Recuperar todas las memorias de la base de datos
66-
67-
#### Entrada
68-
69-
| Parámetro | Tipo | Obligatorio | Descripción |
70-
| --------- | ---- | ----------- | ----------- |
61+
Recuperar todas las memorias del espacio de trabajo actual.
7162

7263
#### Salida
7364

7465
| Parámetro | Tipo | Descripción |
7566
| --------- | ---- | ----------- |
76-
| `success` | boolean | Si todas las memorias fueron recuperadas con éxito |
77-
| `memories` | array | Array de todos los objetos de memoria con campos key, conversationId, blockId, blockName y data |
78-
| `message` | string | Mensaje de éxito o error |
67+
| `success` | boolean | Indica si la operación se realizó correctamente |
68+
| `memories` | array | Todos los objetos de memoria con campos `conversationId` y `data` |
7969
| `error` | string | Mensaje de error si la operación falló |
8070

8171
### `memory_delete`
8272

83-
Eliminar memorias por conversationId, blockId, blockName o una combinación. Admite eliminación masiva.
73+
Eliminar memoria por ID de conversación.
8474

8575
#### Entrada
8676

8777
| Parámetro | Tipo | Obligatorio | Descripción |
8878
| --------- | ---- | ----------- | ----------- |
89-
| `conversationId` | string | No | Identificador de conversación (p. ej., user-123, session-abc). Si se proporciona solo, elimina todas las memorias para esta conversación en todos los bloques. |
90-
| `id` | string | No | Parámetro heredado para el identificador de conversación. Use conversationId en su lugar. Proporcionado para compatibilidad con versiones anteriores. |
91-
| `blockId` | string | No | Identificador de bloque. Si se proporciona solo, elimina todas las memorias para este bloque en todas las conversaciones. Si se proporciona con conversationId, elimina las memorias para esa conversación específica en este bloque. |
92-
| `blockName` | string | No | Nombre del bloque. Alternativa a blockId. Si se proporciona solo, elimina todas las memorias para bloques con este nombre. Si se proporciona con conversationId, elimina las memorias para esa conversación en bloques con este nombre. |
79+
| `conversationId` | string || Identificador de conversación a eliminar |
9380

9481
#### Salida
9582

9683
| Parámetro | Tipo | Descripción |
9784
| --------- | ---- | ----------- |
98-
| `success` | boolean | Si la memoria fue eliminada con éxito |
99-
| `message` | string | Mensaje de éxito o error |
85+
| `success` | boolean | Indica si la operación se realizó correctamente |
86+
| `message` | string | Mensaje de confirmación |
10087
| `error` | string | Mensaje de error si la operación falló |
10188

89+
## Tipos de memoria del agente
90+
91+
Al usar memoria con un bloque de agente, puedes configurar cómo se gestiona el historial de conversación:
92+
93+
| Tipo | Descripción |
94+
| ---- | ----------- |
95+
| **Conversación completa** | Almacena todos los mensajes, limitado por la ventana de contexto del modelo (usa el 90% para dejar espacio para la respuesta) |
96+
| **Ventana deslizante (mensajes)** | Mantiene los últimos N mensajes (predeterminado: 10) |
97+
| **Ventana deslizante (tokens)** | Mantiene los mensajes que caben dentro de un límite de tokens (predeterminado: 4000) |
98+
10299
## Notas
103100

104-
- Categoría: `blocks`
105-
- Tipo: `memory`
101+
- La memoria está limitada por espacio de trabajo: los flujos de trabajo en el mismo espacio de trabajo comparten el almacén de memoria
102+
- Usa valores únicos de `conversationId` para mantener las conversaciones separadas (p. ej., IDs de sesión, IDs de usuario o UUIDs)
103+
- Los mensajes del sistema pertenecen a la configuración del bloque de agente, no a la memoria

0 commit comments

Comments
 (0)