[Alleen SaaS]{class="badge positive" title="Alleen van toepassing op Adobe Commerce as a Cloud Service- en Adobe Commerce Optimizer-projecten (door Adobe beheerde SaaS-infrastructuur)."}

Documentatie RAG-service (Beta)

De documentatie-RAG-service (Retrieval-Augmented Generation) biedt semantische zoekmogelijkheden van AI in alle relevante documentatie van Adobe Commerce en App Builder.

Deze RAG verstrekt een interface van winde voor het stellen van vragen over Adobe Commerce en kan u adviseren over beste praktijken voor het ontwikkelen van toepassingen en andere migratietaken.

De dienst van RAG maakt deel uit van de ​ de rekbaarheidshulpmiddelen van Commerce ​ MCP (ModelProtocol van de Context) server, die met Cursor en andere MCP-compatibele AI medewerkers integreert.

Beschikbare documentatie

De volgende lijst beschrijft welke documentatie momenteel door de dienst van RAG wordt geïndexeerd, en de sleutelwoorden u kunt gebruiken om het zoeken van de bijbehorende index teweeg te brengen. De bijgevoegde documentatie zal verder worden uitgebreid naarmate we de RAG-dienst ontwikkelen.

Voor meer informatie over indexselectie, verwijs naar ​ Automatische indexselectie ​ en ​ Expliciete indexselectie ​.

Voor gedetailleerde informatie over de documentatie inbegrepen in elke index, verwijs naar ​ ingebedde bronlijst ​.

Veiligheid en privacy

Het productieeindpunt wordt beschermd door ​ Azure Voorste Door ​, die de volgende bescherming omvat:

Voor verschillende veiligheidseisen, kunt u een douaneeindpunt gebruiken. Zie ​ Eigen Voorste eindpunt van de Deur van de Douane ​ voor meer informatie.

Vereisten

Controleer voordat u gaat installeren of:

Installatie

Gebruik

Zodra geïnstalleerd, kunt u de indexen ​ automatisch roepen ​ of ​ uitdrukkelijk ​. U kunt ook /search-commerce-docs bevel ​ gebruiken.

Automatische indexselectie (aanbevolen)

Door vragen te stellen over de natuurlijke taal van uw Commerce-project, zoekt het programma automatisch naar de juiste documentatieindex en verstrekt het relevante informatie:

Met de volgende prompt wordt automatisch de commerce-storefront-docs -index geselecteerd:

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

Met de volgende prompt wordt automatisch de commerce-extensibility-docs -index geselecteerd:

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

Met de volgende prompt wordt automatisch de commerce-core-docs -index geselecteerd:

"How to configure product catalog settings?"

Met de volgende prompt wordt automatisch de app-builder-docs -index geselecteerd:

"What are App Builder runtime action best practices?"

Expliciete indexselectie

U kunt ook de index opgeven die u wilt gebruiken in de vraag.

Search commerce-storefront-docs for authentication drop-in

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

Op opdrachten gebaseerde zoekopdracht

Als u er zeker van wilt zijn dat de RAG-service wordt gebruikt, kunt u de opdracht /search-commerce-docs Cursor handmatig aanroepen om de documentatie met uw vraag te doorzoeken:

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

Aangepast eindpunt voorzijde

Door gebrek, gebruikt het documentonderzoek het productie ​ Azure Front Door ​ eindpunt met de bescherming van WAF. Voor test- of ontwikkelingsdoeleinden kunt u dit overschrijven met de omgevingsvariabele FRONT_DOOR_URL .

Om een douaneeindpunt te gebruiken, voeg het aan uw Configuratie van de Curseur MCP toe:

{
  "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"
      }
    }
  }
}

Problemen oplossen

De volgende secties verstrekken het oplossen van problemenuiteinden voor gemeenschappelijke kwesties u kon ontmoeten wanneer het gebruiken van de documentatieRAG dienst.

Verificatiefouten

Voor het zoeken naar documentatie is Adobe IMS-verificatie vereist. Als u verificatiefouten tegenkomt, gebruikt u de volgende stappen om het probleem op te lossen en op te lossen.

MCP-server wordt niet geladen

Als de server MCP verbindt, of uw agent zegt het niet met RAG kan verbinden, gebruik de volgende stappen om de kwestie problemen op te lossen en op te lossen.

Gereedschap niet gevonden

Padproblemen (Windows)

In Windows gebruikt u slashes / of backslashes met escape-teken \\ :

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

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

Aanvullende bronnen