Zep
Memoria a largo plazo para agentes de IA
Configuración
Crear hilo
Operación
Crear hilo
Clave API*
••••••••
ID de hilo*
Introduce el identificador único del hilo
ID de usuario*
Introduce el identificador de usuario
Crear hilo (
zep_create_thread)Inicia un nuevo hilo de conversación en Zep
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
threadId | string | Sí | Identificador único del hilo |
userId | string | Sí | ID de usuario asociado al hilo |
apiKey | string | Sí | Tu clave API de Zep |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
threadId | string | El ID del hilo |
userId | string | El ID de usuario |
uuid | string | UUID interno |
createdAt | string | Marca de tiempo de creación |
projectUuid | string | UUID del proyecto |
Añadir mensajes
Operación
Añadir mensajes
Clave de API*
••••••••
ID de hilo*
Introduce un identificador de hilo único
Mensajes*
json
[{"role": "user", "content": "Hello!"}]
Añadir mensajes (
zep_add_messages)Añade mensajes a un hilo existente
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
threadId | string | Sí | ID del hilo al que añadir mensajes |
messages | json | Sí | Array de objetos de mensaje con role y content |
apiKey | string | Sí | Tu clave de API de Zep |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
context | string | Contexto actualizado tras añadir mensajes |
messageIds | array | Array de UUID de los mensajes añadidos |
threadId | string | El ID del hilo |
Obtener contexto
Operación
Obtener contexto
Clave de API*
••••••••
ID de hilo*
Introduce un identificador de hilo único
Modo de contexto
Resumen (lenguaje natural)
Obtener contexto (
zep_get_context)Recupera el contexto del usuario de un hilo en modo resumen o básico
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
threadId | string | Sí | ID del hilo del que obtener el contexto |
mode | string | No | Modo de contexto: "summary" (lenguaje natural) o "basic" (hechos en bruto) |
minRating | number | No | Puntuación mínima para filtrar los hechos relevantes |
apiKey | string | Sí | Tu clave de API de Zep |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
context | string | La cadena de contexto (summary o basic) |
facts | array | Hechos extraídos |
entities | array | Entidades extraídas |
summary | string | Resumen de la conversación |
Obtener mensajes
Operación
Obtener mensajes
Clave de API*
••••••••
ID del hilo*
Introduce el identificador único del hilo
Límite de resultados
1
Obtener mensajes (
zep_get_messages)Recuperar mensajes de un hilo
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
threadId | string | Sí | ID del hilo del que obtener mensajes |
limit | number | No | Número máximo de mensajes a devolver |
cursor | string | No | Cursor para paginación |
lastn | number | No | Número de mensajes más recientes a devolver (sobrescribe limit y cursor) |
apiKey | string | Sí | Tu clave de API de Zep |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
messages | array | Array de objetos de mensaje |
rowCount | number | Número de mensajes en esta respuesta |
totalCount | number | Número total de mensajes en el hilo |
Obtener hilos
Operación
Obtener hilos
Clave de API*
••••••••
Límite de resultados
1
Obtener hilos (
zep_get_threads)Lista todos los hilos de conversación
Entrada
| Parameter | Type | Required | Description |
|---|---|---|---|
pageSize | number | No | Número de hilos que recuperar por página |
pageNumber | number | No | Número de página para la paginación |
orderBy | string | No | Campo por el que ordenar los resultados (created_at, updated_at, user_id, thread_id) |
asc | boolean | No | Dirección del orden: true para ascendente, false para descendente |
apiKey | string | Sí | Tu clave de API de Zep |
Salida
| Parameter | Type | Description |
|---|---|---|
threads | array | Array de objetos de hilo |
responseCount | number | Número de hilos en esta respuesta |
totalCount | number | Número total de hilos disponibles |
Eliminar hilo
Operación
Eliminar hilo
Clave de API*
••••••••
ID de hilo*
Introduce el identificador único del hilo
Eliminar hilo (
zep_delete_thread)Elimina un hilo de conversación de Zep
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
threadId | string | Sí | ID del hilo que se va a eliminar |
apiKey | string | Sí | Tu clave de API de Zep |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
deleted | boolean | Indica si se eliminó el hilo |
Añadir usuario
Operación
Añadir usuario
Clave de API*
••••••••
ID de usuario*
Introduce el identificador de usuario
Correo electrónico
user@example.com
Nombre
John
Apellido
Doe
Metadatos
json
{"key": "value"}
Añadir usuario (
zep_add_user)Crea un nuevo usuario en Zep
Entrada
| Parameter | Type | Required | Description |
|---|---|---|---|
userId | string | Sí | Identificador único del usuario |
email | string | No | Dirección de correo del usuario |
firstName | string | No | Nombre del usuario |
lastName | string | No | Apellido del usuario |
metadata | json | No | Metadatos adicionales como objeto JSON |
apiKey | string | Sí | Tu clave de API de Zep |
Salida
| Parameter | Type | Description |
|---|---|---|
userId | string | El ID de usuario |
email | string | Correo del usuario |
firstName | string | Nombre del usuario |
lastName | string | Apellido del usuario |
uuid | string | UUID interno |
createdAt | string | Marca de tiempo de creación |
metadata | object | Metadatos del usuario |
Obtener usuario
Operación
Obtener usuario
Clave de API*
••••••••
ID de usuario*
Introduce el identificador de usuario
Obtener usuario (
zep_get_user)Recuperar información del usuario de Zep
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
userId | string | Sí | ID de usuario a recuperar |
apiKey | string | Sí | Tu clave de API de Zep |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
userId | string | El ID de usuario |
email | string | Correo electrónico del usuario |
firstName | string | Nombre del usuario |
lastName | string | Apellido del usuario |
uuid | string | UUID interno |
createdAt | string | Marca de tiempo de creación |
updatedAt | string | Marca de tiempo de última actualización |
metadata | object | Metadatos del usuario |
Obtener hilos del usuario
Operación
Obtener hilos del usuario
Clave de API*
••••••••
ID de usuario*
Introduce el identificador de usuario
Obtener hilos de usuario (
zep_get_user_threads)Lista todos los hilos de conversación de un usuario específico
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
userId | string | Sí | ID de usuario del que obtener los hilos |
limit | number | No | Número máximo de hilos que devolver |
apiKey | string | Sí | Tu clave de API de Zep |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
threads | array | Array de objetos de hilo de este usuario |
userId | string | El ID de usuario |
Instrucciones de uso
Integra Zep para la gestión de memoria a largo plazo. Crea hilos, añade mensajes y recupera contexto con resúmenes e extracción de hechos impulsados por IA.
Notas
- Categoría:
tools - Tipo:
zep