Цитирование

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

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

Вот пример использования цитирования с 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-3-7-sonnet-20250219",
    "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 в следующие шаги:

​

Цитируемый vs нецитируемый контент

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

​

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

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

​

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

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

​

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

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

​

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

​

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

Мы поддерживаем три типа документов для цитирования:

​

Обычные текстовые документы

Обычные текстовые документы автоматически разбиваются на предложения:

{
    "type": "document",
    "source": {
        "type": "text",
        "media_type": "text/plain",
        "data": "Plain text content..."
    },
    "title": "Document Title", # необязательно
    "context": "Context about the document that will not be cited from", # необязательно
    "citations": {"enabled": True}
}

{
    "type": "char_location",
    "cited_text": "The exact text being cited", # не учитывается в выходных токенах
    "document_index": 0,
    "document_title": "Document Title",
    "start_char_index": 0,    # с 0
    "end_char_index": 50      # исключающий
}

​

PDF-документы

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

{
    "type": "document",
    "source": {
        "type": "base64",
        "media_type": "application/pdf",
        "data": base64_encoded_pdf_data
    },
    "title": "Document Title", # необязательно
    "context": "Context about the document that will not be cited from", # необязательно
    "citations": {"enabled": True}
}

{
    "type": "page_location",
    "cited_text": "The exact text being cited", # не учитывается в выходных токенах
    "document_index": 0,     
    "document_title": "Document Title", 
    "start_page_number": 1,  # с 1
    "end_page_number": 2     # исключающий
}

​

Документы с пользовательским контентом

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

{
    "type": "document",
    "source": {
        "type": "content",
        "content": [
            {"type": "text", "text": "First chunk"},
            {"type": "text", "text": "Second chunk"}
        ]
    },
    "title": "Document Title", # необязательно
    "context": "Context about the document that will not be cited from", # необязательно
    "citations": {"enabled": True}
}

{
    "type": "content_block_location",
    "cited_text": "The exact text being cited", # не учитывается в выходных токенах
    "document_index": 0,
    "document_title": "Document Title",
    "start_block_index": 0,   # с 0
    "end_block_index": 1      # исключающий
}

​

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

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

{
    "content": [
        {
            "type": "text",
            "text": "According to the document, "
        },
        {
            "type": "text",
            "text": "the grass is green",
            "citations": [{
                "type": "char_location",
                "cited_text": "The grass is green.",
                "document_index": 0,
                "document_title": "Example Document",
                "start_char_index": 0,
                "end_char_index": 20
            }]
        },
        {
            "type": "text",
            "text": " and "
        },
        {
            "type": "text",
            "text": "the sky is blue",
            "citations": [{
                "type": "char_location",
                "cited_text": "The sky is blue.",
                "document_index": 0,
                "document_title": "Example Document",
                "start_char_index": 20,
                "end_char_index": 36
            }]
        }
    ]
}

​

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

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

event: message_start
data: {"type": "message_start", ...}

event: content_block_start
data: {"type": "content_block_start", "index": 0, ...}

event: content_block_delta
data: {"type": "content_block_delta", "index": 0, 
       "delta": {"type": "text_delta", "text": "According to..."}}

event: content_block_delta
data: {"type": "content_block_delta", "index": 0,
       "delta": {"type": "citations_delta", 
                 "citation": {
                     "type": "char_location",
                     "cited_text": "...",
                     "document_index": 0,
                     ...
                 }}}

event: content_block_stop
data: {"type": "content_block_stop", "index": 0}

event: message_stop
data: {"type": "message_stop"}