Edits

Author: idalithb

website/src/pages/en/ai-suite/_meta-titles.json

@@ -1,5 +1,4 @@
 {
   "graph-assistant": "Graph Assistant",
-  "quick-starts": "Quick Starts",
   "ai-introduction": "The Graph's AI"
 }

website/src/pages/en/ai-suite/_meta.js

@@ -1,7 +1,6 @@
 import titles from './_meta-titles.json'
 
 export default {
-  'quick-starts': titles['quick-starts'],
   'ai-introduction': titles['ai-introduction'],
   'graph-assistant': titles['graph-assistant'],
 }

website/src/pages/en/ai-suite/ai-introduction.mdx

@@ -2,52 +2,45 @@
 title: The Graph's AI
 ---
 
-Build with speed and scale faster with The Graph's AI Suite.
+Build with speed and scale faster with The Graph's AI.
 
-## What is AI on The Graph?
+## Using AI on The Graph?
 
-AI on The Graph connects large language models (LLMs) like Claude to onchain data indexed by The Graph. This allows developers to build AI systems that query blockchain data directly using natural language. This eliminates the need to write code or manage infrastructure.
+[Graph Assistant](/ai-suite/graph-assistant/introduction/) is a powerful **agentic** application that empowers users to easily interact with blockchain data. Ask questions in simple, natural language and get rich, AI powered insights. Both technical developers and non-technical product teams can move faster, make smarter decisions, and gain a clearer understanding than ever before.
 
-Instead of relying on static datasets or centralized APIs, you can now access live, verifiable blockchain data using [Graph Assistant](/ai-suite/graph-assistant/introduction/), [Subgraph MCP](), [Token API MCP]().
-
-Fetch fast access to accurate, real-time onchain data.
+Instead of relying on static datasets or centralized APIs, you can now access live, verifiable blockchain data using [Graph Assistant](/ai-suite/graph-assistant/introduction/), Subgraph MCP, and Token API MCP.
 
 ## Why Use Onchain Data with AI?
 
-If you're building with AI in web3, onchain data is necessary. Wallets, tokens, governance, and transactions all live onchain, but are often very difficult to access at scale without an indexing or custom solution.
+Using onchain data with AI unlocks powerful new ways to interact with and understand blockchain ecosystems.
 
-The Graph solves this by making onchain data available through [Subgraphs]() and [TokenAPI]() via [Graph Assistant]().
+- **AI as an interface**: Developers can use AI to interact directly with The Graph's data through their agents or build AI-powered applications on top of it. This streamlines development and opens up more intuitive, dynamic use cases.
+- **AI as a product**: For non-technical users, AI can turn complex onchain data into accessible insights. Assistants powered by AI enable anyone to explore, analyze, or act on blockchain data, without requiring any coding.
 
-### Benefits
+### Benefits of Using Graph Assistant
 
-- Easy access to data in real-time
-- Save time and scale faster
-- Fast access to indexed blockchain data
-- Verifable answers tied to onchain activity
-- Context-aware agents that interact with live data
+- **Natural language Input**: You don't need to write complex queries or sift through dashboards. Simply ask your question in plain English and get clear, accurate results.
+- **Multi-source support**: Works across multiple Subgraphs and The Graph's APIs. The assistant automatically determines which data source to use, so you don't have to switch tools or manage endpoints.
+- **Schema-free access**: You don't need to understand the schema. You can refer to tokens, protocols, dates, or addresses using natural language. The assistant takes care of the rest.
 
 There's no need to maintain backend infrastructure or manually pull and clean blockchain data.
 
 ## Conversational Querying with Graph Assistant
 
-Graph Assistant allows Claude to understand and query The Graph using plain language. You describe what you want, and the assistant translates it into the correct query against a Subgraph or Token API endpoint.
-
 **Example queries:**
 
-- "List top holders of this token by balance."
-- "Show GRT transfers to this address in the past 7 days."
-- "Get proposals this wallet voted on in May."
+- "Give me the daily volume on Uniswap."
+- "List the top-5 swaps by USD value in the last 24 hours."
+- "List the 20 most recently registered .eth names."
+- "Whats the best liqudity pool to put my ETH into?"
+- "Total delegated stake in The Graph network?"
 
-[Graph Assistant](/ai-suite/graph-assistant/introduction/) uses the Model-Comprehensible Protocol (MCP) to understand data schemas, identify relevant fields, and return structured results.
+Graph Assistant will eventually be a one-stop shop for interacting with The Graph. Right now, it's an agentic AI app that uses state-of-the-art AI techniques, LLMs, and MCPs to understand and answer your questions about Subgraph and Token API data.
 
-You don't need to write GraphQL or study Subgraph schemas manually.
+## Why This Matters?
 
-## Why This Matters for Developers
-
-If you need fast access to token data, user behavior, governance activity, or protocol metrics, this stack gives you a direct path. You save time, avoid technical overhead, and can ship faster.
+Graph Assistant is a powerful agentic application that lets you interact with blockchain data using natural language through a simple chat interface. Unlike a basic chatbot, Graph Assistant can understand your intent, build complex queries, and execute them automatically. This gives you rich, AI-powered insights from onchain data without writing any code.
 
 - No custom backend
 - No manual querying
 - No deep GraphQL knowledge required
-
-You get verifiable blockchain data, ready for use in AI applications, chat interfaces, analytics dashboards, and automation workflows.

website/src/pages/en/ai-suite/graph-assistant/_meta.js

@@ -2,5 +2,5 @@ export default {
   'quick-start': '',
   introduction: '',
   'how-to-guide': '',
-  'faq-graph-assistant': '',
+  faq: '',
 }

website/src/pages/en/ai-suite/graph-assistant/faq-graph-assistant.mdx

@@ -0,0 +1,26 @@
+---
+title: Graph Assistant FAQ
+sidebarTitle: 'FAQ'
+---
+
+This page summarizes some of the most common questions for developers using Graph Assistant.
+
+1. What is The Graph Assistant?
+
+The Graph Assistant is an AI-powered chat interface that lets you query blockchain data in plain English. Under the hood, it translates your questions into GraphQL calls against subgraphs and the Token API, then returns results as a table—no coding required.
+
+2. What is an agentic application?
+
+An agentic application combines AI-driven reasoning with external data sources or APIs to take autonomous actions on your behalf. In this case, Graph Assistant acts as an “agent” that interprets your natural-language prompts, builds and dispatches GraphQL queries, and formats the results so that you don't need to write or manage queries yourself.
+
+3. Which networks and data does Graph Assistant support?
+
+The assistant has access to Subgraphs across 100+ chains. If a Subgraph is published to The Graph Network and is being indexed, the assistant can automatically route queries to it. The assistant also has access to the Token API on Ethereum Mainnet, BSC, Unichain, Arbitrum-One, Optimism, and Polygon.
+
+4. Is there a usage limit or quota?
+
+10 questions per hour.
+
+5. What if the assistant can't interpret my question?
+
+When the assistant fails to parse your intent (for example, ambiguous token name, missing context, or an unsupported request), it will prompt you for clarification. For instance, it might ask, “Did you mean XYZ on Ethereum or XYZ on Arbitrum?” or “Please specify a date range for this query.” If you continue to see parsing errors, check that you're using correct token symbols or specifying networks and time frames clearly.

website/src/pages/en/ai-suite/graph-assistant/faq.mdx

@@ -6,11 +6,10 @@ Graph Assistant gives instant, code-free access to blockchain data, transforming
 
 ## Overview
 
-### What is Graph Assistant?
+Graph Assistant is an advanced, [agentic](/en/ai-suite/graph-assistant/faq/) easy-to-use interface for querying blockchain data using natural language.
 
-It's an advanced, agentic easy to use interface for querying blockchain data using natural language. It automatically interprets user intent, generates precise queries, executes them via The Graph's Subgraphs and Token API, and presents structured, AI-powered answers without requiring any code.
-
-Unlike traditional dashboards or chatbots, Graph Assistant simplifies technical complexity and delivers composable insights directly from indexed subgraphs and token datasets.
+- **Automatically** interprets user intent, generates precise queries, executes them via The Graph's Subgraphs and Token API, and presents structured, AI-powered answers without requiring any code.
+- **Removes** the technical complexity found in traditional dashboards or chatbots. It provides composable insights directly from indexed Subgraphs and Token datasets.
 
 ## Core Features
 
@@ -21,4 +20,3 @@ Unlike traditional dashboards or chatbots, Graph Assistant simplifies technical
 | **Backed by Token API** | Uses Token API for token-level information like balances, transfers, and metadata. |
 | **No Setup Required** | No need to configure data sources or write queries. |
 | **Automatic Query Building** | The assistant performs complex queries such as fetching historical token volumes, protocol analytics, or cross-chain data and handles filtering, pagination, and joins across Subgraphs automatically. |
-| **Supports Complex Data Needs** | Handles multi-chain, historical, and analytical requests (e.g., volume over time, asset flows, usage metrics). |

website/src/pages/en/ai-suite/graph-assistant/introduction.mdx

@@ -37,4 +37,4 @@ The assistant will:
 
 - Digest your question
 - Fetch onchain data using Subgraphs or the Token API
-- Return a clean, formatted response in markdown with the data you need
+- Return a clean, formatted response with the data you need