← Tutte le guide

Abilita la sessione del tuo agente

Dai all'agente una sub-wallet di sessione così può usare strumenti a pagamento — ricerca web, scraping, dati di prezzo o endpoint x402 personalizzati — in autonomia, e limita la spesa.

Per lasciare che l’agente agisca da solo — cercando sul web, facendo scraping, estraendo dati — abiliti una sessione di agente: una piccola sub-wallet che vive nel tuo browser e paga gli strumenti per ogni chiamata tramite lo standard x402, senza pop-up ogni volta. È separata dal tuo saldo principale di inferenza, sei tu a controllare quali strumenti l’agente può usare, e l’importo che carichi è il massimo che potrà mai spendere.

Halo è in alpha sulla mainnet di Base con USDC reale. Gli strumenti funzionano in modalità Agente (vedi chat vs. modalità agente).

Come funzionano i pagamenti x402

x402 trasforma lo stato HTTP “402 Payment Required” in un vero canale di pagamento: uno strumento risponde 402 con un prezzo, il tuo client firma un’autorizzazione USDC off-chain (EIP-3009), e il facilitator di Halo la invia — così una chiamata a uno strumento è semplicemente “richiesta → pagamento → risposta”, senza chiavi API né abbonamenti dalla tua parte.

Il pannello Tools & permissions

Apri Setup → Tools (configurazione → strumenti) nella pagina dell’Agente per raggiungere Tools & permissions (strumenti e permessi) — “cosa può usare l’agente, e cosa può spendere senza chiedere”. Ogni strumento a pagamento ha una policy a tre opzioni:

  • Auto — si esegue liberamente, entro la tua soglia di spesa.
  • Ask (chiedi) — ti chiede prima di ogni esecuzione.
  • Off (disattivato) — nasconde del tutto lo strumento all’agente (lo disabilita).

C’è anche una protezione globale: chiedi sempre prima di qualsiasi singola chiamata superiore a $X, anche per gli strumenti impostati su Auto. Gli strumenti a pagamento integrati includono web_search, web_scrape, coingecko_price, messari e nansen, ognuno con il proprio prezzo per chiamata; gli strumenti integrati gratuiti (come recall e remember) non costano nulla.

Aggiungere uno strumento personalizzato

Espandi + Add a custom tool (x402 endpoint) (aggiungi uno strumento personalizzato — endpoint x402) e fornisci:

  • Name (nome, ad esempio crypto_prices)
  • Description (descrizione) — cosa fa e gli argomenti da passare
  • URL — il tuo endpoint compatibile con x402
  • Method (metodo) — POST (corpo JSON) o GET (parametri di query)

Poi premi Add tool (aggiungi strumento). Gli strumenti personalizzati sono etichettati come “custom”, usano per impostazione predefinita la policy Ask, e hanno un piccolo tetto per chiamata per sicurezza. Durante l’alpha, gli strumenti personalizzati sono solo per endpoint di dati / informazioni / scraping — non per azioni né transazioni.

La sub-wallet degli strumenti

Gli strumenti sono pagati da una sub-wallet dedicata (una chiave separata all’interno del browser), così l’agente può pagare per ogni chiamata senza toccare il tuo saldo principale:

  1. Clicca su Enable autonomous tools (abilita strumenti autonomi) e approva una volta.
  2. Finanzia la sub-wallet con qualche dollaro di USDC (questo usa un trasferimento senza gas). L’importo che carichi è il massimo che potrà essere speso — mantienilo basso; quello è il tuo limite.
  3. Withdraw (preleva) riporta i fondi non usati alla tua wallet principale (senza pop-up), e puoi Disable (disabilitare) la sessione quando vuoi.

La chiave della sub-wallet vive solo in memoria per la durata della sessione della pagina e non viene mai memorizzata.

Correlati