---
title: Zep
description: AIエージェント用の長期記憶
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<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>`}
/>

## 使用方法

Zepを統合して長期記憶管理を実現。スレッドの作成、メッセージの追加、AI駆動の要約や事実抽出によるコンテキストの取得が可能です。

## ツール

### `zep_create_thread`

Zepで新しい会話スレッドを開始する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `threadId` | string | はい | スレッドの一意の識別子 |
| `userId` | string | はい | スレッドに関連付けられたユーザーID |
| `apiKey` | string | はい | あなたのZep APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `threadId` | string | スレッドID |
| `userId` | string | ユーザーID |
| `uuid` | string | 内部UUID |
| `createdAt` | string | 作成タイムスタンプ |
| `projectUuid` | string | プロジェクトUUID |

### `zep_get_threads`

すべての会話スレッドを一覧表示する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `pageSize` | number | いいえ | 1ページあたりに取得するスレッド数 |
| `pageNumber` | number | いいえ | ページネーションのページ番号 |
| `orderBy` | string | いいえ | 結果を並べ替える項目（created_at、updated_at、user_id、thread_id） |
| `asc` | boolean | いいえ | 並べ替え方向：昇順はtrue、降順はfalse |
| `apiKey` | string | はい | あなたのZep APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `threads` | array | スレッドオブジェクトの配列 |
| `responseCount` | number | このレスポンスに含まれるスレッドの数 |
| `totalCount` | number | 利用可能なスレッドの総数 |

### `zep_delete_thread`

Zepから会話スレッドを削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `threadId` | string | はい | 削除するスレッドID |
| `apiKey` | string | はい | あなたのZep APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `deleted` | boolean | スレッドが削除されたかどうか |

### `zep_get_context`

サマリーモードまたは基本モードでスレッドからユーザーコンテキストを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `threadId` | string | はい | コンテキストを取得するスレッドID |
| `mode` | string | いいえ | コンテキストモード：「summary」（自然言語）または「basic」（生のファクト） |
| `minRating` | number | いいえ | 関連するファクトをフィルタリングする最小評価 |
| `apiKey` | string | はい | あなたのZep APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `context` | string | コンテキスト文字列（サマリーまたは基本） |
| `facts` | array | 抽出されたファクト |
| `entities` | array | 抽出されたエンティティ |
| `summary` | string | 会話のサマリー |

### `zep_get_messages`

スレッドからメッセージを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `threadId` | string | はい | メッセージを取得するスレッドID |
| `limit` | number | いいえ | 返すメッセージの最大数 |
| `cursor` | string | いいえ | ページネーション用のカーソル |
| `lastn` | number | いいえ | 返す最新メッセージの数（limitとcursorより優先される） |
| `apiKey` | string | はい | あなたのZep APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `messages` | array | メッセージオブジェクトの配列 |
| `rowCount` | number | このレスポンスに含まれるメッセージの数 |
| `totalCount` | number | スレッド内のメッセージの総数 |

### `zep_add_messages`

既存のスレッドにメッセージを追加する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `threadId` | string | はい | メッセージを追加するスレッドID |
| `messages` | json | はい | ロールとコンテンツを持つメッセージオブジェクトの配列 |
| `apiKey` | string | はい | あなたのZep APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `context` | string | メッセージ追加後の更新されたコンテキスト |
| `messageIds` | array | 追加されたメッセージUUIDの配列 |
| `threadId` | string | スレッドID |

### `zep_add_user`

Zepで新しいユーザーを作成する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `userId` | string | はい | ユーザーの一意の識別子 |
| `email` | string | いいえ | ユーザーのメールアドレス |
| `firstName` | string | いいえ | ユーザーの名 |
| `lastName` | string | いいえ | ユーザーの姓 |
| `metadata` | json | いいえ | JSONオブジェクトとしての追加メタデータ |
| `apiKey` | string | はい | あなたのZep APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `userId` | string | ユーザーID |
| `email` | string | ユーザーのメール |
| `firstName` | string | ユーザーの名 |
| `lastName` | string | ユーザーの姓 |
| `uuid` | string | 内部UUID |
| `createdAt` | string | 作成タイムスタンプ |
| `metadata` | object | ユーザーメタデータ |

### `zep_get_user`

Zepからユーザー情報を取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `userId` | string | はい | 取得するユーザーID |
| `apiKey` | string | はい | あなたのZep APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `userId` | string | ユーザーID |
| `email` | string | ユーザーのメール |
| `firstName` | string | ユーザーの名 |
| `lastName` | string | ユーザーの姓 |
| `uuid` | string | 内部UUID |
| `createdAt` | string | 作成タイムスタンプ |
| `updatedAt` | string | 最終更新タイムスタンプ |
| `metadata` | object | ユーザーメタデータ |

### `zep_get_user_threads`

特定のユーザーのすべての会話スレッドを一覧表示する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `userId` | string | はい | スレッドを取得するユーザーID |
| `limit` | number | いいえ | 返すスレッドの最大数 |
| `apiKey` | string | はい | あなたのZep APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `threads` | array | このユーザーのスレッドオブジェクトの配列 |
| `userId` | string | ユーザーID |

## 注意事項

- カテゴリー: `tools`
- タイプ: `zep`
