For the complete documentation index, see llms.txt. This page is also available as Markdown.

Citations, Source Locations, and Download Links

Citations connect a response to the source material used to support it. Preserve source identifiers and locations so a reader can inspect the evidence.

A short walkthrough of citations, source locations, and download links.

Before you begin

A retrieval or document-processing path that returns source information.

Key concepts

Term
Definition

Citation

A reference linking a response to supporting source material. Preserve the source identifier and available location so readers can inspect evidence.

Source locator

A supported position within a document, such as a page or passage reference. Do not invent a locator when parsing did not return one.

File reference

An identifier or URL used to pass a file to a supported operation. It must be accessible and use the format expected by that operation.

Signed URL

A temporary link authorizing access under its issuance conditions. It can expire and may remain usable until expiration after other permissions change.

Enable and inspect citations

  1. Inspect the retrieved result for its document ID, title, location, and link fields.

  2. Keep those fields attached when passing evidence to the model or interface.

  3. Open the displayed citation with an authorized account and check the relevant passage.

The reader can trace the answer to the correct source.

Behavior and limitations

Do not invent a page number when the source has no page locator. A returned file or provider action result is not automatically a formatted citation. Download URLs can expire. Store durable resource IDs rather than treating a signed URL as a permanent identifier.

File Inputs, Supported Formats, and Size Limits

Was this helpful?