O que mudou
O A2UI permite que um agente descreva uma interface que a aplicação renderiza com componentes registrados. O modelo pode montar uma tela a partir de um vocabulário aprovado, enquanto a aplicação mantém seus próprios controles e sua linguagem visual. Isso é útil quando uma conversa precisa de opções, formulários ou um resultado estruturado junto com o texto.
O anúncio do Google de 11 de novembro apresenta a primeira versão estável do protocolo, com chamadas bidirecionais de funções e metadados de acessibilidade. Trate essa versão como um contrato a ser avaliado. Um marco do protocolo não comprova, por si só, que uma integração será rápida, acessível ou segura na sua aplicação; esses resultados precisam de evidências no nível da aplicação.
Confira toda a cadeia de compatibilidade
Comece pelo cliente que você realmente distribui. O projeto lista renderizadores para React, Angular, Lit, Flutter e SwiftUI. O anúncio informa que Jetpack Compose e a integração de agentes registrados do Gemini ainda estão na versão 0.9.1, com atualizações previstas; o Lynx oferece suporte à versão 0.9. Registre essa diferença em vez de presumir que o nome de um framework em uma página de apresentação significa compatibilidade com a versão 1.0.
Crie uma linha no inventário para cada cliente implantado: ambiente hospedeiro, pacote do renderizador, protocolo, catálogo e SDK do agente. Fixe as versões que você testar. Se um ambiente existente continuar em um protocolo anterior, mantenha disponível o caminho compatível e encaminhe cada conexão de acordo com a versão suportada. Um conjunto de clientes com versões diferentes precisa de um plano de atualização, e não de uma única data de lançamento para todos.
Trate o catálogo como uma API
O guia de migração documenta mudanças incompatíveis nos catálogos. Revise as regras com um catálogo pequeno e representativo antes de alterar todas as telas. Em especial, substituir globalmente path por @path é incorreto: o guia diferencia os vínculos dinâmicos de outros campos path. Revise o significado de cada campo e guarde exemplos das mensagens usadas pela aplicação antes e depois da mudança.
O registro de um componente ou de uma função estabelece um limite. A permissão para realizar uma operação de negócio estabelece outro. Por exemplo, um controle de confirmação renderizado ainda deve se comunicar com um servidor que verifique o usuário autenticado, a operação solicitada e o estado atual do recurso. Inclua essa autorização de forma explícita na revisão da implementação; não a presuma só porque a interface foi renderizada corretamente.
Faça um teste pequeno e observável
Escolha um fluxo de trabalho reversível e descreva seus estados esperados antes de conectar um modelo. Um primeiro teste útil pode coletar uma preferência e mostrar uma prévia, mantendo qualquer ação com consequências no fluxo de confirmação que a aplicação já utiliza. Limite o conjunto de componentes para que alguém consiga inspecionar todas as interações disponíveis.
O Codorc recomenda as verificações abaixo. São critérios de aceitação propostos, não testes que realizamos com o A2UI:
- Reproduza um conjunto fixo de mensagens válidas e verifique o estado renderizado, não apenas se as mensagens foram interpretadas sem erros.
- Envie um componente desconhecido, uma função não registrada e uma chamada de um emissor não autorizado. Confirme que todos falhem sem executar uma operação de negócio.
- Interrompa a transmissão no meio de um formulário, reconecte e verifique se os valores preenchidos e as ações pendentes continuam compreensíveis.
- Percorra todos os controles com o teclado. Confira o foco após as atualizações, os nomes acessíveis e os anúncios com um leitor de tela.
- Compare a mesma tarefa em cada idioma suportado e na largura de um celular pequeno. Procure rótulos cortados, mudanças de sentido causadas pela ordem e erros de validação difíceis de usar.
- Registre o tempo até uma interface utilizável, as tarefas concluídas, as novas tentativas e o esforço de revisão em comparação com o fluxo existente. Defina uma condição de reversão antes de convidar mais usuários.
Escolha pela interação de que você precisa
O início rápido oficial é um exemplo de aprendizado, não um modelo para produção. Use-o para entender como agente, catálogo, transporte e renderizador se conectam e depois revise quais partes a sua própria aplicação precisa fornecer.
Vale avaliar o A2UI quando um agente precisa combinar controles conhecidos de diferentes formas dentro do seu sistema de design. Para uma tarefa fixa e bem compreendida, um formulário convencional pode continuar sendo mais fácil de testar e manter. Decida com base na interação e nas opções de implantação compatíveis e só amplie o uso quando o teste fornecer evidências.
A data do evento corresponde ao anúncio original. A data de publicação indica quando o artigo apareceu na Codorc.
