Memory

Instruções de Uso

Integre o Memory no fluxo de trabalho. Pode adicionar, obter uma memória, obter todas as memórias e excluir memórias.

Adicionar uma nova memória ao banco de dados ou anexar a uma memória existente com o mesmo ID.

Parâmetro	Tipo	Obrigatório	Descrição
`conversationId`	string	Não	Identificador de conversa (ex: user-123, session-abc). Se uma memória com este conversationId já existir para este bloco, a nova mensagem será anexada a ela.
`id`	string	Não	Parâmetro legado para identificador de conversa. Use conversationId em vez disso. Fornecido para compatibilidade retroativa.
`role`	string	Sim	Função para memória do agente (user, assistant ou system)
`content`	string	Sim	Conteúdo para memória do agente
`blockId`	string	Não	ID de bloco opcional. Se não fornecido, usa o ID do bloco atual do contexto de execução ou padrão para "default".

Parâmetro	Tipo	Descrição
`success`	boolean	Se a memória foi adicionada com sucesso
`memories`	array	Array de objetos de memória incluindo a nova ou atualizada memória
`error`	string	Mensagem de erro se a operação falhou

Recuperar memória por conversationId, blockId, blockName ou uma combinação. Retorna todas as memórias correspondentes.

Parâmetro	Tipo	Obrigatório	Descrição
`conversationId`	string	Não	Identificador de conversa (ex: user-123, session-abc). Se fornecido sozinho, retorna todas as memórias para esta conversa em todos os blocos.
`id`	string	Não	Parâmetro legado para identificador de conversa. Use conversationId em vez disso. Fornecido para compatibilidade retroativa.
`blockId`	string	Não	Identificador de bloco. Se fornecido sozinho, retorna todas as memórias para este bloco em todas as conversas. Se fornecido com conversationId, retorna memórias para aquela conversa específica neste bloco.
`blockName`	string	Não	Nome do bloco. Alternativa a blockId. Se fornecido sozinho, retorna todas as memórias para blocos com este nome. Se fornecido com conversationId, retorna memórias para aquela conversa em blocos com este nome.

Parâmetro	Tipo	Descrição
`success`	boolean	Se a memória foi recuperada com sucesso
`memories`	array	Array de objetos de memória com campos conversationId, blockId, blockName e data
`message`	string	Mensagem de sucesso ou erro
`error`	string	Mensagem de erro se a operação falhou

Recuperar todas as memórias do banco de dados

Parâmetro	Tipo	Obrigatório	Descrição

Parâmetro	Tipo	Descrição
`success`	boolean	Se todas as memórias foram recuperadas com sucesso
`memories`	array	Array de todos os objetos de memória com campos key, conversationId, blockId, blockName e data
`message`	string	Mensagem de sucesso ou erro
`error`	string	Mensagem de erro se a operação falhou

Excluir memórias por conversationId, blockId, blockName ou uma combinação. Suporta exclusão em massa.

Parâmetro	Tipo	Obrigatório	Descrição
`conversationId`	string	Não	Identificador de conversa (ex: user-123, session-abc). Se fornecido sozinho, exclui todas as memórias para esta conversa em todos os blocos.
`id`	string	Não	Parâmetro legado para identificador de conversa. Use conversationId em vez disso. Fornecido para compatibilidade retroativa.
`blockId`	string	Não	Identificador de bloco. Se fornecido sozinho, exclui todas as memórias para este bloco em todas as conversas. Se fornecido com conversationId, exclui memórias para aquela conversa específica neste bloco.
`blockName`	string	Não	Nome do bloco. Alternativa a blockId. Se fornecido sozinho, exclui todas as memórias para blocos com este nome. Se fornecido com conversationId, exclui memórias para aquela conversa em blocos com este nome.

Parâmetro	Tipo	Descrição
`success`	boolean	Se a memória foi excluída com sucesso
`message`	string	Mensagem de sucesso ou erro
`error`	string	Mensagem de erro se a operação falhou