Meet your commercetools sidekick: Boost productivity with our AI Assistant embedded in technical documentation

Our documentation is one of our greatest strengths: It’s extensive, detailed and full of guidance to help you master our products — so much so that our customer ARK Bokhandel described it as the “best-documented piece of software” they ever worked with.  

However, connecting the dots between individual APIs, like the Carts API or Orders API, and implementing complete solutions, such as a full checkout flow, can be challenging even for experienced users.

That’s why we built the commercetools AI Assistant, your sidekick for navigating, understanding and implementing our platform with ease.

The AI Assistant is an intelligent, context-aware companion embedded directly in our technical documentation. Unlike a generic search tool, it doesn’t just point you to pages — it helps you to:

• Explain complex relationships across APIs and workflows.

• Provide actionable guidance for building complete solutions.

• Reduce friction in learning and problem-solving for solution architects, developers and even business users.

In essence, the AI Assistant transforms our extensive documentation from a static resource into a dynamic, interactive guide. It accelerates learning, simplifies complex concepts and helps you implement solutions faster.

Here’s an overview of how it works:

The AI Assistant provides persistent, context-aware conversation threads for continuous guidance. Leveraging the documentation as its foundational data, it can explain concepts, suggest best practices and link disparate information together, serving primarily solution architects and developers. 

Solution architects

Solution architects frequently face the challenge of aligning high-level business requirements with the optimal combination of APIs and processes. They need to understand how flows like checkout, cart management or payment integration come together, and where commercetools fits into the bigger picture.

With the AI Assistant, solution architects can:

• Ask questions about specific processes or API sequences to better visualize end-to-end flows. 

• Understand best practices and recommended workflows to plan integrations and design solutions faster. 

• Navigate complex flows with clarity with automatically generated diagrams that help illustrate integrations and checkout processes. 

For example: 

Developers

Developers are typically focused on implementation details, from reading API references to using code snippets in their applications. They want quick, accurate and actionable answers without having to switch contexts or dig through multiple pages.

The AI Assistant helps developers by:

• Generating code snippets in preferred languages, like JavaScript, tailored to their specific use case.

• Providing context-aware explanations directly from the API documentation.

• Allowing interactive exploration, so developers can ask follow-up questions without losing progress.

For example: 

We’ve gone the extra mile for solution architects and developers to make their job faster and easier. Here’s what else the AI Assistant offers:

Ask about specific pages

Our AI Assistant now allows users to ask questions about specific API documentation pages. By highlighting a section or clicking the “Ask about this page” button, the Assistant reads the relevant content and provides precise, context-aware answers.

For example:

“How can I create a cart in JavaScript?”

The Assistant will generate the code snippet and explain the underlying logic, saving developers time and reducing the risk of errors.

Copy for LLM and markdown format

We also added a “Copy for LLM” feature. This copies the page content in a clean, markdown-ready format suitable for external large language models, like ChatGPT or Perplexity. This ensures that developers can leverage advanced AI tools without losing context or formatting.

Context-aware answers

Unlike general-purpose AI tools, the Assistant doesn’t rely on a single page. It consumes multiple relevant links in the background, offering richer context and reducing hallucinations common in generic LLMs.

Every answer includes “suggested resources”, referencing the documentation pages the AI used. This transparency allows users to verify the source and explore further if needed.

Whether you’re designing complex commerce solutions or writing code, the AI Assistant makes your workflow smoother, your answers more precise and your experience more intuitive.

Experience it today and discover a smarter way to navigate, learn and build with commercetools.

Getting started is simple:

• Create a free commercetools account or use the 60-day free trial.

• Explore the documentation with no usage limits.

• Interact with the AI Assistant directly on any page to ask questions, generate code and visualize workflows.

With the AI Assistant as your guide, you can focus on building solutions rather than hunting for answers.