> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aurora-ai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Zep

> Memoria a largo plazo para agentes de IA

export const BlockInfoCard = ({type, color, icon = false, iconSvg}) => {
  return <div className="mb-6 overflow-hidden rounded-lg border border-border">
      <div className="flex items-center justify-center p-6">
        <div className="flex h-20 w-20 items-center justify-center rounded-lg" style={{
    backgroundColor: color
  }}>
          {iconSvg ? <div className="h-10 w-10 text-white" dangerouslySetInnerHTML={{
    __html: iconSvg
  }} /> : <div className="font-mono text-xl opacity-70">
              {type.substring(0, 2)}
            </div>}
        </div>
      </div>
      {icon && <style jsx global>{`
          .block-icon {
            width: 80px;
            height: 80px;
            margin: 1rem auto;
            display: block;
          }
        `}</style>}
    </div>;
};

<BlockInfoCard
  type="zep"
  color="#E8E8E8"
  icon={true}
  iconSvg={`<svg className="block-icon"
  
  xmlns='http://www.w3.org/2000/svg'
  viewBox='0 0 233 196'
  
  
>
  <path
    d='m231.34,108.7l-1.48-1.55h-10.26l3.59-75.86-14.8-.45-2.77,49.31c-59.6-3.24-119.33-3.24-178.92-.02l-1.73-64.96-14.8.45,2.5,91.53H2.16l-1.41,1.47c-1.55,16.23-.66,32.68,2.26,48.89h10.83l.18,1.27c.67,19.34,16.1,34.68,35.9,34.68s44.86-.92,66.12-.92,46.56.92,65.95.92,35.19-15.29,35.9-34.61l.16-1.34h11.02c2.91-16.19,3.81-32.61,2.26-48.81Zm-158.23,58.01c-17.27,0-30.25-13.78-30.25-29.78s12.99-29.78,30.25-29.78,29.62,13.94,29.62,29.94-12.35,29.62-29.62,29.62Zm86.51,0c-17.27,0-30.25-13.78-30.25-29.78s12.99-29.78,30.25-29.78,29.62,13.94,29.62,29.94-12.35,29.62-29.62,29.62Z'
    fill='#FF1493'
  />
  <polygon
    points='111.77 22.4 93.39 49.97 93.52 50.48 185.88 38.51 190.95 27.68 114.32 36.55 117.7 31.48 117.7 31.47 138.38 .49 138.25 0 47.67 11.6 42.85 22.27 118.34 12.61 111.77 22.4'
    fill='#FF1493'
  />
  <path
    d='m72.97,121.47c-8.67,0-15.73,6.93-15.73,15.46s7.06,15.46,15.73,15.46,15.37-6.75,15.37-15.37-6.75-15.55-15.37-15.55Z'
    fill='#FF1493'
  />
  <path
    d='m159.48,121.47c-8.67,0-15.73,6.93-15.73,15.46s7.06,15.46,15.73,15.46,15.37-6.75,15.37-15.37-6.75-15.55-15.37-15.55Z'
    fill='#FF1493'
  />
</svg>`}
/>

## Instrucciones de uso

Integra Zep para la gestión de memoria a largo plazo. Crea hilos, añade mensajes, recupera contexto con resúmenes potenciados por IA y extracción de datos relevantes.

## Herramientas

### `zep_create_thread`

Iniciar un nuevo hilo de conversación en Zep

#### Entrada

| Parámetro  | Tipo   | Obligatorio | Descripción                        |
| ---------- | ------ | ----------- | ---------------------------------- |
| `threadId` | string | Sí          | Identificador único para el hilo   |
| `userId`   | string | Sí          | ID de usuario asociado con el 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 del usuario           |
| `uuid`        | string | UUID interno                |
| `createdAt`   | string | Marca de tiempo de creación |
| `projectUuid` | string | UUID del proyecto           |

### `zep_get_threads`

Listar todos los hilos de conversación

#### Entrada

| Parámetro    | Tipo    | Obligatorio | Descripción                                                                    |
| ------------ | ------- | ----------- | ------------------------------------------------------------------------------ |
| `pageSize`   | number  | No          | Número de hilos a recuperar por página                                         |
| `pageNumber` | number  | No          | Número de página para paginación                                               |
| `orderBy`    | string  | No          | Campo para ordenar resultados (created\_at, updated\_at, user\_id, thread\_id) |
| `asc`        | boolean | No          | Dirección de ordenamiento: true para ascendente, false para descendente        |
| `apiKey`     | string  | Sí          | Tu clave API de Zep                                                            |

#### Salida

| Parámetro       | Tipo   | Descripción                       |
| --------------- | ------ | --------------------------------- |
| `threads`       | array  | Array de objetos de hilo          |
| `responseCount` | number | Número de hilos en esta respuesta |
| `totalCount`    | number | Número total de hilos disponibles |

### `zep_delete_thread`

Eliminar un hilo de conversación de Zep

#### Entrada

| Parámetro  | Tipo   | Obligatorio | Descripción            |
| ---------- | ------ | ----------- | ---------------------- |
| `threadId` | string | Sí          | ID del hilo a eliminar |
| `apiKey`   | string | Sí          | Tu clave API de Zep    |

#### Salida

| Parámetro | Tipo    | Descripción                     |
| --------- | ------- | ------------------------------- |
| `deleted` | boolean | Indica si el hilo fue eliminado |

### `zep_get_context`

Recuperar el contexto del usuario de un hilo con 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 sin procesar) |
| `minRating` | number | No          | Calificación mínima para filtrar hechos relevantes                             |
| `apiKey`    | string | Sí          | Tu clave API de Zep                                                            |

#### Salida

| Parámetro  | Tipo   | Descripción                              |
| ---------- | ------ | ---------------------------------------- |
| `context`  | string | La cadena de contexto (resumen o básico) |
| `facts`    | array  | Hechos extraídos                         |
| `entities` | array  | Entidades extraídas                      |
| `summary`  | string | Resumen de la conversación               |

### `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 (anula el límite y el cursor) |
| `apiKey`   | string | Sí          | Tu clave 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  |

### `zep_add_messages`

Añadir 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 rol y contenido |
| `apiKey`   | string | Sí          | Tu clave API de Zep                             |

#### Salida

| Parámetro    | Tipo   | Descripción                                     |
| ------------ | ------ | ----------------------------------------------- |
| `context`    | string | Contexto actualizado después de añadir mensajes |
| `messageIds` | array  | Array de UUIDs de mensajes añadidos             |
| `threadId`   | string | El ID del hilo                                  |

### `zep_add_user`

Crear un nuevo usuario en Zep

#### Entrada

| Parámetro   | Tipo   | Obligatorio | Descripción                                 |
| ----------- | ------ | ----------- | ------------------------------------------- |
| `userId`    | string | Sí          | Identificador único para el usuario         |
| `email`     | string | No          | Dirección de correo electrónico 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 API de Zep                         |

#### Salida

| Parámetro   | Tipo   | Descripción                    |
| ----------- | ------ | ------------------------------ |
| `userId`    | string | El ID del 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    |
| `metadata`  | object | Metadatos del usuario          |

### `zep_get_user`

Recuperar información del usuario de Zep

#### Entrada

| Parámetro | Tipo   | Obligatorio | Descripción                |
| --------- | ------ | ----------- | -------------------------- |
| `userId`  | string | Sí          | ID del usuario a recuperar |
| `apiKey`  | string | Sí          | Tu clave API de Zep        |

#### Salida

| Parámetro   | Tipo   | Descripción                             |
| ----------- | ------ | --------------------------------------- |
| `userId`    | string | El ID del 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                   |

### `zep_get_user_threads`

Listar todos los hilos de conversación para un usuario específico

#### Entrada

| Parámetro | Tipo   | Obligatorio | Descripción                           |
| --------- | ------ | ----------- | ------------------------------------- |
| `userId`  | string | Sí          | ID del usuario para obtener los hilos |
| `limit`   | number | No          | Número máximo de hilos a devolver     |
| `apiKey`  | string | Sí          | Tu clave API de Zep                   |

#### Salida

| Parámetro | Tipo   | Descripción                                |
| --------- | ------ | ------------------------------------------ |
| `threads` | array  | Array de objetos de hilo para este usuario |
| `userId`  | string | El ID del usuario                          |

## Notas

* Categoría: `tools`
* Tipo: `zep`