Цитаты в Claude API помогают связать фрагмент ответа с местом в переданном источнике. Чтобы сотрудник действительно открыл нужное доказательство, приложению нужно сохранить не только текст ответа, но и соответствие документов, версии файлов и координаты цитат. Красиво оформленная ссылка без этой связи может привести к другому документу.
Этот FAQ — для разработчика корпоративного ассистента и владельца базы знаний. Он отвечает на вопросы о показе источников в интерфейсе: откуда брать страницу, как различать форматы и что сохранять между запросами. Здесь рассматривается работа с предоставленными документами в Messages API, а не интерфейс пользовательского чата Claude или вся архитектура RAG.
Официальная документация проверена 1 ноября 2026 года. Вызовы Claude API, загрузка файлов и работа интерфейса не выполнялись. Диапазоны страниц и схема приложения ниже составлены вручную для объяснения; это не полученные ответы модели и не проверенный SDK-пример.
Содержание
- Достаточно ли написать «ответь со ссылками на источники»?
- Как понять, какие страницы PDF входят в цитату?
- Почему у текстового документа вместо страницы другие координаты?
- Почему модель читает скан, а цитата на него не появляется?
- Можно ли использовать document_index как постоянный ID файла?
- Можно ли получить строгий JSON и встроенные цитаты одновременно?
- Что меняется, если документ загружен через Files API?
Достаточно ли написать «ответь со ссылками на источники»?
Для встроенных цитат документы передают с citations.enabled=true; в одном запросе настройка должна быть включена для всех документов либо выключена для всех. Руководство Citations.
Обычная просьба в тексте поручения и настройка функции — разные части интеграции. У разработчика должен быть понятный ответ на вопрос: ссылка пришла как метаданные API или была написана моделью внутри обычного текста?
Например, ассистент отвечает сотруднику о сроке согласования заявки. Для интерфейса полезно хранить две связанные сущности: само утверждение и описание места в источнике. Тогда дизайнер может показать аккуратную кнопку «Открыть источник», а обработчик кнопки — найти нужный файл. Если оставить только готовую строку ответа, эту связь потом придётся восстанавливать.
Это проектное решение для приложения. Оно не предполагает, что каждое предложение автоматически получит отдельную достаточную цитату.
Как понять, какие страницы PDF входят в цитату?
Для PDF start_page_number начинается с 1, а end_page_number не включается в диапазон. Учебные примеры:
| Начало | Конец | Страницы, которые нужно открыть |
|---|---|---|
| 3 | 4 | Только 3 |
| 3 | 5 | 3 и 4 |
Правило индексов описано в документации цитирования.
Ошибка на единицу особенно заметна в просмотрщике: пользователь нажимает на ссылку, видит соседнюю страницу и решает, что ассистент выдумал источник. Поэтому преобразование диапазона в подпись кнопки нужно согласовать с разработчиком PDF-просмотра.
Номер листа в файле и напечатанная внизу страницы цифра могут различаться из-за обложки или приложений. Документация PDF support рекомендует ориентироваться на номера в PDF-просмотрщике. Правила работы с PDF.
В интерфейсе можно явно подписать «страница файла», а печатный номер показывать дополнительно, если приложение действительно умеет его определять. Не вычисляйте смещение по обложке для всего архива автоматически: разные документы могут иметь разную структуру.
Почему у текстового документа вместо страницы другие координаты?
Формат координат зависит от источника:
| Источник | Координата цитаты |
|---|---|
| PDF с текстом | Диапазон страниц, начало с 1 |
| Plain text | Диапазон символов, начало с 0 |
| Custom content | Диапазон блоков, начало с 0 |
Для символов и блоков конечная граница также не включается. Типы координат в API.
Не пытайтесь открыть любой источник по универсальному полю «страница». Для текстового регламента приложению нужен просмотр фрагмента текста; для PDF — просмотр страницы; для заранее собранных блоков — собственная привязка к исходной записи.
Если вы преобразовали PDF в текст, сохраните связь текста с оригиналом до запроса. Иначе наличие символьной координаты не восстановит номер исходного листа само по себе. Порядок подготовки разных документов разобран в сравнении парсеров PDF для RAG.
Почему модель читает скан, а цитата на него не появляется?
Понимание изображения и текстовое цитирование — разные возможности. Встроенные цитаты не поддерживают изображения; PDF-скан без извлекаемого текста не является цитируемым источником. Ограничения Citations.
При этом механизм PDF support анализирует и текст, и изображения страниц. Поэтому способность ответить на вопрос о картинке не доказывает наличие текстовой цитаты на тот же объект. Как Claude обрабатывает PDF.
Для рабочего архива сначала разберите, что именно должен открыть сотрудник. Если нужен фрагмент распознанного текста, потребуется подготовка текстового слоя и проверка его соответствия скану. Если доказательство — диаграмма или подпись на изображении, интерфейсу может понадобиться отдельное отображение страницы с пояснением происхождения.
Не подменяйте отсутствующую цитату вручную написанным «стр. 7», оформленным так же, как машинная координата. Такая подпись допустима только как отдельно проверенная разметка приложения с понятным происхождением.
Можно ли использовать document_index как постоянный ID файла?
Нет: document_index — позиция документа в переданном наборе, начиная с 0, а не ID в вашей базе. Описание ссылок на документы.
Представьте два запроса. В первом отправлены регламент и приложение к нему, во втором — приложение и регламент. Один и тот же позиционный индекс теперь указывает на разные источники. Это учебная ситуация, которая показывает необходимость сохранять состав конкретного запроса.
Рекомендуемое решение — хранить рядом с результатом собственное соответствие: «позиция документа в этом запросе → внутренний ID → редакция → доступный пользователю оригинал». Значения и названия полей выбирает ваше приложение; это не новая обязательная схема Claude API.
Для долгоживущей ссылки недостаточно заголовка «Регламент закупок». У компании могут быть несколько редакций и документы с одинаковым названием. Открывать нужно ту версию, которая участвовала в ответе, а проверку её действительности показывать отдельно.
Можно ли получить строгий JSON и встроенные цитаты одновременно?
Совместное использование цитат и строгого JSON через output_config.format несовместимо: документация указывает ошибку 400. Это ограничение конкретного режима вывода, а не запрет хранить результаты обработки в JSON. Совместимость Structured outputs.
В руководстве предложен другой порядок: запросить поля в текстовом ответе с цитатами и затем разобрать результат своим кодом. Наличие значения и цитаты для каждого поля всё равно нужно проверить. Раздел о структурированных данных с цитатами.
Например, ваше приложение может хранить такую вручную составленную запись:
{
"field": "approval_period",
"value": "уточнить по действующей редакции",
"source_record": "purchasing-policy",
"source_revision": "training-example",
"review_status": "needs_review"
}Это учебная схема внутреннего результата, а не ответ Claude, API-параметры или настоящий регламент. Ссылка на доказательство должна храниться рядом по правилам вашего приложения. Если обработчик не нашёл цитату или однозначное значение, разумнее сохранить явный статус разбора, чем заполнить поле правдоподобным предположением.
Что меняется, если документ загружен через Files API?
Files API позволяет загрузить файл и ссылаться на него через file_id. Загруженный файл нельзя изменить на месте: для новой редакции нужно загрузить новый файл. Документация также предупреждает, что доступ к загрузкам определяется рабочим пространством, а не отдельной беседой или конечным пользователем. Files API.
Для корпоративного ассистента это повод разделить два решения. Первое — какой объект хранится у поставщика API. Второе — какой сотрудник вашего приложения имеет право открыть исходник. Одна лишь цитата в ответе не задаёт второе правило.
Сохраните собственную таблицу соответствия редакций и файлов. При замене документа обновляйте её осознанно, сохраняя возможность объяснить старые ответы. Не обещайте пользователю, что удаление карточки в вашей базе мгновенно удаляет все связанные объекты в других системах: это отдельная операция с отдельным результатом.
Почему нельзя сохранить только объединённый текст ответа?
Messages API возвращает содержимое сообщения как набор блоков. При обработке ответа учитывайте структуру, а не только визуально склеенную строку. Справочник Create a Message.
Предлагаемый порядок для интерфейса — сохранить исходное представление результата, затем отдельно собрать текст для показа и список переходов к источникам. Это позволит исправлять отображение ссылок без повторного сочинения ответа.
Разработчик должен определить, что происходит при нескольких источниках у одного утверждения, повторной ссылке и недоступном оригинале. Кнопка может оставаться на месте с честным сообщением о доступе; молча открывать другой файл с похожим названием не следует.
Если приложение работает с потоком ответа, правила завершения сообщения и частичных данных рассмотрены в отдельном FAQ о потоковом ответе Claude API.
Доказывает ли работающая ссылка правильность всего ответа?
Нет. Рабочая ссылка позволяет проверить конкретный источник. Для пользователя остаются два отдельных вопроса: подтверждает ли фрагмент утверждение и относится ли правило к его ситуации?
Представьте, что приведён действующий срок для одного подразделения, а вопрос задан о другом. Технически переход на страницу может работать идеально, но ответ всё равно не подходит сотруднику. Это вымышленный пример проверки области действия правила, а не обнаруженная ошибка Claude.
Более глубокий вопрос — насколько существенный факт повлиял на итоговое решение — разобран в статье об ИИ-аналитике документов. Здесь задача уже: сделать происхождение ответа открываемым и понятным, чтобы такая проверка вообще была возможна.
Как AI студия Владимира Ломтева помогает показывать источники в ИИ-ассистенте
AI студия Владимира Ломтева может подготовить документы и их редакции для базы знаний, разработать интерфейс перехода от ответа к источнику, интегрировать поиск с корпоративным ассистентом и проверить соответствие ответов исходным материалам. Это связано с устройством всей базы, а не только с оформлением кнопки цитаты.
Первый шаг — выбрать один набор документов, определить владельца, разрешённый круг пользователей и критерий: сотрудник открывает источник нужной редакции и может проверить утверждение. Обсудить задачу.
Итог: храните цитату вместе с документом и его версией
Для надёжного показа источников свяжите ответ, тип координат, состав запроса и редакцию оригинала. Различайте страницу PDF, символы текста и блоки, сохраняйте структуру результата и явно отмечайте отсутствие доказательства. Тогда цитата станет рабочим переходом к источнику, а не просто убедительным оформлением ответа.
