Agents overview

B2CB2BB2XB2C CORE COMMERCEB2B CORE COMMERCEB2X CORE COMMERCE
Ask about this Page
Copy for LLM
View as Markdown

Agents turn unstructured input into structured commerce objects.

Agents are API-first AI tools that interpret unstructured input, such as free text or files. They produce structured commerce objects you can review, edit, and act on. Agents use the commercetools APIs as their tool surface, which means anything an agent creates remains a first-class resource in your Project.

AI use: Agents use AI to analyze data you provide and generate commerce objects.
Your data: We do not use your data to train models.
Opt-in: To enable Agents in a Project, submit a support request and include the Project key.

Available agents

Intake Agent

The Intake Agent converts unstructured customer requests, such as emails, PDFs, spreadsheets, CSVs, and free-text descriptions, into structured Carts or Quote Requests. It is available through both the HTTP API and the Merchant Center.

How agents work

Agents follow this four-step flow:

  1. Input. The caller provides free text or uploads a file through the HTTP API or the Merchant Center.
  2. AI interpretation. The Agent extracts identifiers (such as SKUs or product keys), quantities, customer context (email, currency, country), and any other relevant metadata from the input.
  3. Commerce object creation. The Agent matches extracted items against the catalog in the Project, resolves the Customer, and applies pricing. It then creates a structured draft, such as a Cart, with any non-fatal issues returned as warnings.
  4. Review and action. The caller reviews the draft and makes corrections. They then choose a next action, such as freezing the Cart, creating a draft Quote, or deleting and starting over.

Tools available to agents

Agents call commercetools APIs through a fixed set of tools, which includes:

  • Customer search. Finds Customers by email using GraphQL. Returns the Customer ID and addresses.
  • Product search. Finds Products by name, key, Product Variant SKU, or Product Variant key using GraphQL. Returns the SKU, key, and pricing for all variants.

Authentication and scopes

The Project must have the Intake Agent enabled. To enable it, submit a support request and include the Project key.
The endpoint requires the manage_intake_agent:{projectKey} OAuth scope.