# Solidus

## Prerequisites

* A Solidus store with admin access
* A Solidus API key

## Getting Your API Key

1. Log in to your Solidus admin panel
2. Navigate to your API settings
3. Generate or copy your API key

## Setup

### Step 1: Enable Solidus in Alhena

1. In Alhena, go to **Settings > Integrations**
2. Find **Solidus** and click **Enable**
3. You'll be taken to the Solidus configuration page

### Step 2: Connect Your Store

1. **Store URL** - Your Solidus store URL (e.g., `https://mystore.com`)
2. **API Key** - Your Solidus API key

Click **Connect** to complete the setup.

***

## Enabled Agents

When you connect your Solidus store, the following agents are enabled:

| Agent                      | Description                                                                |
| -------------------------- | -------------------------------------------------------------------------- |
| **Order management agent** | Handles order inquiries, tracking, and order-related customer support      |
| **Product expert agent**   | Provides detailed product information, specifications, and recommendations |

You can configure these agents in **AI Settings > Agents**.

***

## Recommended: Add Your Store to Training

After connecting, we recommend adding your Solidus store's domain to your training URLs so Alhena can learn from your product pages and help articles. See [Training on Websites](/docs/ai-configuration/data-sources/websites.md) for more information.

***

## Disconnecting

To disconnect your Solidus store:

1. Go to **Settings > Integrations > Solidus**
2. Click **Disconnect**
3. Confirm the disconnection

This will disable the Solidus-connected agents and revoke access to your store data.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://alhena.gitbook.io/docs/integrations/ecommerce/integrating-alhena-ai-with-solidus.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.