← Todos os guias

Habilite a sessão do seu agente

Dê ao agente uma sub-wallet de sessão para que ele use ferramentas pagas — busca na web, scraping, dados de preço ou endpoints x402 personalizados — de forma autônoma, e limite o gasto.

Para deixar o agente agir por conta própria — buscando na web, fazendo scraping, extraindo dados — você habilita uma sessão de agente: uma pequena sub-wallet que vive no seu navegador e paga as ferramentas por chamada usando o padrão x402, sem pop-up a cada vez. Ela é separada do seu saldo principal de inferência, você controla quais ferramentas o agente pode usar, e o valor que você carrega é o máximo que ele poderá gastar.

O Halo está em alpha na mainnet da Base com USDC real. As ferramentas funcionam no modo Agente (veja chat vs. modo agente).

Como funcionam os pagamentos x402

O x402 transforma o status HTTP “402 Payment Required” em um canal de pagamento real: uma ferramenta responde 402 com um preço, seu cliente assina uma autorização de USDC off-chain (EIP-3009), e o facilitator do Halo a envia — assim, uma chamada de ferramenta é simplesmente “requisição → pagamento → resposta”, sem chaves de API nem assinaturas do seu lado.

O painel Tools & permissions

Abra Setup → Tools (configuração → ferramentas) na página do Agente para chegar em Tools & permissions (ferramentas e permissões) — “o que o agente pode usar, e o que pode gastar sem perguntar”. Cada ferramenta paga tem uma política de três opções:

  • Auto — executa livremente, dentro do seu limite de gasto.
  • Ask (perguntar) — pergunta a você antes de cada execução.
  • Off (desativada) — oculta a ferramenta do agente por completo (desabilita-a).

Há também uma proteção global: sempre perguntar antes de qualquer chamada individual acima de $X, mesmo para ferramentas configuradas em Auto. As ferramentas pagas integradas incluem web_search, web_scrape, coingecko_price, messari e nansen, cada uma com seu próprio preço por chamada; as ferramentas gratuitas integradas (como recall e remember) não custam nada.

Adicionar uma ferramenta personalizada

Expanda + Add a custom tool (x402 endpoint) (adicionar uma ferramenta personalizada — endpoint x402) e forneça:

  • Name (nome, por exemplo crypto_prices)
  • Description (descrição) — o que ela faz e os argumentos a passar
  • URL — seu endpoint compatível com x402
  • Method (método) — POST (corpo JSON) ou GET (parâmetros de query)

Depois clique em Add tool (adicionar ferramenta). As ferramentas personalizadas são marcadas como “custom”, usam por padrão a política Ask, e têm um pequeno teto por chamada por segurança. Durante a alpha, as ferramentas personalizadas são apenas para endpoints de dados / informações / scraping — não para ações nem transações.

A sub-wallet de ferramentas

As ferramentas são pagas por uma sub-wallet dedicada (uma chave separada dentro do navegador), assim o agente pode pagar por chamada sem tocar no seu saldo principal:

  1. Clique em Enable autonomous tools (habilitar ferramentas autônomas) e aprove uma vez.
  2. Adicione fundos à sub-wallet com alguns dólares de USDC (isso usa uma transferência sem gas). O valor que você carrega é o máximo que poderá ser gasto — mantenha-o pequeno; esse é o seu limite.
  3. Withdraw (sacar) devolve os fundos não usados à sua wallet principal (sem pop-up), e você pode Disable (desabilitar) a sessão quando quiser.

A chave da sub-wallet vive apenas na memória durante a sessão da página e nunca é armazenada.

Relacionados