What is an agent-friendly URL parameter?

Definition

An agent-friendly URL parameter can provide a simple way to ask a server for Markdown, structured data, or another lower-cost representation. It is useful when clients cannot set content-negotiation headers or when an explicit shareable format URL makes testing and debugging easier.

The parameter should change representation rather than the underlying meaning or authorization. Servers should validate permitted values, preserve canonical indexing rules, return accurate content types, avoid exposing private data, and prevent format variants from creating uncontrolled duplicate search pages.

ELI5

An agent-friendly URL parameter is an extra part of a web address that asks a site for a simpler or more structured version of the same information. This can help an AI tool read the content without processing the full visual page.

For example, adding a supported format parameter might return a clean Markdown version of an article instead of its menus and layout. The alternate version should keep the same meaning and access rules, and it should not expose private data or create misleading duplicate search pages.

What can an agent-friendly URL parameter request?

It can request an approved representation such as Markdown or structured data while leaving the underlying resource and access rules unchanged.

Should agent-friendly URL parameters create separate indexed pages?

Usually no. The human-facing canonical URL should remain authoritative while format variants are treated as alternate representations rather than duplicate pages.

  1. Christopher Burns beside the words Make Libraries Visible to AI Agents
Definition card for agent-friendly URL parameter: What is an agent-friendly URL parameter?

An agent-friendly URL parameter is a query parameter that requests a compact or structured representation of a page for retrieval by an AI tool.