链龙 GEO 可见度检测
这是「链龙 GEO 连接器」配套的使用说明。 它的作用是：教 AI 什么时候该调哪个工具、参数怎么填、返回结果怎么看。 它就是一组远程工具，AI 通过它们拿到真实检索数据（不是模型凭记忆猜的）。
一、最重要的原则（务必遵守，违反会出事）
-
绝不编造分数、排名、结论。 本连接器只返回真实检索到的内容。当数据源未配置或检索失败时， 返回里会带
degraded: true，表示「没查到真实数据」。 此时你必须如实转述："当前未配置真实检索数据源，无法给出真实可见度结论。" 禁止用你自己的记忆、印象、推测去补一个分数或排名。 链龙踩过这个坑：早期整套诊断都是模型编的，差点被当成真实报告卖出去。 -
如实标注数据来源。 有真实数据时，说明"数据来源：博查 AI 搜索"等； 降级时，明确说"无真实数据"。
-
一次回答不要重复调用同一个工具。 每个工具都有超时保护（25 秒），重复调用只会拖慢。
二、三个工具
1. check_visibility —— 查品牌在 AI 搜索里的可见度
什么时候用：用户问「XX 品牌在 AI 里能不能搜到 / 被提到 / 有没有存在感」。
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
brand | 是 | 无 | 品牌名，如「某某造型」 |
industry | 否 | 美发 | 行业，如「美发」「美容」「口腔」 |
city | 否 | ''（空） | 城市，如「北京」。有城市就一定要填，本地生意的检索结果差别很大 |
返回怎么看：
degraded: false→ 有真实数据。看mentioned（是否被提到）、found_count（几个查询命中）、sources（命中证据：标题+站点+链接）。degraded: true→ 没查到真实数据。此时mentioned/found_count一律不存在， 你必须如实说明，不能自己补。
2. keyword_matrix —— 生成关键词矩阵
什么时候用：用户问「该布局哪些词」「有哪些关键词」「帮我出关键词方案」。
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
industry | 是 | 无 | 行业，如「美发」 |
city | 是 | 无 | 城市，如「杭州」 |
返回：三组关键词，每组 5-8 个：
brand_words品牌词：直接搜品牌的词（看有没有公开内容资产）recommend_words推荐词：用户问「哪家店好」的典型问法demand_words需求词：带明确需求的问法（价格、哪家、怎么选）
注意：这是检索词模板，不是实测数据。转述时说"这是建议布局的检索词"， 不要说"这些词的排名是 X"。
3. diagnose —— 综合诊断
什么时候用：用户要一份完整的 GEO 诊断 / 行动建议。
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
brand | 是 | 无 | 品牌名 |
industry | 否 | 美发 | 行业 |
city | 否 | ''（空） | 城市 |
返回：visibility（可见度结果）+ advice（行动建议列表）+ data_status（数据状态）。
注意：degraded: true 时，advice 是通用行动清单（不针对该品牌的实测结论），
转述时必须说明这一点。
三、调用示例
用户说："查一下某某造型在 AI 搜索里的可见度"
→ 调 check_visibility(brand="某某造型", industry="美发", city="北京")
用户说："帮我生成一份杭州美发的关键词矩阵"
→ 调 keyword_matrix(industry="美发", city="杭州")
用户说："给某某造型做个 GEO 综合诊断"
→ 调 diagnose(brand="某某造型", industry="美发", city="北京")
四、错误处理
| 情况 | 返回特征 | 你怎么回复用户 |
|---|---|---|
| 未配置检索数据源 | degraded: true，reason 含「未配置」 | "当前未配置真实检索数据源，无法给出真实可见度。请先到链龙后台配置数据源。" |
| 检索超时（>25 秒） | error 含「超时」 | "这次查询超时了，请稍后重试。" 不要自己猜结果。 |
| 参数缺失 | error 含参数名 | 提醒用户补全参数（最常见是忘了填品牌名/城市）。 |
| 服务连不上 | 调用本身失败 | "GEO 服务暂时不可用，请稍后再试。" |
五、不要做的事
- 不要在没有真实数据时，凭印象说「这个品牌知名度较低」——这是编的。
- 不要给品牌打一个 0-100 的分数——本连接器不产出分数。
- 不要把
keyword_matrix的模板词说成「已验证有效的词」。 - 不要向用户暴露任何密钥、接口地址细节。
