From cb2c085d89e9428f385b46fa6cb9a5474dc2b049 Mon Sep 17 00:00:00 2001 From: sohey Date: Tue, 10 Mar 2026 13:28:24 -0400 Subject: [PATCH 1/2] added agent resources --- AGENTS.md | 2 +- docs/ai-agents/resources-for-ai-agents.mdx | 70 ++++++++++++++++++++++ docs/docs.json | 6 ++ 3 files changed, 77 insertions(+), 1 deletion(-) create mode 100644 docs/ai-agents/resources-for-ai-agents.mdx diff --git a/AGENTS.md b/AGENTS.md index 8c1ba9a22..f36e05680 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,7 +2,7 @@ IMPORTANT: Prefer retrieval-led reasoning. Read relevant docs before generating code. Base is an Ethereum L2 by Coinbase. Docs for: Base Chain, Smart Wallet, OnchainKit, MiniKit. [Docs]|root:./docs -|ai-agents:index,trading +|ai-agents:index,resources-for-ai-agents,trading |ai-agents/core-concepts:agent-apps,agent-frameworks,identity-verification-auth,payments-and-transactions,wallets |base-account/basenames:basename-transfer,basenames-faq,basenames-onchainkit-tutorial,basenames-wagmi-tutorial |base-account/contribute:contribute-to-base-account-docs,security-and-bug-bounty diff --git a/docs/ai-agents/resources-for-ai-agents.mdx b/docs/ai-agents/resources-for-ai-agents.mdx new file mode 100644 index 000000000..5a74ebdf9 --- /dev/null +++ b/docs/ai-agents/resources-for-ai-agents.mdx @@ -0,0 +1,70 @@ +--- +title: "Resources for AI agents" +description: "Base-first resources for AI agents, including docs indexes, MCP access, skills, and recommended starting points" +--- + +Use this page as the starting point when you want an AI assistant to build on Base. These resources help an assistant find the right documentation, retrieve live docs context, and follow the structure of this repository efficiently. + +## Docs index for AI + +Start with the [Base docs index for AI](https://docs.base.org/llms.txt) when you want broad documentation context. It gives your assistant a machine-readable entrypoint into the Base docs so it can discover the most relevant pages before going deeper. + +Use the docs index when you want to: + +- Understand the overall Base docs structure +- Find the right section before reading full pages +- Give an assistant high-level context for multiple Base products + +## Base MCP server + +Use the [Base MCP server setup guide](https://docs.base.org/get-started/docs-mcp) when you want live access to Base documentation from an AI coding assistant. The guide shows you how to connect `https://docs.base.org/mcp` in tools such as Cursor and Claude Code. + +Use MCP when you want your assistant to: + +- Search Base docs in real time +- Retrieve the exact page it needs while you work +- Stay current with the latest Base documentation + +## Base skills + +Use the [Base skills repository](https://github.com/base/skills) when you want installable agent workflows for common Base development tasks. These skills help assistants handle specific jobs such as connecting to Base, deploying contracts, integrating Base Account, running a Base node, or migrating app patterns. + +Use Base skills when you want to: + +- Speed up common implementation tasks +- Give an assistant procedural guidance for Base-specific workflows +- Reuse proven patterns instead of writing prompts from scratch + +## Repo retrieval map + +If you are working in this repository, use the root-level `AGENTS.md` file as your retrieval map. It organizes the docs by topic and product area so an assistant can narrow its search quickly instead of scanning unrelated sections. + +Use `AGENTS.md` when you want to: + +- Route an assistant to the right docs area quickly +- Limit context to the pages that matter for your task +- Improve retrieval quality across `ai-agents`, `base-chain`, `base-account`, `mini-apps`, and `onchainkit` + +## Recommended starting points + +Use these sections when you want to narrow context to a specific type of work: + +- [AI Agents overview](/ai-agents) for the overall agent building model on Base +- [Agent frameworks](/ai-agents/core-concepts/agent-frameworks) for framework choices and tradeoffs +- [Wallets](/ai-agents/core-concepts/wallets) for agent wallets, signing, and funded execution +- [Payments and transactions](/ai-agents/core-concepts/payments-and-transactions) for x402 payments and onchain actions +- [Identity and auth](/ai-agents/core-concepts/identity-verification-auth) for verification and trust between agents and services +- [Base Account quickstart for AI tools](/base-account/quickstart/ai-tools-available-for-devs) for agent-assisted wallet and account flows +- [Deploy on Base](/base-chain/quickstart/deploy-on-base) for contract deployment on Base +- [Create a new Mini App](/mini-apps/quickstart/create-new-miniapp) for agent experiences in the Base app +- [OnchainKit AI prompting guide](/onchainkit/guides/ai-prompting-guide) for prompting patterns when building onchain apps + +## Example prompts + +These prompts show the kinds of tasks you can ask an assistant to handle when it has access to Base resources: + +- "Deploy my ERC-20 contract to Base Sepolia and verify it on Basescan." +- "Add Sign in with Base to my Next.js app using wagmi." +- "Set up a wallet for my AI agent that can hold USDC and sign transactions autonomously." +- "Create a App with a USDC payment flow." +- "Migrate my OnchainKit wallet component to standalone wagmi hooks." diff --git a/docs/docs.json b/docs/docs.json index 7d78cdff3..327d4d9b7 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -541,6 +541,12 @@ "ai-agents/core-concepts/agent-apps" ] }, + { + "group": "Resources", + "pages": [ + "ai-agents/resources-for-ai-agents" + ] + }, { "group": "Trading & Execution", "pages": [ From 2752aeb05e98bd3bc32eabc14c0dda6ad7953f87 Mon Sep 17 00:00:00 2001 From: sohey Date: Tue, 10 Mar 2026 13:35:00 -0400 Subject: [PATCH 2/2] added agent resources --- docs/ai-agents/resources-for-ai-agents.mdx | 19 ++++--------------- 1 file changed, 4 insertions(+), 15 deletions(-) diff --git a/docs/ai-agents/resources-for-ai-agents.mdx b/docs/ai-agents/resources-for-ai-agents.mdx index 5a74ebdf9..2e964002c 100644 --- a/docs/ai-agents/resources-for-ai-agents.mdx +++ b/docs/ai-agents/resources-for-ai-agents.mdx @@ -3,11 +3,11 @@ title: "Resources for AI agents" description: "Base-first resources for AI agents, including docs indexes, MCP access, skills, and recommended starting points" --- -Use this page as the starting point when you want an AI assistant to build on Base. These resources help an assistant find the right documentation, retrieve live docs context, and follow the structure of this repository efficiently. +Use this page as the starting point when you want an AI assistant to build on Base. These resources help an assistant find the right documentation and retrieve live docs context for any Base product. ## Docs index for AI -Start with the [Base docs index for AI](https://docs.base.org/llms.txt) when you want broad documentation context. It gives your assistant a machine-readable entrypoint into the Base docs so it can discover the most relevant pages before going deeper. +Start with the [LLMS.txt](https://docs.base.org/llms.txt) when you want broad documentation context. It gives your assistant a machine-readable entrypoint into the Base docs so it can discover the most relevant pages before going deeper. Use the docs index when you want to: @@ -35,16 +35,6 @@ Use Base skills when you want to: - Give an assistant procedural guidance for Base-specific workflows - Reuse proven patterns instead of writing prompts from scratch -## Repo retrieval map - -If you are working in this repository, use the root-level `AGENTS.md` file as your retrieval map. It organizes the docs by topic and product area so an assistant can narrow its search quickly instead of scanning unrelated sections. - -Use `AGENTS.md` when you want to: - -- Route an assistant to the right docs area quickly -- Limit context to the pages that matter for your task -- Improve retrieval quality across `ai-agents`, `base-chain`, `base-account`, `mini-apps`, and `onchainkit` - ## Recommended starting points Use these sections when you want to narrow context to a specific type of work: @@ -56,8 +46,7 @@ Use these sections when you want to narrow context to a specific type of work: - [Identity and auth](/ai-agents/core-concepts/identity-verification-auth) for verification and trust between agents and services - [Base Account quickstart for AI tools](/base-account/quickstart/ai-tools-available-for-devs) for agent-assisted wallet and account flows - [Deploy on Base](/base-chain/quickstart/deploy-on-base) for contract deployment on Base -- [Create a new Mini App](/mini-apps/quickstart/create-new-miniapp) for agent experiences in the Base app -- [OnchainKit AI prompting guide](/onchainkit/guides/ai-prompting-guide) for prompting patterns when building onchain apps +- [Build a Base app](/get-started/build-app) for agent experiences in the Base app ## Example prompts @@ -67,4 +56,4 @@ These prompts show the kinds of tasks you can ask an assistant to handle when it - "Add Sign in with Base to my Next.js app using wagmi." - "Set up a wallet for my AI agent that can hold USDC and sign transactions autonomously." - "Create a App with a USDC payment flow." -- "Migrate my OnchainKit wallet component to standalone wagmi hooks." +- "Build an agent that pays for API requests using the x402 protocol."