Claude способен предоставлять подробные цитаты при ответах на вопросы о документах, помогая вам отслеживать и проверять источники информации в ответах.

Функция цитирования в настоящее время доступна в Claude Opus 4, Claude Sonnet 4, Claude Sonnet 3.7, Claude Sonnet 3.5 (новый) и Haiku 3.5.

Цитирование с Claude Sonnet 3.7

Claude Sonnet 3.7 может быть менее склонен к созданию цитат по сравнению с другими моделями Claude без более явных инструкций от пользователя. При использовании цитирования с Claude Sonnet 3.7 мы рекомендуем включать дополнительные инструкции в ход user, например "Используйте цитаты для подтверждения вашего ответа.".

Мы также заметили, что когда модель просят структурировать свой ответ, она вряд ли будет использовать цитаты, если явно не сказать использовать цитаты в этом формате. Например, если модель просят использовать теги в своем ответе, вы должны добавить что-то вроде “Всегда используйте цитаты в своем ответе, даже внутри .”

Пожалуйста, поделитесь своими отзывами и предложениями о функции цитирования, используя эту форму.

Вот пример того, как использовать цитирование с Messages API:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "document",
            "source": {
              "type": "text",
              "media_type": "text/plain",
              "data": "The grass is green. The sky is blue."
            },
            "title": "My Document",
            "context": "This is a trustworthy document.",
            "citations": {"enabled": true}
          },
          {
            "type": "text",
            "text": "What color is the grass and sky?"
          }
        ]
      }
    ]
  }'

Сравнение с подходами на основе промптов

По сравнению с решениями цитирования на основе промптов, функция цитирования имеет следующие преимущества:

  • Экономия затрат: Если ваш подход на основе промптов просит Claude выводить прямые цитаты, вы можете увидеть экономию затрат из-за того, что cited_text не засчитывается в ваши выходные токены.
  • Лучшая надежность цитирования: Поскольку мы разбираем цитаты в соответствующие форматы ответов, упомянутые выше, и извлекаем cited_text, цитаты гарантированно содержат действительные указатели на предоставленные документы.
  • Улучшенное качество цитирования: В наших оценках мы обнаружили, что функция цитирования значительно чаще цитирует наиболее релевантные цитаты из документов по сравнению с чисто промптовыми подходами.

​
Как работает цитирование

Интегрируйте цитирование с Claude в следующих шагах:

1

Предоставьте документ(ы) и включите цитирование

  • Включите документы в любом из поддерживаемых форматов: PDF, обычный текст или документы пользовательского содержимого
  • Установите citations.enabled=true для каждого из ваших документов. В настоящее время цитирование должно быть включено для всех или ни одного из документов в запросе.
  • Обратите внимание, что в настоящее время поддерживаются только текстовые цитаты, и цитирование изображений пока невозможно.
2

Документы обрабатываются

  • Содержимое документов “разбивается на части” для определения минимальной детализации возможных цитат. Например, разбивка на предложения позволит Claude цитировать одно предложение или объединять несколько последовательных предложений для цитирования абзаца (или более длинного текста)!
    • Для PDF: Текст извлекается как описано в Поддержка PDF, и содержимое разбивается на предложения. Цитирование изображений из PDF в настоящее время не поддерживается.
    • Для документов с обычным текстом: Содержимое разбивается на предложения, которые можно цитировать.
    • Для документов с пользовательским содержимым: Ваши предоставленные блоки содержимого используются как есть, и дальнейшее разбиение не производится.
3

Claude предоставляет ответ с цитатами

  • Ответы теперь могут включать несколько текстовых блоков, где каждый текстовый блок может содержать утверждение, которое делает Claude, и список цитат, поддерживающих это утверждение.
  • Цитаты ссылаются на конкретные места в исходных документах. Формат этих цитат зависит от типа документа, из которого цитируется.
    • Для PDF: цитаты будут включать диапазон номеров страниц (индексация с 1).
    • Для документов с обычным текстом: Цитаты будут включать диапазон индексов символов (индексация с 0).
    • Для документов с пользовательским содержимым: Цитаты будут включать диапазон индексов блоков содержимого (индексация с 0), соответствующий исходному списку содержимого.
  • Индексы документов предоставляются для указания исходного источника и индексируются с 0 согласно списку всех документов в вашем исходном запросе.

Автоматическое разбиение против пользовательского содержимого

По умолчанию документы с обычным текстом и PDF автоматически разбиваются на предложения. Если вам нужен больший контроль над детализацией цитирования (например, для маркированных списков или транскриптов), используйте вместо этого документы с пользовательским содержимым. См. Типы документов для получения дополнительной информации.

Например, если вы хотите, чтобы Claude мог цитировать конкретные предложения из ваших RAG-фрагментов, вы должны поместить каждый RAG-фрагмент в документ с обычным текстом. В противном случае, если вы не хотите, чтобы производилось дальнейшее разбиение, или если вы хотите настроить любое дополнительное разбиение, вы можете поместить RAG-фрагменты в документ(ы) с пользовательским содержимым.

​
Цитируемое против нецитируемого содержимого

  • Текст, найденный в содержимом source документа, может быть процитирован.
  • title и context являются необязательными полями, которые будут переданы модели, но не будут использоваться для цитируемого содержимого.
  • title ограничен по длине, поэтому вы можете найти поле context полезным для хранения любых метаданных документа в виде текста или строкового json.

​
Индексы цитирования

  • Индексы документов индексируются с 0 из списка всех блоков содержимого документов в запросе (охватывая все сообщения).
  • Индексы символов индексируются с 0 с исключающими конечными индексами.
  • Номера страниц индексируются с 1 с исключающими конечными номерами страниц.
  • Индексы блоков содержимого индексируются с 0 с исключающими конечными индексами из списка content, предоставленного в документе с пользовательским содержимым.

​
Стоимость токенов

  • Включение цитирования влечет за собой небольшое увеличение входных токенов из-за добавлений системного промпта и разбиения документов.
  • Однако функция цитирования очень эффективна с выходными токенами. Под капотом модель выводит цитаты в стандартизированном формате, которые затем разбираются в цитируемый текст и индексы местоположения документа. Поле cited_text предоставляется для удобства и не засчитывается в выходные токены.
  • При передаче обратно в последующих ходах разговора cited_text также не засчитывается во входные токены.

​
Совместимость функций

Цитирование работает в сочетании с другими функциями API, включая кэширование промптов, подсчет токенов и пакетную обработку.

​
Использование кэширования промптов с цитированием

Цитирование и кэширование промптов могут эффективно использоваться вместе.

Блоки цитирования, генерируемые в ответах, не могут быть кэшированы напрямую, но исходные документы, на которые они ссылаются, могут быть кэшированы. Для оптимизации производительности примените cache_control к вашим блокам содержимого документов верхнего уровня.

import anthropic

client = anthropic.Anthropic()

# Содержимое длинного документа (например, техническая документация)
long_document = "Это очень длинный документ с тысячами слов..." + " ... " * 1000  # Минимальная кэшируемая длина

response = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "text",
                        "media_type": "text/plain",
                        "data": long_document
                    },
                    "citations": {"enabled": True},
                    "cache_control": {"type": "ephemeral"}  # Кэшировать содержимое документа
                },
                {
                    "type": "text",
                    "text": "Что говорит этот документ о функциях API?"
                }
            ]
        }
    ]
)

В этом примере:

  • Содержимое документа кэшируется с использованием cache_control в блоке документа
  • Цитирование включено в документе
  • Claude может генерировать ответы с цитатами, получая преимущества от кэшированного содержимого документа
  • Последующие запросы, использующие тот же документ, получат преимущества от кэшированного содержимого

​
Типы документов

​
Выбор типа документа

Мы поддерживаем три типа документов для цитирования. Документы могут быть предоставлены непосредственно в сообщении (base64, текст или URL) или загружены через Files API и ссылаться по file_id:

ТипЛучше всего дляРазбиениеФормат цитирования
Обычный текстПростые текстовые документы, прозаПредложениеИндексы символов (индексация с 0)
PDFPDF-файлы с текстовым содержимымПредложениеНомера страниц (индексация с 1)
Пользовательское содержимоеСписки, транскрипты, специальное форматирование, более детальные цитатыБез дополнительного разбиенияИндексы блоков (индексация с 0)

Файлы .csv, .xlsx, .docx, .md и .txt не поддерживаются как блоки документов. Преобразуйте их в обычный текст и включите непосредственно в содержимое сообщения. См. Работа с другими форматами файлов.

​
Документы с обычным текстом

Документы с обычным текстом автоматически разбиваются на предложения. Вы можете предоставить их встроенными или по ссылке с их file_id:

{
    "type": "document",
    "source": {
        "type": "text",
        "media_type": "text/plain",
        "data": "Содержимое обычного текста..."
    },
    "title": "Заголовок документа", # необязательно
    "context": "Контекст о документе, который не будет цитироваться", # необязательно
    "citations": {"enabled": True}
}

​
PDF-документы

PDF-документы могут быть предоставлены как данные в кодировке base64 или по file_id. Текст PDF извлекается и разбивается на предложения. Поскольку цитирование изображений пока не поддерживается, PDF-файлы, которые являются сканами документов и не содержат извлекаемого текста, не будут цитируемыми.

{
    "type": "document",
    "source": {
        "type": "base64",
        "media_type": "application/pdf",
        "data": base64_encoded_pdf_data
    },
    "title": "Заголовок документа", # необязательно
    "context": "Контекст о документе, который не будет цитироваться", # необязательно
    "citations": {"enabled": True}
}

​
Документы с польз

Документы с пользовательским содержимым дают вам контроль над детализацией цитирования. Дополнительное разбиение не производится, и фрагменты предоставляются модели согласно предоставленным блокам содержимого.

{
    "type": "document",
    "source": {
        "type": "content",
        "content": [
            {"type": "text", "text": "Первый фрагмент"},
            {"type": "text", "text": "Второй фрагмент"}
        ]
    },
    "title": "Заголовок документа", # необязательно
    "context": "Контекст о документе, который не будет цитироваться", # необязательно
    "citations": {"enabled": True}
}

​
Структура ответа

Когда цитирование включено, ответы включают несколько текстовых блоков с цитатами:

{
    "content": [
        {
            "type": "text",
            "text": "Согласно документу, "
        },
        {
            "type": "text",
            "text": "трава зеленая",
            "citations": [{
                "type": "char_location",
                "cited_text": "Трава зеленая.",
                "document_index": 0,
                "document_title": "Пример документа",
                "start_char_index": 0,
                "end_char_index": 20
            }]
        },
        {
            "type": "text",
            "text": " и "
        },
        {
            "type": "text",
            "text": "небо голубое",
            "citations": [{
                "type": "char_location",
                "cited_text": "Небо голубое.",
                "document_index": 0,
                "document_title": "Пример документа",
                "start_char_index": 20,
                "end_char_index": 36
            }]
        },
        {
            "type": "text",
            "text": ". Информация со страницы 5 утверждает, что ",
        },
        {
            "type": "text",
            "text": "вода необходима",
            "citations": [{
                "type": "page_location",
                "cited_text": "Вода необходима для жизни.",
                "document_index": 1,
                "document_title": "PDF-документ",
                "start_page_number": 5,
                "end_page_number": 6
            }]
        },
        {
            "type": "text",
            "text": ". Пользовательский документ упоминает ",
        },
        {
            "type": "text",
            "text": "важные находки",
            "citations": [{
                "type": "content_block_location",
                "cited_text": "Это важные находки.",
                "document_index": 2,
                "document_title": "Документ с пользовательским содержимым",
                "start_block_index": 0,
                "end_block_index": 1
            }]
        }
    ]
}

​
Поддержка потоковой передачи

Для потоковых ответов мы добавили тип citations_delta, который содержит одну цитату для добавления в список citations в текущем блоке содержимого text.