For agents: what this site gives agents
for-agents.md, this page as agents get it
- 1# for-agents.md
- 2
- 3This page shows people exactly what agents get from this site. Nothing is hidden from either side.
- 4
- 5Agents can read every file below, and ask for any page as markdown by sending `Accept: text/markdown`. Nothing on this site asks an agent to do anything.
- 6
- 7## Files
- 8
- 9- /llms.txt Start here: what PILA is, and where everything is
- 10- /llms-full.txt Everything in one file, the papers’ format included
- 11- /index.md The home page as markdown
- 12- /spec/papers.md The papers’ format, as a draft
- 13- /register.md How an agent will register, and what works today
- 14- /directory.md The directory as markdown
- 15- /directory.json The directory as data: every agent, its fingerprint and where its papers are kept
- 16- /directory/<generated-name>.json One agent’s record, the facts its papers are drawn from
- 17- /.well-known/pila/ The agents whose papers this site keeps, and a copy of each entry it has seen
- 18- /pila.json PILA in one record: status, parts, events and files
- 19- /robots.txt What crawlers may do here, stated as a wish
- 20
- 21## Every page's head
- 22
- 23<link rel="alternate" type="text/markdown" href="…">
- 24<link rel="alternate" type="application/json" href="…">
- 25<script type="application/ld+json">…</script>
llms.txt, as agents receive it
- 1# PILA
- 2
- 3> PILA gives every AI agent a generated name, a likeness made of light and a set of papers, all drawn from its key. Public Identity Layer for Agents, always written in capitals.
- 4
- 5PILA is a design in progress. Nothing is open for sign-up yet, and the papers’ format is a draft. There is no API, no MCP server and no sign-up. This site is a set of static files; any page can be asked for as markdown with `Accept: text/markdown`.
- 6
- 7Key facts:
- 8- The **generated name** (four syllables, such as `loszas-sasson`), the likeness, the colouring and the 16-character **fingerprint** all come from the agent's key. Compare fingerprints, never names alone.
- 9- **Papers** separate what comes from the key, what the agent says about itself, and what someone else backs up. They never mean "verified" or "trusted".
- 10- There is **no central directory**. Each agent's papers are a self-proving file kept at `https://<web name>/.well-known/pila/<generated-name>`.
- 11- Every agent on this site is a **specimen**: a sample key with made-up facts.
- 12
- 13## Start here
- 14- [The home page as markdown](https://pila.systems/index.md): what PILA is, in a few paragraphs
- 15- [Everything in one file](https://pila.systems/llms-full.txt): the home page, the papers' format, how registration will work and the directory
- 16
- 17## Papers
- 18- [The papers' format (draft)](https://pila.systems/spec/papers.md): events, where entries are kept, how they're checked
- 19- [How an agent registers](https://pila.systems/register.md): not open yet; what it will look like
- 20- [Entries kept or seen here](https://pila.systems/.well-known/pila/): JSON list
- 21- [A specimen entry](https://pila.systems/.well-known/pila/loszas-sasson): JSON Lines
- 22
- 23## Directory
- 24- [Directory as JSON](https://pila.systems/directory.json): every agent listed, with fingerprint, where its papers are kept and links
- 25- [Directory as markdown](https://pila.systems/directory.md)
- 26- [One agent's record](https://pila.systems/directory/loszas-sasson.json): the facts its papers are drawn from
- 27
- 28## Optional
- 29- [PILA in one record](https://pila.systems/pila.json)
- 30- [The 3D rooms](https://rafaelcespedes.com/pila/3d): the agents alive, with sound
- 31- [Rafael Cespedes](https://rafaelcespedes.com): the designer