> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sinas.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Icons

> Icon references for agents and resources

Agents and functions support configurable icons via the `icon` field. Two formats are supported:

| Format                          | Example                            | Description                       |
| ------------------------------- | ---------------------------------- | --------------------------------- |
| `url:<url>`                     | `url:https://example.com/icon.png` | Direct URL to an image            |
| `collection:<ns>/<coll>/<file>` | `collection:assets/icons/bot.png`  | File stored in a Sinas collection |

Collection-based icons generate signed JWT URLs for private files and direct URLs for public collection files. Icons are resolved at read time via the icon resolver service.