> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yourhomie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Einrichtung

> Konfiguriere Produktfragen, generiere sie für deine Produktseiten und bette das Widget in deinem Storefront ein.

Diese Anleitung führt dich durch das Generieren kurzer, hilfreicher Fragen für deine Product Detail Pages (PDPs) und das Anzeigen im Storefront. Dein Frontend ruft die Fragen öffentlich ab und zeigt sie nur an, wenn ein gültiger Satz existiert.

<Note>
  **Bevor du startest:** arbeite innerhalb einer Organization und identifiziere idealerweise deine meistbesuchten oder am häufigsten nachgefragten PDPs, damit du dort beginnst, wo es am meisten zählt.
</Note>

## 1. Produktfragen konfigurieren

Öffne einen deiner Assistenten und wähle **KI-Produktfragen**, dann klick auf **Einrichtung starten**, um die erste Konfiguration zu starten. Diese Einrichtung legt fest, wie Fragen generiert werden und welche Domains sie abrufen dürfen.

| Einstellung                                    | Erforderlich | Beschreibung                                                                                                   | Empfehlung                                                                                           |
| ---------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Anzahl der Fragen pro Produkt**              | Erforderlich | Wie viele Fragen homie pro Produktseite generiert (1–6).                                                       | **3–5** halten die Fragen nützlich, ohne die Seite zu überladen.                                     |
| **Wo möchtest du die Produktfragen anzeigen?** | Erforderlich | Die Domain(s) deines Shops, die die Fragensätze abrufen und anzeigen dürfen. Mindestens eine ist erforderlich. | Füge die Domain(s) deines Live-Shops hinzu, damit nur autorisierte Seiten deine Fragen laden können. |
| **Zusätzliche Anweisungen**                    | Optional     | Zusätzliche Vorgaben für die Generierung, etwa Ton, Schwerpunkte oder Themen, die vermieden werden sollen.     | Formuliere sie als kurze Stichpunkte für die besten Ergebnisse.                                      |

<Frame>
  <img src="https://mintcdn.com/homieai/m0ZcYuq9OdpATfdE/images/Bildschirmfoto-2026-07-03-um-07.47.28.png?fit=max&auto=format&n=m0ZcYuq9OdpATfdE&q=85&s=8e72f76c9bcfa1e665e498c29c86a86e" alt="Setup-Seite für Produktfragen mit Anzahl der Fragen, erlaubten Domains und zusätzlichen Generierungsregeln" lightAlt="Setup-Seite für Produktfragen mit Anzahl der Fragen, erlaubten Domains und zusätzlichen Generierungsregeln" darkAlt="Setup-Seite für Produktfragen mit Anzahl der Fragen, erlaubten Domains und zusätzlichen Generierungsregeln" className="dark:hidden" width="697" height="672" data-path="images/Bildschirmfoto-2026-07-03-um-07.47.28.png" />

  <img src="https://mintcdn.com/homieai/m0ZcYuq9OdpATfdE/images/Bildschirmfoto-2026-07-03-um-07.47.28-1.png?fit=max&auto=format&n=m0ZcYuq9OdpATfdE&q=85&s=7492a4e9e6850c58cf6dbfb9a68fcc5c" alt="Setup-Seite für Produktfragen mit Anzahl der Fragen, erlaubten Domains und zusätzlichen Generierungsregeln" lightAlt="Setup-Seite für Produktfragen mit Anzahl der Fragen, erlaubten Domains und zusätzlichen Generierungsregeln" darkAlt="Setup-Seite für Produktfragen mit Anzahl der Fragen, erlaubten Domains und zusätzlichen Generierungsregeln" className="hidden dark:block" width="697" height="672" data-path="images/Bildschirmfoto-2026-07-03-um-07.47.28-1.png" />
</Frame>

## 2. Produktseiten hinzufügen

Klick auf **Erstellen**, um Produktseiten hinzuzufügen. Du kannst aus drei Importmethoden wählen.

<Frame>
  <img src="https://mintcdn.com/homieai/m0ZcYuq9OdpATfdE/images/Bildschirmfoto-2026-07-03-um-07.48.02.png?fit=max&auto=format&n=m0ZcYuq9OdpATfdE&q=85&s=08ffabb0b6876abc3d10f8820a0b7eab" alt="Create-Dialog mit den Methoden Einzel-URL, Sitemap und CSV-Import zum Hinzufügen von Produktseiten" lightAlt="Create-Dialog mit den Methoden Einzel-URL, Sitemap und CSV-Import zum Hinzufügen von Produktseiten" darkAlt="Create-Dialog mit den Methoden Einzel-URL, Sitemap und CSV-Import zum Hinzufügen von Produktseiten" className="dark:hidden" width="908" height="420" data-path="images/Bildschirmfoto-2026-07-03-um-07.48.02.png" />

  <img src="https://mintcdn.com/homieai/m0ZcYuq9OdpATfdE/images/Bildschirmfoto-2026-07-03-um-07.48.02-1.png?fit=max&auto=format&n=m0ZcYuq9OdpATfdE&q=85&s=a8994534849df8a05225ffc4416c70e9" alt="Create-Dialog mit den Methoden Einzel-URL, Sitemap und CSV-Import zum Hinzufügen von Produktseiten" lightAlt="Create-Dialog mit den Methoden Einzel-URL, Sitemap und CSV-Import zum Hinzufügen von Produktseiten" darkAlt="Create-Dialog mit den Methoden Einzel-URL, Sitemap und CSV-Import zum Hinzufügen von Produktseiten" className="hidden dark:block" width="908" height="420" data-path="images/Bildschirmfoto-2026-07-03-um-07.48.02-1.png" />
</Frame>

<Tabs>
  <Tab title="Einzel-URL">
    Gib eine Produktseiten-URL direkt ein und klick auf **Hinzufügen**. Ideal, um einzelne Seiten mit hoher Priorität hinzuzufügen.
  </Tab>

  <Tab title="Sitemap">
    Wähle eine deiner erlaubten Domains und einen Sitemap-Pfad (Standard `/sitemap.xml`) und klick auf **Sitemap laden**. Standardmäßig importiert homie nur URLs, die gängigen Produktseiten-Mustern entsprechen; alternativ kannst du alle URLs importieren.
  </Tab>

  <Tab title="CSV-Import">
    Lade eine CSV-Datei mit deinen Produkt-URLs hoch. Die Datei muss eine Spalte mit dem Namen **`url`** enthalten — nur diese Spalte wird verarbeitet.
  </Tab>
</Tabs>

<Note>
  Du kannst alle drei Methoden kombinieren — beginne manuell mit deinen wichtigsten PDPs und erweitere dann per Sitemap oder CSV, um zu skalieren.
</Note>

## 3. Fragen generieren

Sobald deine Liste fertig ist, klick auf **Generieren**. homie verarbeitet alle URLs im Hintergrund und überspringt Duplikate automatisch. Je nach Anzahl der URLs kann das einige Minuten dauern.

Die Ergebnistabelle listet jede Produkt-URL mit der Anzahl der Fragen, dem Generierungszeitpunkt und der Anzahl der Aufrufe (**Aufrufe**) auf. Die Zeilen aktualisieren sich live, während die Generierung läuft, sodass du den Fortschritt verfolgen kannst. Nutze die Suche und die Seitennavigation, um große Kataloge zu verwalten.

<Tip>
  Beginne mit 20–50 stark performenden PDPs (viel Traffic, häufige Anfragen). Werte die Nutzung aus und verfeinere, bevor du auf deinen gesamten Katalog skalierst.
</Tip>

## 4. Auf deinen Produktseiten einbetten

Die Einbettungs-Optionen findest du im Tab **Integration** der **KI-Produktfragen**. Es gibt zwei Wege, die generierten Fragen anzuzeigen.

<Note>
  **Voraussetzung:** Der homie-Assistent muss bereits auf deinem Storefront eingebunden sein. Produktfragen erweitern den bestehenden Assistenten — sie laden kein separates Script.
</Note>

### Shopify

<Steps>
  <Step title="Shopify Theme Editor öffnen">
    Öffne in Shopify den **Theme Editor** und navigiere zu einer **Produktseite**.
  </Step>

  <Step title="Section hinzufügen">
    Klick in der Seitenleiste auf **Abschnitt hinzufügen** und wähle unter **Apps** die Komponente **homie Product Questions**.
  </Step>

  <Step title="Block positionieren">
    Zieh den Block an die gewünschte Position, zum Beispiel unter die Produktbeschreibung.
  </Step>
</Steps>

<Note>
  Stell sicher, dass für das Produkt, das du in der Vorschau ansiehst, bereits Fragen generiert wurden. Andernfalls erscheint die Section leer.
</Note>

### Manuelle Integration

Füge das folgende Element an der Stelle in deinem Seitentemplate ein, an der die Fragen erscheinen sollen:

```html theme={null}
<div id="homie-product-questions"></div>
```

<Note>
  Dieses Host-Element ist erforderlich. Das bereits eingebundene homie-Assistenten-Script erkennt `#homie-product-questions` auf jeder Seite automatisch und befüllt es mit den Fragen der jeweiligen Seite. Ohne das Element werden keine Fragen angezeigt.
</Note>

## Eine Frage programmatisch auslösen

Wenn ein Shopper auf eine vorgeschlagene Frage klickt, öffnet sich der Chat mit dieser bereits gestellten Frage. Dasselbe Verhalten kannst du aus deiner eigenen UI über die Client-API auslösen. Siehe [`sendMessage`](/de/api-reference/client/methods) in der Referenz der Client-Methoden, um den Chat mit einer bestimmten PDP-Frage zu öffnen.

Wenn du einen Fragensatz direkt abrufen musst — etwa um Fragen in einem eigenen Frontend zu rendern — nutze den öffentlichen Endpoint, der unter [Get PDP questions](/de/api-reference/backend/pdp-questions/get-pdp-questions) dokumentiert ist.

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Widget stylen" icon="palette" href="/de/user-guide/product-questions/styling">
    Passe das Produktfragen-Widget an deinen Storefront an.
  </Card>

  <Card title="Wissen hinzufügen" icon="book" href="/de/user-guide/knowledge/overview">
    Gib dem Assistenten die Inhalte, die er braucht, um die Fragen gut zu beantworten.
  </Card>
</CardGroup>