Benutzerdefinierte Skripte und Store Agent
Fügen Sie Storefront-JavaScript hinzu und wählen Sie, welche Skills in einem Shop-Projekt verfügbar sind.
Benutzerdefinierte Skripte ändern das Storefront-Verhalten, während Store Agent ändert, welche Skills Runner für das aktuelle Projekt verwenden kann. Beide sind Shop-spezifische Einstellungen und sollten mit besonderer Sorgfalt überprüft werden.
Was dieser Leitfaden abdeckt
Sie können ein Skript hinzufügen und speichern, es pausieren, ohne es zu löschen, und eine Skill für nur das aktuelle Projekt hinzufügen oder deaktivieren.
Verfügbarkeit und Voraussetzungen
- Öffnen Sie Einstellungen aus dem beabsichtigten Projekt.
- Benutzerdefiniertes JavaScript kann das Storefront-Verhalten ändern. Fügen Sie nur Code hinzu, den Sie verstehen und dem Sie vertrauen.
- Skill-Aktionen hängen von verfügbaren Workspace-Skills und davon ab, ob eine System-Skill konfigurierbar ist.
- Die vollständige Agent-Seite und das Plan-Gate steuern weiterhin die breitere Skill-Verfügbarkeit.
Eingabepfade
- Skripte: Avatar → Einstellungen → Shop → Benutzerdefinierte Skripte
- Projekt-Skills: Avatar → Einstellungen → Shop → Agent
Steuerelemente für benutzerdefinierte Skripte
| Eintrag oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
|---|---|---|
| Skript hinzufügen | Erstellen Sie einen Storefront-Skripteintrag. | Eine neue aktivierte Skriptzeile wird mit leerem JavaScript-Code geöffnet. |
| Skriptzeile | Erweitern oder reduzieren Sie seinen Editor. | Skriptname und JavaScript-Code werden sichtbar. |
| Auge / verstecktes Augensymbol | Aktivieren oder deaktivieren Sie ein Skript. | Die lokale Zeile ändert den Zustand; wählen Sie Änderungen speichern, um sie anzuwenden. |
| Löschsymbol | Entfernen Sie ein Skript aus der ausstehenden Liste. | Die Zeile verschwindet ohne einen zweiten Dialog; Änderungen speichern wendet die Entfernung an. |
| Änderungen speichern | Wenden Sie jede ausstehende Skriptbearbeitung an. | Runner speichert die vollständige Skriptliste und zeigt eine Erfolgs- oder Fehlermeldung an. |
Runner erlaubt bis zu zehn Skripteinträge. Die Schaltfläche Änderungen speichern bleibt deaktiviert, wenn sich nichts geändert hat.
Hinzufügen oder Ändern eines Skripts
- Öffnen Sie Shop → Benutzerdefinierte Skripte.
- Wählen Sie Skript hinzufügen.
- Geben Sie einen klaren Skriptnamen und vertrauenswürdigen JavaScript-Code ein.
- Lassen Sie das Skript nur aktiviert, wenn es auf der Storefront ausgeführt werden soll.
- Überprüfen Sie alle anderen Zeilen, da Änderungen speichern die gesamte Liste anwendet.
- Wählen Sie Änderungen speichern und warten Sie auf Gespeichert.
- Überprüfen Sie die Storefront sicher nach dem Speichern.
Runner versucht zu verhindern, dass ein Skriptfehler die Seite zum Absturz bringt, aber das macht unbekannten Code nicht sicher. Ein Skript kann immer noch Datenschutz, Leistung, Tracking und Kundenerlebnis beeinflussen.
Store Agent-Steuerelemente
| Eintrag oder Schaltfläche | Warum es nützlich ist | Was passiert als Nächstes |
|---|---|---|
| Aktive Skill-Zeile | Sehen Sie, welche Skill in diesem Projekt verfügbar ist. | Die Zeile zeigt Name, Beschreibung und System- oder Custom-Typ. |
| Deaktivieren | Entfernen Sie eine konfigurierbare Skill aus diesem Projekt. | Die Skill verlässt die aktive Liste dieses Projekts; sie wird nicht global gelöscht. |
| Skill hinzufügen | Fügen Sie eine verfügbare Workspace-Skill zu diesem Projekt hinzu. | Das Auswählen einer aufgelisteten Skill aktiviert sie für das aktuelle Projekt. |
| Benutzerdefinierte Skill erstellen… | Erstellen Sie eine neue benutzerdefinierte Fähigkeit. | Der Skill-Editor wird geöffnet, dann wird die Projektliste nach dem Erfolg aktualisiert. |
Konfigurieren Sie Projekt-Skills
- Öffnen Sie Shop → Agent.
- Überprüfen Sie die derzeit aktiven Skills.
- Wählen Sie Skill hinzufügen, dann wählen Sie eine verfügbare Skill oder Benutzerdefinierte Skill erstellen….
- Warten Sie auf die Erfolgsmeldung und bestätigen Sie, dass die Skill angezeigt wird.
- Verwenden Sie Deaktivieren, wenn eine konfigurierbare Skill nicht mehr auf dieses Projekt angewendet werden soll.
- Öffnen Sie Kontrollzentrum → Agent für vollständige Skill-Details, Pause, Bearbeitung, Import oder Löschaktionen.
Zustände und Limits
- Skriptänderungen bleiben lokal, bis Änderungen speichern erfolgreich ist.
- Das Entfernen einer Skriptzeile hat keine separate Bestätigung vor Änderungen speichern.
- Das Erreichen von zehn Skripten deaktiviert Skript hinzufügen.
- Store Agent kann Laden, einen Fehler, Keine Skills aktiviert oder die aktive Liste anzeigen.
- Feste System-Skills zeigen nicht Deaktivieren.
- Das Deaktivieren in Store Agent ändert den Umfang dieses Projekts; es löscht oder pausiert die Skill nicht global.
Fehlerbehebung
- Wenn ein Skript immer noch ausgeführt wird, bestätigen Sie seinen deaktivierten Zustand, gefolgt von Änderungen speichern.
- Wenn Speichern fehlschlägt, bleibt die zuvor gespeicherte Liste unverändert; korrigieren Sie den Code oder versuchen Sie es nach dem Fehler erneut.
- Wenn Skill hinzufügen keinen erwarteten Eintrag hat, überprüfen Sie die vollständige Agent-Seite und den aktuellen Plan.
- Wenn Deaktivieren fehlt, ist die System-Skill nicht für dieses Projekt konfigurierbar.
- Wenn eine neue Skill global angezeigt wird, aber nicht hier, fügen Sie sie von Store Agent zum Projekt hinzu.