Zep

Instruções de Uso

Integre o Zep para gerenciamento de memória de longo prazo. Crie threads, adicione mensagens, recupere contexto com resumos alimentados por IA e extração de fatos.

Ferramentas

`zep_create_thread`

Inicia uma nova thread de conversa no Zep

Input

Parâmetro	Tipo	Obrigatório	Descrição
`threadId`	string	Sim	Identificador único para a thread
`userId`	string	Sim	ID do usuário associado à thread
`apiKey`	string	Sim	Sua chave de API do Zep

Output

Parâmetro	Tipo	Descrição
`threadId`	string	O ID da thread
`userId`	string	O ID do usuário
`uuid`	string	UUID interno
`createdAt`	string	Timestamp de criação
`projectUuid`	string	UUID do projeto

`zep_get_threads`

Lista todas as threads de conversa

Input

Parâmetro	Tipo	Obrigatório	Descrição
`pageSize`	number	Não	Número de threads a recuperar por página
`pageNumber`	number	Não	Número da página para paginação
`orderBy`	string	Não	Campo para ordenar resultados por (created_at, updated_at, user_id, thread_id)
`asc`	boolean	Não	Direção da ordenação: true para crescente, false para decrescente
`apiKey`	string	Sim	Sua chave de API do Zep

Output

Parâmetro	Tipo	Descrição
`threads`	array	Array de objetos de thread
`responseCount`	number	Número de threads nesta resposta
`totalCount`	number	Número total de threads disponíveis

`zep_delete_thread`

Exclui uma thread de conversa do Zep

Input

Parâmetro	Tipo	Obrigatório	Descrição
`threadId`	string	Sim	ID da thread a excluir
`apiKey`	string	Sim	Sua chave de API do Zep

Output

Parâmetro	Tipo	Descrição
`deleted`	boolean	Se a thread foi excluída

`zep_get_context`

Recupera o contexto do usuário de uma thread com modo de resumo ou básico

Input

Parâmetro	Tipo	Obrigatório	Descrição
`threadId`	string	Sim	ID da thread para obter contexto
`mode`	string	Não	Modo de contexto: "summary" (linguagem natural) ou "basic" (fatos brutos)
`minRating`	number	Não	Classificação mínima pela qual filtrar fatos relevantes
`apiKey`	string	Sim	Sua chave de API do Zep

Output

Parâmetro	Tipo	Descrição
`context`	string	A string de contexto (resumo ou básico)
`facts`	array	Fatos extraídos
`entities`	array	Entidades extraídas
`summary`	string	Resumo da conversa

`zep_get_messages`

Recupera mensagens de uma thread

Input

Parâmetro	Tipo	Obrigatório	Descrição
`threadId`	string	Sim	ID da thread para obter mensagens
`limit`	number	Não	Número máximo de mensagens a retornar
`cursor`	string	Não	Cursor para paginação
`lastn`	number	Não	Número de mensagens mais recentes a retornar (sobrescreve limit e cursor)
`apiKey`	string	Sim	Sua chave de API do Zep

Output

Parâmetro	Tipo	Descrição
`messages`	array	Array de objetos de mensagem
`rowCount`	number	Número de mensagens nesta resposta
`totalCount`	number	Número total de mensagens na thread

`zep_add_messages`

Adiciona mensagens a uma thread existente

Input

Parâmetro	Tipo	Obrigatório	Descrição
`threadId`	string	Sim	ID da thread para adicionar mensagens
`messages`	json	Sim	Array de objetos de mensagem com role e content
`apiKey`	string	Sim	Sua chave de API do Zep

Output

Parâmetro	Tipo	Descrição
`context`	string	Contexto atualizado após adicionar mensagens
`messageIds`	array	Array de UUIDs de mensagens adicionadas
`threadId`	string	O ID da thread

`zep_add_user`

Cria um novo usuário no Zep

Input

Parâmetro	Tipo	Obrigatório	Descrição
`userId`	string	Sim	Identificador único para o usuário
`email`	string	Não	Endereço de email do usuário
`firstName`	string	Não	Primeiro nome do usuário
`lastName`	string	Não	Sobrenome do usuário
`metadata`	json	Não	Metadados adicionais como objeto JSON
`apiKey`	string	Sim	Sua chave de API do Zep

Output

Parâmetro	Tipo	Descrição
`userId`	string	O ID do usuário
`email`	string	Email do usuário
`firstName`	string	Primeiro nome do usuário
`lastName`	string	Sobrenome do usuário
`uuid`	string	UUID interno
`createdAt`	string	Timestamp de criação
`metadata`	object	Metadados do usuário

`zep_get_user`

Recupera informações do usuário do Zep

Input

Parâmetro	Tipo	Obrigatório	Descrição
`userId`	string	Sim	ID do usuário a recuperar
`apiKey`	string	Sim	Sua chave de API do Zep

Output

Parâmetro	Tipo	Descrição
`userId`	string	O ID do usuário
`email`	string	Email do usuário
`firstName`	string	Primeiro nome do usuário
`lastName`	string	Sobrenome do usuário
`uuid`	string	UUID interno
`createdAt`	string	Timestamp de criação
`updatedAt`	string	Timestamp da última atualização
`metadata`	object	Metadados do usuário

`zep_get_user_threads`

Lista todas as threads de conversa para um usuário específico

Input

Parâmetro	Tipo	Obrigatório	Descrição
`userId`	string	Sim	ID do usuário para obter threads
`limit`	number	Não	Número máximo de threads a retornar
`apiKey`	string	Sim	Sua chave de API do Zep

Output

Parâmetro	Tipo	Descrição
`threads`	array	Array de objetos de thread para este usuário
`userId`	string	O ID do usuário

Notes

Category: tools
Type: zep

Zep

On this page