Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion apps/docs/content/docs/en/tools/meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,7 @@
"whatsapp",
"wikipedia",
"x",
"youtube"
"youtube",
"zep"
]
}
4 changes: 4 additions & 0 deletions apps/docs/content/docs/en/tools/microsoft_teams.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -113,6 +113,7 @@ Read content from a Microsoft Teams chat
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `chatId` | string | Yes | The ID of the chat to read from |
| `includeAttachments` | boolean | No | Download and include message attachments \(hosted contents\) into storage |

#### Output

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

### `microsoft_teams_write_chat`

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

#### Output

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

### `microsoft_teams_write_channel`

Expand Down
2 changes: 2 additions & 0 deletions apps/docs/content/docs/en/tools/outlook.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -206,13 +206,15 @@ Read emails from Outlook
| --------- | ---- | -------- | ----------- |
| `folder` | string | No | Folder ID to read emails from \(default: Inbox\) |
| `maxResults` | number | No | Maximum number of emails to retrieve \(default: 1, max: 10\) |
| `includeAttachments` | boolean | No | Download and include email attachments |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success or status message |
| `results` | array | Array of email message objects |
| `attachments` | file[] | All email attachments flattened from all emails |

### `outlook_forward`

Expand Down
246 changes: 246 additions & 0 deletions apps/docs/content/docs/en/tools/zep.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,246 @@
---
title: Zep
description: Long-term memory for AI agents
---

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

<BlockInfoCard
type="zep"
color="#4F46E5"
icon={true}
iconSvg={`<svg className="block-icon"



viewBox='0 0 24 24'
fill='none'
xmlns='http://www.w3.org/2000/svg'
>
<path
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'
fill='currentColor'
/>
<path
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'
fill='currentColor'
/>
<circle cx='12' cy='12' r='2' fill='currentColor' />
<path
d='M8 8h8M8 16h8'
stroke='currentColor'
strokeWidth='1.5'
strokeLinecap='round'
/>
</svg>`}
/>

## Usage Instructions

Integrate Zep for long-term memory management. Create threads, add messages, retrieve context with AI-powered summaries and facts extraction.



## Tools

### `zep_create_thread`

Start a new conversation thread in Zep

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `threadId` | string | Yes | Unique identifier for the thread |
| `userId` | string | Yes | User ID associated with the thread |
| `apiKey` | string | Yes | Your Zep API key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `threadId` | string | The thread ID |
| `userId` | string | The user ID |
| `uuid` | string | Internal UUID |
| `createdAt` | string | Creation timestamp |
| `projectUuid` | string | Project UUID |

### `zep_get_threads`

List all conversation threads

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `pageSize` | number | No | Number of threads to retrieve per page |
| `pageNumber` | number | No | Page number for pagination |
| `orderBy` | string | No | Field to order results by \(created_at, updated_at, user_id, thread_id\) |
| `asc` | boolean | No | Order direction: true for ascending, false for descending |
| `apiKey` | string | Yes | Your Zep API key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `threads` | array | Array of thread objects |
| `responseCount` | number | Number of threads in this response |
| `totalCount` | number | Total number of threads available |

### `zep_delete_thread`

Delete a conversation thread from Zep

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `threadId` | string | Yes | Thread ID to delete |
| `apiKey` | string | Yes | Your Zep API key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `deleted` | boolean | Whether the thread was deleted |

### `zep_get_context`

Retrieve user context from a thread with summary or basic mode

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `threadId` | string | Yes | Thread ID to get context from |
| `mode` | string | No | Context mode: "summary" \(natural language\) or "basic" \(raw facts\) |
| `minRating` | number | No | Minimum rating by which to filter relevant facts |
| `apiKey` | string | Yes | Your Zep API key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `context` | string | The context string \(summary or basic\) |
| `facts` | array | Extracted facts |
| `entities` | array | Extracted entities |
| `summary` | string | Conversation summary |

### `zep_get_messages`

Retrieve messages from a thread

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `threadId` | string | Yes | Thread ID to get messages from |
| `limit` | number | No | Maximum number of messages to return |
| `cursor` | string | No | Cursor for pagination |
| `lastn` | number | No | Number of most recent messages to return \(overrides limit and cursor\) |
| `apiKey` | string | Yes | Your Zep API key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `messages` | array | Array of message objects |
| `rowCount` | number | Number of messages in this response |
| `totalCount` | number | Total number of messages in the thread |

### `zep_add_messages`

Add messages to an existing thread

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `threadId` | string | Yes | Thread ID to add messages to |
| `messages` | json | Yes | Array of message objects with role and content |
| `apiKey` | string | Yes | Your Zep API key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `context` | string | Updated context after adding messages |
| `messageIds` | array | Array of added message UUIDs |
| `threadId` | string | The thread ID |

### `zep_add_user`

Create a new user in Zep

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `userId` | string | Yes | Unique identifier for the user |
| `email` | string | No | User email address |
| `firstName` | string | No | User first name |
| `lastName` | string | No | User last name |
| `metadata` | json | No | Additional metadata as JSON object |
| `apiKey` | string | Yes | Your Zep API key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `userId` | string | The user ID |
| `email` | string | User email |
| `firstName` | string | User first name |
| `lastName` | string | User last name |
| `uuid` | string | Internal UUID |
| `createdAt` | string | Creation timestamp |
| `metadata` | object | User metadata |

### `zep_get_user`

Retrieve user information from Zep

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `userId` | string | Yes | User ID to retrieve |
| `apiKey` | string | Yes | Your Zep API key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `userId` | string | The user ID |
| `email` | string | User email |
| `firstName` | string | User first name |
| `lastName` | string | User last name |
| `uuid` | string | Internal UUID |
| `createdAt` | string | Creation timestamp |
| `updatedAt` | string | Last update timestamp |
| `metadata` | object | User metadata |

### `zep_get_user_threads`

List all conversation threads for a specific user

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `userId` | string | Yes | User ID to get threads for |
| `limit` | number | No | Maximum number of threads to return |
| `apiKey` | string | Yes | Your Zep API key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `threads` | array | Array of thread objects for this user |
| `userId` | string | The user ID |



## Notes

- Category: `tools`
- Type: `zep`
1 change: 1 addition & 0 deletions apps/sim/app/(landing)/components/footer/footer.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -90,6 +90,7 @@ const tools = [
'Wikipedia',
'X',
'YouTube',
'Zep',
]

interface FooterProps {
Expand Down
Loading