DocumentaçãoAplicativos de LLM

Resolução de problemas troubleshooting

Ú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.

Comece com o sintoma observável. Não compartilhe credenciais, tokens, URLs de MCP privados ou resultados confidenciais de manipuladores durante a solução de problemas.

Criação e geração de ação do aplicativo

Sintoma
O que tentar
LLM Apps falha na configuração da infraestrutura gerenciada
Leia o erro em Falha na instalação e selecione Repetir. Se a página não puder verificar o progresso, selecione Verificar novamente; a instalação continua em segundo plano
Nenhum programa do AEM está disponível
Solicite acesso ao programa ao administrador. Se o carregamento falhar, selecione Repetir carregamento de programas
Novos repositórios não são exibidos
Adicione o repositório ao programa Cloud Manager como um repositório privado e aguarde o status ser Pronto e reabra a lista de repositórios. Repositórios hospedados pelo Adobe no Cloud Manager não são compatíveis
Nenhum site do Edge Delivery Services vinculado
Um repositório de widgets que não esteja no GitHub deve ser vinculado a um site EDS no Cloud Manager com o Bring Your Own Git. Vincule-o e selecione Validar repositório novamente. Consulte Traga seu próprio Git
Falha na validação do repositório de ações ou widgets
Use um projeto existente compatível ou um repositório vazio. Use repositórios separados para ações e widgets e selecione Validar repositório novamente
Falha na configuração do site ou na validação de acesso do AEM (repositório de widgets do GitHub)
Siga Configurar o acesso ao site do AEM. Para uma nova instalação da Sincronização de código, conclua o assistente de página de confirmação. Para um site existente, mantenha a instalação e peça a um administrador de site para conceder acesso à conta do Adobe admin por meio do Administrador de Usuários do AEM. Confirme se a Sincronização de Código cobre o repositório do widget e selecione Validar configuração do AEM
É necessário acesso de gravação do DA
Solicite a um administrador de organização do DA que conceda acesso de gravação à conta do Adobe usada em aplicativos LLM para todo o conteúdo do site. Siga Conceder acesso de gravação do DA, entre com essa conta e selecione Validar configuração do AEM. As funções de site do AEM não concedem permissões do DA
Não foi possível verificar o acesso ao AEM ou ao DA
Tente Validar a configuração do AEM novamente para obter uma falha de verificação temporária. Se, em vez disso, a mensagem relatar uma negação de acesso, corrija as permissões do AEM ou DO usando as instruções acima antes de tentar novamente
A criação do aplicativo não gerou ações
A criação do aplicativo só configura a infraestrutura. Na página do aplicativo, selecione Criar ações automaticamente, insira Seu site e selecione Criar minhas ações. Consulte Criar ações
As ações ainda estão sendo geradas
A interface do usuário estima até 30 minutos para geração. Siga o progresso na página Ações ou saia da página e retorne posteriormente
Falha na geração de relatórios de ação
Confirme se o site é público por HTTPS e, para seus próprios repositórios, se o acesso ao repositório ainda é válido. Entre em contato com a equipe de aplicativos LLM com a mensagem de erro visível se o problema persistir

Ações e manipuladores

Sintoma
O que tentar
A ação não foi invocada
Habilite o plug-in ou conector do aplicativo na conversa. Confirme se a opção Expor ao modelo de IA nas configurações de ação e a opção Visibilidade da ação na página do aplicativo estão ativadas. Melhorar a descrição e reimplantar alterações de metadados
Resposta vazia ou de erro
Execute npm test e chame o manipulador com o Inspetor MCP ou curl. Consulte Desenvolvimento e teste de manipulador local
O manipulador funciona localmente, mas não após a implantação
Verifique a confirmação enviada mais recentemente, confirme a configuração de tempo de execução e verifique se o identificador do código de ação corresponde a actions/<code-identifier>/index.js
A ação gerada não pode ser marcada como revisada
Confirme a geração do manipulador e widget com êxito. Verifique se há conflitos de mesclagem nas solicitações de pull ou ramificações geradas, recarregue a ação e selecione Marcar como revisado novamente. Com seus próprios repositórios, se a revisão solicitar que você mescle uma ramificação, mescle-a com o processo normal primeiro

Widgets

Sintoma
O que tentar
O dispositivo não é renderizado
Verificar o URL do script, o URL do widget, a publicação HTTPS, os domínios da CSP e os cabeçalhos do CORS
O widget é renderizado, mas não mostra dados
Chame o manipulador com o Inspetor MCP e compare sua forma structuredContent com os campos lidos de bridge.toolResult
O widget funciona em visualização direta, mas não no ChatGPT
A visualização direta pode usar dados de amostra. Teste o resultado do manipulador implantado e verifique se a origem do EDS é permitida pelo CORS e pelo CSP
Solicitação de navegador bloqueada
Adicione somente a origem necessária ao campo CSP correto e reimplante
O Editor de Cabeçalhos HTTP não pode salvar a configuração
Use o Serviço de Configuração do AEM ou peça ao administrador do EDS para inicializar a configuração dos cabeçalhos do site

Não registre em log os valores bridge.toolResult concluídos quando eles puderem conter dados pessoais ou confidenciais.

Extensões da ChatGPT

Para pontos de entrada ausentes, problemas do visualizador de arquivos, URLs de ícone inválidos, configurações de exibição ou erros de menção do compositor, consulte Solução de problemas de extensões ChatGPT. Verifique o suporte ao cliente antes de alterar o aplicativo: uma conexão funcional não significa que todas as extensões sejam compatíveis com esse cliente.

Implantação

Sintoma
O que tentar
Falha na implantação durante Preparando
Verifique se o repositório do manipulador está vinculado e se o acesso ao Adobe Developer Console ainda é válido
Falha na implantação durante Compilar aplicativo
Executar npm install, npm test e npm run build localmente. Corrija dependências, sintaxe ou falhas de teste e envie as alterações
A implantação foi bem-sucedida, mas as alterações estão ausentes
Confirmar se a confirmação esperada foi enviada e reimplantar no mesmo ambiente
A ação permanece Não implantada
Implantar novamente depois de revisar a ação ou alterar seus metadados

Autenticação authentication

Aplica-se quando Habilitar autenticação está ativado. Consulte Autenticar usuários finais com seu próprio provedor de identidade.

Sintoma
O que tentar
As ações ainda são públicas depois de salvar as configurações
Implante o aplicativo novamente nesse ambiente. As alterações de autenticação têm efeito na próxima implantação
As configurações parecem incorretas após alternar os ambientes
Confirme se o seletor de Workspace mostra o ambiente pretendido. O Estágio e a Produção estão configurados independentemente
A entrada não inicia
Confirme que você implantou o aplicativo após habilitar a autenticação e que a ação usa Obrigatório. Uma ação Opcional só é solicitada quando seu manipulador solicita entrada
A plataforma envia o usuário para a página de entrada errada
Verifique se Emissor corresponde exatamente à URL do emissor do seu provedor de identidade e se ela pode ser acessada por HTTPS público
O logon foi bem-sucedido, mas todas as chamadas ainda foram rejeitadas
Confirme se o provedor de identidade emite tokens cujo público-alvo é o URL do servidor MCP do aplicativo para esse ambiente e que o token é um JWT assinado com um algoritmo assimétrico. Consulte Requisitos de token
O provedor de identidade nunca recebe tráfego
A descoberta, a autorização e os endpoints do token do seu provedor devem ser acessíveis por HTTPS público. Verifique um firewall, WAF ou incluo na lista de permissões IP na frente dele — seu aplicativo pode ser acessado enquanto seu provedor não estiver
O provedor de identidade se recusa a emitir um token para o público solicitado
Alguns provedores só emitem tokens para um recurso que está registrado com eles. Confirme se o URL do servidor MCP do aplicativo está registrado como um identificador de recurso em seu provedor de identidade
Um escopo recém-adicionado não é solicitado na entrada
As plataformas LLM armazenam em cache os metadados publicados do aplicativo por alguns minutos. Aguarde e tente fazer logon novamente
O usuário é solicitado a fazer logon novamente para obter um escopo
A ação requer um escopo que o token não carrega. Adicionar o escopo para a concessão do cliente no seu provedor de identidade ou removê-lo da ação
O usuário recebe prompts de entrada repetidos
Um manipulador que retorna extra.challengeAuth() em cada chamada sem verificar a identidade do chamador solicita a entrada novamente após a autenticação. Solicitar autenticação somente quando a identidade necessária à ação estiver ausente
O logon é rejeitado antes que o usuário chegue ao seu provedor de identidade
O URI de redirecionamento que a plataforma LLM enviou não está registrado no servidor de autorização. Algumas plataformas emitem uma diferente para cada conector, portanto, registre o valor mostrado na tela de configuração do conector
Salvar está bloqueado com uma mensagem de escopo sem suporte
Adicione o escopo a Escopos com suporte ou remova-o da ação que o exige
Uma ação pública ainda solicita a entrada em Claude
Verifique se o conector usa Entrar quando necessário, não Entrar agora. Para um aplicativo implantado mais antigo, atualize o tempo de execução e reimplante. Um aplicativo misto no tempo de execução atual deixa ações públicas chamadas anonimamente
Uma ação Opcional retorna o texto de entrada, mas nenhum prompt de entrada Claude
extra.challengeAuth() é um desafio de resultado de ferramenta ChatGPT. Para uma porta de entrada portátil, use uma ação Obrigatório para que o tempo de execução retorne o desafio HTTP que Claude espera
O aplicativo solicita entrada mesmo que cada ação seja Nenhuma
Desative Habilitar autenticação e implante. Enquanto estiver ativado, o aplicativo anuncia um servidor de autorização mesmo quando nenhuma ação é bloqueada

Não cole tokens de acesso, conjuntos de declarações ou segredos de cliente do provedor de identidade em uma solicitação de suporte.

Plug-ins do ChatGPT

Sintoma
O que tentar
O plug-in não aparece
Abra chatgpt.com/plugins, confirme se sua conta ou espaço de trabalho permite servidores MCP personalizados e instale ou conecte o plug-in resultante
Falha na criação do plug-in
Copie novamente a URL completa do servidor MCP HTTPS de Teste o aplicativo e escolha o método de autenticação que corresponda ao aplicativo. Use Sem autenticação somente para um aplicativo público, não como solução alternativa para OAuth com falha
O plug-in se conecta, mas não pode invocar ações
Confirme se o plug-in está anexado ao bate-papo, as ações são expostas ao modelo e a versão mais recente é implantada
O plug-in usa o ambiente errado
Editar ou recriar o plug-in com o URL do servidor de Preparo ou Produção MCP pretendido
O plug-in ainda mostra metadados de ação antigos
Implante as alterações, selecione Atualizar na conexão ChatGPT e inicie uma nova conversa

Se o problema persistir, registre o nome do aplicativo, o ambiente, a etapa com falha, o horário e a mensagem de erro visível antes de entrar em contato com a equipe de aplicativos do LLM. Não inclua segredos ou dados confidenciais do cliente.

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