类class io.agentscope.core.memory.mem0 2.x

Mem0SearchRequest

@JsonInclude(JsonInclude.Include.NON_NULL) public class Mem0SearchRequest

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:36–365

Mem 0 搜索请求，在多次调用之间保存和恢复会话与记忆数据。位于 io.agentscope.core.memory.mem0 包。核心成员包括 getQuery、setQuery、getVersion、setVersion、getFilters、setFilters。

Request object for searching memories in Mem0 v2 API.

This request is sent to the Mem0 API's POST /v2/memories/search/ endpoint to retrieve relevant memories based on a query string. The search uses semantic similarity to find the most relevant memories.

The v2 API uses a filters object to specify search criteria (user_id, agent_id, run_id, app_id, etc.), enabling proper memory isolation in multi-tenant scenarios. The filters field is required by the API and will be sent as an empty object if no filters are specified.

嵌套类摘要Nested Class Summary

类Class	类型Kind	说明Description
`Builder`	类class	Mem0SearchRequest的构建器。 Builder for Mem0SearchRequest.

构造器摘要Constructor Summary

构造器Constructor	说明Description
`public` `Mem0SearchRequest()`	初始化 `Mem0SearchRequest` 实例。 Default constructor for Jackson.

方法摘要Method Summary

方法Method	说明Description
`public String getQuery()`	获取查询。 Returns the query.
`public void setQuery(String query)`	设置查询。 Sets the query.
`public String getVersion()`	获取版本。 Returns the version.
`public void setVersion(String version)`	设置版本。 Sets the version.
`public Map<String, Object> getFilters()`	获取 `getFilters`。 Returns the filters.
`public void setFilters(Map<String, Object> filters)`	设置 `setFilters`。 Sets the filters.
`public Integer getTopK()`	获取 `getTopK`。 Returns the top k.
`public void setTopK(Integer topK)`	设置 `setTopK`。 Sets the top k.
`public List<String> getFields()`	获取 `getFields`。 Returns the fields.
`public void setFields(List<String> fields)`	设置 `setFields`。 Sets the fields.
`public Boolean getRerank()`	获取重排。 Returns the rerank.
`public void setRerank(Boolean rerank)`	设置重排。 Sets the rerank.
`public Boolean getKeywordSearch()`	获取 `getKeywordSearch`。 Returns the keyword search.
`public void setKeywordSearch(Boolean keywordSearch)`	设置 `setKeywordSearch`。 Sets the keyword search.
`public Boolean getFilterMemories()`	获取 `getFilterMemories`。 Returns the filter memories.
`public void setFilterMemories(Boolean filterMemories)`	设置 `setFilterMemories`。 Sets the filter memories.
`public Double getThreshold()`	获取阈值。 Returns the threshold.
`public void setThreshold(Double threshold)`	设置阈值。 Sets the threshold.
`public String getOrgId()`	获取 `getOrgId`。 Returns the org id.
`public void setOrgId(String orgId)`	设置 `setOrgId`。 Sets the org id.
`public String getProjectId()`	获取 `getProjectId`。 Returns the project id.
`public void setProjectId(String projectId)`	设置 `setProjectId`。 Sets the project id.
`public String getUserId()`	获取用户标识。 Returns the user id.
`public void setUserId(String userId)`	设置用户标识。 Sets the user id.
`public static Builder builder()` static	创建新的构建器用于 Mem0SearchRequest。 Creates a new builder for Mem0SearchRequest.

构造器详情Constructor Detail

Mem0SearchRequest

public Mem0SearchRequest()

初始化 Mem0SearchRequest 实例。

Default constructor for Jackson.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:86–90

方法详情Method Detail

getQuery

public String getQuery()

获取查询。

Returns the query.

返回Returns String

返回字符串结果。Returns a string.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:94–96

setQuery

public void setQuery(String query)

设置查询。

Sets the query.

参数Parameters

名称Name	类型Type	说明Description
`query`	String	查询文本（类型 `String`）。The query.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:98–100

getVersion

public String getVersion()

获取版本。

Returns the version.

返回Returns String

返回字符串结果。Returns a string.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:102–104

setVersion

public void setVersion(String version)

设置版本。

Sets the version.

参数Parameters

名称Name	类型Type	说明Description
`version`	String	版本（类型 `String`）。The version.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:106–108

getFilters

public Map<String, Object> getFilters()

获取 getFilters。

Returns the filters.

返回Returns Map<String, Object>

返回映射。Returns map.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:110–112

setFilters

public void setFilters(Map<String, Object> filters)

设置 setFilters。

Sets the filters.

参数Parameters

名称Name	类型Type	说明Description
`filters`	Map<String, Object>	filters（类型 `Map`）。The filters.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:114–116

getTopK

public Integer getTopK()

获取 getTopK。

Returns the top k.

返回Returns Integer

返回数值结果。Returns a numeric result.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:118–120

setTopK

public void setTopK(Integer topK)

设置 setTopK。

Sets the top k.

参数Parameters

名称Name	类型Type	说明Description
`topK`	Integer	top K（类型 `Integer`）。The top k.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:122–124

getFields

public List<String> getFields()

获取 getFields。

Returns the fields.

返回Returns List<String>

返回列出。Returns list.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:126–128

setFields

public void setFields(List<String> fields)

设置 setFields。

Sets the fields.

参数Parameters

名称Name	类型Type	说明Description
`fields`	List<String>	fields（类型 `List`）。The fields.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:130–132

getRerank

public Boolean getRerank()

获取重排。

Returns the rerank.

返回Returns Boolean

返回布尔值，表示判断结果。Returns a boolean result.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:134–136

setRerank

public void setRerank(Boolean rerank)

设置重排。

Sets the rerank.

参数Parameters

名称Name	类型Type	说明Description
`rerank`	Boolean	重排（类型 `Boolean`）。The rerank.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:138–140

getKeywordSearch

public Boolean getKeywordSearch()

获取 getKeywordSearch。

Returns the keyword search.

返回Returns Boolean

返回布尔值，表示判断结果。Returns a boolean result.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:142–144

setKeywordSearch

public void setKeywordSearch(Boolean keywordSearch)

设置 setKeywordSearch。

Sets the keyword search.

参数Parameters

名称Name	类型Type	说明Description
`keywordSearch`	Boolean	keyword 搜索（类型 `Boolean`）。The keyword search.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:146–148

getFilterMemories

public Boolean getFilterMemories()

获取 getFilterMemories。

Returns the filter memories.

返回Returns Boolean

返回布尔值，表示判断结果。Returns a boolean result.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:150–152

setFilterMemories

public void setFilterMemories(Boolean filterMemories)

设置 setFilterMemories。

Sets the filter memories.

参数Parameters

名称Name	类型Type	说明Description
`filterMemories`	Boolean	过滤 Memories（类型 `Boolean`）。The filter memories.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:154–156

getThreshold

public Double getThreshold()

获取阈值。

Returns the threshold.

返回Returns Double

返回数值结果。Returns a numeric result.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:158–160

setThreshold

public void setThreshold(Double threshold)

设置阈值。

Sets the threshold.

参数Parameters

名称Name	类型Type	说明Description
`threshold`	Double	阈值（类型 `Double`）。The threshold.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:162–164

getOrgId

public String getOrgId()

获取 getOrgId。

Returns the org id.

返回Returns String

返回字符串结果。Returns a string.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:166–168

setOrgId

public void setOrgId(String orgId)

设置 setOrgId。

Sets the org id.

参数Parameters

名称Name	类型Type	说明Description
`orgId`	String	org 标识（类型 `String`）。The org id.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:170–172

getProjectId

public String getProjectId()

获取 getProjectId。

Returns the project id.

返回Returns String

返回字符串结果。Returns a string.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:174–176

setProjectId

public void setProjectId(String projectId)

设置 setProjectId。

Sets the project id.

参数Parameters

名称Name	类型Type	说明Description
`projectId`	String	project 标识（类型 `String`）。The project id.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:178–180

getUserId

public String getUserId()

获取用户标识。

Returns the user id.

返回Returns String

返回字符串结果。Returns a string.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:182–184

setUserId

public void setUserId(String userId)

设置用户标识。

Sets the user id.

参数Parameters

名称Name	类型Type	说明Description
`userId`	String	用户标识（类型 `String`）。The user id.

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:186–192

builder

public static Builder builder()

static

创建新的构建器用于 Mem0SearchRequest。

Creates a new builder for Mem0SearchRequest.

返回Returns Builder

一种新的构建器实例。A new builder instance

源码Source io/agentscope/core/memory/mem0/Mem0SearchRequest.java:199–201

嵌套类详情Nested Class Detail

Builder

public static class Builder

Mem0SearchRequest的构建器。位于 io.agentscope.core.memory.mem0 包。核心成员包括 query、version、filters、getFilters、agentId、userId。

Builder for Mem0SearchRequest.