Zep

配置

创建线程

操作

创建线程

API 密钥*

••••••••

线程 ID*

输入唯一线程标识符

用户 ID*

输入用户标识符

创建线程 (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

添加消息

操作

添加消息

API 密钥*

••••••••

线程 ID*

输入唯一线程标识符

消息*

json

[{"role": "user", "content": "Hello!"}]

添加消息 (zep_add_messages)

向现有线程添加消息

输入

参数	类型	必填	说明
`threadId`	string	是	要添加消息的线程 ID
`messages`	json	是	包含 role 和 content 的消息对象数组
`apiKey`	string	是	你的 Zep API 密钥

输出

参数	类型	说明
`context`	string	添加消息后的更新上下文
`messageIds`	array	已添加消息的 UUID 数组
`threadId`	string	线程 ID

获取上下文

操作

获取上下文

API 密钥*

••••••••

线程 ID*

输入唯一线程标识符

上下文模式

摘要（自然语言）

获取上下文 (zep_get_context)

以摘要或基础模式从线程检索用户上下文

输入

参数	类型	必填	说明
`threadId`	string	是	要从中获取上下文的线程 ID
`mode`	string	否	上下文模式："summary" (自然语言) 或 "basic" (原始事实)
`minRating`	number	否	用于筛选相关事实的最低评分
`apiKey`	string	是	你的 Zep API 密钥

输出

参数	类型	说明
`context`	string	上下文字符串 (summary 或 basic)
`facts`	array	提取的事实
`entities`	array	提取的实体
`summary`	string	对话摘要

获取消息

操作

获取消息

API 密钥*

••••••••

线程 ID*

输入唯一的线程标识符

结果上限

获取消息（zep_get_messages）

从线程中检索消息

输入

参数	类型	必填	说明
`threadId`	string	是	要从中获取消息的线程 ID
`limit`	number	否	返回的最大消息数
`cursor`	string	否	分页游标
`lastn`	number	否	要返回的最近消息数量（覆盖 limit 和 cursor）
`apiKey`	string	是	你的 Zep API 密钥

输出

参数	类型	说明
`messages`	array	消息对象数组
`rowCount`	number	本次响应中的消息数量
`totalCount`	number	线程中的消息总数

获取线程

操作

获取线程

API 密钥*

••••••••

结果上限

获取线程（zep_get_threads）

列出所有会话线程

输入

参数	类型	必填	说明
`pageSize`	number	否	每页获取的线程数量
`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	可用线程总数

删除线程

操作

删除线程

API 密钥*

••••••••

线程 ID*

输入唯一线程标识符

删除线程（zep_delete_thread）

从 Zep 删除会话线程

输入

参数	类型	必填	说明
`threadId`	string	是	要删除的线程 ID
`apiKey`	string	是	你的 Zep API 密钥

输出

参数	类型	说明
`deleted`	boolean	线程是否已删除

添加用户

操作

添加用户

API 密钥*

••••••••

用户 ID*

输入用户标识符

邮箱

user@example.com

名

John

姓

Doe

元数据

json

{"key": "value"}

添加用户（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	用户元数据

获取用户

操作

获取用户

API 密钥*

••••••••

用户 ID*

输入用户标识符

获取用户（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	用户元数据

获取用户会话

操作

获取用户会话

API 密钥*

••••••••

用户 ID*

输入用户标识符

获取用户线程 (zep_get_user_threads)

列出指定用户的所有会话线程

输入

参数	类型	必填	说明
`userId`	string	是	要获取线程的用户 ID
`limit`	number	否	返回的最大线程数
`apiKey`	string	是	你的 Zep API 密钥

输出

参数	类型	说明
`threads`	array	该用户的线程对象数组
`userId`	string	用户 ID

使用说明

集成 Zep 以进行长期记忆管理。创建线程、添加消息，并检索包含 AI 摘要和事实提取的上下文。

备注

分类：tools
类型：zep

Zep

On this page