Campi azione e widget action-widget-configuration

IMPORTANT
Adobe LLM Apps è attualmente in Beta.
Le funzioni, i flussi di lavoro e l’interfaccia utente mostrati qui non rappresentano necessariamente lo stato finale del prodotto. Per partecipare al Beta, invia un’e-mail a llm-apps-beta@adobe.com.

Utilizza questa pagina per cercare i campi nell’editor delle azioni. Per i passaggi di creazione, consulta Creare un’azione da zero.

Trova le impostazioni

La finestra di dialogo Crea nuova azione contiene schede Azione e Metadati widget.

Dopo la creazione, l’editor delle azioni salvate utilizza tre schede:

Scheda
Impostazioni
Dettagli widget LLM
Tipo di widget, dominio sandbox, descrizione del widget, URL di modelli e CSP
Dettagli azione
Identificatore di codice, descrizione, parametri di input e impostazioni LLM, incluse annotazioni, testo dello stato di chiamata e visibilità
Analytics
Raccolta e istruzioni per l’intento dell’utente

Per salvare le modifiche, seleziona Salva modifiche. Le azioni generate in attesa di revisione mostrano invece Contrassegna come revisionate, che gestisce anche le richieste pull generate.

Parametri azione

I parametri di input sono i valori che la piattaforma LLM invia al gestore delle azioni. Il modello estrae i valori dal messaggio dell’utente e li mappa sui parametri configurati.

Proprietà
Descrizione
Nome
Identificatore del parametro (ad esempio, category, query)
Tipo
String, Number, Integer o Boolean
Descrizione
Spiegazione leggibile: la piattaforma LLM utilizza la spiegazione per estrarre il valore corretto
Obbligatorio
Se questa opzione è selezionata, il modello deve fornire questo parametro prima di richiamare l’azione

Parametri del file

I parametri di file sono nomi di campi di input configurati nell’editor delle azioni. Quando un utente carica un file, l’host fornisce un oggetto file per tali argomenti, in genere inclusi download_url e file_id.

Campi metadati

Informazioni di base

Campo
Obbligatorio
Descrizione
Nome azione
Sì
Nome visualizzato per l’azione (ad esempio, Cerca prodotti)
Descrizione
Sì
Spiegazione delle operazioni dell’azione: la piattaforma LLM utilizza la spiegazione per decidere quando invocare l’azione

La finestra di dialogo per la creazione visualizza in anteprima un identificatore di codice immutabile derivato dal nome dell’azione. È univoco all’interno dell’app e contiene fino a 63 caratteri, a partire da una lettera minuscola e utilizzando lettere minuscole, cifre, trattini o trattini bassi. L’azione viene mappata su actions/<code-identifier>/index.js nell’archivio del gestore.

Annotazioni

Hint facoltativi che descrivono il comportamento dell’azione:

Annotazione
Descrizione
Suggerimento distruttivo
L’azione può eliminare o sovrascrivere dati
Idempotent (stessi argomenti = nessun effetto aggiuntivo)
La ripetizione della stessa richiesta non ha alcun effetto aggiuntivo sull’ambiente; le richieste ripetute non restituiscono necessariamente dati identici
Apri hint mondo
L’azione interagisce con sistemi esterni
Suggerimento di sola lettura
L’azione legge solo i dati, non scrive mai

Metadati OpenAI

Campo
Lunghezza massima
Descrizione
Richiamo del testo di stato
64 caratteri
Messaggio visualizzato nella piattaforma LLM durante l’esecuzione dell’azione (ad esempio, Caricamento prodotti …)
Testo di stato richiamato
64 caratteri
Messaggio visualizzato al termine dell’azione (ad esempio, Prodotti caricati …)
Descrizione widget
512 caratteri
Viene mappato su _meta["openai/widgetDescription"]; riepiloga il componente sottoposto a rendering per il modello e riduce i commenti ripetuti

La descrizione dell’azione controlla quando il modello seleziona l’azione. La descrizione del widget spiega cosa viene visualizzato dal componente dopo il rendering.

Visibilità

Per attivare o disattivare un’azione, usa l’opzione Visibilità nella pagina dell’app. Lo switch controlla se la distribuzione successiva include l’azione. L’editor azioni non dispone di un interruttore on/off separato.

Le seguenti impostazioni dell’editor di azioni controllano l’esposizione al modello e al widget, non lo stato di attivazione/disattivazione a livello di app:

Attiva/disattiva
Descrizione
Esposizione a modello di IA
L’azione può essere richiamata dal modello di intelligenza artificiale durante le conversazioni
Mostra come widget nella superficie dell’app
L’azione esegue il rendering di un widget visivo nell’app

Le impostazioni di esposizione del modello e del widget non sostituiscono la scelta di un tipo di widget.

Analisi

Campo
Descrizione
Raccogli intento utente
Abilitato per impostazione predefinita. Richiede un riepilogo anonimo dell’obiettivo che ha portato all’azione per Analytics
Descrizione intento utente
Istruzioni utilizzate per richiedere il riepilogo, fino a 2.000 caratteri. L’impostazione predefinita esclude le informazioni personali e riservate. Rivedi eventuali personalizzazioni in base all’informativa sulla privacy

Campi widget

Informazioni widget

Campo
Descrizione
Tipo / Tipo widget
Nella finestra di dialogo di creazione, seleziona Blocco Edge Delivery Services o Nessun widget. L’editor salvato contrassegna la scelta di solo testo Nessuna interfaccia utente interattiva
Dominio widget
Origine sandbox utilizzata dall’host. L’interfaccia utente lo identifica come richiesto per l’invio dell’app e come univoco per app. Separato dall’URL widget della pagina EDS
Preferisce il bordo
Richiede un contenitore delimitato; il rendering dipende dall’host. Disponibile nella finestra di dialogo di creazione

URL modello

Campo
Descrizione
URL script
URL HTTPS per il punto di ingresso EDS scripts/aem-embed.js. Condiviso tra le azioni nello stesso progetto EDS
URL widget
URL HTTPS per la pagina EDS sottoposta a rendering dall’azione. Le azioni generate configurano automaticamente l’URL

Configurazione CSP

L’informativa sulla sicurezza dei contenuti controlla quali domini esterni l’iframe del widget può contattare. Ogni dominio esterno deve essere inserito nell’elenco Consentiti esplicitamente.

Direttiva
Descrizione
Domini risorse
Domini per risorse statiche: immagini, font, script, stili
Connetti domini
Domini che il widget può contattare tramite fetch, XHR o WebSocket
Domini frame
Le origini sono consentite per gli iframe nidificati; attiva una revisione app più rigorosa
Domini di reindirizzamento
Destinazioni attendibili per openExternal collegamenti di reindirizzamento (ChatGPT specifici)
Domini URI di base
Direttiva CSP base-uri (solo SDK delle app MCP, non ChatGPT)

Autorizzazioni

Le autorizzazioni dei widget regolano l’accesso all’hardware e alle API del browser. Le autorizzazioni vengono associate ai criteri di autorizzazione per iframe.

I controlli delle autorizzazioni vengono visualizzati in Autorizzazioni (specifiche MCP) nella finestra di dialogo di creazione. Concedi solo le funzionalità richieste dal widget; vengono applicati anche il supporto host e il consenso degli utenti.

Autorizzazione
Descrizione
Fotocamera
Accedere alla fotocamera del dispositivo
Microfono
Accedere al microfono del dispositivo
Geolocalizzazione
Accedere al percorso dell’utente
Appunti
Leggi o scrivi negli Appunti
recommendation-more-help
llm-apps-help-main-toc