AI content updates by mnelsonBT · Pull Request #17994 · ethereum/ethereum-org-website

mnelsonBT · 2026-04-19T23:42:48Z

Adds the AI agents builder hub (/ai-agents/) with a landing page and nine sub-pages
Replaces the AI agents use case page with a Decentralized AI use case page
Updates site navigation per AI Agents Developer Hub: Content Architecture for /ai-agents/ #17615
Video embeds: Integrated five educational video resources via across getting-started/, ethereum/, identity/, and decentralized-ai/

Description

Builder pages added

/ai-agents/ — AI agents builder hub landing page
/ai-agents/ethereum/ — Why Ethereum for AI agents
/ai-agents/getting-started/ — Four-step developer on-ramp
/ai-agents/frameworks/ — Framework directory and decision guide
/ai-agents/wallets/ — Smart accounts, session keys, key management
/ai-agents/verification/ — zkML, TEEs, onchain audit trails
/ai-agents/payments/ — Machine payments with x402
/ai-agents/identity/ — Agent identity with ERC-8004
/ai-agents/use-cases/ — What agents are doing on Ethereum today
/ai-agents/l2s/ — Choosing an L2 for agent workloads

Layout and components

Custom AiAgentsLayout template (src/layouts/md/AiAgents.tsx) with dropdown sub-navigation, ContentHero, and ToC sidebar
HubCard component built from Card/CardBanner/CardContent/CardTitle/CardParagraph/ButtonLink primitives for the landing page capability grid
pre → Codeblock override so fenced code blocks render with syntax highlighting, line numbers, copy button, and language label (matching /developers/docs/* behavior)

Navigation changes:

Updated buildNavigation.ts to add AI agents under the Build menu
Replaced the AI agents callout on the Use Cases hub with a Decentralized AI callout
Added all required i18n keys to common.json

Deviations from original Issue scope:

Added a BREADCRUMB_LABEL_OVERRIDES map in page-jsonld.tsx so the slug-derived breadcrumb label renders as "AI agents" instead of "Ai agents" in the BreadcrumbList JSON-LD, fixing incorrect casing visible in Google's breadcrumb rich results, per Jakub feedback
Distributed the centralized FAQ page (from AI Agents Hub: Comprehensive FAQ (LLM optimization) #17627) into per-page ExpandableCard FAQ sections. Each page carries its own contextual Q&A rather than linking to a single FAQ index
body text to match faqItems schema answers, eliminating "on this page" references, and removing substantive content (contract addresses, SDK lists) that only appeared in one location
Note: Original change to add FAQ JSON schemas reverted per @wackerow - FAQ schemas will be updated site-wide rather than bespoke implementation on this PR
Deferred from this PR: AI Agents data page (AI Agents Hub: State of AI Agents data page #17626)
- Static metrics are stale-by-design given how quickly space is evolving
- The issue spec says "updated monthly," but there is no automation; this relies on a human manually remembering to edit markdown
- Recommend deferring to dev for live data page pulling from onchain resources/explorers, or adding an AI data dashboard list to /index

Related Issue

…into ai-content-updates

netlify · 2026-04-19T23:42:54Z

✅ Deploy Preview for ethereumorg ready!

Name	Link
🔨 Latest commit	`cf0820b`
🔍 Latest deploy log	https://app.netlify.com/projects/ethereumorg/deploys/6a11926b373f950008f5e202
😎 Deploy Preview	https://deploy-preview-17994.ethereum.it
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
Lighthouse	7 paths audited Performance: 68 (🟢 up 3 from production) Accessibility: 96 (no change from production) Best Practices: 100 (no change from production) SEO: 98 (🔴 down 1 from production) PWA: 59 (no change from production) View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

konopkja

UI polish pass on the two landing pages.

/ai-agents/ banner: add breathing room around the info Alert.
/ai-agents/: convert the four capability bullets (Programmable wallets, Verifiable inference, Machine payments, Agent identity) into a CardGrid, matching the pattern used on other use-case pages.
/decentralized-ai/: add breathing room around the three inline Alerts (Are you a builder?, Early blockchain media authenticity proofs, Before using AI wallet tools).

All suggestions are one-click committable. Rationale per comment.

konopkja

Scannability pass: proposing bold on key phrases across both landing pages.

Scope.

/ai-agents/ethereum/: 22 paragraph-level suggestions covering the lead paragraph of each section and the load-bearing paragraphs elsewhere.
/decentralized-ai/: 19 suggestions following the same pattern.

Principles applied.

Bold 1 to 3 phrases per paragraph. Beyond that, bold loses signal.
Target phrases that carry the claim. A scanner should reconstruct the section by reading only the bold.
Skip paragraphs whose lead is already bold (session keys, x402 protocol, Zero-knowledge machine learning, Censorship-resistance, etc.) and pure-link lists.
No wording, punctuation, or link changes. One exception flagged inline: the typo auditabile on /decentralized-ai/ line 31.

All suggestions are one-click committable.

Co-authored-by: Jakub <100724231+konopkja@users.noreply.github.com>

Jakub edits to content/decentralized-ai/index and content/ai-agents/ethereum/index Co-authored-by: Jakub <100724231+konopkja@users.noreply.github.com>

…into ai-content-updates # Conflicts: # src/intl/en/template-usecase.json

Co-authored-by: Jakub <100724231+konopkja@users.noreply.github.com>

…into ai-content-updates # Conflicts: # src/intl/en/common.json # src/lib/nav/buildNavigation.ts

phipsae

Hi everyone,

Really nice and comprehensive work on this.
I gave the /ai-agents/ landing page a read and left some comments, mostly around a few claims that could use softening or a citation, plus the agents-vs-bots table. Happy to look at the other pages next if helpful.

Let me know if some comments are unclear.

Best, Philip

phipsae · 2026-05-12T11:03:21Z

-summaryPoint3: Hires humans or other agents for work
+alt: Developer working with AI agent architecture on Ethereum
+summaryPoint1: Programmable wallets with spending limits and session keys
+summaryPoint2: Verifiable behavior via zkML proofs and TEE attestations


Verifiable behavior via TEE attestations today, with zkML proofs emerging for smaller models.

phipsae · 2026-05-12T13:48:16Z

+AI agents are software programs that observe their environment, make decisions, and take actions, including sending transactions, paying for services, and interacting with smart contracts, without requiring human input on every step.

-On Ethereum, we’re seeing innovations of AI agents ranging from virtual influencers and autonomous content creators to real-time market analysis platforms, empowering users by delivering insights, entertainment, and operational efficiency.
+Ethereum provides the infrastructure these agents need: programmable wallets that enforce spending limits, verifiable computation that proves an agent followed its rules, open payment rails for machine-to-machine commerce, and a permissionless identity layer that any application can verify. These are **not properties that a centralized server can replicate**, because they depend on a network that no single party controls.


"verifiable computation that proves an agent followed its rules": Reads like Ethereum provides this already today

"not properties that a centralized server can replicate": a centralized server can publish enforce spending limits, zk proofs, TEE attestations --> better framing about who controls the rules and can change or shut them down

phipsae · 2026-05-12T14:00:07Z

+| -------------------- | ------------------------------------------------------------------------------ | ---------------------------------------------- |
+| **Decision-making**  | Autonomous; adapts to new inputs and conditions                                | Rule-based; executes fixed, pre-programmed logic |
+| **Learning**         | Can update behavior from real-time data and feedback                           | Operates on pre-trained data or hardcoded rules  |
+| **Onchain identity** | Holds a programmable wallet, can sign and send transactions                    | Typically reads data; does not hold assets       |


Also bots can hold wallets (e.g. trading bots)

phipsae · 2026-05-12T14:00:25Z

+| **Decision-making**  | Autonomous; adapts to new inputs and conditions                                | Rule-based; executes fixed, pre-programmed logic |
+| **Learning**         | Can update behavior from real-time data and feedback                           | Operates on pre-trained data or hardcoded rules  |
+| **Onchain identity** | Holds a programmable wallet, can sign and send transactions                    | Typically reads data; does not hold assets       |
+| **Composability**    | Can discover and interact with any open protocol                                | Limited to the APIs it was explicitly integrated with |


dynamic discovery vs. static integration

phipsae · 2026-05-12T14:01:27Z

+| **Learning**         | Can update behavior from real-time data and feedback                           | Operates on pre-trained data or hardcoded rules  |
+| **Onchain identity** | Holds a programmable wallet, can sign and send transactions                    | Typically reads data; does not hold assets       |
+| **Composability**    | Can discover and interact with any open protocol                                | Limited to the APIs it was explicitly integrated with |
+| **Guardrails**       | Enforced by smart contract logic (spending limits, session keys, allowlists)   | Enforced by the operator's server configuration  |


a bot could also hold a smart contract with sessions keys, etc.

phipsae · 2026-05-12T14:03:17Z

-In traditional finance, AI agents often operate in centralized environments with limited data inputs. This hinders their ability to learn or manage assets autonomously.
+|                      | AI agents                                                                      | AI bots                                        |
+| -------------------- | ------------------------------------------------------------------------------ | ---------------------------------------------- |
+| **Decision-making**  | Autonomous; adapts to new inputs and conditions                                | Rule-based; executes fixed, pre-programmed logic |


"Rule-based; executes fixed, pre-programmed logic": thats more an algorithm not AI, maybe drop AI in front of bot

phipsae · 2026-05-12T14:03:56Z

+| **Onchain identity** | Holds a programmable wallet, can sign and send transactions                    | Typically reads data; does not hold assets       |
+| **Composability**    | Can discover and interact with any open protocol                                | Limited to the APIs it was explicitly integrated with |
+| **Guardrails**       | Enforced by smart contract logic (spending limits, session keys, allowlists)   | Enforced by the operator's server configuration  |
+| **Verification**     | Behavior can be proven onchain via zkML or TEE attestations                    | Behavior is attested only by the operator        |


Bots can also be verified

phipsae · 2026-05-13T15:26:03Z

+## AI agents vs AI bots {#ai-agents-vs-bots}

-In traditional finance, AI agents often operate in centralized environments with limited data inputs. This hinders their ability to learn or manage assets autonomously.
+|                      | AI agents                                                                      | AI bots                                        |


Maybe just bots? AI bots contradicts with AI agents

phipsae · 2026-05-13T15:34:27Z

+| **ERC-4337** — Smart account standard | Production EntryPoint deployments on all major networks (v0.7 widely adopted; v0.8, v0.9 also live) |
+| **ERC-8004** — Onchain agent identity registry | Draft — in active adoption; live on 20+ chains since January 2026 |
+| **x402** — Machine-to-machine HTTP payments | Production-ready since Q1 2026 |
+| **L2 transaction cost** | $0.001–$0.003 per operation |


Maybe: sub-cent to low-cents per operation

Resolves conflicts from PR 18198 (Topic layout consolidation) landing in dev while PR 17994 introduced AiAgents as another per-template layout. The AiAgents layout is replaced by a TopicConfig (src/data/topics/ai-agents.ts) plus an aiAgentsComponents bundle (HubCard, CardGrid). Layout wiring: src/layouts/index.ts maps ai-agents to TopicLayout + topicComponents.aiAgentsComponents. src/layouts/md/ folder deleted. i18n: src/intl/en/page-ai-agents.json renamed to template-ai-agents.json with every key prefix renamed accordingly; src/lib/utils/translations.ts LAYOUT_NAMESPACES["ai-agents"] points at template-ai-agents. Types: src/lib/interfaces.ts takes dev's TopicFrontmatter shape (with hideEditBanner); AiAgentsFrontmatter and StakingFrontmatter removed. src/lib/types.ts Frontmatter union drops the removed types. Compile pipeline: src/lib/md/compile.ts taken as-is from dev (sizeOf for image dimensions, async extractLayoutFromMarkdown). src/lib/md/data.ts updated to await extractLayoutFromMarkdown. Content: public/content/ai-agents/index.md uses template: ai-agents and summaryPoints array. All nine ai-agents sub-pages converted from summaryPoint1/2/3 keys to summaryPoints array so the new TopicLayout hero renders the description list. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>

- Updates non-English versions as well given no manifest established yet -- string value to be re-translated via intl-pipeline

- Converts html to markdown where it suffices, removing custom className alignment - Removes `variant="info"` from ui/alert ("info" variant used by default)

konopkja · 2026-05-21T15:12:29Z

some tooltips are broken this is on https://deploy-preview-17994--ethereumorg.netlify.app/ai-agents

konopkja · 2026-05-21T15:13:23Z

some tooltips are broken this is on https://deploy-preview-17994--ethereumorg.netlify.app/ai-agents

same here on main https://deploy-preview-17994--ethereumorg.netlify.app/ai-agents/getting-started/

- Remove custom margin overrides within markdown usage of `Alert` component - Apply minimal 2rem top and bottom margins broadly to the `Alert` component for all markdown usage via `MdComponents/index.tsx` (additional margins from components above or below will automatically collapse and not add together)

Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>

- Updates [svg] to [svg:not(.lucide-external-link)] for SVG coloring in alert variants - Avoids re-coloring the external link arrow within Alert component Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>

Handled automatically via layout using `title` front matter Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>

Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>

- Removes redundant `const Pre` declaration in `Static` layout Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>

Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>

mnelsonBT added 10 commits April 16, 2026 17:11

add initial AI agents framework

85463a6

Merge branch 'dev' of https://github.com/ethereum/ethereum-org-website …

e55047e

…into ai-content-updates

decentralized AI use case page content

e50989f

finishing dAI page and catching up nav

67956ca

updating use case and build navs

59a5e49

writing ai agent landing

87f450b

updating builder sections to subheaders

37a9187

writing ai agent why ethereum page

9b3b649

updating per ethskills and adding get started page

a36f234

Remove incomplete pages from PR

9344a6d

mnelsonBT added 8 commits April 20, 2026 10:39

pushing up getting started builder page

dafe9e0

adding getting started page

bb3e6ad

removing outdated reference

60b70ba

adding wallet page

c828381

why ethereum copyedits

ae99dee

framework edit

c31b9d3

updating further reading for why ethereum

7536985

adding frameworks page

6d2f519

konopkja reviewed Apr 23, 2026

View reviewed changes

mnelsonBT and others added 8 commits April 23, 2026 09:22

adding use case page

de1dc0b

updating framework further reading

e9f8bc7

adding identity page

69db8ed

updating resource lists

2838a35

Update public/content/ai-agents/index.md

5bf5e6a

Co-authored-by: Jakub <100724231+konopkja@users.noreply.github.com>

Update public/content/ai-agents/index.md

73f3069

Co-authored-by: Jakub <100724231+konopkja@users.noreply.github.com>

Apply suggestions from code review

598a715

Jakub edits to content/decentralized-ai/index and content/ai-agents/ethereum/index Co-authored-by: Jakub <100724231+konopkja@users.noreply.github.com>

Merge branch 'dev' of https://github.com/ethereum/ethereum-org-website …

927a051

…into ai-content-updates # Conflicts: # src/intl/en/template-usecase.json

mnelsonBT force-pushed the ai-content-updates branch from b12b63c to 927a051 Compare April 23, 2026 19:59

mnelsonBT and others added 7 commits May 4, 2026 14:50

Update src/layouts/md/AiAgents.tsx

0bb4a1d

Co-authored-by: Jakub <100724231+konopkja@users.noreply.github.com>

Update src/layouts/md/AiAgents.tsx

3395015

Co-authored-by: Jakub <100724231+konopkja@users.noreply.github.com>

Apply suggestions from Jakub code review

0caa70e

Co-authored-by: Jakub <100724231+konopkja@users.noreply.github.com>

Merge branch 'dev' of https://github.com/ethereum/ethereum-org-website …

c5fb859

…into ai-content-updates # Conflicts: # src/intl/en/common.json # src/lib/nav/buildNavigation.ts

applying Jakub edits to additional pages

8ca66ed

updating nav post dev merge

9903509

removing FAQ schemas

ef8432f

mnelsonBT marked this pull request as ready for review May 5, 2026 13:46

mnelsonBT requested review from minimalsm, pettinarip and wackerow as code owners May 5, 2026 13:46

phipsae reviewed May 13, 2026

View reviewed changes

myelinated-wackerow mentioned this pull request May 15, 2026

feat(layouts): consolidate topic page layouts #18198

Merged

7 tasks

mnelsonBT marked this pull request as draft May 15, 2026 12:00

myelinated-wackerow and others added 6 commits May 20, 2026 05:15

Merge branch 'dev' into codeblock-restyle

dae64ab

Merge branch 'codeblock-shiki' into ai-content-updates

c748411

fix(i18n): decentralized-ai dropdown key

7645e45

- Updates non-English versions as well given no manifest established yet -- string value to be re-translated via intl-pipeline

chore: remove redundant "AI agents:" prefix

67af889

refactor: use markdown syntax, rm default variant

f95f8da

- Converts html to markdown where it suffices, removing custom className alignment - Removes `variant="info"` from ui/alert ("info" variant used by default)

myelinated-wackerow and others added 8 commits May 23, 2026 02:46

Merge branch 'dev' into ai-content-updates

65c6321

refactor: ui/alert sub-component usage

bbed1ed

Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>

fix(ui): external link color styling

a3cf664

- Updates [svg] to [svg:not(.lucide-external-link)] for SVG coloring in alert variants - Avoids re-coloring the external link arrow within Alert component Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>

fix: remove repeated h1

ac339d7

Handled automatically via layout using `title` front matter Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>

chore: prettify content

44148e2

Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>

refactor: use default Pre from MdComponents

0765a59

- Removes redundant `const Pre` declaration in `Static` layout Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>

chore: add todo clean-up task pending PR #18210

cf0820b

Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>

Conversation

mnelsonBT commented Apr 19, 2026 • edited by wackerow Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Builder pages added

Layout and components

Navigation changes:

Deviations from original Issue scope:

Related Issue

Uh oh!

netlify Bot commented Apr 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for ethereumorg ready!

Uh oh!

konopkja left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

konopkja left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

phipsae left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

konopkja commented May 21, 2026

Uh oh!

konopkja commented May 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

mnelsonBT commented Apr 19, 2026 •

edited by wackerow

Loading

netlify Bot commented Apr 19, 2026 •

edited

Loading

konopkja left a comment •

edited

Loading