DocumentazioneApp LLM

Risoluzione di problemi troubleshooting

Ultimo aggiornamento: 18 giugno 2026
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.

Inizia con il sintomo che puoi vedere. Durante la risoluzione dei problemi, non condividere credenziali, token, URL MCP privati o risultati sensibili del gestore.

Creazione e onboarding di app

Sintomo
Cosa provare
I nuovi archivi non vengono visualizzati
Seleziona Gestisci repository su GitHub, concedi all’app GitHub delle app Adobe LLM l’accesso a entrambi gli archivi, torna alla finestra di dialogo e aggiorna gli elenchi
L’archivio EDS richiede AEM Code Sync
Installa AEM Code Sync per l’archivio EDS, quindi torna alla finestra di dialogo Crea app LLM
La convalida EDS indica che non si è amministratori
Seleziona Apri AEM Live Admin, aggiungi te stesso/a come amministratore per il sito EDS, quindi aggiorna l’archivio
L’onboarding è ancora in fase di generazione
Attendere circa 15 minuti. Puoi uscire dalla pagina e tornare in un secondo momento
Report di onboarding non riusciti
Verifica che entrambi gli archivi siano accessibili e che il sito web sia pubblico tramite HTTPS, quindi contatta il team di Beta con il messaggio di errore visibile

Azioni e gestori

Sintomo
Cosa provare
Azione non richiamata
Allega il plug-in ChatGPT, conferma che Esposizione al modello di IA sia abilitato, migliora la descrizione dell’azione e ridistribuisci le modifiche ai metadati
Risposta vuota o di errore
Esegui npm test, quindi chiama il gestore con MCP Inspector o curl. Vedi Sviluppo e test del gestore locale
Il gestore funziona localmente, ma non dopo la distribuzione
Conferma il push dell’ultimo commit, la configurazione runtime è presente e l’identificatore del codice azione corrisponde a actions/<code-identifier>/index.js
L’azione generata non può essere contrassegnata come rivista
Generazione del gestore e del widget di conferma completata. Controlla le richieste pull generate per i conflitti di unione, ricarica l’azione e seleziona Contrassegna come revisionato

Widget

Sintomo
Cosa provare
Widget non eseguito rendering
Verifica l’URL dello script, l’URL del widget, HTTPS, la pubblicazione EDS, i domini CSP e le intestazioni CORS
Il widget esegue il rendering ma non mostra dati
Chiamare il gestore con MCP Inspector e confrontare la relativa forma structuredContent con i campi letti da bridge.toolResult
Il widget funziona in anteprima diretta ma non in ChatGPT
L’anteprima diretta potrebbe utilizzare dati di esempio. Verifica il risultato del gestore distribuito e verifica che l’origine EDS sia consentita da CORS e CSP
La richiesta del browser è bloccata
Aggiungi solo l’origine richiesta al campo CSP corretto e ridistribuisci
L’editor intestazioni HTTP non può salvare la configurazione
Utilizza il Servizio di configurazione AEM o chiedi all’amministratore EDS di inizializzare la configurazione delle intestazioni del sito

Non registrare valori bridge.toolResult completi quando possono contenere dati personali o sensibili.

Distribuzione

Sintomo
Cosa provare
Distribuzione non riuscita durante la preparazione
Verifica che l’archivio del gestore sia collegato e che l’accesso a Adobe Developer Console sia ancora valido
Distribuzione non riuscita durante Build app
Eseguire npm install, npm test e npm run build localmente. Correggi gli errori di dipendenza, sintassi o test e invia le modifiche
La distribuzione riesce ma mancano le modifiche
Conferma che il commit previsto è stato inviato e ridistribuito nello stesso ambiente
L’azione rimane Non distribuita
Ripeti la distribuzione dopo aver esaminato l’azione o averne modificato i metadati

Plug-in ChatGPT

Sintomo
Cosa provare
Il plug-in non viene visualizzato
Attiva la modalità sviluppatore, apri chatgpt.com/plugins, verifica che il plug-in esista e seleziona Connetti
Creazione del plug-in non riuscita
Conferma che la modalità sviluppatore è abilitata, copia di nuovo l’URL del server MCP da Verifica l’app e utilizza URL del server con Nessuna autenticazione
Il plug-in si connette ma non può richiamare azioni
Conferma che il plug-in sia allegato alla chat, che le azioni siano esposte al modello e che sia distribuita la versione più recente
Il plug-in utilizza l’ambiente errato
Modifica o ricrea il plug-in con l’URL del server MCP di stage o produzione previsto

Se il problema persiste, registra il nome dell’app, l’ambiente, il passaggio non riuscito, l’ora e il messaggio di errore visibile prima di contattare il team di Beta. Non includere segreti o dati sensibili dei clienti.

recommendation-more-help
llm-apps-help-main-toc