名称： airweave
描述： 面向跨用户应用程序的AI智能体的上下文检索层。从Airweave集合中搜索和检索上下文。Airweave对来自用户应用程序的数据进行索引和同步，以实现AI智能体的最佳上下文检索。支持语义搜索、关键词搜索和智能体搜索。当用户询问其关联应用（如Slack、GitHub、Notion、Jira、Confluence、Google Drive、Salesforce、Linear、SharePoint、Stripe等）中的数据、需要从其工作区查找文档或信息、希望基于其公司数据获得答案，或需要你检查应用数据以获取上下文来完成某项任务时使用。
元数据： {"clawdbot":{"requires":{"bins":["python3"],"env":["AIRWEAVE_API_KEY","AIRWEAVE_COLLECTION_ID"]},"primaryEnv":"AIRWEAVE_API_KEY"}}

Airweave 搜索

使用位于 {baseDir}/scripts/search.py 的搜索脚本，从Airweave集合中搜索和检索上下文。

何时进行搜索

在以下用户场景中进行搜索：
- 询问其关联应用中的数据（例如：“我们在Slack中讨论了关于……的什么内容？”）
- 需要查找文档、消息、问题或记录
- 询问关于其工作区的事实性问题（例如：“谁负责……？”、“我们关于……的政策是什么？”）
- 提及特定工具名称（例如：“在Notion中”、“在GitHub上”、“在Jira里”）
- 需要你训练数据中未包含的最新信息
- 需要你检查应用数据以获取上下文（例如：“查看我们的Notion文档”、“看看Jira工单”）

以下情况无需搜索：
- 用户询问通用知识问题（请使用你的训练数据）
- 用户已在对话中提供了所有必要的上下文
- 问题本身是关于Airweave的，而不是其中的数据

查询构建

将用户意图转化为有效的搜索查询：

技巧：
- 使用自然语言——Airweave采用语义搜索
- 包含上下文——“定价反馈”比单纯的“定价”更好
- 要具体但不要过于狭窄
- 省略填充词，如“请查找”、“你能搜索一下”

执行搜索

运行搜索脚本：

python3 {baseDir}/scripts/search.py "你的搜索查询"

可选参数：
- --limit N — 最大结果数（默认：20）
- --temporal N — 时间相关性 0-1（默认：0，使用0.7+表示“最近”、“最新”）
- --strategy TYPE — 检索策略：hybrid（混合）、semantic（语义）、keyword（关键词）（默认：hybrid）
- --raw — 返回原始结果而非AI生成的答案
- --expand — 启用查询扩展以获得更广泛的结果
- --rerank / --no-rerank — 切换LLM重排序（默认：开启）

示例：

# 基础搜索
python3 {baseDir}/scripts/search.py "客户反馈 定价"

# 最近对话
python3 {baseDir}/scripts/search.py "产品发布 更新" --temporal 0.8

# 查找特定文档
python3 {baseDir}/scripts/search.py "API 认证 文档" --strategy keyword

# 获取原始结果以供探索
python3 {baseDir}/scripts/search.py "项目 状态" --limit 30 --raw

# 使用查询扩展进行广泛搜索
python3 {baseDir}/scripts/search.py "入职" --expand

处理结果

解读相关性分数：
- 0.85+ → 高度相关，可放心使用
- 0.70-0.85 → 可能相关，结合上下文使用
- 0.50-0.70 → 可能相关，需提及不确定性
- 低于0.50 → 匹配度弱，考虑重新构建查询

向用户呈现结果：
1. 直接给出答案——不要以“我找到了5个结果”开头
2. 引用来源——说明信息来自何处（例如：“根据您的Slack对话……”）
3. 综合信息——将相关部分整合成连贯的回应
4. 承认信息缺口——如果结果未能完全解答，请如实说明

处理无结果的情况

如果搜索未返回有用结果：
1. 扩大查询范围——移除特定术语
2. 尝试不同表述——使用同义词
3. 增加结果数量限制——获取更多结果
4. 请求用户澄清——用户可能掌握更多上下文

参数参考

详细参数指南请参阅 PARAMETERS.md。

示例

完整搜索场景示例请参阅 EXAMPLES.md。