Zep - Agno

ZepTools 使智能体能够与 Zep 内存系统进行交互，提供存储、检索和搜索与用户会话相关的内存数据的功能。

前提条件

ZepTools 需要 zep-cloud Python 包和 Zep API 密钥。

pip install zep-cloud

export ZEP_API_KEY=your_api_key

示例

以下示例演示了如何创建一个拥有 Zep 内存访问权限的智能体：

cookbook/tools/zep_tools.py

import time

from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.tools.zep import ZepTools

# 初始化 ZepTools
zep_tools = ZepTools(user_id="agno", session_id="agno-session", add_instructions=True)

# 初始化智能体
agent = Agent(
    model=OpenAIChat(),
    tools=[zep_tools],
    context={"memory": zep_tools.get_zep_memory(memory_type="context")},
    add_context=True,
)

# 与智能体交互，使其了解用户
agent.print_response("My name is John Billings")
agent.print_response("I live in NYC")
agent.print_response("I'm going to a concert tomorrow")

# 允许内存与 Zep 数据库同步
time.sleep(10)

# 刷新上下文
agent.context["memory"] = zep_tools.get_zep_memory(memory_type="context")

# 询问智能体关于用户的信息
agent.print_response("What do you know about me?")

Toolkit 参数

参数	类型	默认值	描述
`session_id`	`str`	`None`	可选的会话 ID。如果未提供，将自动生成。
`user_id`	`str`	`None`	可选的用户 ID。如果未提供，将自动生成。
`api_key`	`str`	`None`	Zep API 密钥。如果未提供，则使用 ZEP_API_KEY 环境变量。
`ignore_assistant_messages`	`bool`	`False`	添加到内存时是否忽略助手消息。
`add_zep_message`	`bool`	`True`	向当前 Zep 会话内存添加消息。
`get_zep_memory`	`bool`	`True`	为当前 Zep 会话检索内存。
`search_zep_memory`	`bool`	`True`	在 Zep 内存存储中搜索相关信息。
`instructions`	`str`	`None`	使用 Zep 工具的自定义说明。
`add_instructions`	`bool`	`False`	是否添加默认说明。

Toolkit 函数

函数	描述
`add_zep_message`	向当前 Zep 会话内存添加消息。接受消息发送者的 `role` (str) 和消息文本的 `content` (str)。返回确认或错误消息。
`get_zep_memory`	为当前 Zep 会话检索内存。接受可选的 `memory_type` (str) 参数，选项包括 “context” (默认)、“summary” 或 “messages”。返回请求的内存内容或错误。
`search_zep_memory`	在 Zep 内存存储中搜索相关信息。接受 `query` (str) 以查找相关事实和可选的 `search_scope` (str) 参数，选项包括 “messages” (默认) 或 “summary”。返回搜索结果或错误消息。

Async Toolkit

ZepAsyncTools 类扩展了 ZepTools 类，并提供了工具函数的异步版本。

开发者资源

查看 Tools
查看 Cookbook
查看 Async Cookbook