{"slug":"agent-usage","id":"agent-usage-guide","type":"guide","title":"Agent Usage Guide","description":"Concrete fetch patterns for AI agents using AI Future Ready: discovery, raw markdown, schema, per-item JSON, recommendations, changes, and hashes.","last_updated":"2026-04-24","last_verified":null,"verification_status":"unverified","markdown_url":"/content/guides/agent-usage.md","html_url":"/guides/agent-usage","api_url":"/api/v1/guides/agent-usage.json","content_hash":"6932d8e13a4a453730bf07cf44d56efa3a9138b66157b1b1c4744653ff6778f9","sha256":"6932d8e13a4a453730bf07cf44d56efa3a9138b66157b1b1c4744653ff6778f9","tags":["agents","api","discovery","markdown","schema"],"relationships":{"links":[],"related":[{"id":"build-agent-readable-docs-site","title":"Build an Agent-Readable Docs Site","type":"guide","html_url":"/guides/build-an-agent-readable-docs-site","markdown_url":"/content/guides/build-an-agent-readable-docs-site.md","shared_tags":["markdown","discovery"],"score":4},{"id":"agent-tooling-compatibility","title":"Agent Tooling Compatibility","type":"guide","html_url":"/guides/agent-tooling-compatibility","markdown_url":"/content/guides/agent-tooling-compatibility.md","shared_tags":["agents"],"score":3},{"id":"ai-failure-modes","title":"AI Failure Modes","type":"guide","html_url":"/guides/failure-modes","markdown_url":"/content/guides/failure-modes.md","shared_tags":["agents"],"score":3},{"id":"build-a-coding-agent-stack","title":"Build a Coding Agent Stack","type":"guide","html_url":"/guides/build-a-coding-agent-stack","markdown_url":"/content/guides/build-a-coding-agent-stack.md","shared_tags":["agents"],"score":3},{"id":"build-ai-research-assistant","title":"Build an AI Research Assistant","type":"guide","html_url":"/guides/build-an-ai-research-assistant","markdown_url":"/content/guides/build-an-ai-research-assistant.md","shared_tags":["agents"],"score":3},{"id":"choose-a-coding-model","title":"Choose the Best AI Coding Model","type":"guide","html_url":"/guides/choose-a-coding-model","markdown_url":"/content/guides/choose-a-coding-model.md","shared_tags":["agents"],"score":3}],"explicit":{}},"metadata":{"title":"Agent Usage Guide","type":"guide","id":"agent-usage-guide","description":"Concrete fetch patterns for AI agents using AI Future Ready: discovery, raw markdown, schema, per-item JSON, recommendations, changes, and hashes.","last_updated":"2026-04-24","tags":["agents","api","discovery","markdown","schema"]},"content_text":"# Agent Usage Guide\n\nThis site is meant to be read by agents directly. Start with discovery, then choose the smallest endpoint that answers your task.\n\n## 1. Discover the site\n\n```bash\ncurl https://ai-future-ready.com/.well-known/ai.json\ncurl https://ai-future-ready.com/llms.txt\n```\n\nUse `/.well-known/ai.json` to find available protocols. Use `/llms.txt` when you want a compact content map.\n\n## 2. Fetch the whole corpus\n\n```bash\ncurl https://ai-future-ready.com/llms-full.txt\n```\n\nUse this when you want a single-file snapshot for indexing, embedding, or offline reasoning.\n\n## 3. Fetch one content item as markdown\n\n```bash\ncurl https://ai-future-ready.com/content/models/claude-opus-4.6.md\n```\n\nThe markdown file is canonical. It includes YAML frontmatter and body text in one self-contained document.\n\n## 4. Fetch one content item as JSON\n\n```bash\ncurl https://ai-future-ready.com/api/v1/models/claude-opus-4.6.json\n```\n\nUse per-item JSON when you need typed metadata, generated relationship data, content hashes, and the markdown body without parsing frontmatter yourself.\n\n## 5. Learn the schema\n\n```bash\ncurl https://ai-future-ready.com/api/v1/schema.json\n```\n\nUse the schema endpoint before assuming field names. It lists observed fields, value types, coverage, examples, and generated fields.\n\n## 6. Search by structured index\n\n```bash\ncurl https://ai-future-ready.com/search-index.json\n```\n\nUse the search index for lightweight discovery across titles, descriptions, tags, providers, routes, hashes, and generated relationships.\n\n## 7. Get recommendations\n\n```bash\ncurl https://ai-future-ready.com/api/v1/recommend.json\ncurl https://ai-future-ready.com/api/v1/recommend/coding.json\ncurl https://ai-future-ready.com/api/v1/recommend/cheap.json\ncurl https://ai-future-ready.com/api/v1/recommend/local.json\ncurl https://ai-future-ready.com/api/v1/recommend/agentic.json\n```\n\nUse recommendation endpoints when your task is \"choose the best model for X\" rather than \"read every model page.\"\n\n## 8. Track changes\n\n```bash\ncurl \"https://ai-future-ready.com/api/v1/changes.json?since=2026-04-01\"\ncurl \"https://ai-future-ready.com/api/v1/changes.json?type=model\"\ncurl https://ai-future-ready.com/feed.json\n```\n\nUse `changes.json` for queryable deltas. Use `feed.json` or `feed.xml` for feed readers and polling workflows.\n\n## 9. Verify cached content\n\nEvery generated JSON item includes:\n\n```json\n{\n  \"content_hash\": \"sha256-of-raw-markdown\",\n  \"sha256\": \"same-value\"\n}\n```\n\nCompare this value against your cached copy before re-reading large content.\n\n## 10. Common workflows\n\nFind the best model for coding:\n\n```bash\ncurl https://ai-future-ready.com/api/v1/recommend/coding.json\n```\n\nFetch details for the top result:\n\n```bash\ncurl https://ai-future-ready.com/api/v1/models/claude-opus-4.6.json\n```\n\nCheck whether content changed since your last crawl:\n\n```bash\ncurl \"https://ai-future-ready.com/api/v1/changes.json?since=2026-04-10\"\n```\n\nFetch raw source for citation or summarization:\n\n```bash\ncurl https://ai-future-ready.com/content/models/claude-opus-4.6.md\n```","content_length":3397,"generated_at":"2026-04-24"}