Products
What are Products?
Products are the catalog your AI agent draws from when helping visitors. Every product you define — with its name, description, attributes, and variants — becomes knowledge the agent can search, recommend, and display in conversation.
Think of it as building a structured product database that lives inside your agent. When a visitor asks "Do you have this in blue?" or "What material is the jacket made of?", the agent looks up the answer from your product catalog.
Products belong to an agent. Each agent has its own catalog, so you can run completely different product lines across different agents.
Create a Product
Navigate to Products in the left sidebar. Click New Product in the top-right corner.
You will be prompted to enter a name for the product. After confirming, the product is created and you land on its detail page where you can add everything else.
Name
The product name is what the AI agent uses when referring to this product in conversation. Keep it clear and descriptive — the same way you would name it in a shop or catalog.
Example: Merino Wool Crewneck or Running Shoe Pro 3.0
Description
The description gives the AI agent context about the product beyond the name. Write it from the perspective of a sales associate explaining the product to a customer — what it is, what it is for, and what makes it special.
Example: Lightweight merino wool crewneck, naturally temperature-regulating. Ideal for layering in autumn and winter. Machine washable at 30°C.
Handle
The handle is a URL-friendly identifier automatically generated from the product name. It is used internally to reference the product. You can change it manually if needed, but it must be unique within your agent.
Example: If the name is Running Shoe Pro 3.0, the handle might be running-shoe-pro-3-0.
Add Attributes
Attributes describe your product in a structured way. Think of them as key-value pairs that the AI agent can read and communicate: Price: 89.99, Material: Organic Cotton, Origin: Portugal.
Navigate to the product detail page and open the Attributes section. Click Add Attribute to add a new one.
Attribute Types
Each attribute has a type that controls what kind of value it holds:
| Type | Use for | |------|---------| | Text | Short labels, materials, categories, origins | | Number | Prices, weights, dimensions | | Image | Product photos linked to a data item | | Data | Any linked file or document from your Data library |
Attribute Fields
| Field | Description | |-------|-------------| | Type | The kind of value this attribute holds (see above) | | Usage | How the agent should use this attribute — informational, filterable, or display-only | | Value | The actual content of the attribute (text, number, or a reference to a data item) | | Image URL | For image attributes: the URL of the image to display | | Linked Data Item | For data or image attributes: a reference to a file in your Data library |
Attributes are flexible — a single product can have as many attributes as it needs. A simple product might have just Price and Material. A detailed technical product might have a dozen attributes covering dimensions, certifications, compatibility, and more.
Define Variant Types
Variant Types are templates that define which dimensions your products vary along. Examples: Color, Size, Fit, Material.
Variant Types are defined at the agent level, not per product. This means the same variant types apply across your entire product catalog for that agent.
Navigate to Products and open Variant Types (usually in a tab or section at the top of the Products area). Click New Variant Type to create one.
Variant Type Fields
| Field | Description |
|-------|-------------|
| Name | The dimension name, e.g. Color, Size, Width |
Once you define a variant type, it becomes available for all products in that agent. You then assign specific values to it when creating variants on individual products.
Example: Setting up Color and Size
If you sell clothing, you would typically create two variant types:
Color— values likeBlack,White,NavySize— values likeXS,S,M,L,XL
These type definitions live once at the agent level. Each product then picks the specific combinations it offers (see below).
Create Variants
Variants are the specific, purchasable versions of a product. Each variant is a combination of values across your variant types.
Navigate to the product detail page and open the Variants section. Click New Variant to create one.
How Variants Work
A variant is built from a set of type-value pairs. For each variant type you have defined, you choose one value. The combination of those values creates the variant.
Example: For a product with variant types Color and Size:
| Variant | Color | Size | |---------|-------|------| | Variant 1 | Black | S | | Variant 2 | Black | M | | Variant 3 | Navy | M | | Variant 4 | Navy | L |
Each variant can also carry its own attribute values, such as a different price or a specific image, overriding the defaults set on the product level.
Adding Values to a Variant Type
When you create a variant, you select values for each variant type. If a value does not exist yet (e.g. Forest Green for Color), you can add it directly in the variant creation dialog.
New values you add are stored for that variant type and are available for future variants of any product in the agent.
Link Products to Tools and Plugins
Products do not automatically show up in every conversation. They are made available through product links — connections between a product and a specific tool or plugin.
When you link a product to a tool, the agent can surface it when that tool runs. For example, if you have a Product Advisor tool, only products linked to it will be used in product recommendation conversations.
Navigate to the product detail page and open the Links section to manage which tools and plugins have access to this product.
This system gives you precise control: a product can be relevant for some agent capabilities but not others. A behind-the-scenes supplier item might only be linked to an internal lookup tool, while customer-facing products are linked to the recommendation and display tools.
Product Settings Reference
Product
| Setting | Description | |---------|-------------| | Name | Display name used by the AI in conversation | | Description | Context and details about the product | | Handle | URL slug, auto-generated, must be unique per agent |
Attributes
| Setting | Description | |---------|-------------| | Type | Value type: text, number, image, or data | | Usage | How the attribute is surfaced by the agent | | Value | The attribute's content | | Image URL | Direct URL for image attributes | | Linked Data Item | Reference to a file in your Data library |
Variant Types
| Setting | Description | |---------|-------------| | Name | The dimension name (e.g. Color, Size) — defined per agent |
Variants
| Setting | Description | |---------|-------------| | Type Values | The combination of values that define this variant |
Manage Your Products
Search and Filter
The Products list shows all products for the current agent. Use the search field at the top to filter by name. This is useful when your catalog grows large.
The list is paginated — use the navigation at the bottom to move between pages.
Edit a Product
Click on any product in the list to open its detail page. From there you can:
- Rename the product or update the description
- Add, edit, or remove attributes
- Create new variants or update existing ones
- Manage product links
Save changes with the Save button. Updates are picked up by the agent immediately.
Delete a Product
Open the product detail page and use the delete option at the bottom of the page.
Deleting a product removes it from the catalog permanently. The agent will no longer be able to find or recommend it. If the product had variants or attributes, those are removed as well.
Deletion is permanent. If you removed a product by mistake, you will have to create it again from scratch.
Delete a Variant Type
Deleting a variant type removes it from all products in the agent. Any variants that used values of this type will lose those associations. Consider carefully before deleting a variant type that is in active use across many products.
FAQ
Can I import products in bulk? Not yet. Products are currently created one by one in the dashboard. Bulk import is on the roadmap.
What happens when I delete a variant type? The variant type and all its defined values are removed. Variants that referenced those values are updated to remove the deleted type values. The variants themselves are not deleted — they just lose the dimension.
Can two products share the same handle? No. Handles must be unique within an agent. If you try to save a duplicate handle, the dashboard will prompt you to choose a different one.
Does the AI agent use all attributes? The agent has access to all attributes you define, but how it uses them depends on the attribute's usage setting and the tools you have enabled. Attributes marked as informational are available for the agent to mention in conversation. Filterable attributes can be used to narrow down search results.
Can a variant have a different price than the base product?
Yes. Add a Price attribute directly to the variant. Variant-level attributes override the product-level default for that specific combination.
How many products can I have per agent? There is no hard limit on the number of products per agent. Very large catalogs may affect search response times. If you manage thousands of products, consider using descriptive names and attributes to keep search results precise.
Can I link one product to multiple tools? Yes. A product can be linked to as many tools and plugins as needed. Each link is managed independently, so you can add or remove access without affecting other connections.