> ## 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 Guide

Optimize your BigCommerce and Shopify product catalogs for AI-driven commerce.

## Welcome to Agent Ready

Agent Ready is an AI-powered product catalog optimization tool for the modern merchant. It helps you ensure your products are ready for AI-driven commerce by analyzing, scoring, and improving your entire catalog.

<CardGroup cols={2}>
  <Card title="Analyzes every product" icon="magnifying-glass">
    Uses GPT-4o to evaluate titles, descriptions, tags, categorization, images, and variants.
  </Card>

  <Card title="Scores AI readiness" icon="chart-simple">
    Assigns each product a score on a 0–100 scale to track catalog health at a glance.
  </Card>

  <Card title="Auto-fixes issues" icon="wand-magic-sparkles">
    Generates improved AI content and writes it back to your store with a full change history.
  </Card>

  <Card title="Generates product feeds" icon="rss">
    Produces feeds in JSON, Google/Bing XML, and LLMs.txt formats enriched with AI data.
  </Card>
</CardGroup>

## Getting Started

Getting up and running with Agent Ready takes just a few minutes. Once installed, the app automatically syncs your product catalog and is ready to analyze.

### Step-by-step walkthrough

<Steps>
  <Step title="Install the app">
    Your product catalog is automatically synced from BigCommerce or Shopify during the installation process.
  </Step>

  <Step title="Visit the Dashboard">
    See your overall score overview, top recommendations, and **Recent Activity** at a glance.
  </Step>

  <Step title="Analyze All Products">
    Click the **Analyze All** button to run AI analysis on every product. Each product takes 15–30 seconds.
  </Step>

  <Step title="Review Scores">
    Products are color-coded: **Green** for Ready, **Yellow** for Needs Work, and **Red** for Not Ready.
  </Step>

  <Step title="Fix Issues">
    Use individual fix buttons for specific fields, the **Fix All Issues** button for a full overhaul, or **Bulk Fix** for multiple products.
  </Step>
</Steps>

<Note>
  **Automatic Sync:** Products are automatically re-analyzed when updated in your store admin via webhooks. You can also trigger manual re-analysis from the dashboard or individual product pages.
</Note>

***

## Understanding AI Readiness Scores

Every product receives an overall AI readiness score from **0 to 100** based on core optimization categories.

### The Scoring Categories

| Category           | Evaluation Criteria                                                             |
| :----------------- | :------------------------------------------------------------------------------ |
| **Title**          | Is it descriptive, keyword-rich, and optimized for search and AI comprehension? |
| **Description**    | Quality, length, and detail regarding features and benefits.                    |
| **Tags**           | Checks for relevant, specific tags that aid discoverability and categorization. |
| **Categorization** | Accuracy of product types and assigned storefront categories.                   |
| **Images**         | High-quality image count to improve AI and customer confidence.                 |
| **Metadata**       | Presence of structured data required for rich search results and AI feeds.      |
| **Variants**       | Completeness of variant titles, SKUs, and inventory details.                    |

### Status Meanings

| Status         | Score  | Color  | Meaning                                                 |
| :------------- | :----- | :----- | :------------------------------------------------------ |
| **Ready**      | 80–100 | Green  | Well-optimized for AI commerce.                         |
| **Needs Work** | 50–79  | Yellow | Minor issues identified.                                |
| **Not Ready**  | 0–49   | Red    | Needs significant improvement.                          |
| **Pending**    | N/A    | Gray   | Analysis has not yet completed for this product.        |
| **Error**      | N/A    | Orange | Temporary API issue; the product should be re-analyzed. |

***

## Fixing Issues & Tone

You can improve your content and write it directly back to your storefront with one click.

### Bulk Fix & Safety

Bulk Fix allows you to fix multiple products at once. You can filter by **Score threshold** or **Category selection**.

<Warning>
  **Safety First:** Fixes are written directly to your live store. Every change is recorded in **Change History** indefinitely. You can revert individual changes or use **"Revert All Changes Since..."** on the dashboard to bulk-undo updates from a specific date.
</Warning>

### AI Writing Tone

Set your brand voice in the dashboard settings to control how the AI writes:

* **Professional**: Clear and polished language.
* **Luxury**: Elegant and refined.
* **Playful**: Fun, energetic, and full of personality.
* **Casual**: Relaxed and approachable.
* **Technical/Minimal/Friendly**: Specification-focused or warm and welcoming.

***

## Product Feeds

We generate three specialized feeds enriched with AI-detected attributes (color, material, audience) and readiness scores.

<Tabs>
  <Tab title="JSON Feed">
    Ideal for custom integrations. Includes individual category scores and recommendations.
  </Tab>

  <Tab title="Google/Bing XML">
    RSS 2.0 compatible. Agent Ready **automatically pings** search engine endpoints whenever your feed is updated to ensure listings stay current.
  </Tab>

  <Tab title="LLMs.txt">
    An emerging standard designed for AI agents (ChatGPT, Perplexity). It provides structured data that AI models can parse instantly to answer complex shopper queries.
  </Tab>
</Tabs>

***

## Agent Ready FAQ

<AccordionGroup>
  <Accordion title="Does Agent Ready slow down my storefront?">
    No. All analysis happens on our serverless edge infrastructure. Writing to product fields via the API has zero impact on your storefront loading speed.
  </Accordion>

  <Accordion title="Does OpenAI use my data to train their models?">
    No. We use the OpenAI API with enterprise privacy settings. Data sent via the API is not used to train their global models.
  </Accordion>

  <Accordion title="How is billing handled?">
    All billing is handled securely through your respective platform (Shopify Admin or BigCommerce Billing).
  </Accordion>

  <Accordion title="Can I use Agent Ready with multiple stores?">
    Yes! Each store that installs Agent Ready gets its own isolated data, separate feed URLs, and independent results.
  </Accordion>
</AccordionGroup>

<br />

<div style={{ display: 'flex', flexDirection: 'column', gap: '12px' }}>
  <a href="https://apps.shopify.com/partners/amethyst-apps" class="btn-amethyst-install" style={{ width: 'fit-content' }}>
    Get Agent Ready Now →
  </a>
</div>

***

<Card title="Still need help?" icon="envelope" href="/guides/support">
  If you can't find what you're looking for, click here to contact our support team directly at [support@amethystapps.com](mailto:support@amethystapps.com).
</Card>