How Agent Cards Work: Structured Product Data for AI Engines
Learn how Agent Cards structure your product data for AI engines like ChatGPT and Perplexity. Boost your GEO visibility with AI-ready product cards.
When you search for a product on ChatGPT, Perplexity, or Google AI Overviews, where do those results come from? How does an AI engine know your product exists, what it costs, whether it's in stock, or what your customers think of it?
The answer lies in Agent Cards. They are not a new file format or another product feed standard. Agent Cards are structured, AI-optimized product data objects that speak the language of large language models. They solve a fundamental problem in modern e-commerce: traditional product feeds are built for search engines from the 2000s, not for conversational AI.
This article explains what Agent Cards are, how they differ from legacy data formats, how AI engines consume them, and most importantly, how to implement them to boost your Generative Engine Optimization visibility.
What Are Agent Cards?
An Agent Card is a semantically rich product data object designed specifically for consumption by large language models and AI commerce systems. Unlike a Google Shopping feed, which optimizes for keyword matching, or a standard product page, which optimizes for human readers, an Agent Card optimizes for AI comprehension, intent matching, and conversational context.
Think of it this way: A product page tells a story to humans. A Google Shopping feed provides structured fields to a database. An Agent Card provides dense semantic meaning to an AI model so that the model understands not just what the product is, but why it might be a good match for a specific customer query.
Agent Cards include product attributes, pricing, inventory, reviews and ratings, brand guidelines, visual descriptions, and purchase metadata. They are designed to be atomically consumable by AI systems. Meaning a single Agent Card contains everything an LLM needs to recommend or describe a product without pulling additional data from external sources.
Why AI Engines Need Structured Product Data
LLMs like ChatGPT and Gemini are trained on vast amounts of text, but they are not trained on your proprietary product data. If your product catalog exists only as HTML pages indexed by general search engines, an LLM may have seen a cached or outdated version of your site, or it may not have any structured product information about you at all.
Worse still, without structured data, an LLM might hallucinate product details. It might invent pricing, make up specifications, or imagine reviews that do not exist. The Semantic Firewall enforces zero hallucinations by design, but only when given accurate, complete structured product data to work with.
Agent Cards solve this problem by making your product data:
- Authoritative - The data comes directly from your commerce system, not from cached web crawls or third-party sources.
- Complete - Every relevant attribute is present, so the AI engine has no reason to fill gaps with guesses.
- Fresh - Real-time inventory, pricing, and review data can be pushed as it changes.
- Intent-matched - Agent Cards can be tagged with use cases, customer segments, and query contexts so the AI engine understands when to surface them.
- Brand-consistent - Guidelines for tone, imagery, and messaging are embedded, so recommendations sound like your brand.
Technical Architecture: What Goes Into an Agent Card
An Agent Card is a JSON object (or equivalent structured format) that contains the following categories of data:
Core Identity
- Product ID and SKU
- Product name and title
- Slug or canonical URL
- Brand name
- Category and subcategory tags
Descriptive Content
- Short description (one-liner)
- Long description (detailed features, use cases, benefits)
- Key attributes (color, size, material, etc.)
- Visual descriptions for accessibility and AI context
- Brand voice guidelines and recommended tone
Commerce Data
- List price and sale price
- Currency
- Discount percentage or amount
- Stock status (in stock, limited, out of stock, pre-order)
- SKU variants (if applicable, such as size or color options)
- Shipping information
- Return policy summary
Trust Signals
- Overall rating (1-5 stars)
- Review count
- Top review excerpts (to support recommendations with social proof)
- Return rate (if available)
- Bestseller badge or popularity ranking
- Primary product image URL and alt text
- Additional images or 360-degree view metadata
- Video URL (if available)
Intent & Context
- Use case tags (e.g., "gift", "professional", "budget-friendly")
- Audience tags (e.g., "beginners", "outdoor enthusiasts")
- Compatibility notes (e.g., iOS version, shoe size range)
- Related or complementary products
- Membership or loyalty applicable
- Gift wrap available
- Subscription option available
- Warranty or guarantee details
This data structure ensures that when an AI engine recommends your product in a conversation, it has everything needed to contextualize the recommendation, answer follow-up questions, and facilitate a purchase.
Let's compare Agent Cards to three existing product data formats:
Google Shopping feeds are tab-separated or XML files optimized for the Google Shopping network. They focus on title, description, image, price, and category. They work well for Google's keyword-based shopping search, but they lack semantic richness. A Google Shopping feed tells the system "this is a blue widget for $29.99," but it does not tell the system why a customer looking for durability or sustainability should care about it. Agent Cards include intent, context, and AI-native metadata.
Agent Cards vs. Schema.org Markup
Schema.org markup (such as Product schema) is HTML embedded code that helps search engines understand page content. It is a step forward from raw HTML, but it still assumes a web crawler will read and parse it, and it often contains only a subset of product information. Agent Cards are complete, standalone data objects designed for API consumption, not HTML parsing. They can be updated in real time, and they support the full semantic context that AI engines need.
Agent Cards vs. Traditional Product Pages
A product page is optimized for human readers. It includes marketing copy, lifestyle images, customer testimonials, and navigation elements that are irrelevant to an AI engine. While product pages are important for brand building and conversion, they are not structured for automated, intent-based parsing. An AI engine consuming a product page must work harder to extract relevant facts and context. Agent Cards eliminate this friction.
It is worth noting that Agent Cards do not operate in isolation. They serve as the semantic context layer within a broader orchestration stack. Google's Universal Commerce Protocol (UCP) defines how AI agents discover and interact with merchants at the protocol level, handling product queries, availability checks, and transaction initiation. The Agentic Commerce Protocol (ACP), co-developed by Stripe and OpenAI, completes the stack by serving as both the primary distribution format optimized for LLM assistants and the secure checkout handover protocol. Agent Cards provide the rich, intent-matched data that flows through UCP and ACP, making your products not just discoverable but genuinely understood by AI agents, and purchasable in a single conversation. For a deeper look at how these protocols work together, see Google's UCP and the future of AI-agent commerce.
On-site, the Demand Gateway delivers Agent Cards to your Agentic Client Advisor in real time for conversational selling. Off-site, the Distribution Gateway converts those same Agent Cards into ACP, JSON-LD, Google Shopping XML, Klarna APP, and Mirakl Nexus feeds, making your catalog discoverable across every major AI ecosystem. Both gateways read from the same source of truth: the Mirror Catalog within Querytail OS, a parallel, AI-optimized copy of your product data that is continuously enriched without ever altering your original catalog. This ensures consistency between what external AI engines recommend and what your on-site advisor sells.
How AI Engines Consume Agent Cards
When you enable Agent Cards in your Querytail dashboard, Querytail's Distribution Gateway automatically converts your Agent Cards into multiple standardized formats, including ACP (optimized for LLM assistants), JSON-LD, Google Shopping XML, Klarna APP, and Mirakl Nexus, and publishes them as hosted certified feeds. The merchant configures nothing: a single "Push to AIs" action makes your entire catalog agent-ready across every ecosystem. Here is what happens next:
Discovery - ChatGPT, Perplexity, Google AI Overviews, or Gemini consume your Agent Card feeds from Querytail's Distribution Gateway. They do this periodically to refresh their knowledge of available products.
Semantic Indexing - The AI engine ingests your Agent Cards and semantically indexes them. This is not keyword indexing like a search engine. It is embedding the semantic meaning of your product description, use cases, and attributes into the model's context so it understands how your product relates to various customer intents.
Intent Matching - When a user asks a question in the AI engine, the engine evaluates that question against indexed Agent Cards. It uses semantic similarity to match products that solve the stated problem, not just products that contain certain keywords.
Contextual Ranking - The AI engine ranks matched products based on relevance, rating, availability, and brand fit. A higher-rated product with more reviews will often rank higher, just as on a traditional marketplace.
Response Generation - The AI engine generates a natural language response that incorporates your product data. It cites pricing, availability, reviews, and features. Because the data came from an Agent Card, there are no hallucinations. Every detail the AI mentions has been verified against your source of truth.
Purchase Intent - When the customer is ready to buy, the AI engine surfaces a high-intent link from the Agent Card that directs the customer back to your storefront. Once on-site, your Agentic Client Advisor picks up the conversation and completes the purchase through In-Chat Checkout, where you control the entire experience.
This entire flow depends on Agent Cards being present, accurate, and real-time. Without them, the AI engine either has no knowledge of your product, or it relies on cached web data that may be incomplete or outdated.
Creating Agent Cards with Querytail
Querytail provides a straightforward path to Agent Card creation. Here is how it works:
1. Data Mapping
You map your existing product database fields to Agent Card fields. If you have product data in Shopify, WooCommerce, or a custom system, Querytail connects to your source and automatically populates Agent Card fields. You do not need to reformat or re-enter data.
2. Enrichment
Querytail uses AI to enrich Agent Cards with missing data. If your product database lacks a detailed description or visual description, Querytail can generate one based on existing fields, images, and category data. You review and approve before publication.
3. Brand Guidelines Integration
You upload your brand guidelines, tone of voice, and visual style. Querytail embeds these into your Agent Cards so every recommendation that includes your product will sound like your brand.
4. Testing & Preview
Before publishing Agent Cards to LLM distribution partners, you can preview how your products will appear in AI conversations. Querytail shows you exactly what an AI engine will see and how it will present your product.
5. Publishing & Distribution
Once approved, Querytail publishes your Agent Cards to ChatGPT, Perplexity, Google AI Overviews, and Gemini (depending on your distribution settings). Updates to inventory, pricing, or reviews are reflected in real time.
6. Optimization
Querytail provides analytics on how often your products are recommended, clicked, and purchased through AI channels. You can iterate on Agent Card content based on this feedback.
Agent Cards and Generative Engine Optimization
Generative Engine Optimization, or GEO, is the practice of optimizing your content and product data for discovery through AI search and conversational interfaces. Agent Cards are a foundational element of GEO.
Here is why:
Visibility - If your product data is not structured for AI engines, you are invisible to ChatGPT users, Perplexity users, and Google AI Overview users. These audiences are growing rapidly, especially in younger demographics. This is what we call the "Invisibility Gap": as consumers shift from traditional search to AI-powered platforms, brands without AI-optimized data disappear from the conversation entirely. Agent Cards close that gap and make you visible.
Intent Matching - A traditional search engine cares about keywords. An AI engine cares about intent. If you optimize your product descriptions in an Agent Card for intent ("perfect for someone who prioritizes sustainability") rather than just keywords, the AI engine is more likely to recommend you to users with that intent, even if they do not use the exact keyword.
Trust Signals - AI engines weight review counts, ratings, and bestseller status heavily. By including comprehensive review data in your Agent Cards, you amplify these trust signals directly in the AI engine's recommendation process.
Context Preservation - In a conversational interface, context is everything. If a customer asks "what would be good for my 10-year-old child who loves science?", the AI engine needs to understand not just that a product exists, but what audience and use case it serves. Agent Cards include audience and use case tags, so your product is recommended in the right context.
Real-Time Freshness - Stock and pricing data in Agent Cards can be updated in real time. If you are running a flash sale, your Agent Card reflects that immediately. An AI engine might recommend your product to a customer searching for a deal because the updated Agent Card shows a discount.
Real-World Example: Fashion Brand with Agent Cards
Let's walk through a concrete example. Suppose you operate a sustainable fashion brand that sells organic cotton T-shirts.
Without Agent Cards
A user on ChatGPT searches: "I want an ethical, affordable T-shirt made from natural materials. What do you recommend?"
ChatGPT has no indexed Agent Cards for your brand. It might suggest generic brands with better SEO footprints or brands it has cached data about. If it does mention a similar sustainable brand, it might have outdated pricing or incomplete product information. The customer does not discover your product because the AI engine simply does not have sufficient structured knowledge of it.
With Agent Cards
The same user asks the same question. ChatGPT queries Querytail's Agent Card feed and finds your product:
- Product title and short description: Organic Cotton Essentials T-Shirt
- Use case tags: "sustainable," "affordable," "everyday basics," "eco-conscious"
- Audience tags: "environmentally aware," "budget-conscious," "minimalists"
- Detailed description: References fair-trade certification, organic cotton sourcing, carbon-neutral shipping, and lifetime durability.
- Pricing: $34.99 (compared to competitor average of $48).
- Reviews: 4.7 stars from 1,200 reviews. Top review: "Perfect quality at a fair price. Wore mine twice a week for 2 years without fading."
- Brand voice: Your tone comes through as authentic, values-driven, and unpretentious.
ChatGPT includes your product in its recommendation, with a natural language response that incorporates your Agent Card data: "The Organic Cotton Essentials T-Shirt from [Brand] is a top choice. It is certified fair-trade, made from 100% organic cotton, and priced at $34.99. With a 4.7-star rating from over 1,200 reviews, customers consistently praise the durability and quality. One customer noted they have worn theirs twice a week for two years without fading."
The customer clicks through to view your product and makes a purchase. Your Agent Card made you discoverable, and your structured data made you trustworthy.
FAQ: Agent Cards and GEO
What if I do not have all the product data an Agent Card requires?
Querytail can enrich Agent Cards with missing data. If you lack detailed descriptions, images, or review metadata, Querytail uses AI and third-party data to fill gaps. You review all enriched data before publication, ensuring accuracy.
Do I need to manually create Agent Cards, or is it automated?
It is almost entirely automated. Querytail connects to your product database, maps fields automatically, and generates Agent Cards. You configure brand guidelines and review output. No manual data entry is required for most brands.
No. Agent Cards are separate from your website and search engine optimization. They do not cannibalize organic search. They open a new distribution channel. Many brands see organic search performance improve because Agent Card visibility increases brand recognition and traffic.
How often are Agent Cards updated?
Agent Cards can be updated in real time. Inventory, pricing, and review data are refreshed as you update them in your source system. Descriptive content updates are reflected within hours.
All data in Agent Cards comes from your source system, and the Semantic Firewall enforces accuracy. If an AI engine makes an error in how it interprets or presents your data, the error is in the LLM's reasoning, not in your Agent Card. Querytail provides tools to flag and correct such issues.
Can I have different Agent Cards for different AI engines?
Yes. You can customize Agent Cards for specific distribution channels. For example, you might include additional safety information for Gemini in some verticals, or region-specific content for different markets.
How do I measure the impact of Agent Cards on my business?
Querytail provides detailed analytics on Agent Card performance. You can see how often your products are recommended, which AI engines drive the most traffic, click-through rates, and conversion rates. You can also tie performance back to specific Agent Card attributes or content variants.
Do AI engines charge me to be included in their results?
No. Inclusion in AI search results is free. Querytail does not pay AI engines for distribution, and you do not pay per click or impression. You may pay Querytail for the Agent Card platform itself, but distribution is included.
What happens if an AI engine stops operating or changes its model?
Your Agent Cards are your data. They remain in your Querytail account and can be deployed to any distribution partner. As new AI commerce channels emerge, you can enable them with your existing Agent Cards.
How do Agent Cards support multi-language and multi-region commerce?
Agent Cards can include localized descriptions, pricing, and availability for different regions and languages. For example, you can create a single product with an English Agent Card optimized for US customers and a French Agent Card optimized for Canadian customers, with region-specific pricing and inventory.
Getting Started with Agent Cards
If you are a Querytail customer, Agent Cards are available today. If you are not yet a customer, you can request a demo to see Agent Cards in action and understand how they fit into your commerce strategy.
The shift from traditional product feeds to Agent Cards reflects a fundamental change in how customers discover products. The AI Commerce Layer is not a replacement for your website, your search engine optimization, or your paid advertising. It is a new channel, with its own rules and best practices. Agent Cards are how you master that channel.
Your competitors are already thinking about their presence in AI search. The products and brands that invest in structured, AI-optimized data today will capture an outsized share of traffic and revenue as conversational commerce grows.
For a step-by-step guide on preparing your catalog, read Preparing your product catalog for AI distribution.
AI Commerce Technology Series.
This article is part of Querytail's AI Commerce Technology series. Explore the full series:
- The Semantic Firewall: how zero-hallucination AI works
- In-Chat Checkout: from prompt to payment
- Merchant of Record in conversational commerce
- How Agent Cards work (you are here)
Querytail is the AI Commerce Layer for e-commerce brands, from on-site Agentic Client Advisors to LLM distribution across ChatGPT, Gemini, and Perplexity. Request a demo.
You can also contact our team with any questions, or if you are a brand looking for early access, apply for the Design Partner program.