[Solo SaaS]{class="badge positive" title="Applicabile solo ai progetti Adobe Commerce as a Cloud Service e Adobe Commerce Optimizer (infrastruttura SaaS gestita da Adobe)."}

Servizio RAG documentazione (Beta)

Il servizio di documentazione RAG (Retrieval-Augmented Generation) fornisce funzionalità di ricerca semantica basate sull’intelligenza artificiale nella documentazione pertinente di Adobe Commerce e App Builder.

Questo RAG fornisce un’interfaccia IDE per porre domande su Adobe Commerce e può consigliarti sulle best practice per lo sviluppo di applicazioni e altre attività di migrazione.

Il servizio RAG fa parte del server Commerce extensibility tools MCP (Model Context Protocol), che si integra con Cursor e altri assistenti di IA compatibili con MCP.

Documentazione disponibile

Nella tabella seguente viene descritta la documentazione attualmente indicizzata dal servizio RAG e le parole chiave che è possibile utilizzare per attivare la ricerca nell'indice associato. La documentazione inclusa continuerà a crescere man mano che svilupperemo il servizio RAG.

Per ulteriori informazioni sulla selezione dell'indice, consultare Selezione automatica dell'indice e Selezione esplicita dell'indice.

Per informazioni dettagliate sulla documentazione inclusa in ogni indice, consulta l'elenco di origini acquisite.

Sicurezza e privacy

L'endpoint di produzione è protetto da Azure Front Door, che include le seguenti protezioni:

Per diversi requisiti di sicurezza, puoi utilizzare un endpoint personalizzato. Per ulteriori informazioni, vedere Endpoint Front Door personalizzato.

Prerequisiti

Prima dell’installazione, assicurati di disporre di:

Installazione

Utilizzo

Una volta installato, è possibile chiamare gli indici automaticamente o in modo esplicito. È inoltre possibile utilizzare il comando /search-commerce-docs.

Selezione automatica indice (scelta consigliata)

Facendo domande in linguaggio naturale sul progetto Commerce, lo strumento cercherà automaticamente l’indice della documentazione appropriato e fornirà informazioni pertinenti:

Il seguente prompt seleziona automaticamente l'indice commerce-storefront-docs:

"How do I use Edge Delivery Services drop-ins for product listing?"

Il seguente prompt seleziona automaticamente l'indice commerce-extensibility-docs:

"How do I create a webhook in Adobe Commerce?"

Il seguente prompt seleziona automaticamente l'indice commerce-core-docs:

"How to configure product catalog settings?"

Il seguente prompt seleziona automaticamente l'indice app-builder-docs:

"What are App Builder runtime action best practices?"

Selezione esplicita dell'indice

In alternativa, è possibile specificare l'indice da utilizzare nel prompt.

Search commerce-storefront-docs for authentication drop-in

Using app-builder-docs, how do I deploy runtime actions?

Ricerca basata su comandi

Se si desidera assicurarsi che venga utilizzato il servizio RAG, è possibile richiamare manualmente il comando Cursore /search-commerce-docs per eseguire ricerche nella documentazione al prompt:

/search-commerce-docs "How do I subscribe to Commerce events?"

Endpoint personalizzato porta anteriore

Per impostazione predefinita, la ricerca nella documentazione utilizza l'endpoint di produzione Azure Front Door con protezione WAF. A scopo di test o sviluppo, è possibile eseguire l'override con la variabile di ambiente FRONT_DOOR_URL.

Per utilizzare un endpoint personalizzato, aggiungilo alla configurazione MCP cursore:

{
  "mcpServers": {
    "commerce-extensibility-tools": {
      "command": "node",
      "args": ["/<your-project-directory>/commerce-extensibility-tools/index.js"],
      "env": {
        "NODE_ENV": "production",
        "FRONT_DOOR_URL": "https://<custom-endpoint>.azurefd.net"
      }
    }
  }
}

Risoluzione dei problemi

Nelle sezioni seguenti vengono forniti suggerimenti per la risoluzione dei problemi comuni che possono verificarsi quando si utilizza il servizio RAG della documentazione.

Errori di autenticazione

Lo strumento di ricerca della documentazione richiede l’autenticazione Adobe IMS. Se riscontri errori di autenticazione, procedi come segue per risolvere il problema e risolverlo.

Impossibile caricare il server MCP

Se il server MCP non si connette o l'agente comunica che non è in grado di connettersi a RAG, attenersi alla procedura seguente per risolvere il problema.

Strumento non trovato

Problemi di percorso (Windows)

In Windows, utilizzare le barre / o le barre rovesciate con escape \\:

{
  "args": ["C:/Users/yourname/projects/commerce-extensibility-tools/index.js"]
}

{
  "args": ["C:\\Users\\yourname\\projects\\commerce-extensibility-tools\\index.js"]
}

Risorse aggiuntive