You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -10,96 +10,94 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
10
10
color="#F64F9E"
11
11
/>
12
12
13
-
## Gebrauchsanweisung
13
+
## Übersicht
14
14
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.
16
18
17
19
## Tools
18
20
19
21
### `memory_add`
20
22
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.
22
24
23
25
#### Eingabe
24
26
25
27
| Parameter | Typ | Erforderlich | Beschreibung |
26
28
| --------- | ---- | -------- | ----------- |
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 |
32
32
33
33
#### Ausgabe
34
34
35
35
| Parameter | Typ | Beschreibung |
36
36
| --------- | ---- | ----------- |
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|
Erinnerungen nach conversationId, blockId, blockName oder einer Kombination abrufen. Gibt alle übereinstimmenden Erinnerungen zurück.
43
+
Speicher nach Konversations-ID abrufen.
44
44
45
45
#### Eingabe
46
46
47
47
| Parameter | Typ | Erforderlich | Beschreibung |
48
48
| --------- | ---- | -------- | ----------- |
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 |
53
50
54
51
#### Ausgabe
55
52
56
53
| Parameter | Typ | Beschreibung |
57
54
| --------- | ---- | ----------- |
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`|
Löschen von Erinnerungen nach conversationId, blockId, blockName oder einer Kombination davon. Unterstützt Massenlöschung.
73
+
Erinnerung nach Konversations-ID löschen.
84
74
85
75
#### Eingabe
86
76
87
77
| Parameter | Typ | Erforderlich | Beschreibung |
88
78
| --------- | ---- | -------- | ----------- |
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 |
93
80
94
81
#### Ausgabe
95
82
96
83
| Parameter | Typ | Beschreibung |
97
84
| --------- | ---- | ----------- |
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 |
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) |
101
98
102
99
## Hinweise
103
100
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
@@ -10,96 +10,94 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
10
10
color="#F64F9E"
11
11
/>
12
12
13
-
## Instrucciones de uso
13
+
## Descripción general
14
14
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.
16
18
17
19
## Herramientas
18
20
19
21
### `memory_add`
20
22
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.
22
24
23
25
#### Entrada
24
26
25
27
| Parámetro | Tipo | Obligatorio | Descripción |
26
28
| --------- | ---- | ----------- | ----------- |
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 | Sí | Rol para la memoria del agente (user, assistant o system) |
30
-
|`content`| string | Sí | 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 | Sí | Identificador único para la conversación (ej., `user-123`, `session-abc`) |
30
+
|`role`| string | Sí | Rol del mensaje: `user` o `assistant`|
31
+
|`content`| string | Sí | Contenido del mensaje |
32
32
33
33
#### Salida
34
34
35
35
| Parámetro | Tipo | Descripción |
36
36
| --------- | ---- | ----------- |
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ó |
40
40
41
41
### `memory_get`
42
42
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.
44
44
45
45
#### Entrada
46
46
47
47
| Parámetro | Tipo | Obligatorio | Descripción |
48
48
| --------- | ---- | ----------- | ----------- |
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 | Sí | Identificador de conversación |
53
50
54
51
#### Salida
55
52
56
53
| Parámetro | Tipo | Descripción |
57
54
| --------- | ---- | ----------- |
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ó |
62
58
63
59
### `memory_get_all`
64
60
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.
71
62
72
63
#### Salida
73
64
74
65
| Parámetro | Tipo | Descripción |
75
66
| --------- | ---- | ----------- |
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`|
79
69
|`error`| string | Mensaje de error si la operación falló |
80
70
81
71
### `memory_delete`
82
72
83
-
Eliminar memorias por conversationId, blockId, blockName o una combinación. Admite eliminación masiva.
73
+
Eliminar memoria por ID de conversación.
84
74
85
75
#### Entrada
86
76
87
77
| Parámetro | Tipo | Obligatorio | Descripción |
88
78
| --------- | ---- | ----------- | ----------- |
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 | Sí | Identificador de conversación a eliminar |
93
80
94
81
#### Salida
95
82
96
83
| Parámetro | Tipo | Descripción |
97
84
| --------- | ---- | ----------- |
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|
100
87
|`error`| string | Mensaje de error si la operación falló |
101
88
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
+
102
99
## Notas
103
100
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