Не просите Gemini просто «добавить ссылки в конце». Если приложение использует Grounding with Google Search, привязку ответа к результатам поиска Google, стройте ссылки из структурированных данных ответа.
Список URL, нарисованный моделью в тексте, не заменяет связь между конкретной фразой и найденным источником.
Проверяйте нумерацию и границы цитируемых фрагментов в обработчике ответа. Ошибка отображения ссылок не доказывает, что все источники выдуманы.
Выберите формат вашего API
У текущего Interactions API ссылки представлены annotations, аннотациями текстового блока. Аннотация url_citation содержит url, title, start_index и end_index.
В шагах ответа google_search_call показывает поисковые запросы, а google_search_result содержит поисковые подсказки search_suggestions.
У Generate Content API используется другой формат:
- groundingChunks содержит источники с адресами и названиями.
- groundingSupports связывает сегмент ответа с индексами источников.
- searchEntryPoint содержит данные для отображения Search Suggestions.
Как собрать понятный ответ
- Возьмите исходный текст того блока, к которому относятся аннотации. Сопоставьте границы фрагментов и источники до добавления оформления.
- Проверьте обработку индексов, то есть указанных API границ фрагмента, выбранной библиотекой на небольших примерах с кириллицей и эмодзи.
- Добавьте оформление, сохраняя связь с исходными позициями. Если заранее удалить символы, склеить блоки или вставить собственные номера, границы могут перестать соответствовать тексту.
Не придумывайте источник для фрагмента без соответствующей аннотации. Ссылка не гарантирует истинность утверждения. Она показывает, к какому материалу API привязал утверждение.
Для важного решения откройте страницу, проверьте дату, формулировку и то, действительно ли источник поддерживает вывод.
Что проверить перед показом результатов
Подключённый google_search даёт модели возможность искать, но решение о необходимости поиска она принимает по запросу.
Кроме того, условия Google требуют отображать связанные Search Suggestions и ограничивают отдельный сбор ссылок, построение индекса, хранение и повторное использование результатов. Не превращайте этот инструмент в самостоятельный сборщик URL без проверки разрешённого сценария.
Проверено 10 ноября 2026 года. Форматы сверены по двум актуальным руководствам; собственные тесты обработки индексов не проводились.
Последнее редактирование: