Configurar variáveis e segredos do aplicativo app-variables

Use variáveis e segredos para configurar seu aplicativo sem codificar valores nos manipuladores de ação. Por exemplo, defina o URL da API do catálogo de produtos para a qual seu aplicativo chama, usando um serviço de teste no Preparo e o serviço em tempo real na Produção, sem alterar o código do manipulador.

As variáveis mantêm configurações não confidenciais. Os segredos são destinados a valores confidenciais, como chaves de API e tokens de acesso.

Jornada: Adicione uma variável ou segredo → leia-o em seu manipulador → implantar → teste.

Antes de começar before-you-begin

Você precisa:

Para verificar a versão, execute isso no repositório do manipulador:

npm ls @adobe/llm-apps-runtime

Se a versão for anterior à 1.1.0, atualize-a e confirme e envie por push package.json e package-lock.json:

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

Gerenciar variáveis manage-variables

Cada ambiente, Preparo ou Produção, tem suas próprias variáveis. Portanto, verifique o Workspace antes de adicionar, atualizar ou excluir um ambiente. As alterações entrarão em vigor na próxima vez que você implantar o aplicativo nesse ambiente.

Adicionar uma variável add-variable-to-app

Este guia usa uma variável nomeada GREETING_PREFIX com o valor Good day como um exemplo não sensível, substituindo a saudação padrão do manipulador de Hello. A adição de uma variável não altera uma ação automaticamente: o manipulador deve lê-la.

Etapa 1: adicionar uma variável na interface do add-a-variable

A variável aparece na tabela com seu Nome, Tipo, Valor e data da Última atualização. Use o controle de cópia ao lado do valor se precisar copiá-lo.

Etapa 2: leia a variável no seu manipulador use-a-variable

No repositório do manipulador, abra actions/<action-name>/index.js. Verifique se o manipulador aceita um segundo argumento, extra, e leia a variável com 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}!` }]
  };
};

Com o valor Good day, uma chamada com name definida como Ada retorna Good day, Ada! em vez do Hello, Ada! padrão. Posteriormente, se você alterar o valor para Howdy, a saudação será alterada após a reimplantação, sem que outro manipulador seja editado.

O nome no código deve corresponder exatamente ao nome na interface do usuário. Se a variável não estiver definida, getVariable retornará undefined. Decida se sua ação pode usar um padrão adequado, como no exemplo, ou se deve retornar um erro claro, pois requer a configuração.

Quando as alterações do manipulador estiverem prontas, confirme-as e envie-as por push para o repositório do manipulador do aplicativo. A próxima implantação usa o código enviado mais recente. Para saber mais sobre a edição de manipuladores, consulte Personalizar um manipulador gerado.

Etapa 3: implantar e testar deploy-and-verify

Para configurar o outro ambiente, selecione-o no Workspace, repita a instalação com o valor apropriado e, em seguida, implante-o e verifique-o.

Atualizar uma variável update-or-delete

A atualização altera somente o valor. As variáveis não podem ser renomeadas; para usar um nome diferente, exclua a variável existente e adicione uma nova e atualize o manipulador para ler o novo nome.

Excluir uma variável delete-a-variable

Regras e limites good-to-know

Resolução de problemas verify-configuration

O que vem a seguir whats-next