Skip to content

Commit 56d04a9

Browse files
icecrasher321icecrasher321
authored
feat(zep): add tools from Zep (#1646)
* feat(zep): add tools from Zep * correct icon * address greptile comments
1 parent 2ca9044 commit 56d04a9

File tree

20 files changed

+1549
-1
lines changed

20 files changed

+1549
-1
lines changed

‎apps/docs/content/docs/en/tools/meta.json‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,7 @@
7070
"whatsapp",
7171
"wikipedia",
7272
"x",
73-
"youtube"
73+
"youtube",
74+
"zep"
7475
]
7576
}

‎apps/docs/content/docs/en/tools/microsoft_teams.mdx‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,7 @@ Read content from a Microsoft Teams chat
113113
| Parameter | Type | Required | Description |
114114
| --------- | ---- | -------- | ----------- |
115115
| `chatId` | string | Yes | The ID of the chat to read from |
116+
| `includeAttachments` | boolean | No | Download and include message attachments \(hosted contents\) into storage |
116117

117118
#### Output
118119

@@ -125,6 +126,7 @@ Read content from a Microsoft Teams chat
125126
| `attachmentCount` | number | Total number of attachments found |
126127
| `attachmentTypes` | array | Types of attachments found |
127128
| `content` | string | Formatted content of chat messages |
129+
| `attachments` | file[] | Uploaded attachments for convenience \(flattened\) |
128130

129131
### `microsoft_teams_write_chat`
130132

@@ -158,6 +160,7 @@ Read content from a Microsoft Teams channel
158160
| --------- | ---- | -------- | ----------- |
159161
| `teamId` | string | Yes | The ID of the team to read from |
160162
| `channelId` | string | Yes | The ID of the channel to read from |
163+
| `includeAttachments` | boolean | No | Download and include message attachments \(hosted contents\) into storage |
161164

162165
#### Output
163166

@@ -171,6 +174,7 @@ Read content from a Microsoft Teams channel
171174
| `attachmentCount` | number | Total number of attachments found |
172175
| `attachmentTypes` | array | Types of attachments found |
173176
| `content` | string | Formatted content of channel messages |
177+
| `attachments` | file[] | Uploaded attachments for convenience \(flattened\) |
174178

175179
### `microsoft_teams_write_channel`
176180

‎apps/docs/content/docs/en/tools/outlook.mdx‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -206,13 +206,15 @@ Read emails from Outlook
206206
| --------- | ---- | -------- | ----------- |
207207
| `folder` | string | No | Folder ID to read emails from \(default: Inbox\) |
208208
| `maxResults` | number | No | Maximum number of emails to retrieve \(default: 1, max: 10\) |
209+
| `includeAttachments` | boolean | No | Download and include email attachments |
209210

210211
#### Output
211212

212213
| Parameter | Type | Description |
213214
| --------- | ---- | ----------- |
214215
| `message` | string | Success or status message |
215216
| `results` | array | Array of email message objects |
217+
| `attachments` | file[] | All email attachments flattened from all emails |
216218

217219
### `outlook_forward`
218220

‎apps/docs/content/docs/en/tools/zep.mdx‎

Lines changed: 246 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,246 @@
1+
---
2+
title: Zep
3+
description: Long-term memory for AI agents
4+
---
5+
6+
import { BlockInfoCard } from "@/components/ui/block-info-card"
7+
8+
<BlockInfoCard
9+
type="zep"
10+
color="#4F46E5"
11+
icon={true}
12+
iconSvg={`<svg className="block-icon"
13+
14+
15+
16+
viewBox='0 0 24 24'
17+
fill='none'
18+
xmlns='http://www.w3.org/2000/svg'
19+
>
20+
<path
21+
d='M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm0 18c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59 8-8 8z'
22+
fill='currentColor'
23+
/>
24+
<path
25+
d='M12 6c-3.31 0-6 2.69-6 6s2.69 6 6 6 6-2.69 6-6-2.69-6-6-6zm0 10c-2.21 0-4-1.79-4-4s1.79-4 4-4 4 1.79 4 4-1.79 4-4 4z'
26+
fill='currentColor'
27+
/>
28+
<circle cx='12' cy='12' r='2' fill='currentColor' />
29+
<path
30+
d='M8 8h8M8 16h8'
31+
stroke='currentColor'
32+
strokeWidth='1.5'
33+
strokeLinecap='round'
34+
/>
35+
</svg>`}
36+
/>
37+
38+
## Usage Instructions
39+
40+
Integrate Zep for long-term memory management. Create threads, add messages, retrieve context with AI-powered summaries and facts extraction.
41+
42+
43+
44+
## Tools
45+
46+
### `zep_create_thread`
47+
48+
Start a new conversation thread in Zep
49+
50+
#### Input
51+
52+
| Parameter | Type | Required | Description |
53+
| --------- | ---- | -------- | ----------- |
54+
| `threadId` | string | Yes | Unique identifier for the thread |
55+
| `userId` | string | Yes | User ID associated with the thread |
56+
| `apiKey` | string | Yes | Your Zep API key |
57+
58+
#### Output
59+
60+
| Parameter | Type | Description |
61+
| --------- | ---- | ----------- |
62+
| `threadId` | string | The thread ID |
63+
| `userId` | string | The user ID |
64+
| `uuid` | string | Internal UUID |
65+
| `createdAt` | string | Creation timestamp |
66+
| `projectUuid` | string | Project UUID |
67+
68+
### `zep_get_threads`
69+
70+
List all conversation threads
71+
72+
#### Input
73+
74+
| Parameter | Type | Required | Description |
75+
| --------- | ---- | -------- | ----------- |
76+
| `pageSize` | number | No | Number of threads to retrieve per page |
77+
| `pageNumber` | number | No | Page number for pagination |
78+
| `orderBy` | string | No | Field to order results by \(created_at, updated_at, user_id, thread_id\) |
79+
| `asc` | boolean | No | Order direction: true for ascending, false for descending |
80+
| `apiKey` | string | Yes | Your Zep API key |
81+
82+
#### Output
83+
84+
| Parameter | Type | Description |
85+
| --------- | ---- | ----------- |
86+
| `threads` | array | Array of thread objects |
87+
| `responseCount` | number | Number of threads in this response |
88+
| `totalCount` | number | Total number of threads available |
89+
90+
### `zep_delete_thread`
91+
92+
Delete a conversation thread from Zep
93+
94+
#### Input
95+
96+
| Parameter | Type | Required | Description |
97+
| --------- | ---- | -------- | ----------- |
98+
| `threadId` | string | Yes | Thread ID to delete |
99+
| `apiKey` | string | Yes | Your Zep API key |
100+
101+
#### Output
102+
103+
| Parameter | Type | Description |
104+
| --------- | ---- | ----------- |
105+
| `deleted` | boolean | Whether the thread was deleted |
106+
107+
### `zep_get_context`
108+
109+
Retrieve user context from a thread with summary or basic mode
110+
111+
#### Input
112+
113+
| Parameter | Type | Required | Description |
114+
| --------- | ---- | -------- | ----------- |
115+
| `threadId` | string | Yes | Thread ID to get context from |
116+
| `mode` | string | No | Context mode: "summary" \(natural language\) or "basic" \(raw facts\) |
117+
| `minRating` | number | No | Minimum rating by which to filter relevant facts |
118+
| `apiKey` | string | Yes | Your Zep API key |
119+
120+
#### Output
121+
122+
| Parameter | Type | Description |
123+
| --------- | ---- | ----------- |
124+
| `context` | string | The context string \(summary or basic\) |
125+
| `facts` | array | Extracted facts |
126+
| `entities` | array | Extracted entities |
127+
| `summary` | string | Conversation summary |
128+
129+
### `zep_get_messages`
130+
131+
Retrieve messages from a thread
132+
133+
#### Input
134+
135+
| Parameter | Type | Required | Description |
136+
| --------- | ---- | -------- | ----------- |
137+
| `threadId` | string | Yes | Thread ID to get messages from |
138+
| `limit` | number | No | Maximum number of messages to return |
139+
| `cursor` | string | No | Cursor for pagination |
140+
| `lastn` | number | No | Number of most recent messages to return \(overrides limit and cursor\) |
141+
| `apiKey` | string | Yes | Your Zep API key |
142+
143+
#### Output
144+
145+
| Parameter | Type | Description |
146+
| --------- | ---- | ----------- |
147+
| `messages` | array | Array of message objects |
148+
| `rowCount` | number | Number of messages in this response |
149+
| `totalCount` | number | Total number of messages in the thread |
150+
151+
### `zep_add_messages`
152+
153+
Add messages to an existing thread
154+
155+
#### Input
156+
157+
| Parameter | Type | Required | Description |
158+
| --------- | ---- | -------- | ----------- |
159+
| `threadId` | string | Yes | Thread ID to add messages to |
160+
| `messages` | json | Yes | Array of message objects with role and content |
161+
| `apiKey` | string | Yes | Your Zep API key |
162+
163+
#### Output
164+
165+
| Parameter | Type | Description |
166+
| --------- | ---- | ----------- |
167+
| `context` | string | Updated context after adding messages |
168+
| `messageIds` | array | Array of added message UUIDs |
169+
| `threadId` | string | The thread ID |
170+
171+
### `zep_add_user`
172+
173+
Create a new user in Zep
174+
175+
#### Input
176+
177+
| Parameter | Type | Required | Description |
178+
| --------- | ---- | -------- | ----------- |
179+
| `userId` | string | Yes | Unique identifier for the user |
180+
| `email` | string | No | User email address |
181+
| `firstName` | string | No | User first name |
182+
| `lastName` | string | No | User last name |
183+
| `metadata` | json | No | Additional metadata as JSON object |
184+
| `apiKey` | string | Yes | Your Zep API key |
185+
186+
#### Output
187+
188+
| Parameter | Type | Description |
189+
| --------- | ---- | ----------- |
190+
| `userId` | string | The user ID |
191+
| `email` | string | User email |
192+
| `firstName` | string | User first name |
193+
| `lastName` | string | User last name |
194+
| `uuid` | string | Internal UUID |
195+
| `createdAt` | string | Creation timestamp |
196+
| `metadata` | object | User metadata |
197+
198+
### `zep_get_user`
199+
200+
Retrieve user information from Zep
201+
202+
#### Input
203+
204+
| Parameter | Type | Required | Description |
205+
| --------- | ---- | -------- | ----------- |
206+
| `userId` | string | Yes | User ID to retrieve |
207+
| `apiKey` | string | Yes | Your Zep API key |
208+
209+
#### Output
210+
211+
| Parameter | Type | Description |
212+
| --------- | ---- | ----------- |
213+
| `userId` | string | The user ID |
214+
| `email` | string | User email |
215+
| `firstName` | string | User first name |
216+
| `lastName` | string | User last name |
217+
| `uuid` | string | Internal UUID |
218+
| `createdAt` | string | Creation timestamp |
219+
| `updatedAt` | string | Last update timestamp |
220+
| `metadata` | object | User metadata |
221+
222+
### `zep_get_user_threads`
223+
224+
List all conversation threads for a specific user
225+
226+
#### Input
227+
228+
| Parameter | Type | Required | Description |
229+
| --------- | ---- | -------- | ----------- |
230+
| `userId` | string | Yes | User ID to get threads for |
231+
| `limit` | number | No | Maximum number of threads to return |
232+
| `apiKey` | string | Yes | Your Zep API key |
233+
234+
#### Output
235+
236+
| Parameter | Type | Description |
237+
| --------- | ---- | ----------- |
238+
| `threads` | array | Array of thread objects for this user |
239+
| `userId` | string | The user ID |
240+
241+
242+
243+
## Notes
244+
245+
- Category: `tools`
246+
- Type: `zep`

‎apps/sim/app/(landing)/components/footer/footer.tsx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -90,6 +90,7 @@ const tools = [
9090
'Wikipedia',
9191
'X',
9292
'YouTube',
93+
'Zep',
9394
]
9495

9596
interface FooterProps {

0 commit comments

Comments
 (0)