Automatizando o Partner Revenue Measurement (PRM) com Kiro e Amazon Nova Act

Automatizando o PRM com Kiro e Amazon Nova Act

Como usamos o Kiro IDE com o Power do Amazon Nova Act para criar ofertas de Professional Services no AWS Marketplace e configurar o PRM do zero ao product-code em minutos.

Contexto

Por que o PRM e o Novo AWS Partner Central São Importantes

PRM (Partner Revenue Measurement) é o mecanismo que a AWS usa para atribuir receita ao parceiro. É assim que a AWS determina e reconhece seu envolvimento na geração de consumo AWS pelos seus clientes. Seja seu time vendendo serviços profissionais ou soluções SaaS no Marketplace, PRM e Partner Central são obrigatórios para quem é partner da AWS.

O PRM é a maneira que a AWS reconhece seu impacto em cada venda, o que libera acesso a investimentos da AWS, melhora sua visibilidade como partner e fortalece oportunidades de co-sell.

O novo AWS Partner Central integra Marketplace e co-sell em uma só plataforma, com mais segurança e visibilidade operacional. Os parceiros ganham acesso a automações e ferramentas novas para gerenciar oportunidades e atividades de forma mais eficiente.

Se você é um parceiro AWS e migrou recentemente para o novo Partner Central, provavelmente recebeu orientações para:

  1. Criar uma oferta de Professional Services no AWS Marketplace
  2. Obter o product-code gerado
  3. Aplicar a tag aws-apn-id nos recursos dos seus clientes
  4. Monitorar a receita atribuída via Attributed Revenue

O processo parece simples, mas envolve várias etapas manuais no portal: copiar/colar descrições, selecionar categorias, configurar dimensões de pricing. E se você tem múltiplas soluções, o trabalho se multiplica.

Neste post, mostro como automatizamos esse fluxo usando o Kiro (IDE com agente AI da AWS) e o Amazon Nova Act (automação de browser com AI).

O que é o Kiro?

O Kiro é um IDE com agente AI integrado que vai além de autocompletar código. Ele pode:

  • Navegar e entender seu projeto
  • Executar comandos no terminal
  • Conectar-se a serviços AWS via MCP (Model Context Protocol)
  • Usar Powers, extensões que adicionam capacidades especializadas
  • Automatizar tarefas complexas de forma conversacional

Para este caso, usamos o Kiro como orquestrador de todo o processo: desde a leitura das soluções no Partner Central até a geração dos prompts de tagging.

O que é o Amazon Nova Act?

O Amazon Nova Act é um SDK de automação de browser que usa AI para interagir com páginas web como um humano faria. Diferente de ferramentas tradicionais de automação (Selenium, Puppeteer), o Nova Act entende a página visualmente e aceita instruções em linguagem natural.

No Kiro, ele está disponível como um Power chamado nova-act, que expõe um CLI (act browser) para controlar o Chrome programaticamente.

Pré-requisitos

  • Kiro IDE instalado
  • Python 3.10+ disponível no sistema
  • Conta AWS com acesso ao Partner Central e Marketplace Management Portal
  • API Key do Nova Act (gere em nova.amazon.com/act)
  • Logo da empresa em URL pública S3, formato PNG/JPG, 120–640px, ratio 1:1 ou 2:1

Passo 1: Ativar o Power do Amazon Nova Act no Kiro

O Kiro possui um sistema de Powers, extensões que adicionam capacidades especializadas ao agente. O Power do Nova Act permite automação de browser diretamente do chat.

Instalar o Power

  1. Abra o Kiro
  2. Acesse o painel de Powers (ícone de raio na barra lateral ou Command Palette → "Powers")
  3. Busque por "nova-act"
  4. Clique em Install

O Power inclui documentação completa (POWER.md), steering files com guias de uso e integração com o CLI act browser.

Como o Kiro usa o Power

Com o Power instalado, o Kiro reconhece automaticamente quando a tarefa envolve automação de browser, ativa o Power e usa os comandos corretos (execute, fill-form, extract, ask). Você pode ativar explicitamente pedindo no chat:

Ative o power do Nova Act para automação de browser

Configurar o SDK

No terminal do Kiro:

python3 -m venv .venv
source .venv/bin/activate
pip install 'nova-act[cli]'
act browser setup --api-key "sua-api-key-aqui"
act browser doctor

Após a configuração inicial, basta conversar com o Kiro. Por exemplo: "Abra o Partner Central e liste minhas soluções". O Kiro vai ativar o Power, abrir o browser e executar os comandos necessários.

Passo 2: Abrir o browser e autenticar

Como usar: Você não precisa executar comandos manualmente. Basta abrir o Kiro com o Power do Nova Act ativado e pedir em linguagem natural. O prompt sugerido para cada etapa está destacado em cada seção.

O prompt para iniciar todo o processo:

Abra o Partner Central da AWS em modo headed (browser visível),
farei o login manualmente.
Não feche o browser para não perder sessão.

O Nova Act abre uma instância do Chrome que você controla. Inicie em modo headed (visível) para acompanhar:

Importante: O Chrome que o Nova Act abre é uma instância limpa. Você precisará fazer login manualmente (incluindo MFA) na primeira vez. Depois de logado, a sessão persiste enquanto o browser estiver aberto. Não feche o Chrome durante o trabalho. Se fechar, perderá a sessão e precisará autenticar novamente.

Passo 3: Ler as soluções existentes no Partner Central

Prompt para o Kiro:

Navegue até a seção de Soluções no Partner Central e extraia todas as minhas
soluções com nome, status e detalhes. Para cada uma, abra a edição e leia
o Value Proposition e Solution Details completos.

Passo 4: Criar a oferta de Professional Services

Prompt para o Kiro:

Com base nas soluções que você leu, crie uma oferta de Professional Services 
no AWS Marketplace para cada uma. Use as descrições existentes para preencher 
os campos e siga as instruções abaixo:

Logo: use a opção "Amazon S3 link" no formulário e informe a URL pública da imagem.
Exemplo de URL: https://s3.amazonaws.com/meu-bucket-publico/logos/logo-marketplace.png
Substitua pela URL real onde sua imagem está hospedada (pode ser S3, CloudFront ou 
qualquer URL pública acessível).
A imagem deve ser PNG ou JPG, fundo branco ou transparente, entre 120 e 640 pixels, 
ratio 1:1 ou 2:1.

Categoria: analise o conteúdo de cada solução e selecione a categoria mais adequada 
entre as opções disponíveis:
- Assessments: para soluções de avaliação, discovery ou auditoria
- Implementation: para migrações, deploys e construção de soluções
- Managed Services: para operação contínua e monitoramento
- Premium Support: para suporte técnico dedicado
- Training: para treinamentos e capacitação

Preço: $0 (oferta privada para fins de Partner Revenue Measurement).

O Kiro vai navegar até o formulário e preencher tudo automaticamente.

Logo via S3 URL (recomendado)

Em vez de fazer upload de arquivo (que é problemático via automação), use a opção de Amazon S3 link.

O upload de arquivo via automação de browser é instável. O diálogo do sistema operacional não é controlável pelo Nova Act. Usar uma URL pública resolve isso de forma confiável. Requisitos da imagem: PNG ou JPG, fundo branco ou transparente, entre 120 e 640 pixels, ratio 1:1 ou 2:1.

Passo 5: Obter o product-code

Após a aprovação (pode levar de minutos a horas), o product-code estará disponível na página do produto.

Atenção: Sempre copie o product-code manualmente do portal. A leitura via AI pode conter erros de caracteres. O product-code tem o formato crqecctrwlz4y43kbr6sxq50f.

Passo 6: Aplicar as tags PRM nos recursos dos clientes

Com o o product-code: pc:crqecctrwlz4y43kbr6sxq50f em mãos. Abra o projeto do cliente no kiro e aplique a tag aws-apn-id com esse valor em todos os recursos de produção. Use a abordagem correta para o tipo de IaC do projeto (CDK, CloudFormation, Terraform ou CLI).

Abaixo estão os prompts específicos por tecnologia e os exemplos de código que o Kiro vai gerar.

Agora que você tem o product-code, aplique a tag em todos os recursos AWS que provisiona para clientes:

Tag Key Tag Value
aws-apn-id pc:<seu-product-code>

Para quem usa CDK (TypeScript/Python)

Abra o projeto do cliente no Kiro e use o prompt:

Preciso adicionar a tag de Partner Revenue Measurement (PRM) da AWS em TODOS os recursos deste projeto CDK.

A tag deve ser:

  • Key: aws-apn-id
  • Value: pc:<SEU_PRODUCT_CODE>

Use Tags.of(app).add('aws-apn-id', 'pc:<SEU_PRODUCT_CODE>') no nível do App para propagar automaticamente para todos os stacks e recursos. Aplique apenas em ambientes de produção. Liste todos os recursos que receberão a tag.

Resultado esperado no código:

import { App, Tags } from 'aws-cdk-lib';

const app = new App();
// ... seus stacks ...

// Tag PRM - aplicada em todos os recursos de produção
Tags.of(app).add('aws-apn-id', 'pc:crqeectrwlz4y43kbr6sxq50f');

Para quem usa CloudFormation

Preciso adicionar a tag de Partner Revenue Measurement (PRM) da AWS em TODOS os recursos deste template CloudFormation.

A tag deve ser:

  • Key: aws-apn-id
  • Value: pc:<SEU_PRODUCT_CODE>

Adicione no bloco Tags de cada recurso que suporta tagging. Se houver um parâmetro de Environment, use Conditions para aplicar apenas em produção. Liste todos os recursos que receberão a tag.

Resultado esperado:

Resources:
  MyECSCluster:
    Type: AWS::ECS::Cluster
    Properties:
      Tags:
        - Key: aws-apn-id
          Value: !Sub "pc:crqeectrwlz4y43kbr6sxq50f"

Para quem usa Terraform

Preciso adicionar a tag de Partner Revenue Measurement (PRM) da AWS em TODOS os recursos deste projeto Terraform.

A tag deve ser:

  • Key: aws-apn-id
  • Value: pc:<SEU_PRODUCT_CODE>

Use default_tags no bloco provider para aplicar automaticamente em todos os recursos. Aplique apenas em ambientes de produção. Liste todos os recursos que receberão a tag.

Resultado esperado:

provider "aws" {
  region = "us-east-1"

  default_tags {
    tags = {
      aws-apn-id = "pc:crqeectrwlz4y43kbr6sxq50f"
    }
  }
}

Para quem não usa IaC (recursos manuais)

Preciso aplicar a tag PRM em recursos AWS existentes na minha conta.

A tag deve ser:

  • Key: aws-apn-id
  • Value: pc:<SEU_PRODUCT_CODE>

Liste todos os recursos na região us-east-1 que suportam tagging (EC2, RDS, ECS, Lambda, S3, DynamoDB, etc.) e gere os comandos AWS CLI para aplicar a tag em cada um. Execute os comandos após minha confirmação.

Exemplo de comandos que o Kiro geraria:

# EC2 instances
aws ec2 create-tags --resources i-0abc123def456 \
  --tags Key=aws-apn-id,Value=pc:crqeectrwlz4y43kbr6sxq50f

# RDS clusters
aws rds add-tags-to-resource \
  --resource-name arn:aws:rds:us-east-1:123456789:cluster:my-cluster \
  --tags Key=aws-apn-id,Value=pc:crqeectrwlz4y43kbr6sxq50f

# ECS clusters
aws ecs tag-resource \
  --resource-arn arn:aws:ecs:us-east-1:123456789:cluster/my-cluster \
  --tags key=aws-apn-id,value=pc:crqeectrwlz4y43kbr6sxq50f

# Lambda functions
aws lambda tag-resource \
  --resource arn:aws:lambda:us-east-1:123456789:function:my-function \
  --tags aws-apn-id=pc:crqeectrwlz4y43kbr6sxq50f

Passo 7: Monitorar via Attributed Revenue

Após 30 dias de tagging ativo, os dados de receita aparecem no dashboard Attributed Revenue no novo Partner Central. Esse dashboard consolida o impacto financeiro das suas ofertas.

Lições aprendidas

O que funcionou bem

  • fill-form do Nova Act é excelente para preencher formulários com múltiplos campos
  • ask e extract são ótimos para ler dados de páginas complexas
  • O Kiro como orquestrador mantém o contexto entre as etapas
  • Usar S3 link para o logo evita problemas com upload de arquivo

O que exigiu intervenção manual

  • Login com MFA: o Nova Act não pode completar autenticação por você
  • Dropdown de categorias: alguns componentes React/custom não respondem bem à automação
  • Product-code: sempre copie manualmente para evitar erros de leitura
  • Permissões IAM: verifique antes se sua role tem acesso a todas as seções necessárias

Dicas para outros parceiros

  1. Tenha o logo em URL pública antes de começar
  2. Verifique que o título tem no máximo 72 caracteres
  3. Use modo headed para acompanhar visualmente
  4. Não feche o Chrome durante o processo — a sessão de login se perde
  5. O product-code só é gerado após aprovação da AWS (pode levar horas)
  6. Cada recurso AWS só aceita uma tag aws-apn-id. Coordene com outros parceiros se necessário

Resumo do fluxo

# Ferramenta O que acontece
1 Kiro + Nova Act Ler soluções do Partner Central — nome, status e detalhes de cada solução
2 Kiro + Nova Act Criar oferta de Professional Services — preencher formulário (fill-form), logo via S3 URL, selecionar categoria, configurar dimensão de pricing e submeter
3 AWS Portal (manual) Aguardar aprovação da AWS e copiar o product-code manualmente do portal
4 Kiro Aplicar tag aws-apn-id nos projetos dos clientes — CDK (Tags.of(app).add), CloudFormation (bloco Tags), Terraform (default_tags) ou AWS CLI
5 Partner Central Monitorar Attributed Revenue — dados disponíveis após 30 dias de tagging ativo

Referências

Compartilhe este artigo: