[Feature] Gemini 原生搜索：返回引用来源，并在配置提示中说明 Google 的展示条款

Aperta
  • Qualcosa non va?
#10,874 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
35/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
python
Ambito
backend, documentation

Direzione di ricerca

Start with astrbot/core/provider/sources/gemini_source.py, especially _process_content_parts, and the gm_native_search configuration hint in astrbot/core/config/default.py; read the linked Gemini terms and issue #9728 for the existing source field and card. Decide how to display both grounding sources and Search Suggestions across chat platforms, including the stated audience restriction, then update the implementation, configuration hint, and documentation to match that decision.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

enhancement
功能描述

开启 gm_native_search 后，适配器会在请求里加上 google_search 工具（gemini_source.py#L252-L253），但解析响应时只读取 candidate.content.parts（_process_content_parts），candidate.grounding_metadata 被整个丢弃，仓库中没有任何读取它的代码。结果是：

  • 回复里没有来源链接（grounding_chunks[].web 的 uri、title），用户无法核查答案；
  • Search Suggestions（search_entry_point.rendered_content）也被丢弃。

Gemini API 附加条款对 Grounding with Google Search 的要求：

You will only use Grounding with Google Search in an application that is owned and operated by you and will only display the Grounded Results with the associated Search Suggestion(s) to the end user who submitted the prompt.

Unless permitted by Google in writing, you: (1) will not modify, or intersperse any other content with, the Grounded Results or Search Suggestions; ...

AstrBot 常见的用法是在 QQ 群等聊天平台里回复：群里所有人都能看到回复，平台也渲染不了 Search Suggestions 的 HTML/CSS。按现在的实现，在群聊里开启这个开关无法满足上述条款，但配置提示只写了"启用后所有函数工具将全部失效，免费次数限制请查阅官方文档"（default.py#L2623），没有提到这一点。

建议

  1. 加个开关决定是否解析 grounding_metadata.grounding_chunks，把来源（标题和原始链接）附在回复里。#9728 为 xAI 新增了 LLMResponse.web_search_sources 和来源卡片，如果合并 Gemini 可以复用同一字段。
  2. 在 gm_native_search 的配置提示和文档里写明条款限制：结果只能展示给提问者本人，并须同时展示 Search Suggestions；群聊场景得说明。
  3. 需要决定的是：在渲染不了 HTML 的平台上如何处理 Search Suggestions，例如只在 WebUI 渲染，或在群聊中禁用原生搜索。
使用场景
  • 用 Gemini 原生搜索回答新闻、版本号等时效性问题时，用户需要知道来源才能判断答案是否可靠。
  • 部署者在开启前需要知道：在群聊使用原生搜索与可能与 Google 条款冲突。
检查清单
  • 我已在 Issue 列表中搜索过相关功能，确认该功能想法从未被提出过。
  • 我建议的功能与 AstrBot 本体相关，而非在建议某一插件的功能。
  • 我已阅读并同意本项目的贡献者行为准则。
  • (可选)我愿意提交 PR 以帮助实现该功能。
Lingua principale
Python
Stelle
46.4k
Fork
3.4k
Merge medio
1g 11h
PR unite (30g)
120

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di AstrBotDevs/AstrBot

Tutte le issue di AstrBotDevs/AstrBot

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.