Aktions- und Widget-Felder action-widget-configuration

IMPORTANT
Adobe LLM Apps befindet sich derzeit in Beta.
Die hier gezeigten Funktionen, Workflows und Benutzeroberflächen stellen nicht unbedingt den endgültigen Status des Produkts dar. Um Beta beizutreten, senden Sie eine E-Mail an llm-apps-beta@adobe.com.

Auf dieser Seite können Sie Felder im Aktionseditor nachschlagen. Die Erstellungsschritte finden Sie unter Erstellen einer neuen Aktion.

Suchen der Einstellungen

Das „Neue Aktion erstellen verfügt über die Registerkarten Aktion und Widget-Metadaten.

Nach der Erstellung verwendet der Editor für gespeicherte Aktionen drei Registerkarten:

Registerkarte
Einstellungen
LLM-Widget-Details
Widget-Typ, Sandbox-Domain, Widget-Beschreibung, Vorlagen-URLs und CSP
Aktionsdetails
Code-Kennung, Beschreibung, Eingabeparameter und LLM-Einstellungen einschließlich Anmerkungen, Text zum Aufrufstatus und Sichtbarkeit
Analytics
Benutzerabsichtserfassung und Anweisungen

Um Ihre Änderungen zu speichern, klicken Sie auf Änderungen speichern. Erzeugte Aktionen, die auf eine Überprüfung warten, zeigen stattdessen Als geprüft markieren an, wodurch auch die generierten Pull-Anforderungen verarbeitet werden.

Aktionsparameter

Eingabeparameter sind die Werte, die die LLM-Plattform an Ihren Aktions-Handler sendet. Das Modell extrahiert die Werte aus der Nachricht des Benutzers und ordnet sie den konfigurierten Parametern zu.

Eigenschaft
Beschreibung
Name
Die Parameterkennung (z. B. category, query)
Typ
String, Number, Integer oder Boolean
Beschreibung
Eine für Menschen lesbare Erklärung - Die LLM-Plattform verwendet die Erklärung, um den richtigen Wert zu extrahieren
Erforderlich
Falls aktiviert, muss das Modell diesen Parameter bereitstellen, bevor die Aktion aufgerufen wird

Dateiparameter

Dateiparameter sind im Aktionseditor konfigurierte Eingabefeldnamen. Wenn ein Benutzer eine Datei hochlädt, stellt der Host ein Dateiobjekt für diese Argumente bereit, normalerweise einschließlich download_url und file_id.

Metadatenfelder

Grundlegende Informationen

Feld
Erforderlich
Beschreibung
Aktionsname
Ja
Anzeigename für die Aktion (z. B. Produkte suchen)
Beschreibung
Ja
Erläuterung der Funktionsweise der Aktion - Die LLM-Plattform entscheidet anhand der Erklärung, wann die Aktion aufgerufen wird

Im Erstellungsdialogfeld wird eine unveränderliche Code-Kennung, die vom Aktionsnamen abgeleitet ist, in der Vorschau angezeigt. Sie ist innerhalb der App eindeutig und enthält bis zu 63 Zeichen, beginnend mit einem Kleinbuchstaben und unter Verwendung von Kleinbuchstaben, Ziffern, Bindestrichen oder Unterstrichen. Dabei wird die Aktion dem actions/<code-identifier>/index.js im Handler-Repository zugeordnet.

Anmerkungen

Optionale Hinweise, die das Verhalten der Aktion beschreiben:

Anmerkung
Beschreibung
Destruktiver Hinweis
Die Aktion kann Daten löschen oder überschreiben
Idempotent (gleiche Argumente = kein zusätzlicher Effekt)
Eine Wiederholung derselben Anfrage hat keine zusätzlichen Auswirkungen auf die Umgebung. Wiederholte Anfragen geben nicht unbedingt identische Daten zurück
Open world hint
Die Aktion interagiert mit externen Systemen
Schreibgeschützter Hinweis
Die Aktion liest nur Daten, schreibt nie

OpenAI-Metadaten

Feld
Max. Länge
Beschreibung
Aufrufen des Statustextes
64 Zeichen
Meldung, die auf der LLM-Plattform während der Ausführung der Aktion angezeigt wird (z. B „Produkte werden geladen …)
Aufgerufener Statustext
64 Zeichen
Meldung, die nach Abschluss der Aktion angezeigt wird (z. B „Produkte geladen …)
Widget-Beschreibung
512 Zeichen
Ordnet _meta["openai/widgetDescription"] zu. Fasst die gerenderte Komponente für das Modell zusammen und reduziert wiederholte Aussagen.

Die Aktionsbeschreibung steuert, wann das Modell die Aktion auswählt. In der Widget-Beschreibung wird erläutert, was die Komponente nach dem Rendern anzeigt.

Sichtbarkeit

Um eine Aktion zu aktivieren oder zu deaktivieren, verwenden Sie ihren Sichtbarkeit Schalter auf der App-Seite. Der Schalter steuert, ob die nächste Bereitstellung die Aktion enthält. Der Aktionseditor verfügt über keinen separaten Ein-/Ausschalter.

Die folgenden Einstellungen des Aktionseditors steuern die Modell- und Widget-Belichtung, nicht den Ein-/Aus-Status auf Programmebene:

Umschalter
Beschreibung
KI-Modell bereitstellen
Die Aktion kann vom KI-Modell während Konversationen aufgerufen werden
Als Widget in Programmoberfläche anzeigen
Die Aktion rendert ein visuelles Widget in der App

Die Einstellungen für die Modell- und Widget-Belichtung ersetzen nicht die Auswahl eines Widget-Typs.

Analytics

Feld
Beschreibung
Benutzerabsicht erfassen
Standardmäßig aktiviert. Fordert eine anonymisierte Zusammenfassung des Ziels an, das zu der Aktion für Analytics geführt hat
Beschreibung der Benutzerabsicht
Anweisungen zur Anforderung der Zusammenfassung, bis zu 2.000 Zeichen. Die Standardeinstellung schließt personenbezogene und vertrauliche Informationen aus. Überprüfen Sie alle Anpassungen anhand Ihrer Datenschutzrichtlinien

Widget-Felder

Widget-Informationen

Feld
Beschreibung
Typ/Widget-Typ
Wählen Sie im Erstellungsdialogfeld Edge Delivery Services-Block oder Kein Widget aus. Der gespeicherte Editor kennzeichnet die Auswahl „Nur Text“ keine interaktive Benutzeroberfläche
Widget-Domain
Vom Host verwendeter Sandbox-Ursprung. Die Benutzeroberfläche identifiziert sie als erforderlich für die Übermittlung der App und eindeutig pro App. Dies ist von der Widget-URL der EDS Seite getrennt
Bevorzugter Rahmen
Fordert einen umrandeten Container an; die Darstellung hängt vom Host ab. Verfügbar im Erstellungsdialogfeld

Vorlagen-URLs

Feld
Beschreibung
Skript-URL
HTTPS-URL für den EDS-scripts/aem-embed.js. Gemeinsam genutzt über Aktionen im selben EDS-Projekt
Widget-URL
HTTPS-URL für die von der Aktion gerenderte EDS-Seite. Erzeugte Aktionen konfigurieren die URL automatisch

CSP-Konfiguration

Die Content Security Policy steuert, an welche externen Domains der Widget-IFrame sich wenden darf. Jede externe Domain muss explizit angegeben werden.

Anweisung
Beschreibung
Ressourcendomänen
Domains für statische Assets: Bilder, Schriftarten, Skripte, Stile
Verbinden von Domains
Domains, mit denen das Widget über fetch, XHR oder WebSocket Kontakt aufnehmen kann
Frame-Domains
Zulässige Ursprünge für verschachtelte iFrames; Trigger strengere App-Überprüfung
Umleitungs-Domains
Vertrauenswürdige Ziele für openExternal Umleitungs-Links (ChatGPT)
Basis-URI-Domains
Die base-uri CSP-Direktive (nur MCP Apps SDK, nicht ChatGPT)

Berechtigungen

Widget-Berechtigungen steuern den Zugriff auf Hardware- und Browser-APIs. Die Berechtigungen sind der iframe-Berechtigungsrichtlinie zugeordnet.

Berechtigungssteuerelemente werden unter Berechtigungen (MCP-spezifisch) im Erstellungsdialogfeld angezeigt. Gewähren Sie nur Funktionen, die das Widget erfordert. Es gelten auch Hostunterstützung und Benutzerzustimmung.

Berechtigung
Beschreibung
Kamera
Zugriff auf die Gerätekamera
Mikrofon
Zugriff auf das Gerätemikrofon
Geolocation
Zugriff auf den Standort des Benutzers
Zwischenablage
Aus der Zwischenablage lesen oder in die Zwischenablage schreiben
recommendation-more-help
llm-apps-help-main-toc