DocumentaçãoAplicativos de LLM

Atualizar um aplicativo existente upgrade-existing-app

Última atualização: 13 de novembro de 2026
IMPORTANT
Aplicativos LLM está disponível para todos os clientes do AEM Sites Cloud Service para desenvolver e gerenciar seus próprios aplicativos. Depois que a medição for iniciada, cada chamada de aplicativo será contabilizada nas Solicitações de conteúdo do AEM Sites do cliente. A Adobe anunciará a taxa de medição e a data de início antes de a medição entrar em vigor.

Use este guia somente se o aplicativo usar o @adobe/llm-apps-runtime anterior à versão 1.2.0 ou se os widgets EDS usarem o SDK Aplicativos LLM anterior à versão 0.1.13. Os aplicativos que já atendem a ambos os requisitos podem prosseguir diretamente para Configurar Adobe Analytics e Customer Journey Analytics.

Neste guia: saiba como atualizar e verificar o tempo de execução de um aplicativo mais antigo e o EDS SDK. Em seguida, retorne ao guia de configuração do Analytics para ativar o Analytics e verificar a coleta.

Antes de começar before-you-begin

Você precisa acessar o repositório do manipulador e, para aplicativos com widgets EDS, o repositório EDS vinculado ao seu aplicativo. Se seu aplicativo usa a infraestrutura gerenciada do LLM Apps, solicite acesso ao código antes de fazer atualizações. Consulte Usar LLM Apps infraestrutura gerenciada.

Não é necessário criar outro aplicativo. Atualize somente os componentes abaixo das versões compatíveis. Você pode reutilizar a configuração existente do Adobe que atende aos requisitos de configuração do Analytics.

Para aplicativos com widgets EDS, publique e verifique a atualização do SDK primeiro, depois mescle a atualização do tempo de execução e reimplante o aplicativo. As duas atualizações do repositório podem ser preparadas independentemente, mas ambas devem estar disponíveis antes de você testar a implantação habilitada para análise.

Verificar e atualizar o Repositório de Ações dos Aplicativos LLM upgrade-runtime

  1. Abra o repositório do manipulador vinculado ao seu aplicativo e instale as dependências dele:

    code language-bash 
    npm install

  2. Verifique o tempo de execução instalado:

    code language-bash 
    npm ls @adobe/llm-apps-runtime

  3. Se o tempo de execução for anterior à versão 1.2.0, instale a versão atual:

    code language-bash 
    npm install @adobe/llm-apps-runtime@latest
npm ls @adobe/llm-apps-runtime

    Confirme se a versão instalada é a 1.2.0 ou posterior. Mantenha uma versão compatível mais recente se o aplicativo já usar uma.

  4. Confirme se a dependência do tempo de execução e sua versão resolvida atendem ao requisito mínimo. A própria versão do aplicativo é separada da dependência do tempo de execução.

  5. Execute as verificações do repositório. Para o padrão de referência Aplicativos LLM:

    code language-bash 
    npm test -- --runInBand
npm run build
npm run lint

    Investigue as falhas antes da implantação. Se uma verificação já falhar na versão original, registre essa linha de base separadamente de todas as falhas introduzidas pela atualização. Uma build local bem-sucedida não verifica a coleção de análises.

  6. Confirme a atualização da dependência e seu arquivo de bloqueio, em seguida, envie e mescle a atualização na ramificação padrão do repositório do manipulador, geralmente main. A implantação clona essa ramificação. Uma atualização que existe apenas localmente ou em uma ramificação de recurso não mesclada não é incluída na implantação.

    Quando um arquivo de bloqueio existe, a implantação instala dependências com npm ci, que usa as versões gravadas. A reimplantação não atualiza o tempo de execução automaticamente. Antes de reimplantar, confirme a dependência atualizada e a versão resolvida na ramificação padrão do repositório.

Verificar e atualizar o Repositório de Dispositivos de Aplicativos LLM upgrade-sdk

Para aplicativos com widgets EDS, verifique o SDK no repositório EDS, bem como o tempo de execução do servidor. A atualização de um repositório não atualiza o outro.

Alguns repositórios EDS incluem scripts SDK copiados sem uma dependência npm. O navegador carrega esses scripts fornecidos diretamente, de modo que a ausência de uma entrada de pacote não significa que o SDK está ausente. Atualize a distribuição do SDK copiada usando o processo de atualização do SDK do projeto. Adicionar uma dependência npm persistente não é necessário para um projeto que mantém o SDK como scripts copiados.

Para projetos que gerenciam o SDK por meio do npm:

  1. Na raiz do repositório EDS, instale o SDK atual e confirme sua versão:

    code language-bash 
    npm install --save-dev @adobe/llmapps-sdk@latest
npm ls @adobe/llmapps-sdk

    Use 0.1.13 ou posterior. Mantenha uma versão compatível mais recente se o projeto já usar uma.

  2. Verifique se a instalação atualizou a distribuição do SDK fornecida. O gancho de instalação substitui os scripts SDK copiados, portanto, revise as personalizações locais antes de confirmar. Atualizar apenas a declaração de dependência não atualiza os scripts que o EDS fornece. Consulte Instalar o SDK de Aplicativos LLM.

  3. Execute as verificações do repositório EDS, como npm run lint, e verifique se um widget existente ainda é renderizado e responde às interações.

  4. Confirme a distribuição do SDK atualizada junto com qualquer dependência e atualizações de arquivo de bloqueio. O EDS fornece os scripts copiados, não diretamente o pacote npm instalado.

Após qualquer um dos métodos de atualização, envie e mescle a atualização com a ramificação EDS usada pela URL do script da ação. Verifique se o URL serve o SDK atualizado e se suas bibliotecas de suporte foram carregadas com êxito. Se o URL usar o site do EDS ativo, conclua as etapas de publicação desse site.

Próxima etapa next-step

Retorne a Configurar Adobe Analytics e Customer Journey Analytics. Todos os aplicativos devem habilitar o Analytics e implantar para coletar eventos; atualizar o tempo de execução ou o SDK sozinho não habilita a coleção.

Depois de salvar as configurações do Analytics, implante no Palco e verifique novos eventos de chamada de ação e interação de widget antes de implantar na Produção. Confirme se a ação e o widget ainda estão funcionando e se uma única seleção de link produz um evento de interação de widget.

O Analytics começa a coletar novas interações após a implantação habilitada para análise. A atualização não reconstrói interações que ocorreram antes da habilitação da coleção.

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