Configurare le variabili e i segreti dell’app app-variables

Utilizza variabili e segreti per configurare l’app senza valori di codifica fissa nei relativi gestori di azioni. Ad esempio, configura l’URL API del catalogo dei prodotti per utilizzare un servizio di test in Stage e il servizio live in Produzione senza modificare il codice del gestore.

Le variabili contengono impostazioni non sensibili. I segreti sono destinati a valori sensibili come le chiavi API e i token di accesso.

In questa guida: Scopri come aggiungere una variabile app e leggerla in un gestore azioni. Distribuisci l’app e verifica che il gestore utilizzi il valore previsto.

Prima di iniziare before-you-begin

Hai bisogno di:

Per verificare la versione, esegui il seguente comando nell’archivio del gestore:

npm ls @adobe/llm-apps-runtime

Se la versione è precedente alla 1.1.0, aggiornarla, quindi eseguire il commit e il push di package.json e package-lock.json:

npm install @adobe/llm-apps-runtime@latest

Gestisci variabili manage-variables

Ogni ambiente, Stage o Produzione, ha le proprie variabili. Controllare Workspace prima di aggiungere, aggiornare o eliminare una variabile. Le modifiche diventano effettive la prossima volta che distribuisci l’app in tale ambiente.

Aggiungi una variabile add-variable-to-app

In questo esempio viene utilizzata la variabile non sensibile GREETING_PREFIX con il valore Good day per ignorare il messaggio di saluto predefinito del gestore Hello. L’aggiunta di una variabile non modifica automaticamente un’azione: il gestore deve leggere la variabile.

Passaggio 1: aggiungere una variabile nell’interfaccia utente add-a-variable

La variabile viene visualizzata nella tabella con la relativa data Name, Type, Value e Last updated. Per copiare il valore, utilizzate il controllo Copia adiacente.

Passaggio 2: leggere la variabile nel gestore use-a-variable

Nel repository del gestore, aprire actions/<action-name>/index.js. Assicurarsi che il gestore accetti un secondo argomento, extra, e legga la variabile con getVariable:

const { getVariable } = require('@adobe/llm-apps-runtime');

module.exports = async ({ name = 'there' } = {}, extra) => {
  const prefix = getVariable(extra, 'GREETING_PREFIX') || 'Hello';

  return {
    content: [{ type: 'text', text: `${prefix}, ${name}!` }]
  };
};

Con il valore Good day, una chiamata con name impostato su Ada restituisce Good day, Ada! invece del valore predefinito Hello, Ada!. Se in seguito si modifica il valore in Howdy, il messaggio di saluto cambia dopo la ridistribuzione, senza un’altra modifica del gestore.

Il nome nel codice deve corrispondere esattamente al nome nell’interfaccia utente. Se la variabile non è impostata, getVariable restituisce undefined. Scegli un valore predefinito appropriato, come nell’esempio, oppure restituisce un errore chiaro se l’azione richiede l’impostazione.

Quando le modifiche del gestore sono pronte, esegui il commit e inviale all’archivio del gestore dell’app. La distribuzione successiva utilizza il codice push più recente. Per ulteriori informazioni sulla modifica dei gestori, vedere Personalizzare un gestore generato.

Passaggio 3: distribuire e testare deploy-and-verify

Per configurare l’altro ambiente, selezionare l’ambiente in Workspace, ripetere l’installazione con il valore appropriato, quindi distribuire e testare l’app.

Aggiornare una variabile update-or-delete

L’aggiornamento di una variabile ne modifica solo il valore. impossibile rinominare le variabili. Per utilizzare un nome diverso, elimina la variabile esistente, aggiungi una nuova variabile e aggiorna il gestore per leggere il nuovo nome.

Eliminare una variabile delete-a-variable

Regole e limiti good-to-know

Risoluzione di problemi verify-configuration

Passaggio successivo whats-next