Цитирование

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

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

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

​

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

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

​

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

• Текст, найденный в содержимом 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"}