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:
- Criar uma oferta de Professional Services no AWS Marketplace
- Obter o product-code gerado
- Aplicar a tag
aws-apn-idnos recursos dos seus clientes - 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
- Abra o Kiro
- Acesse o painel de Powers (ícone de raio na barra lateral ou Command Palette → "Powers")
- Busque por "nova-act"
- 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
- Tenha o logo em URL pública antes de começar
- Verifique que o título tem no máximo 72 caracteres
- Use modo headed para acompanhar visualmente
- Não feche o Chrome durante o processo — a sessão de login se perde
- O product-code só é gerado após aprovação da AWS (pode levar horas)
- 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 |