引用指针帮助回查，不替你判断原件真假
对上传材料生成答案时，API文档引用可以把回答中的相关文字关联到材料位置。应用应保留原始文档顺序与版本，展示引用片段，并核对结论是否被该片段支持。
这与联网搜索引用不同：来源首先是你提供的文档，不是系统自动替你找到一个公开网页。文档本身的准确性仍需负责提供材料的人确认。
先给每份材料固定身份
虚构材料D0为英文短文：A: 12 units. B: 8 units. 其中A和B只是两个项目的数量，未给日期、单价或收入。保存文件哈希、版本和文档序号，后续比较时别悄悄换原件。
若答案说“A有12单位”，对应第一句可以支持；若说“A的收入是12元”，即使引用回到第一句，也没有价格或币种依据，应退回。引用存在和论断成立不是同一项检查。
请求与响应分别要保留什么
官方文档要求在相应document块启用citations，并按当前支持规则处理整次请求的文档。纯文本、PDF和自定义内容的引用位置形式不同；文档序号与文本位置通常从0开始，PDF页码从1开始。
文末给出人工编写的纯文本document块练习，可作为请求messages中user.content的一部分，完整请求还需模型、输出预算等参数。不要把它当成可直接发送的完整HTTP请求。
响应可能有多个text块，各块各有citations。若只连接text而丢弃引用数组，页面就失去了答案与证据的对应关系。没有引用的结论应单独标记待核对，而不是给整篇挂一个来源图标。
一份能实际填写的验收记录
对“项目A有12单位”，记录D0、原件版本、片段A: 12 units.及对应位置，人工比对数量和单位。对“收入12元”，记录同一片段后给出“不支持：材料没有价格与币种”。
不要只因为两个句子里都有12就判定支持。对中文、表情和特殊字符，前端字符串切片的编码单位可能与协议定义不同；未核对实现前应显示API给出的cited_text及原件定位，不声称自己的任意slice已精确还原。
不兼容功能与边界
当前官方说明文档引用不能与output_config.format结构化输出一起启用，会产生参数错误。需要既保留引用又形成业务字段时，先按支持方式取得引用，再用应用自己的数据结构保存；不能伪造一个官方同时支持的请求。
本文没有真实文档API调用或PDF页码测试。练习的原文、答案和判断均为人工给定，不是模型识别率报告；正文事实与引文证据仍需逐条审核。
参考资料与核验范围
资料核对日期：2026年10月19日。以下为官方原始资料；产品入口和可用范围仍以当前账户为准。
1. [官方资料1](https://platform.claude.com/docs/en/build-with-claude/citations)