A2UI Compose

  
O renderizador de agente para interface (A2UI) do Jetpack Compose oferece uma implementação do protocolo A2UI, permitindo que agentes de IA gerem interfaces do usuário interativas e avançadas que renderizam componentes nativos do Compose sem executar código arbitrário.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
23 de setembro de 2026 - - - 1.0.0-alpha01

Declarar dependências

Para adicionar uma dependência ao A2UI Compose, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

Groovy

dependencies {
    implementation "androidx.a2ui.compose:compose-runtime:1.0.0-alpha01"
    implementation "androidx.a2ui.compose:compose-ui:1.0.0-alpha01"
    androidTestImplementation "androidx.a2ui.compose:compose-ui-testing:1.0.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.a2ui.compose:compose-runtime:1.0.0-alpha01")
    implementation("androidx.a2ui.compose:compose-ui:1.0.0-alpha01")
    androidTestImplementation("androidx.a2ui.compose:compose-ui-testing:1.0.0-alpha01")
}

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.0

Versão 1.0.0-alpha01

23 de setembro de 2026

Lançamento de androidx.a2ui.compose:compose-runtime:1.0.0-alpha01, androidx.a2ui.compose:compose-ui:1.0.0-alpha01 e androidx.a2ui.compose:compose-ui-testing:1.0.0-alpha01. A versão 1.0.0-alpha01 contém estes commits.

Novos recursos

O renderizador de agente para interface (A2UI) do Jetpack Compose oferece uma implementação do protocolo A2UI, permitindo que agentes de IA gerem interfaces do usuário interativas e avançadas que renderizam componentes nativos do Compose sem executar código arbitrário. Essa biblioteca mapeia as mensagens do protocolo A2UI para primitivos do Compose, oferecendo uma reatividade refinada com base no sistema de estado do Snapshot do Compose. A biblioteca também oferece APIs para criar componentes e catálogos personalizados.

Mudanças na API

  • Atualização de A2uiBasicCatalogV1.CatalogId de .../v0_9_1/... para .../v0_9/... para ficar alinhado à especificação canônica do protocolo A2UI. (Idcc20).
  • Atualize a ordem dos componentes em A2uiBasicCatalogV para corresponder exatamente à especificação básica do catálogo. (I23093, b/547851648).
  • Adicionamos ChecksProperty a todas as interfaces de componentes relevantes em A2uiBasicCatalogV1 e disponibilizamos o valor da propriedade por um parâmetro transmitido para TypedContent de cada componente. (I9f393, b/547851648).
  • Os elementos A2uiBasicCatalogV1.ChoicePicker e a MaterialA2uiBasicCatalogV1Defaults.choicePicker foram adicionados. (I875a6, b/547851648)
  • Os elementos A2uiBasicCatalogV1.Modal e a MaterialA2uiBasicCatalogV1Defaults.modal foram adicionados. (Icd553, b/547851648).
  • Renomeação das propriedades em A2uiBasicCatalogV1 para seguir o estilo de nomenclatura pascal-case. (I91512, b/547851648).
  • Adicionamos AccessibilityProperty a todas as interfaces de componentes em A2uiBasicCatalogV1 e disponibilizamos o valor da propriedade por um parâmetro transmitido a TypedContent de cada componente. (I76b80, b/547851648).
  • Adição de A2uiBasicCatalogV1.TextField e MaterialA2uiBasicCatalogV1Defaults.textField. (Ifdaec, b/547851648)
  • Adição de A2uiBasicCatalogV1.Video e MaterialA2uiBasicCatalogV1Defaults.video. (I8595c, b/547851648).
  • Adição de A2uiBasicCatalogV1.AudioPlayer e MaterialA2uiBasicCatalogV1Defaults.audioPlayer. (Ida509, b/547851648)
  • Adicionamos suporte para format e palavras-chave de esquema if-then condicionais em a2ui-model e a2ui-engine, além de atualizar os esquemas de propriedades mínimas e máximas de A2uiBasicCatalogV1.DateTimeInput. (I556d5, b/553193771)
  • Adição de A2uiBasicCatalogV1.Slider e MaterialA2uiBasicCatalogV1Defaults.slider. (Ieb72d, b/547851648)
  • Adição de A2uiBasicCatalogV1.CheckBox e MaterialA2uiBasicCatalogV1Defaults.checkBox. (I84525, b/547851648).
  • Adição de A2uiBasicCatalogV1.Divider e MaterialA2uiBasicCatalogV1Defaults.divider. (I91208, b/547851648)
  • Adição de A2uiBasicCatalogV1.Tabs e MaterialA2uiBasicCatalogV1Defaults.tabs. (Ic33d3, b/547851648)
  • Adição de A2uiBasicCatalogV1.List e MaterialA2uiBasicCatalogV1Defaults.list. (I89f73, b/547851648)
  • Adição de A2uiBasicCatalogV1.Icon e MaterialA2uiBasicCatalogV1Defaults.icon. (I65524, b/547851648).
  • Adição de ProvideActionInterceptor para interceptar ações de componentes filhos. (I6ae69, b/552486965)
  • Adicionamos suporte para anunciar esquemas de catálogo inline em A2uiClientCapabilities e A2uiCoreCatalog. (I973cf, b/537714970).
  • Adição de A2uiBasicCatalogV1.Image e MaterialA2uiBasicCatalogV1Defaults.image. (I673b3, b/547851648).
  • Adição de A2uiBasicCatalogV1.Button e MaterialA2uiBasicCatalogV1Defaults.button. (I5215f, b/547851648)
  • A2uiBasicCatalogV1.Row/A2uiBasicCatalogV1.Column e MaterialA2uiBasicCatalogV1Defaults.row/MaterialA2uiBasicCatalogV1Defaults.column foram adicionados. (Ibcbe7, b/547851648).
  • Adição de parâmetros default aos tipos de enumeração, número e booleano A2uiProperty. (Id509e, b/547851648)
  • Os elementos A2uiBasicCatalogV1.Card e a MaterialA2uiBasicCatalogV1Defaults.card foram adicionados. (Icf604, b/547851648).
  • Os parâmetros isAdditionalPropertiesAllowed e additionalPropertiesSchema foram adicionados a A2uiProperty.nested e A2uiProperty.nestedList. (I72836, b/547815898)
  • Adição dos parâmetros minItems e maxItems à lista de tipos A2uiProperty. (I716d3, b/547798330)
  • Adição dos tipos de propriedade A2uiProperty.enum, A2uiProperty.custom e A2uiProperty.dynamicCustom. (I0647d, b/545522395)
  • Substitua A2uiCoreSurfaceModel por A2uiSurfaceModel em observeA2uiComponentState para garantir que as APIs públicas em androidx.a2ui.compose.runtime não exponham tipos de androidx.a2ui.engine. (Ic45e2, b/544705890)
  • Adicionamos o elemento combinável A2uiTestSurface para montar e testar superfícies e componentes da A2UI de forma isolada. (I03c8a, b/527415570).
  • Agora, A2uiSchema oferece suporte a palavras-chave em cada subclasse, em vez de subclasses dedicadas para oneOf, allOf, anyOf, not, const, default e enum. (I6a6f8).
  • Foram adicionadas APIs de teste para o renderizador A2UI do Compose. (I59c9f, b/527415570)
  • Adição de A2uiReadinessEvaluator e APIs relacionadas. (Ib37d3, b/527415547, b/524122705).
  • Adição de A2uiComponentCollection, A2uiFunctionCollection e A2uiCoreComponentDefinitionCollection, além da atualização das APIs de catálogo para usar as novas coleções. (I96438, b/527415547)
  • Adicionamos uma função de fábrica A2uiMessageParser. (I8596a, b/524122705).
  • Adição da interface de marcador A2uiRuntimeCatalog e APIs em androidx.a2ui.compose.ui para definir componentes e catálogos. (Ibea7a, b/527415547, b/524122705).
  • androidx.compose.runtime:runtime-a2ui movido para androidx.a2ui.compose:compose-runtime. (Ifc7cf, b/524122705)

Correções de bugs

  • A dependência androidx.lifecycle:lifecycle-runtime foi atualizada para 2.10.0. Essa versão é necessária para que as verificações de lint do tempo de execução do ciclo de vida agrupado sejam executadas com o AGP versão 9.5.0-alpha04 ou mais recente. (Id18ea, b/556807521)
  • O compileSdk para bibliotecas do Compose foi atualizado para a versão 37.1. Isso vai exigir a atualização transitiva do compileSdk para todos os apps e bibliotecas que usam o Compose. (I05b0f).
  • Atualizamos o alinhamento horizontal padrão de Column para Alignment.Start em A2UI Basic Catalog V1. Ia1c6db
  • Atualização do alinhamento vertical padrão Row para Alignment.Top em A2UI Basic Catalog V1. If0bca4