Roos — Shopify Agent
Roos is the team's Shopify expert. She has 30+ tools for managing stores, orders, products, customers, and discount codes — and she can work with multiple Shopify stores at the same time.
Roos is powered by Claude Sonnet 4.6 and has direct access to the Shopify Admin API. She can read and write data across all connected stores.
Role
Roos handles everything Shopify-related. When Alfred routes a question about sales, inventory, or customers to her, she pulls up the data, processes it, and sends back a clear answer. She's data-driven and to the point — no fluff, just the numbers and facts you need.
Personality
Roos keeps it clean and structured. She presents data clearly, often with summaries and breakdowns. If you ask about yesterday's sales, you'll get the total, the order count, and the top sellers — without having to ask twice.
Multi-store support
Roos works with multiple Shopify stores simultaneously. Which stores she has access to is configured in your DealDome settings. When you ask a question, she'll query the relevant store (or all of them if needed) and make it clear which store the data comes from.
Tools
Roos has over 30 Shopify API tools, organized into the following categories.
Orders
- Name
fetch_order- Type
- tool
- Description
Retrieves a specific order by ID, including line items, fulfillment status, and payment details.
- Name
search_orders- Type
- tool
- Description
Searches orders using filters like date range, status, customer, or financial status. Great for questions like "how many orders did we get last week?"
- Name
cancel_order- Type
- tool
- Description
Cancels an open order. Supports specifying a reason and whether to restock items.
- Name
close_order- Type
- tool
- Description
Closes an order, marking it as completed and archiving it.
- Name
reopen_order- Type
- tool
- Description
Reopens a previously closed order so it can be modified or fulfilled.
- Name
update_order_notes- Type
- tool
- Description
Updates the internal notes on an order — useful for adding context or instructions for fulfillment.
- Name
update_order_tags- Type
- tool
- Description
Adds or removes tags on an order for organization and filtering.
Products
- Name
fetch_product- Type
- tool
- Description
Retrieves a specific product by ID, including variants, images, and inventory levels.
- Name
change_product_status- Type
- tool
- Description
Changes a product's status between active, draft, and archived.
- Name
update_product_title- Type
- tool
- Description
Updates the title of a product.
- Name
update_product_tags- Type
- tool
- Description
Adds or removes tags on a product.
- Name
update_product_price- Type
- tool
- Description
Updates the price of a product or specific variant.
- Name
update_product_inventory- Type
- tool
- Description
Adjusts inventory quantities for a product variant at a specific location.
- Name
delete_product- Type
- tool
- Description
Permanently deletes a product from the store. Use with caution.
Customers
- Name
fetch_customer- Type
- tool
- Description
Retrieves a specific customer by ID, including order history and contact info.
- Name
search_customers- Type
- tool
- Description
Searches customers by name, email, tag, or other attributes.
- Name
update_customer_tags- Type
- tool
- Description
Adds or removes tags on a customer profile.
- Name
update_customer_notes- Type
- tool
- Description
Updates the internal notes on a customer record.
Discount codes
- Name
create_discount_code- Type
- tool
- Description
Creates a new discount code with configurable type (percentage, fixed amount), conditions, and usage limits.
- Name
delete_discount_code- Type
- tool
- Description
Deletes an existing discount code.
- Name
fetch_discount_codes- Type
- tool
- Description
Lists all active discount codes, including their usage stats and configuration.
Store info and webhooks
- Name
fetch_store_info- Type
- tool
- Description
Retrieves general store information like name, domain, currency, and plan.
- Name
manage_webhooks- Type
- tool
- Description
Lists, creates, or deletes webhooks for real-time event notifications from Shopify.
Example interaction
Here's what a typical exchange looks like when Alfred routes a question to Roos:
You: "What were our top 3 products last week?"
Alfred routes this to Roos, who searches orders from the past 7 days, aggregates line items, and returns a ranked breakdown. Alfred then reformulates and sends something like:
"Roos checked the numbers — your top 3 last week were: 1) Pro Bundle (23 sold), 2) Starter Kit (18 sold), 3) Premium Add-on (12 sold). Total revenue from those three: €4,230."
Request
curl -X POST https://api.dealdome.eu/query \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{"message": "What were our top 3 products last week?"}'
Response
{
"response": "Roos checked the numbers — your top 3 last week were: 1) Pro Bundle (23 sold), 2) Starter Kit (18 sold), 3) Premium Add-on (12 sold). Total revenue from those three: €4,230.",
"agent": "alfred",
"delegated_to": "roos"
}