Avaliar e aprovar o Agente de modernização de experiência evaluate
Esta página é para a pessoa que aprova o Agente de modernização de experiência para uma equipe que cria ou migra sites do Adobe Experience Manager no Edge Delivery Services: um arquiteto, líder técnico ou proprietário de plataforma que pode nunca usar o agente pessoalmente. Ele explica quais mudanças ocorrem para sua equipe, as três formas de executar uma migração, como a equipe da Adobe trabalha com a sua equipe, quais sistemas e dados o agente toca, como as alterações são controladas e rastreadas e o que permanece funcionando no projeto.
Para saber o que é o Edge Delivery Services e como um projeto se encaixa, consulte Como seu site é criado e atualizado. Um resultado em suas próprias páginas informa mais do que qualquer descrição, portanto, peça a um membro da equipe para iniciar com o modo Automático ou importar uma página passo a passo enquanto você lê.
Alterações para a sua equipe team-impact
Sem o agente, uma migração para o Edge Delivery Services começa com semanas de trabalho de desenvolvedor antes que qualquer pessoa possa julgar o resultado: listar as páginas de origem, agrupá-las por layout, mapear o conteúdo para blocos, escrever código de bloco e estilos e escrever scripts de importação. O agente faz esse trabalho repetitivo com sua equipe, em um ambiente hospedado sem nada para instalar.
- A sua equipe decide e analisa; o agente produz. As pessoas definem o escopo, o modelo de conteúdo, o design do target e as integrações e aceitam o resultado. O agente grava o código, importa o conteúdo e compara o resultado com a origem.
- Mais pessoas contribuem diretamente. Designers, especialistas em conteúdo e profissionais de marketing que conhecem alguns HTML e as noções básicas do Git fazem alterações descrevendo-as em linguagem simples. Os desenvolvedores mantêm o controle do que atinge a produção, revisando essas alterações como solicitações de pull. Consulte Contribuição Mais Ampla, Mesmo Controle De Produção.
- O esforço aumenta com layouts, não com páginas. Uma correção altera um bloco reutilizável ou script de importação em vez de uma página, de modo que se aplica a todas as páginas do mesmo layout. Um site de 5.000 páginas que compartilham 12 layouts é, em sua maioria, trabalho de 12 modelos. Consulte Como o Agente Migra em Escala e para dimensionar o trabalho a partir dos primeiros modelos, Estimar Antes de Confirmar.
- O resultado é um projeto padrão. O código é HTML, CSS e JavaScript simples no repositório Git, seguindo as convenções da matriz do AEM. O site não depende do agente no tempo de execução, e os desenvolvedores podem continuar em seu próprio editor ou com outras ferramentas de IA.
- O conhecimento do projeto permanece no repositório. As convenções em que sua equipe concorda residem no
AGENTS.mde em arquivos relacionados, que o agente e os novos membros da equipe seguem. Consulte Instruções e memória do projeto.
O que o agente faz e o que sua equipe faz responsibilities
Para saber como o lead de migração coordena os colaboradores, consulte Liderar a Migração. Várias pessoas podem trabalhar em um projeto, cada uma em seu próprio espaço de trabalho de console; consulte Trabalhar como uma equipe.
O que resta do trabalho do projeto project-work
O agente é um agente de desenvolvimento: o que pode ser construído no Edge Delivery Services pode ser construído com ele. No entanto, uma migração copia o que as páginas de origem mostram, não os sistemas por trás delas. O agente reconstrói o site: suas páginas, blocos, estilos e o código que chama seus serviços. Os fluxos de trabalho de aprovação e publicação, os sistemas de back-end por trás das integrações e como suas equipes trabalham no novo site permanecem como trabalho de sua organização. Estas necessidades exigem uma decisão da sua equipe para que o agente possa criá-las:
Para acesso de origem, conteúdo interativo e outros limites da importação, consulte Limitações.
Figma e sistemas de design figma
Figma pode ser a fonte de um novo design. Com o complemento de importação do Figma, o agente lê o componente ou quadro selecionado por meio da API do Figma, usando um servidor MCP (Model Context Protocol), da mesma forma que um desenvolvedor lê uma entrega de design. Ele escreve as variáveis e os estilos do design, como cores, tipografia e espaçamento, como propriedades personalizadas CSS nos estilos globais do projeto. Essas propriedades são os tokens de design do site. Eles residem no código, não em uma exportação de token separada, portanto, os designers e desenvolvedores os analisam como qualquer outra alteração. Para saber como os designers trabalham do Figma com o agente, consulte Trabalhar com um Figma Design.
O que aprovar:
- Acesso: cada pessoa que usa o Figma com o agente cria um token de acesso pessoal do Figma com escopos somente leitura e o armazena nas configurações do console. O Figma emite e rege esse token de acesso, que não tem nada a ver com tokens de design. Não há conexão Figma em toda a organização e um token de acesso pessoal não pode ser limitado a arquivos específicos: ele lê todos os arquivos que seu proprietário pode abrir.
- Limites de vagas e taxa: O Figma limita a frequência com que um token pode ler arquivos, com base na vaga do proprietário do token e no plano que possui o arquivo. Com um assento View or Collab, um token pode ler arquivos por meio da API do Figma apenas algumas vezes por mês, então as pessoas que usam o Figma com o agente precisam de um assento Dev ou Full. Consulte limites de taxa do Figma.
- Dados: Para o quadro ou componente selecionado, o agente envia sua estrutura, uma captura de tela, suas variáveis e seu texto para o modelo de IA. Consulte O que o modelo de IA processa.
Escolha como a migração é executada approaches
O mesmo agente pode executar uma migração de três maneiras. Eles diferem em quem orienta o agente e quem responde pelo resultado. Todos os três produzem um projeto padrão do Edge Delivery Services, com código em um repositório Git e conteúdo que os autores editam, para que você possa mudar de um para o próximo: transfira um resultado do modo Automático para seu próprio site e continue no console ou continue com o agente por conta própria após um envolvimento com os engenheiros de resultados de agências.
A equipe por trás do agente adobe-team
Quando você escolhe o agente, você também escolhe a equipe que o constrói e a direção que ele vai tomar. Como as pessoas encontram informações na Web está mudando: mais pessoas perguntam a um assistente de IA, que responde a partir do que lê no próprio site da marca. E um agente pode alterar o conteúdo, o design e o código de um site, de modo que uma alteração que tenha sido necessária em um projeto possa levar horas. A missão da equipe é ajudá-lo a migrar para o Edge Delivery Services, aproveitar ao máximo o Experience Manager e usar ferramentas de desenvolvimento agênico para criar sites que permaneçam relevantes à medida que essas mudanças continuarem. Seu trabalho com você não termina na migração e o agente continua mudando; as notas de versão listam cada alteração.
Quando as mudanças são baratas, a parte difícil é decidir o que mudar, mantê-las controladas e fornecer ao agente a marca, o design e o contexto comercial corretos. Esse conhecimento se encaixa em suas equipes e sistemas. A equipe da Adobe ajuda você a conectá-lo à plataforma:
- Engenheiros que podem executar a migração com você. Para uma migração complexa, os engenheiros de resultados agenciais da Adobe podem operar o agente com sua equipe e entregar o site para ela. Consulte Escolher como a Migração é Executada.
- Atual à medida que o produto muda. O aviso Novidades do console lista os destaques de cada versão. Para aplicar uma alteração ao seu próprio site, revisar sua arquitetura ou discutir uma necessidade que o agente ainda não atende, peça ao gerente de sucesso do cliente ou à equipe de conta da Adobe para uma reunião com especialistas no assunto e a equipe de produtos.
- A sua experiência molda o produto. A equipe de produtos troca experiências com clientes e parceiros e trabalha com alguns deles em novos recursos. O que você relata alimenta o que a equipe corrige e cria a seguir.
Para contatar a equipe pelo console, use Solicitar suporte ou Obter ajuda nas páginas do modo Automático. Sua mensagem vai diretamente para a equipe que cria o agente, que procura e acompanha por email. Consulte Solicitar Suporte e, para saber o que uma solicitação compartilha, Solicitações de Suporte.
A equipe da Adobe trabalha da mesma forma com os parceiros de implementação, para que o site continue melhorando após a migração.
Sistemas e fluxo de dados systems
O agente funciona em um ambiente hospedado e alcança seus sistemas somente por meio de conexões configuradas por pessoas e permissões concedidas por elas.
aemcoder.adobe.io onde as pessoas trabalham com o agente.aem.page e o site ativo em aem.live.Segurança e manuseio de dados security
O console permite que o agente trabalhe no site sem fornecer as credenciais configuradas e você decide quando as alterações chegam ao repositório Git e ao destino de conteúdo.
Acesso e isolamento security-access
- Você faz logon no console com sua Adobe ID. Cada solicitação é autenticada com o Adobe Identity Management Services (IMS).
- Cada usuário trabalha em um ambiente de back-end separado com seu próprio armazenamento de espaço de trabalho, um em cada organização da Adobe com a qual faz logon. O console cria o ambiente quando o usuário entra pela primeira vez e o pausa quando está ocioso.
- O console não tem funções de projeto. Qualquer pessoa com acesso pode solicitar ao agente qualquer alteração em seu próprio espaço de trabalho. A Experience Manager e seu provedor Git continuam a aplicar suas próprias permissões para qualquer código ou conteúdo que saia do espaço de trabalho.
Credenciais security-credentials
- O agente de IA não recebe as credenciais configuradas no console. Os tokens para GitHub, repositórios Git da Cloud Manager, Experience Workspace, Figma e sites de origem protegidos são mantidos fora do ambiente do agente. Um componente separado adiciona cada credencial somente às solicitações do serviço ao qual pertence. O mesmo se aplica à credencial usada para chamar o modelo de IA.
- As credenciais pertencem ao usuário que as configura, não ao projeto. Cada membro da equipe conecta sua própria conta Git e armazena seu próprio token Figma.
- Permissões de agente ficam desativadas até que você as ative. Ativar um permite que o agente aja com esse acesso, por exemplo, para enviar para o repositório sem ver a credencial. Por padrão, uma permissão usa a entrada do próprio usuário. Para limitar o que o agente pode acessar, insira um token para ele: um token de acesso pessoal refinado com escopo para os repositórios necessários ou o token de uma conta de serviço da Adobe.
- Outros serviços que o agente chama enquanto funciona, como uma API de teste, obtêm suas credenciais da mesma maneira a partir de uma entrada em Autenticação de site protegida para o nome de host do serviço. Consulte Credenciais para Outros Serviços.
- Armazene credenciais somente nas configurações do console, nunca em prompts, bate-papo, conteúdo de origem ou arquivos de projeto: o agente lê esses itens e pode enviá-los para o modelo de IA. Torne isso parte da integração, pois as pessoas que são novas nos agentes de codificação podem colar uma senha ou chave no chat para realizar uma tarefa. Peça a todos que usam o console que leiam Manter segredos fora do bate-papo primeiro e digam quais são as políticas da sua organização que permitem que eles compartilhem com as ferramentas de IA.
O que o modelo de IA processa security-model-data
Para executar sua solicitação, o agente pode enviar o seguinte para o modelo de linguagem grande (LLM) que ele usa, atualmente um modelo Claude:
- Seus prompts e instruções.
- URLs de página, marcação e conteúdo do Source, ou conteúdo do CMS exportado.
- Código e configuração do repositório, como blocos, estilos e configuração do site.
- Referências de design e marca, como designs Figma e capturas de tela.
- Conteúdo e código gerados em revisão.
A Adobe não usa suas conversas ou outros dados do cliente para treinar ou ajustar modelos de IA.
Controle de alterações security-control
O agente funciona no espaço de trabalho do console, onde você revisa as alterações e a pré-visualização. O trabalho chega ao seu site em etapas separadas e cada etapa tem seu próprio controle:
- As próprias verificações do console são proteções, não portas de aprovação. O modo de plano opcional permite aprovar um plano antes que o agente seja iniciado. O console também impede que o agente faça upload, pré-visualização ou publicação, a menos que sua mensagem atual solicite ou você concorde quando o agente solicita, mas ele não consegue detectar todas as maneiras de fazer tal solicitação. Nenhuma das verificações impede uma pessoa com acesso de enviar ou publicar.
- Com uma permissão Git, o agente pode enviar para qualquer ramificação na qual suas credenciais possam gravar, incluindo
main. Um push paramainaltera o código do site ativo. - Para exigir revisão, aplique-a onde a alteração chega. Proteja
maincom proteção de ramificação que requer uma solicitação de pull revisada, envie por push com Criar nova PR e limite quem pode publicar com a função de publicação do site. A solicitação de pull lista os arquivos alterados e os URLs de visualização das páginas afetadas, para que um desenvolvedor verifique o resultado antes de mesclar. Configure esses controles antes que mais pessoas contribuam e ative as permissões do agente somente quando uma tarefa precisar deles. Consulte Contribuição Mais Ampla, Mesmo Controle De Produção. - Tratar páginas de origem e arquivos de design como entrada não confiável. Eles podem conter texto que tenta orientar o agente. Revise as alterações antes de enviá-las, visualizá-las ou publicá-las.
Permissões de push de conteúdo content-push-permissions
Ao carregar conteúdo usando o logon da Adobe, o destino impõe as permissões da conta. Para conteúdo baseado em documentos editado no Experience Workspace, é necessário acesso de gravação ao conteúdo de destino. Para criação no Experience Manager, é necessário ter permissão para gravar páginas e ativos nos caminhos selecionados na instância do autor. Fazer logon no console não concede esses direitos.
Quando você ativa a permissão de credenciais do Adobe do agente, seu conteúdo é enviado para o repositório de conteúdo baseado em documentos e usa o acesso da sua conta. Solicitar que o agente faça upload não ignora as permissões do destino. Para criação no Experience Manager, faça upload do conteúdo sozinho através do console; os uploads diretos de agentes não são suportados.
Se um upload baseado em documento usar uma conta de fallback configurada porque seu logon não está disponível ou a autenticação falha, o destino aplicará as permissões dessa conta. O mesmo se aplica quando você configura explicitamente uma conta de serviço para o agente. Confirme qual conta é usada antes de confiar em suas permissões pessoais para limitar as alterações.
Rastrear o que o agente fez audit-trail
O console não mantém um registro de auditoria separado, mas o trabalho do agente não fica sem registro. O que o agente produz chega ao seu site somente por meio do repositório Git ou da Experience Manager e ambos mantêm um histórico:
- O código é o registro principal. O histórico do Git registra cada alteração nos blocos, estilos e scripts de importação, e os scripts de importação definem a estrutura de cada página importada.
- As alterações de conteúdo são gravadas com o conteúdo. A Experience Workspace mantém um histórico de versões de cada documento e a instância do autor mantém suas próprias versões de página.
- A conversa mostra o que foi solicitado. Baixar chat salva a conversa como um arquivo Markdown. Baixe antes de selecionar Limpar chat, que remove as mensagens e não pode ser desfeita. Consulte Painel de Chat.
O registro é mais fácil de seguir quando cada solicitação ao agente termina em sua própria confirmação, enviada para uma ramificação de trabalho, em vez de main, e, quando as páginas forem alteradas, seu próprio carregamento de conteúdo, que o agente oferece e uma pessoa aprova. Solicite isso no AGENTS.md do projeto; consulte Deixar um Registro de Cada Solicitação. Os revisores leem o que o agente alterou, solicitação por solicitação, nas ferramentas que já usam.
Onde Seu Trabalho Está Armazenado security-storage
- O código que você envia é armazenado no repositório Git e o conteúdo que você carrega é armazenado no Experience Workspace ou na instância do autor. Suas próprias políticas de retenção e de histórico de versões se aplicam.
- O trabalho que você não enviou ou carregou existe apenas no espaço de trabalho do console, juntamente com o histórico do chat e as transcrições das sessões do agente. Limpar chat remove as mensagens do painel de chat, mas mantém as transcrições. Para excluir o trabalho do projeto aberto no espaço de trabalho do console, incluindo as transcrições, use Redefinir espaço de trabalho.
Para obter locais de processamento, retenção de dados e informações de conformidade, entre em contato com a equipe de conta da Adobe ou consulte a Central de Confiabilidade da Adobe.
Health Data e HIPAA security-hipaa
O Agente de modernização de experiência é uma ferramenta de desenvolvedor para migrar e criar sites. Os visitantes do site nunca o acessam: o Edge Delivery Services disponibiliza o site publicado e as solicitações dos visitantes não passam pelo console nem pelo agente. É possível migrar páginas, designs e ativos de um site da área de saúde sem os dados do paciente. Nunca forneça ao agente dados reais do usuário final, como registros de pacientes ou credenciais de seus usuários, e não migre páginas ou ativos que os contenham. Use dados fictícios para desenvolver e testar layouts específicos do paciente. O que você fornecer ao agente pode alcançar o modelo de IA. Consulte O que o modelo de IA processa.
Um site de preparo, incluo na lista de permissões ou logon de origem não altera essa restrição. Antes de importar uma origem protegida, verifique as páginas e os ativos no escopo e restrinja a conta de origem ao conteúdo sem informações de integridade protegidas (PHI). Configure essa conta através da autenticação de origem, não no chat.
Em um site que processará PHI de acordo com a HIPAA (Health Insurance Portability and Accountability Act, Lei de Portabilidade e Responsabilidade do Seguro de Saúde), confirme a configuração de criação e entrega com a equipe de conta da Adobe, incluindo a licença necessária, o BAA (Business Associate Agreement, Contrato de Parceiro Comercial) e a configuração. A preparação para HIPAA no Adobe Experience Manager as a Cloud Service lista o Edge Delivery Services como HIPAA pronto, mas o Editor Universal não como HIPAA pronto; ele pode ser adicionado a um Programa de Segurança Estendida somente quando nenhuma PHI é introduzida. Um serviço de entrega pronto para HIPAA não estende sua cobertura de PHI ao agente ou a um editor que não esteja pronto para HIPAA.
Solicitações de suporte security-support
Uma solicitação de suporte será enviada para a equipe da Adobe que cria o agente. Com o tópico e a descrição gravados pelo remetente, ele compartilha:
- O nome, o endereço de email e as IDs de usuário e de organização da Adobe.
- A ID da sessão, o nome do projeto, o URL de visualização e o host Git do GitHub Enterprise.
- Quaisquer prompts recentes que o remetente optar por anexar. Nenhum é anexado por padrão.
Esses detalhes permitem que a equipe encontre a conversa e os registros da sessão. Antes da configuração do espaço de trabalho do console do remetente, uma solicitação compartilha somente o nome, o endereço de email e a organização. Nas páginas do modo Automático, o Get help compartilha somente o nome e o endereço de email do remetente com sua mensagem. Peça aos usuários que não incluam senhas, tokens ou dados pessoais na descrição. Consulte Solicitar Suporte.
Próximas etapas next-steps
Depois que sua equipe concordar com o escopo, a abordagem e os controles, siga Migrar um site de produção. Use o Modo automático para fazer uma primeira verificação em suas próprias páginas antes de confirmar esse trabalho.