- Claude Opus 4.1 (
claude-opus-4-1-20250805) - Claude Opus 4 (
claude-opus-4-20250514) - Claude Sonnet 4.5 (
claude-sonnet-4-5-20250929) - Claude Sonnet 4 (
claude-sonnet-4-20250514) - Claude Sonnet 3.7 (устарела) (
claude-3-7-sonnet-20250219) - Claude 3.5 Haiku (
claude-3-5-haiku-20241022)
Ключевые преимущества
- Естественные цитирования - Достигните того же качества цитирования, что и веб-поиск, для любого содержимого
- Гибкая интеграция - Используйте в возвращаемых значениях инструментов для динамического RAG или как содержимое верхнего уровня для предварительно загруженных данных
- Надлежащее указание источника - Каждый результат включает информацию об источнике и названии для четкого указания источника
- Не требуются обходные пути на основе документов - Исключает необходимость в обходных путях на основе документов
- Согласованный формат цитирования - Соответствует качеству и формату цитирования функции веб-поиска Claude
Как это работает
Результаты поиска можно предоставить двумя способами:- Из вызовов инструментов - Ваши пользовательские инструменты возвращают результаты поиска, обеспечивая динамические приложения RAG
- Как содержимое верхнего уровня - Вы предоставляете результаты поиска непосредственно в сообщениях пользователя для предварительно загруженного или кэшированного содержимого
Схема результата поиска
Результаты поиска используют следующую структуру:Обязательные поля
| Поле | Тип | Описание |
|---|---|---|
type | string | Должно быть "search_result" |
source | string | URL источника или идентификатор содержимого |
title | string | Описательное название для результата поиска |
content | array | Массив текстовых блоков, содержащих фактическое содержимое |
Необязательные поля
| Поле | Тип | Описание |
|---|---|---|
citations | object | Конфигурация цитирования с логическим полем enabled |
cache_control | object | Параметры управления кэшем (например, {"type": "ephemeral"}) |
content должен быть текстовым блоком с:
type: Должно быть"text"text: Фактическое текстовое содержимое (непустая строка)
Метод 1: Результаты поиска из вызовов инструментов
Наиболее мощный вариант использования - возврат результатов поиска из ваших пользовательских инструментов. Это обеспечивает динамические приложения RAG, где инструменты получают и возвращают релевантное содержимое с автоматическими цитированиями.Пример: Инструмент базы знаний
Метод 2: Результаты поиска как содержимое верхнего уровня
Вы также можете предоставить результаты поиска непосредственно в сообщениях пользователя. Это полезно для:- Предварительно загруженного содержимого из вашей инфраструктуры поиска
- Кэшированных результатов поиска из предыдущих запросов
- Содержимого из внешних служб поиска
- Тестирования и разработки
Пример: Прямые результаты поиска
Ответ Claude с цитированиями
Независимо от того, как предоставляются результаты поиска, Claude автоматически включает цитирования при использовании информации из них:Поля цитирования
Каждое цитирование включает:| Поле | Тип | Описание |
|---|---|---|
type | string | Всегда "search_result_location" для цитирований результатов поиска |
source | string | Источник из исходного результата поиска |
title | string или null | Название из исходного результата поиска |
cited_text | string | Точный цитируемый текст |
search_result_index | integer | Индекс результата поиска (начиная с 0) |
start_block_index | integer | Начальная позиция в массиве содержимого |
end_block_index | integer | Конечная позиция в массиве содержимого |
search_result_index относится к индексу блока содержимого результата поиска (начиная с 0), независимо от того, как были предоставлены результаты поиска (вызов инструмента или содержимое верхнего уровня).
Несколько блоков содержимого
Результаты поиска могут содержать несколько текстовых блоков в массивеcontent:
start_block_index и end_block_index.
Расширенное использование
Объединение обоих методов
Вы можете использовать результаты поиска на основе инструментов и содержимое верхнего уровня в одном разговоре:Объединение с другими типами содержимого
Оба метода поддерживают смешивание результатов поиска с другим содержимым:Управление кэшем
Добавьте управление кэшем для лучшей производительности:Управление цитированиями
По умолчанию цитирования отключены для результатов поиска. Вы можете включить цитирования, явно установив конфигурациюcitations:
citations.enabled установлено на true, Claude будет включать ссылки на цитирования при использовании информации из результата поиска. Это обеспечивает:
- Естественные цитирования для ваших пользовательских приложений RAG
- Указание источника при взаимодействии с собственными базами знаний
- Цитирования качества веб-поиска для любого пользовательского инструмента, который возвращает результаты поиска
citations опущено, цитирования отключены по умолчанию.
Цитирования - это все или ничего: либо все результаты поиска в запросе должны иметь включенные цитирования, либо все должны иметь их отключенными. Смешивание результатов поиска с различными параметрами цитирования приведет к ошибке. Если вам нужно отключить цитирования для некоторых источников, вы должны отключить их для всех результатов поиска в этом запросе.
Лучшие практики
Для поиска на основе инструментов (Метод 1)
- Динамическое содержимое: Используйте для поиска в реальном времени и динамических приложений RAG
- Обработка ошибок: Возвращайте соответствующие сообщения при сбое поиска
- Ограничения результатов: Возвращайте только наиболее релевантные результаты, чтобы избежать переполнения контекста
Для поиска верхнего уровня (Метод 2)
- Предварительно загруженное содержимое: Используйте, когда у вас уже есть результаты поиска
- Пакетная обработка: Идеально подходит для обработки нескольких результатов поиска одновременно
- Тестирование: Отлично подходит для тестирования поведения цитирования с известным содержимым
Общие лучшие практики
-
Эффективно структурируйте результаты
- Используйте четкие, постоянные URL-адреса источников
- Предоставляйте описательные названия
- Разбивайте длинное содержимое на логические текстовые блоки
-
Поддерживайте согласованность
- Используйте согласованные форматы источников в вашем приложении
- Убедитесь, что названия точно отражают содержимое
- Сохраняйте согласованное форматирование
-
Обрабатывайте ошибки корректно
Ограничения
- Блоки содержимого результатов поиска доступны на Claude API и Google Cloud’s Vertex AI
- Внутри результатов поиска поддерживается только текстовое содержимое (без изображений или других медиа)
- Массив
contentдолжен содержать по крайней мере один текстовый блок