Agent/examples/create/skills/search_by_element.md

---

name: element_search

description: 根据元素值在图数据库中检索关联的点

元素关联检索

你可以通过元素关联检索工具 search_by_element 在图数据库的 elements 字段中查找包含特定元素的点。

使用场景

• 查找包含特定风格、技法、物品等元素的关键点
• 发现与某个元素相关的灵感点、目的点
• 探索元素在不同路径下的分布情况

工具说明

search_by_element(element_value, top_k=10)

参数：

• element_value: 元素值，如 "全景光绘摄影"、"奶油风"、"法式风格"
• top_k: 返回数量，默认 10

返回信息：

• point: 点的完整名称
• element_frequency: 该元素在此点中的出现频率
• point_type: 点类型（灵感点/目的点/关键点）
• path: 点的路径
• frequency_in_posts: 该点在帖子中的总频率
• edge_count: 该点的关联边数量

使用示例

# 查找包含"奶油风"的点
result = await search_by_element("奶油风", top_k=5)

# 查找包含"全景光绘摄影"的点
result = await search_by_element("全景光绘摄影")

注意事项

• 搜索结果按点的 frequency_in_posts 降序排序
• 可以通过多次搜索不同元素来探索关联关系
• 结合 search_library 工具可以进一步查找点之间的关联