> ## Documentation Index
> Fetch the complete documentation index at: https://amethystapps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Ready FAQ

Everything you need to know about Agent Ready and AEO Certification.

## Getting Started

<AccordionGroup>
  <Accordion title="What is Agent Ready?" icon="shield-check" iconType="solid" color="#39FF14">
    Agent Ready is a Shopify app that uses AI (GPT-4o) to analyze your product catalog and optimize it for discovery by **AI search engines**, shopping assistants, and platforms like Google Shopping.

    It scores each product on **AI readiness**, identifies structural data issues, and automatically fixes weak titles, missing descriptions, and incorrect categorization.
  </Accordion>

  <Accordion title="How do I get started?" icon="rocket" color="#39FF14">
    Click **Analyze All Products** on the dashboard. Agent Ready will use AI to analyze every product in your catalog. Each product takes about 15-30 seconds. Once complete, you’ll see readiness scores, recommendations, and can start fixing issues.
  </Accordion>

  <Accordion title="What does the AI Readiness Score mean?" icon="gauge-high" color="#39FF14">
    The score (0-100) measures how well-optimized a product is for discovery by AI agents and search engines. It evaluates: **title quality, description completeness, tag relevance, categorization accuracy, image quality, pricing clarity, and variant information.**
  </Accordion>

  <Accordion title="Is my product data sent to external services?" icon="shield-lock" color="#39FF14">
    Product data is sent to OpenAI's GPT-4o for analysis. **OpenAI does not use API data for training.** No product data is shared with any other third party, and all results are stored securely in your Gadget app database.
  </Accordion>
</AccordionGroup>

## Product Analysis & Fixing

<AccordionGroup>
  <Accordion title="What does the AI analyze for each product?" icon="magnifying-glass" color="#39FF14">
    The AI evaluates seven categories:

    * **Title:** Clarity, keywords, and length.
    * **Description:** Completeness, formatting, and detail.
    * **Tags:** Relevance, coverage, and specificity.
    * **Categorization:** Accuracy of product type.
    * **Images:** Quality indicators from product data.
    * **Pricing:** Clarity and completeness.
    * **Variants:** Size, color, and option information.
  </Accordion>

  <Accordion title="How does 'Fix' work and can I undo it?" icon="wand-magic-sparkles" color="#39FF14">
    When you click **Fix**, Agent Ready generates improved content and writes it directly to your Shopify store via the API.

    **Yes, you can undo it.** Every fix is tracked in **Change History**. You can revert individual changes from the product page or use **"Revert All Changes Since..."** on the dashboard for bulk restoration of all fixes made after a specific date.
  </Accordion>

  <Accordion title="How often are products re-analyzed?" icon="rotate" color="#39FF14">
    Products are automatically re-analyzed whenever they are updated in Shopify via **webhooks**. You can also manually trigger a full re-analysis from the dashboard at any time.
  </Accordion>

  <Accordion title="What is the AI Writing Tone setting?" icon="pen-nib" color="#39FF14">
    Choose a tone to ensure AI content matches your brand voice: Professional, Casual, Luxury, Playful, Minimal, Friendly, or Technical.

    * **Luxury Example:** *"Exquisitely crafted from the finest Italian leather..."*
    * **Casual Example:** *"This awesome leather bag goes with everything..."*
  </Accordion>
</AccordionGroup>

## Product Feeds

<AccordionGroup>
  <Accordion title="What product feeds are provided?" icon="rss" color="#39FF14">
    * **JSON Feed:** Structured data with AI attributes for custom integrations. Supports pagination via `cursor` and `pageSize` (max 250).
    * **Google/Bing XML Feed:** Standard RSS 2.0 format. Agent Ready **automatically pings** Google and Bing whenever your feed changes.
    * **LLMs.txt Feed:** Markdown format optimized for AI search engines like ChatGPT and Perplexity.
  </Accordion>

  <Accordion title="What is llms.txt and why do I need it?" icon="file-code" color="#39FF14">
    `llms.txt` helps AI answer complex queries like *"What's a good winter jacket under \$200?"*. It provides AI agents with readiness scores and AI-generated summaries in a format they can parse instantly, helping your products surface better in AI-powered shopping recommendations. It works as a companion to your robots.txt, providing a structured map that AI agents use to understand your store's context without the noise of HTML code.
  </Accordion>

  <Accordion title="Can I set different score thresholds for different feeds?" icon="sliders" color="#39FF14">
    Yes. The JSON and Google/Bing XML feeds have independent minimum score sliders. You can show only high-scoring products in Google Shopping while including your full catalog in other feeds.
  </Accordion>
</AccordionGroup>

## Plans & Billing

<AccordionGroup>
  <Accordion title="How much does Agent Ready cost?" icon="credit-card" color="#39FF14">
    * **Free (\$0/mo):** 10 analyses and 5 AI fixes.
    * **Pro (\$14.99/mo):** 500 analyses and unlimited fixes.
    * **Enterprise (\$29.99/mo):** Unlimited analyses and fixes.

    All charges are billed through your **Shopify invoice**. Counters reset every 30 days; unused credits do not roll over.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Why is a product showing 'Pending' or 'Error'?" icon="circle-exclamation" color="#39FF14">
    **Pending:** Queued for analysis (15-30s). If pending over 5 minutes, try re-analyzing manually.
    **Error:** Usually a temporary AI API timeout. Check the **Activity Log** for details and try re-analyzing.
  </Accordion>

  <Accordion title="Why is my readiness score lower than expected?" icon="chart-line-down" color="#39FF14">
    Common reasons include generic titles, missing descriptions, or lack of variant/pricing data. Check the product detail page for specific AI recommendations.
  </Accordion>
</AccordionGroup>