Konfigurieren des KI-Assistenten

Als Administrator können Sie die Funktion KI-Assistent in Experience Manager Guides konfigurieren. Der KI-Assistent wird durch die authentifizierungsbasierte Adobe IMS-Authentifizierung geschützt. Integrieren Sie Ihre Umgebung mit den sicheren Token-basierten Authentifizierungs-Workflows von Adobe und verwenden Sie die Funktion KI-Assistent . Mit der folgenden Konfiguration können Sie die Registerkarte KI-Konfiguration zum Ordnerprofil hinzufügen. Nach dem Hinzufügen können Sie die Funktion KI-Assistent in Experience Manager Guides verwenden.

Führen Sie die folgenden Schritte aus, um den KI-Assistenten zu konfigurieren:

Erstellen von IMS-Konfigurationen in Adobe Developer Console

Führen Sie die folgenden Schritte aus, um IMS-Konfigurationen in Adobe Developer Console zu erstellen:

NOTE
Wenn Sie bereits ein OAuth-Projekt erstellt haben, um die auf Microservices basierende Veröffentlichung zu konfigurieren, können Sie die folgenden Schritte überspringen, um das Projekt zu erstellen.
  1. Adobe Developer Console starten.

  2. Nach erfolgreicher Anmeldung bei Developer Console wird der Bildschirm "". Auf dem Startseite-Bildschirm finden Sie mühelos Informationen und Schnelllinks, einschließlich der oberen Navigationslinks zu Projekten und Downloads.

  3. Um ein neues leeres Projekt zu erstellen, wählen Sie Neues Projekt erstellen aus den Schnellstart ​Links aus.
    Schnellstart-Links {width="550"}
    Neues Projekt erstellen.

  4. Wählen API hinzufügen auf dem Bildschirm Projekte aus. Der „API hinzufügen wird angezeigt. Auf diesem Bildschirm werden alle verfügbaren APIs, Ereignisse und Services für Adobe-Produkte und -Technologien angezeigt, mit denen Sie Anwendungen entwickeln können.

  5. Wählen Sie die I/O Management API aus, um sie zu Ihrem Projekt hinzuzufügen.
    IO-Management-API
    Fügen Sie Ihrem Projekt die I/O-Management-API hinzu.

  6. Erstellen Sie eine neue OAuth-Berechtigung und speichern Sie sie.

    OAuth-Berechtigungskachel in der API konfigurieren

    Konfigurieren von OAuth-Anmeldeinformationen für Ihre API.

  7. Wählen Sie auf Registerkarte die Option OAuth-Server zu Server und wählen Sie dann die neu erstellten Anmeldeinformationen aus.

  8. Wählen Sie den OAuth Server-zu-Server-Link aus, um die Details der Anmeldeinformationen Ihres Projekts anzuzeigen.

    Verbundene Anmeldedaten {width="800"}

    Stellen Sie eine Verbindung zum Projekt her, um die Details der Berechtigung anzuzeigen.

  9. Kehren Sie zur Registerkarte Projekte zurück und wählen Sie Projektübersicht auf der linken Seite aus.

    Projektübersicht {width="500"}

    Erste Schritte mit dem neuen Projekt.

  10. Klicken Sie oben auf Schaltfläche Herunterladen“, um die JSON-Datei des Services herunterzuladen.

    JSON herunterladen {width="500"}

    JSON-Service-Details herunterladen.

Sie haben die OAuth-Authentifizierungsdetails konfiguriert und die JSON-Service-Details heruntergeladen. Halten Sie diese Datei bereit, da sie im nächsten Abschnitt benötigt wird.

Hinzufügen der IMS-Konfiguration zur Umgebung

Führen Sie die folgenden Schritte aus, um die IMS-Konfiguration zur Umgebung hinzuzufügen:

  1. Öffnen Sie Experience Manager und wählen Sie dann Ihr Programm aus, das die Umgebung enthält, die Sie konfigurieren möchten.

  2. Wechseln Sie zur Registerkarte Umgebungen.

  3. Wählen Sie den Namen der Umgebung aus, die Sie konfigurieren möchten. Dadurch sollten Sie zur Seite Umgebungsinformationen gelangen.

  4. Wechseln Sie zur Registerkarte Konfiguration .

  5. Aktualisieren Sie das JSON-Feld SERVICE_ACCOUNT_DETAILS . Stellen Sie sicher, dass Sie denselben Namen und dieselbe Konfiguration wie im folgenden Screenshot verwenden.

    Konfiguration des IMS-Dienstkontos {width="800"}

KI-Markierung in der Umgebung aktivieren

Um die Funktion „KI-Assistent“ in der Experience Manager Guides-Benutzeroberfläche zu aktivieren, fügen Sie die ENABLE_GUIDES_AI in der Umgebung hinzu.

Stellen Sie sicher, dass Sie denselben Namen und dieselbe Konfiguration wie im folgenden Screenshot verwenden.

{width="800"}

Wenn Sie das Flag auf true setzen, wird die Funktion aktiviert, wenn Sie sie auf false setzen.

Fügen Sie die Variable GUIDES_AI_SITE_ID in der Umgebung hinzu

Fügen Sie die Variable GUIDES_AI_SITE_ID in Ihrer Umgebung (Cloud Manager) hinzu und legen Sie den Wert auf id_f651abc807c84f52b425737bb93f87ba fest, um sie zu aktivieren.

Stellen Sie sicher, dass Sie denselben Namen und dieselbe Konfiguration wie im folgenden Screenshot verwenden.

{width="800"}

Änderungen auf die Umgebung anwenden

Nachdem Sie die IMS-Konfiguration hinzugefügt und das Flag „KI-Assistent“ für die Umgebung aktiviert haben, führen Sie die folgenden Schritte aus, um diese Eigenschaften mithilfe von OSGi mit AEM Guides zu verknüpfen:

  1. Fügen Sie in Ihrem Cloud Manager-Git-Projekt-Code die folgenden beiden Dateien hinzu (für den Dateiinhalt, Ansicht Anhang).

    • com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
    • com.adobe.guides.ai.config.service.AiConfigImpl.cfg.json
  2. Stellen Sie sicher, dass die neu hinzugefügten Dateien von Ihrem filter.xml abgedeckt werden.

  3. Übertragen Sie Ihre Git-Änderungen und übertragen Sie sie.

  4. Führen Sie die Pipeline aus, um die Änderungen auf die Umgebung anzuwenden.

Aktivieren des KI-Assistenten im Ordnerprofil

Sobald die Konfigurationsänderungen angewendet wurden, aktivieren Sie die Funktion des KI-Assistenten für das gewünschte Ordnerprofil.

Weitere Informationen finden Sie unter Die Editor-Funktionen kennen.

{width="300"}

Konfigurieren von Smart-Vorschlägen im Ordnerprofil

Konfigurieren Sie nach der Aktivierung der Funktion „KI-Assistent“ die Funktion „Intelligente Vorschläge“ im Ordnerprofil.

Weitere Informationen finden Sie unter Konfigurieren von Smart-Vorschlägen im".

Anhang appendix

Datei:
com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json

Inhalt:

{
 "service.account.details": "$[secret:SERVICE_ACCOUNT_DETAILS]"
}

Datei: com.adobe.guides.ai.config.service.AiConfigImpl.cfg.json

Inhalt:

{
  "conref.inline.threshold":0.6,
  "conref.block.threshold":0.7,
  "related.link.threshold":0.5,
  "emerald.url":"https://adobeioruntime.net/apis/543112-smartsuggest/emerald/v1",
  "instance.type":"prod",
  "chat.url":"https://aem-guides-ai-v2.adobe.io"
  }

Konfigurationsdetails des KI-Assistenten

Schlüssel
Beschreibung
Zulässige Werte
Standardwert
conref.inline.threshold
Schwellenwert, der die Präzision/den Abruf von Vorschlägen steuert, die für das Tag abgerufen werden, das der Benutzer derzeit eingibt.
Beliebiger Wert von -1,0 bis 1,0.
0,6
conref.block.threshold
Schwellenwert, der die Präzision/den Abruf von Vorschlägen steuert, die für Tags in der gesamten Datei abgerufen werden.
Beliebiger Wert von -1,0 bis 1,0.
0,7
emerald.url
Endpunkt für die Smart Suggestion-Vektordatenbank
https://adobeioruntime.net/apis/543112-smartsuggest/emerald/v1
https://adobeioruntime.net/apis/543112-smartsuggest/emerald/v1
chat.url
Endpunkt für den KI-Assistenten-Service
https://aem-guides-ai-v2.adobe.io
https://aem-guides-ai-v2.adobe.io
instance.type
Typ der AEM-Instanz. Stellen Sie sicher, dass dies für jede AEM-Instanz, für die die Smart-Vorschläge konfiguriert sind, eindeutig ist. Ein Anwendungsfall bestünde darin, die Funktion in der Staging-Umgebung mit „instance.type“ = „stage“ zu testen, während die Funktion gleichzeitig auch in „prod“ konfiguriert ist.
Jeder eindeutige Schlüssel, der die Umgebung identifiziert. Nur alphanumerische Werte sind zulässig. „dev“/„stage“/„prod“/„test1“/„stage2“
„prod“

Nach der Konfiguration wird das Symbol für den KI-Assistenten auf der Startseite und im Editor der Experience Manager Guides angezeigt. Weitere Informationen finden Sie AbschnittKI-Assistent“ im Experience Manager-Benutzerhandbuch.

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178