Claude Citations: как превратить цитаты в проверяемые доказательства? 3 способа локализации и 4 границы использования

Короткий ответ: Claude Citations позволяет ответам модели указывать на конкретные фрагменты и места в предоставленных вами документах. Обычный текст локализуется по диапазонам символов, PDF — по страницам, пользовательский контент — по блокам. Чтобы цитаты действительно можно было проверить, главное — на стороне приложения: сохранять вместе значение поля для каждого вывода, соответствующий объект цитаты и ограничивающие условия. При преобразовании в структурированные данные цитаты нельзя терять.

Важно уточнить: правильное местоположение цитаты означает лишь, что «это предложение можно найти в документе», но не означает, что сам источник достоверен или что рассуждение достаточно полное. Citations — инструмент для проверки человеком, а не замена проверки.

Что вы узнаете из этой статьи?

  • Для каких входных данных работает Claude Citations и каковы три способа локализации.
  • Почему после включения цитат нельзя одновременно использовать строгий структурированный вывод output_config.format и какую альтернативу рекомендует официальная документация.
  • Ограничения возможностей цитирования для сканированных PDF и изображений и способы компенсации на стороне приложения.
  • Как проектировать структуру данных «значение поля + цитата + ограничивающие условия», чтобы цена, длина контекстного окна, регион и другие сведения выдерживали проверку.

Содержание: во вводной части статьи сначала с помощью таблицы понятий объясняются связанные термины, затем описывается влияние этой возможности на разные категории читателей. В разделе «Объективные факты» на основе официальной документации собраны способы локализации, конфликты совместимости и ограничения входных данных. В разделе «Аналитические суждения» обсуждается, как превратить цитаты в проверяемые доказательства и какие утверждения нельзя делать публично.

claude-citations-verifiable-evidence-ru-image-0

Что нужно знать заранее о Claude Citations

Понятие Краткое объяснение
Citations (цитирование) Возможность Claude API возвращать в ответе цитаты из предоставленных пользователем документов с указанием их расположения
Привязка по диапазону символов Способ цитирования для простых текстовых документов — указываются начальная и конечная позиции символов цитируемого оригинала
Привязка по номеру страницы Способ цитирования для PDF-документов — источник указывается постранично
Привязка по блокам содержимого Способ цитирования для пользовательского содержимого — за единицу берутся блоки, которые разработчик размечает сам
Строго структурированный вывод Ограничение формата ответа модели через output_config.format; не может быть включено одновременно с функцией цитирования
Извлекаемый текст Текстовый слой PDF, который можно прочитать напрямую; у сканов его обычно нет
OCR Оптическое распознавание символов — преобразование текста с картинки в текст; это обработка на стороне приложения, а не возможность цитирования Claude
Уточняющее условие Предпосылка, при которой значение имеет силу, например единица тарификации, версия модели, регион применения

Кратко о том, на что влияет Claude Citations

Кому Что это даёт
Разработчикам Можно добавить в приложения для вопросов-ответов, retrieval-augmented генерации и извлечения данных из материалов проверяемые источники; но придётся выбирать между структурированным выводом и цитированием, а логику разбора ответа проектировать самостоятельно
Контент-специалистам и исследователям При проверке можно сразу перейти к фрагменту оригинала или к нужной странице и меньше листать вручную; но оценивать достоверность источника и состоятельность вывода всё равно приходится самому
Продуктовым командам и операционке Подходит для показа информации, где источник обязателен, — например цен, характеристик, политик; материалы-сканы сначала нужно распознать и проверить
Обычным пользователям Ответы с указанием источника удобнее проверять, но «есть цитата» не стоит понимать как «всё точно правильно»

Claude Citations: объективные факты

Приведённые ниже факты основаны на официальной документации Claude (источник: platform.claude.com/docs/en/build-with-claude/citations), дата проверки — 2026-11-17. Эта страница относится к постоянно обновляемой документации, поэтому нам не удалось установить самую раннюю дату публикации этой функции, и мы не приводим дату первого релиза.

Три способа указания позиции в Claude Citations

Citations работает с документами, которые предоставляет сам пользователь. При ответе модель возвращает цитируемый фрагмент исходного текста и его позицию в документе. Гранулярность локализации зависит от типа документа:

Тип документа Способ локализации Как использовать при проверке
Простой текст Диапазон символов Вырезать фрагмент по начальной и конечной позиции — можно сравнить посимвольно
PDF Номер страницы Перейти на нужную страницу и просмотреть вручную; конкретное место на странице придётся искать самостоятельно
Пользовательский контент Контентные блоки Проверять по блокам, заданным разработчиком; гранулярность определяется способом разбиения

Как видно, точность у всех трёх способов разная. Диапазон символов — самый точный, он подходит для программной проверки; привязка к номеру страницы требует ручного поиска внутри страницы; точность контентных блоков полностью зависит от того, как разработчик их нарезал. Если блоки слишком большие, цитата формально «верна», но стоимость её проверки заметно возрастает.

claude-citations-verifiable-evidence-ru-image-1

Claude Citations несовместимы со строгим структурированным выводом

Это самый частый капкан при внедрении. В официальной документации прямо сказано: после включения цитирования нельзя одновременно использовать строгий структурированный вывод output_config.format — если включить оба, запрос вернёт ошибку 400.

Официально предложенная альтернатива: заставить модель отвечать поле за полем, строка за строкой и прикладывать цитаты, а затем программно разбирать это в нужную структуру. Есть ещё один внешне рабочий вариант — просто просить в промпте, чтобы модель выдала JSON. Иногда JSON действительно получается, но цитат может стать меньше или они вовсе исчезнут. Эти подходы надо различать:

  • Строгий структурированный вывод: формат гарантирован, но его нельзя включать вместе с цитированием.
  • JSON только через промпт: формат не гарантирован, цитаты тоже могут пропасть — не подходит для доказательной цепочки.
  • Ответ поле за полем, строка за строкой + цитаты, затем программный разбор: официально рекомендованный способ; за формат отвечает приложение, а цитаты сохраняются.

claude-citations-verifiable-evidence-ru-image-2

Ограничения на входные данные в Claude Citations

Входные данные Можно ли цитировать напрямую Пояснение
PDF с текстовым слоем Да Можно привязать к странице
Сканированный PDF без извлекаемого текста Напрямую нельзя Нет текстового слоя — невозможно определить, где именно находится текст
Изображения Не поддерживаются Возможность цитирования не распространяется на содержимое изображений
Текст, полученный через OCR Зависит от обработки на стороне приложения OCR — рекомендованный приём на стороне приложения, а не возможность цитирования изображений

Здесь важно правильно понять фразу «нельзя цитировать напрямую». Речь о том, что сканированный PDF без извлекаемого текста нельзя цитировать напрямую, а не о том, что со всеми сканированными материалами вообще невозможно работать. Разработчик может сначала получить текст на стороне приложения, а затем передать этот текст модели как документ.

О заявлениях об улучшении результатов

Производитель заявлял, что функция цитирования даёт прирост около 20%. Эта цифра основана только на заявлении производителя; в этой статье мы её независимо не проверяли. В этой статье мы также не проводили никаких тестов производительности, поэтому не даём выводов о количественной выгоде.


Анализ и выводы по Claude Citations

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

Как реализовать Claude Citations в виде «значение поля + цитата + ограничения»

Настоящая ценность цитат в том, чтобы каждый вывод можно было проследить и проверить. Если в итоговое хранилище попадает только одно число — например, «128K» или «3 доллара», — цитата теряется при преобразовании данных, и потом никто не сможет подтвердить, откуда оно взялось и при каких условиях верно.

Более надёжный подход — хранить для каждого фактического поля три части: значение поля, объект цитаты и ограничения. Ниже пример структуры данных на стороне приложения. Названия полей разработчик выбирает сам; это не формат ответа Claude API:

{
  "field": "input_price",
  "value": "3",
  "qualifiers": {
    "unit": "USD per million input tokens",
    "model_version": "<文档中标注的版本>",
    "region": "<适用地区,如文档未提及则为 null>"
  },
  "citation": {
    "doc_id": "pricing-2026-11",
    "location_type": "page",
    "location": "<模型返回的页码或字符范围>",
    "quoted_text": "<模型返回的原文片段>"
  },
  "verified": false
}

Числовое значение цены в примере только демонстрирует структуру и не означает никакой реальной цены. При проектировании есть несколько важных моментов:

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

Построчный ответ вместо строгого структурированного вывода

Раз цитирование и output_config.format не могут работать одновременно, на инженерном уровне приходится принимать, что «за формат отвечаем сами». Рабочий процесс может выглядеть так:

  1. В промпте перечислить по одному все поля, которые нужно извлечь, и требовать, чтобы модель отвечала по одному полю на строку и прилагала к этой строке цитату.
  2. На стороне приложения разбирать ответ построчно, сопоставляя текст ответа в каждой строке с приложенным к ней объектом цитаты один к одному.
  3. По фиксированным правилам преобразовывать текст в целевую структуру, записывая цитату как есть в поле citation.
  4. Строки без цитаты помечать и отправлять на ручную проверку или просто отбрасывать, не сохраняя в базу как подтверждённый факт.

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

Работа со сканами: сначала получить текст, потом перепроверить

Если перед нами сканированный PDF, на стороне приложения можно сначала прогнать OCR и получить текст, а затем передать его модели для цитирования. Но сам OCR тоже вносит погрешности, поэтому как минимум нужно проверить следующее:

  • Числа и единицы: десятичные точки, разделители тысяч и символы валют распознаются неверно чаще всего — а именно они и составляют суть информации о ценах.
  • Структура таблиц: сдвиг строк и столбцов приводит к тому, что числовые значения привязываются к неверному пункту, и даже самая точная позиция цитаты уже ничего не значит.
  • Сопоставление страниц: позиция в тексте OCR должна отображаться обратно на исходную сканированную страницу, иначе проверяющий не найдёт источник.

Иными словами, в этой цепочке цитата указывает на текст OCR, а не на исходное сканированное изображение. Верхняя граница достоверности определяется качеством OCR.

Чего Claude Citations не может доказать

С цитатами проверяемость ответа повышается, но в публичных формулировках стоит быть сдержанным. Следующие заявления не имеют оснований, и их не стоит использовать:

  • «Автоматическая проверка в интернете»: Citations работают с документами, которые предоставил пользователь, и не связаны с поиском в сети.
  • «Ноль галлюцинаций»: правильное место цитаты ещё не значит, что обобщение и рассуждение модели не содержат отклонений.
  • «Источник гарантированно надёжен»: если исходный документ сам содержит ошибку, цитата лишь точно укажет на эту ошибку.
  • «Со всеми сканированными PDF невозможно работать»: ограничение заключается в том, что при отсутствии извлекаемого текста нельзя дать прямую ссылку; на стороне приложения всё ещё есть способы обойти это.

Более точная формулировка такова: Claude Citations снижают цену доказательства «откуда взялась эта фраза», а вот «верна ли эта фраза» по-прежнему должны определять человек или правила.

claude-citations-verifiable-evidence-ru-image-3

Направления, за которыми стоит следить дальше

Перечисленное ниже относится к прогнозам и вопросам, требующим наблюдения, а не к уже подтверждённым фактам:

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

Пока по этим вопросам нет однозначных ответов, разумная стратегия — относиться к Claude Citations как к «локатору» в цепочке доказательств, а не как к «судье».

Если верить всему, что написано в книге, то лучше бы её вовсе не было. — «Мэн-цзы», глава «Цзинь синь», часть вторая

Оставьте комментарий