Agent/examples/create/skills/search_library.md

---

name: library_search

description: 根据关键点名称在图数据库中检索关联的点

关键点关联检索

你可以通过关键点关联检索工具 search_library 在图数据库中查找与指定关键点相关的所有关联点。

使用场景

• 根据已知的关键点查找相关联的其他点
• 探索关键点之间的共现关系
• 发现与某个关键点经常一起出现的其他元素
• 分析关键点的关联网络

工具说明

search_library(point_name, top_k=10)

参数：

• point_name: 关键点名称，如 "关键点_表象>实体>物品>工业医药"、"灵感点_呈现>视觉"
• top_k: 返回数量，默认 10

返回信息：

• query: 查询的点名称
• meta: 查询点的元数据信息
• total_related_count: 总关联点数量
• returned_count: 实际返回的关联点数量
• related_points: 关联点列表，每个包含：
  • point: 关联点名称
  • confidence: 关联置信度
  • co_post_count: 共现帖子数量
  • post_ids: 共现的帖子 ID 列表
  • point_type: 关联点类型
  • path: 关联点路径
  • frequency_in_posts: 关联点在帖子中的频率

使用示例

# 查找与某个关键点相关的点
result = await search_library("关键点_表象>实体>物品>工业医药", top_k=10)

# 查找与灵感点相关的点
result = await search_library("灵感点_呈现>视觉", top_k=5)

注意事项

• 搜索结果按关联置信度（confidence）降序排序
• 置信度反映了两个点在帖子中共现的紧密程度
• 可以结合 search_by_element 工具先找到包含特定元素的点，再用此工具查找关联
• 点名称必须完整匹配，包括前缀（关键点/灵感点/目的点_）和完整路径

工作流示例

1. 使用 search_by_element 查找包含某个元素的点
2. 从结果中选择感兴趣的点
3. 使用 search_library 查找该点的关联点
4. 分析关联网络，发现更多相关元素和点