Agentes criados na sua conta: o que são e como operam

Um agente criado na sua conta é o seu software atuando como você. Não é uma conta separada: com a credencial dele, compra e vende em seu nome, e tudo fica na sua conta. As compras, os downloads e os recibos são seus; os templates que ele publica e as vendas deles, também. Você o cria em Meus agentes e só você o comanda.

• Atua como você: o que ele compra aparece nas suas compras e o que ele publica sai com o seu @usuario, sem nenhuma marca de agente.
• Paga com a wallet dele, nunca com a sua: a Bernuvia não guarda chaves e o MCP não assina, então o seu agente não pode usar a sua wallet da Bernuvia.
• Sem sessão nem e-mail: não entra no site e não há senha para roubar. Ele só fala com a Bernuvia pelo MCP, com a credencial dele.
• Sob o seu comando: aparece na sua lista de Meus agentes e só você pode rotacionar a credencial dele, revogá-la ou suspendê-lo.

Os dois atuam sobre a sua conta e você pode usar os dois. A diferença está em quem assina os pagamentos:

• MCP: você, com o seu assistente do lado. Ele deixa para você assinar qualquer pagamento, no seu navegador e com a sua wallet. É o que explica Conectar seu assistente de IA (MCP).
• Agente criado na sua conta: o seu software, sozinho. Ele compra sem você precisar estar na frente porque quem assina é ele, com a wallet dele e com o dinheiro que você tiver colocado nela. É o que explica este artigo.

Como criar e que permissões dar está em Criar um agente na sua conta. Como trocar a credencial dele, retirá-la ou suspendê-lo, em Rotacionar, revogar ou suspender o seu agente. E pelo que você responde, em Sua responsabilidade pelos agentes que você cria.

O seu agente traz a própria wallet (uma conta normal da Polygon) e prova que a controla assinando um desafio com link_wallet, sem gas e sem mover fundos. Essa é a wallet pagadora das compras que ele fizer em seu nome, e você a vê junto do agente em Meus agentes. A Bernuvia não guarda a chave privada dele nem consegue assinar por ele.

• Ela precisa de USDC para pagar e de POL para o gas do que ela mesma envia, como o depósito pela via clássica. my_balance diz a ele o seu saldo e, à parte, o da wallet dele: o endereço com que ele realmente paga vem em payerWallet (o dele, nunca o seu) e accountType diz que tipo de conta está chamando; esses dois campos vêm também no perfil e nas capacidades dele. O objeto com o endereço e o saldo da wallet dele, agentWallet, só vem em my_balance: nas capacidades esse nome traz só o endereço, e no perfil não vem.
• Os reembolsos voltam para essa wallet, não para a sua: na rede, quem comprou foi ela. Se o envio direto falhar, o valor fica creditado no contrato de custódia em favor dessa wallet e quem tiver a chave dela o saca.
• Só serve para pagar: não recebe as suas vendas e não pode sacar o seu dinheiro.
• Uma wallet, uma conta: não pode ser a sua nem a de outro agente.
• Trocar de wallet é negado enquanto a atual tiver algo pendente: compras que ela pagou e seguem em custódia ou em disputa, cotações vivas, pedidos esperando o vendedor ou saldo a sacar do contrato. Os pedidos que você não vai pagar se fecham antes com cancel_order, e uma autorização de depósito já entregue se retira com cancel_deposit_authorization; o que está em custódia, porém, é esperar ou sacar. Depois troque.

O seu agente compra em seu nome e paga ele mesmo. O dinheiro não vai para o vendedor: fica em custódia até vencer o prazo de 30 horas ou até uma disputa ser resolvida; ninguém antecipa isso.

1. 1Busca o template com search_templates e lê a ficha com template_details.
2. 2Pede o total com quote_purchase: devolve o preço de hoje com os descontos aplicados e um identificador de cotação que amarra esse valor.
3. 3Cria o pedido em seu nome com prepare_payment, com confirmação explícita e esse identificador: se o total de hoje não for o que ele declarou, a compra é recusada e nada é criado.
4. 4Pede os dados com deposit_data e deposita pela via clássica, que é a recomendada: assina e envia com a wallet dele a autorização de USDC e o depósito no escrow, e paga esse gas. A cotação caduca em 15 minutos; se passar, pede outra.
5. 5Consulta order_status até o depósito ficar confirmado na rede.
6. 6A compra já é sua: aparece em Minhas compras indicando que quem pagou foi o seu agente, e o download e o recibo são seus. Ele também pode baixá-la com download.

Em uma compra que o seu agente pagou, o comprador que consta na rede é a wallet dele. Por isso só ele pode abrir a disputa com open_dispute, retirá-la com withdraw_dispute ou fechá-la por vencimento com close_expired_dispute: cada função devolve a ele a transação para assinar com a wallet dele. Se houver reembolso, ele volta para essa wallet.

Você continua vendo o caso no site: envia provas e fala com o suporte como em qualquer compra sua. O que você não pode é assinar a abertura dessa disputa com a sua wallet, porque não foi ela que pagou. As compras que você paga no site continuam sendo só suas: o seu agente não mexe nelas.

Com a permissão de vendedor, o seu agente publica e gerencia os seus templates com a sua assinatura: não paga uma própria nem deposita caução. O que ele publica sai com o seu @usuario, sem marca de agente, e passa pela mesma revisão humana que se você mesmo o subisse pelo site.

• Requisito: a sua assinatura de vendedor ativa. Se ela vencer, as funções de vendedor dele param de responder na hora, igual às suas.
• Imagens e arquivo: envia as imagens da galeria com image_upload_link e o ZIP com zip_upload_link. As imagens têm de ser WebP e com proporção 4:3 (tolerância ±4 %; o recomendado é 1600x1200 px, o mesmo que o recortador do site produz). O servidor não as recorta nem as converte: a que não se encaixa é recusada no envio.
• Ensaio a seco: com o ZIP já subido, check_before_submit diz a ele o que o envio diria sem gastá-lo, com os problemas e o que fazer em cada um. Não cria nem altera nada.
• Publicar, corrigir e atualizar: submit_for_review com a ficha completa e, se for recusado, resubmit_for_review corrige o que falhou sem criar outro. Para mudar um já publicado, update_published_template envia só o que muda (e um ZIP novo se precisar) para a mesma revisão, e o publicado continua à venda até ser aprovado. Ele também pode pausar ou retirar os seus templates e gerenciar os seus códigos de desconto.
• Um freio: os envios dele para revisão vão de um em um, com pelo menos um minuto entre um e outro contando todos os seus agentes, e há um teto de templates da sua conta esperando revisão, no qual também contam os que você sobe pelo site. Se estiver cheio, ele tem de esperar que se resolvam.
• Receber: as suas vendas são pagas na sua wallet, como sempre. Sacar esse dinheiro é coisa só sua, pelo site.

O seu agente não tem e-mail: ele lê as suas notificações com my_notifications. Ali ele vê as compras confirmadas, o dinheiro liberado e os seus templates em revisão, aprovados ou recusados. Vale a pena ele consultar de vez em quando.

Se você vai ensaiar o caminho da compra de ponta a ponta, pode marcar o seu agente como conta de testes em Meus agentes, com o seu segundo fator. Quem põe e tira a marca é o dono dele ou a equipe da Bernuvia; o próprio agente nunca pode pô-la nem tirá-la.

• O dinheiro é real: assina-se, deposita-se, libera-se e reembolsa-se igual, e a comissão é cobrada. O download e o direito a disputa não mudam em nada.
• Nada do que nasce de uma conta marcada conta em nenhum número: fica fora do catálogo e da busca, da média de estrelas e do número de avaliações, do contador de vendas, da receita, do peso de reputação que ordena o catálogo de todo mundo, das métricas e da comissão de indicação. A avaliação dela, além disso, não é exibida: fica fora da lista do template e da do vendedor, embora a Bernuvia a conserve e continue vendo.
• Um template de testes não é publicado: não leva dados estruturados nem cartão social e fica fora do mapa do site. A ficha dele continua abrindo pelo endereço direto, e quem comprou mantém o download.
• A marca congela assim que a conta movimenta dinheiro de verdade por qualquer das duas pontas, comprando ou vendendo: a partir daí não se põe nem se tira.

Não é uma promessa de bom comportamento: essas funções estão fora do alcance dele e o servidor sempre as nega, esteja a credencial com quem estiver.

• Sacar o seu dinheiro. Nem os seus ganhos nem o seu saldo: sacar exige a sua assinatura no site.
• Usar a sua wallet, ou fazer a gente assinar por ele. A Bernuvia não guarda a chave privada dele; o depósito quem assina é ele, com a dele, e a Bernuvia só envia o que ele já assinou: o depósito com uma só assinatura e a retirada dessa mesma autorização.
• Deixar avaliações em seu nome. Uma avaliação é escrita por uma pessoa que usou o template: se você quiser opinar, faz isso pelo site.
• Criar agentes ou credenciais, nem mexer no seu e-mail, no seu 2FA ou nos seus dados de acesso.
• Antecipar um pagamento. O dinheiro está no contrato de custódia e ninguém, nem uma pessoa nem um agente, o libera antes do prazo.
• Entrar no painel de administração. Mesmo que a sua conta tenha esse acesso, o seu agente não o herda.
• Operar suspenso. Se você suspender o agente, ou se a sua conta estiver suspensa, ele para de funcionar na hora.