mirror of
https://github.com/simstudioai/sim.git
synced 2026-04-28 03:00:29 -04:00
feat(i18n): update translations (#2530)
Co-authored-by: icecrasher321 <icecrasher321@users.noreply.github.com>
This commit is contained in:
Waleed
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Memoria
|
||||
description: Añadir almacén de memoria
|
||||
description: Almacena y recupera el historial de conversaciones
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
@@ -10,96 +10,94 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
color="#F64F9E"
|
||||
/>
|
||||
|
||||
## Instrucciones de uso
|
||||
## Descripción general
|
||||
|
||||
Integra la Memoria en el flujo de trabajo. Puede añadir, obtener una memoria, obtener todas las memorias y eliminar memorias.
|
||||
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`.
|
||||
|
||||
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.
|
||||
|
||||
## Herramientas
|
||||
|
||||
### `memory_add`
|
||||
|
||||
Añade una nueva memoria a la base de datos o agrega a una memoria existente con el mismo ID.
|
||||
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.
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `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. |
|
||||
| `id` | string | No | Parámetro heredado para el identificador de conversación. Use conversationId en su lugar. Proporcionado para compatibilidad con versiones anteriores. |
|
||||
| `role` | string | Sí | Rol para la memoria del agente (user, assistant o system) |
|
||||
| `content` | string | Sí | Contenido para la memoria del agente |
|
||||
| `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". |
|
||||
| `conversationId` | string | Sí | Identificador único para la conversación (ej., `user-123`, `session-abc`) |
|
||||
| `role` | string | Sí | Rol del mensaje: `user` o `assistant` |
|
||||
| `content` | string | Sí | Contenido del mensaje |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Indica si la memoria se añadió correctamente |
|
||||
| `memories` | array | Array de objetos de memoria incluyendo la memoria nueva o actualizada |
|
||||
| `error` | string | Mensaje de error si la operación falló |
|
||||
| `success` | boolean | Si la operación tuvo éxito |
|
||||
| `memories` | array | Array de memoria actualizado |
|
||||
| `error` | string | Mensaje de error si falló |
|
||||
|
||||
### `memory_get`
|
||||
|
||||
Recuperar memoria por conversationId, blockId, blockName o una combinación. Devuelve todas las memorias coincidentes.
|
||||
Recupera la memoria por ID de conversación.
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `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. |
|
||||
| `id` | string | No | Parámetro heredado para el identificador de conversación. Use conversationId en su lugar. Proporcionado para compatibilidad con versiones anteriores. |
|
||||
| `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. |
|
||||
| `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. |
|
||||
| `conversationId` | string | Sí | Identificador de conversación |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si la memoria fue recuperada con éxito |
|
||||
| `memories` | array | Array de objetos de memoria con campos conversationId, blockId, blockName y data |
|
||||
| `message` | string | Mensaje de éxito o error |
|
||||
| `error` | string | Mensaje de error si la operación falló |
|
||||
| `success` | boolean | Si la operación tuvo éxito |
|
||||
| `memories` | array | Array de mensajes con `role` y `content` |
|
||||
| `error` | string | Mensaje de error si falló |
|
||||
|
||||
### `memory_get_all`
|
||||
|
||||
Recuperar todas las memorias de la base de datos
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
Recuperar todas las memorias del espacio de trabajo actual.
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si todas las memorias fueron recuperadas con éxito |
|
||||
| `memories` | array | Array de todos los objetos de memoria con campos key, conversationId, blockId, blockName y data |
|
||||
| `message` | string | Mensaje de éxito o error |
|
||||
| `success` | boolean | Indica si la operación se realizó correctamente |
|
||||
| `memories` | array | Todos los objetos de memoria con campos `conversationId` y `data` |
|
||||
| `error` | string | Mensaje de error si la operación falló |
|
||||
|
||||
### `memory_delete`
|
||||
|
||||
Eliminar memorias por conversationId, blockId, blockName o una combinación. Admite eliminación masiva.
|
||||
Eliminar memoria por ID de conversación.
|
||||
|
||||
#### Entrada
|
||||
|
||||
| Parámetro | Tipo | Obligatorio | Descripción |
|
||||
| --------- | ---- | ----------- | ----------- |
|
||||
| `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. |
|
||||
| `id` | string | No | Parámetro heredado para el identificador de conversación. Use conversationId en su lugar. Proporcionado para compatibilidad con versiones anteriores. |
|
||||
| `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. |
|
||||
| `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. |
|
||||
| `conversationId` | string | Sí | Identificador de conversación a eliminar |
|
||||
|
||||
#### Salida
|
||||
|
||||
| Parámetro | Tipo | Descripción |
|
||||
| --------- | ---- | ----------- |
|
||||
| `success` | boolean | Si la memoria fue eliminada con éxito |
|
||||
| `message` | string | Mensaje de éxito o error |
|
||||
| `success` | boolean | Indica si la operación se realizó correctamente |
|
||||
| `message` | string | Mensaje de confirmación |
|
||||
| `error` | string | Mensaje de error si la operación falló |
|
||||
|
||||
## Tipos de memoria del agente
|
||||
|
||||
Al usar memoria con un bloque de agente, puedes configurar cómo se gestiona el historial de conversación:
|
||||
|
||||
| Tipo | Descripción |
|
||||
| ---- | ----------- |
|
||||
| **Conversación completa** | Almacena todos los mensajes, limitado por la ventana de contexto del modelo (usa el 90% para dejar espacio para la respuesta) |
|
||||
| **Ventana deslizante (mensajes)** | Mantiene los últimos N mensajes (predeterminado: 10) |
|
||||
| **Ventana deslizante (tokens)** | Mantiene los mensajes que caben dentro de un límite de tokens (predeterminado: 4000) |
|
||||
|
||||
## Notas
|
||||
|
||||
- Categoría: `blocks`
|
||||
- Tipo: `memory`
|
||||
- La memoria está limitada por espacio de trabajo: los flujos de trabajo en el mismo espacio de trabajo comparten el almacén de memoria
|
||||
- Usa valores únicos de `conversationId` para mantener las conversaciones separadas (p. ej., IDs de sesión, IDs de usuario o UUIDs)
|
||||
- Los mensajes del sistema pertenecen a la configuración del bloque de agente, no a la memoria
|
||||
|
||||
Reference in New Issue
Block a user