he talk¶

使用自然语言与您的知识库对话。

概要¶

he talk KA_PATH [OPTIONS]

参数¶

参数	描述
`KA_PATH`	知识库目录的路径

选项¶

选项	简写	描述
`--query`	`-q`	要问的单个问题
`--top-k`	`-n`	要检索的上下文项目数量
`--interactive`	`-i`	进入交互式聊天模式
`--source`	—	范围限定：仅使用这些来源文档贡献的知识（可重复）
`--tag`	—	范围限定：仅使用带有这些标签的来源贡献的知识（可重复）

描述¶

talk 命令让您与知识库进行对话：

检索相关上下文 — 搜索与您问题相关的信息
生成答案 — 使用 LLM 综合自然语言响应
显示来源 — 显示用于生成答案的项目

要求：必须构建搜索索引。

示例¶

单个问题¶

he talk ./output/ -q "苏轼的主要成就是什么？"

输出：

Query: 苏轼的主要成就是什么？
Knowledge Abstract: ./output/
Top K: 3

苏轼在文学、艺术领域取得了卓越成就，主要贡献包括：

1. 开创了豪放词派，《念奴娇·赤壁怀古》成为千古名篇，
   对后世词坛影响深远。

2. 与黄庭坚并称"苏黄"，诗歌清新豪健；书法为"宋四家"之首，
   《黄州寒食诗帖》被誉为"天下第三行书"。

3. 散文为"唐宋八大家"之一，其《赤壁赋》等作品至今仍被广泛传诵。

Retrieved context:
1. 苏轼: 北宋文学家、书画家，号东坡居士...
2. 《念奴娇·赤壁怀古》: 类型: 作品, 描述: 豪放词代表作...
3. 黄州: 类型: 地点, 描述: 苏轼被贬之地，东坡居士名号由来...

交互模式¶

he talk ./output/ -i

会话：

Entering interactive mode. Type 'exit' or 'quit' to stop.

Knowledge Abstract: ./output/
Template: general/biography_graph
Top K: 3

> 苏轼是谁？
苏轼（1037-1101），字子瞻，号东坡居士，是北宋时期最杰出的
文学家、书画家、政治家，唐宋八大家之一。

> 他是什么时候出生的？
苏轼于 1037 年出生于眉州眉山（今四川眉山）。

> 他与王安石的关系如何？
苏轼与王安石政见不合。王安石推行新法时，苏轼多次上书批评，
认为新法过于激进，损害百姓利益。1079年因此发生"乌台诗案"，
苏轼被贬黄州。

> exit
Goodbye!

Other useful commands:
  he show ./output/              # 可视化
  he search ./output/ "关键词"  # 搜索
  he info ./output/              # 查看信息

使用更多上下文¶

为复杂问题增加上下文：

he talk ./output/ -q "解释电流战争" -n 10

范围限定对话¶

用 --source（指定来源文档）或 --tag（带有该标签的任意来源 —— 标签用 he tag 管理）把生成答案限定到部分来源，过滤条件与 he search 相同：

# 只根据带有 `legal` 标签的来源作答
he talk ./ka/ -q "终止条件是什么？" --tag legal

# 只根据两份指定文档作答
he talk ./ka/ -q "终止条件是什么？" --source contract-2024 --source annex-b

--source 与 --tag 以并集方式组合：只要某个键的任一贡献来源满足任一过滤条件，该键即匹配。交互模式（-i）每一轮都沿用同一范围。

范围限定要求知识库在摄入时带有 --source，这样来源台账才会存在 —— 见来源标注与溯源。没有台账的类型（例如 AutoList / AutoModel）遇到 --source / --tag 会以 scoped-chat 错误退出。

交互命令¶

在交互模式（-i）中：

命令	操作
`exit`, `quit`, `q`	退出交互模式
`help`	显示可用命令

用例¶

研究助手¶

he talk ./paper_kb/ -q "总结本文的主要贡献"

法律分析¶

he talk ./contract_kb/ -q "终止条件是什么？"

历史研究¶

he talk ./bio_kb/ -q "哪些事件导致了苏轼的政治生涯坎坷？"

工作原理¶

语义搜索 — 在知识库中找到相关项目
上下文组装 — 将检索到的项目组合成上下文
LLM 生成 — 使用上下文生成答案
来源归属 — 显示哪些项目提供了答案

更好答案的技巧¶

要具体 — "苏轼创作了哪些词作？" vs "告诉我关于苏轼的事"
追问 — 通过对话构建上下文
调整 top-k — 对于复杂问题使用 -n 5 或更高
检查来源 — 审查 "Retrieved context" 的准确性

与 `he search` 的比较¶

功能	`he search`	`he talk`
输出	原始实体/关系	自然语言
最适合	查找特定数据	理解/解释
速度	快	更慢（LLM 调用）
来源可见性	直接	在上下文中引用

故障排除¶

"未找到索引"¶

he build-index ./output/

"没有相关信息"¶

尝试重新表述您的问题
使用 -n 10 增加上下文
验证知识库有相关数据：he info ./output/

另请参见¶

he search — 搜索特定项目
he build-index — 构建搜索索引
he show — 可视化知识图谱