Casi d'uso
Updated:
Ogni flusso mostra un esempio di prompt e gli strumenti che l’assistente richiama, in ordine. Non è necessario specificare i nomi degli strumenti: è sufficiente un linguaggio semplice.
Verifica cosa sta per scadere
💬 “Quali dei miei proxy IPv4 scadranno nei prossimi 7 giorni? Mostra l’IP, il paese e la data di scadenza.”
Un'unica chiamata: list_proxies con type: "ipv4", ends: true.
Acquista proxy
💬 “Acquista 10 proxy IPv4 statunitensi per 1 mese per Google, paga dal saldo.”
get_reference — codici paese e periodo validi.
calc_order_cost — prezzo; l’assistente lo mostra e chiede conferma.
get_balance — fondi sufficienti?
make_order — dopo la tua conferma.
check_order_status — fino all’emissione dei proxy.
export_proxies —
ip:portrighe più una nota che indica che le password sono state omesse; previa vostra conferma,reveal: trueper connectablelogin:password@host:portrighe.
Ottenere proxy residenziali per una determinata località
💬 “Forniscimi 5 proxy residenziali a Berlino, con IP fisso, nel formato login:password@host:port.”
get_resident_geo_count —
country: "DE",city: "Berlin"— Ci sono dei nodi?add_resident_list —
ports: 5,rotation: -1,country: "DE",city: "Berlin"— la regione richiesta dall’API (State of Berlin) viene ricercato automaticamente.export_proxies —
type: "resident",listId,ext: "%login%:%password%@%ip%:%port%"— il modello richiede le credenziali, quindi l’assistente le verifica con te e le trasmettereveal: true.
Senza la fase di conferma, un modello che nomini %password% viene rifiutata e l’assistente ti chiede prima; viene restituita un’esportazione semplice (senza modello) come ip:port righe con una nota che indica che le password sono state omesse: questa è l'impostazione predefinita, non un errore.
Analisi del traffico residenziale
💬 «Quanto traffico residenziale ho utilizzato ad agosto e quanto mi è costato? Quale elenco ne ha consumato di più?»
get_resident_consumption —
date_start: "2026-08-01",date_end: "2026-08-31".get_resident_package — ciò che resta.
Assegnare a un compagno di squadra il proprio traffico
💬 “Crea un utente secondario con 5 GB e una lista statunitense con 20 porte, con rotazione ogni 5 minuti.”
get_resident_package — C'è ancora abbastanza traffico?
create_resident_subpackage —
traffic_limit: 5368709120,is_link_date: true.add_resident_subuser_list —
country: "US",ports: 20,rotation: 300.export_proxies —
type: "subresident",package_key— unip:portelenco; previa tua conferma,reveal: trueper le credenziali che ci fornisci.
Metterli in pausa in un secondo momento:
💬 “Metti in pausa quell’utente secondario”
→ update_resident_subpackage con is_active: false.
Non lasciare mai che i proxy scadano
💬 “Attiva il rinnovo automatico per tutti i miei proxy ISP dal saldo e ricarica 50 $ ogni volta che il saldo scende al di sotto dei 20 $.”
calc_autoprolong_cost — importo ricorrente e data del prossimo addebito.
enable_autoprolong — previa conferma.
get_autotopup — Una carta è vincolata?
set_autotopup —
threshold: 20,amount: 50.
Entrambe queste voci presentano un errore ricorrente — vedi Pagamenti e sicurezza.
Correggere un proxy non funzionante
💬 “Il proxy 185.x.x.x non funziona, sostituirlo.”
list_proxies — trovalo.
replace_proxy —
reason: "NOT_WORK".
Gestire gli accessi
💬 “Aggiungi il mio IP 1.1.1.1 alla whitelist per l’ordine 1234567”
Un'unica chiamata: add_auth con ip, orderNumber.
💬 “Cambia la password di quell’account in …”
list_auth — reperire l’autorizzazione.
change_auth — inviare solo le modifiche apportate.
💬 «Sposta la whitelist con numero d'ordine 1234567 all'indirizzo 2.2.2.2»
→ list_auth → change_auth (ip).
💬 “Blocca l’accesso da 1.1.1.1”
→ list_auth → delete_auth — L’autorizzazione IP non può essere disattivata senza un nuovo indirizzo IP.
Realizzare un'integrazione
💬 “Come si rinnovano le deleghe tramite l’API? Mostra un esempio in Node.js.”
ps_docs_search — trova la pagina giusta.
ps_api_get_endpoint — Leggi le istruzioni.
ps_sdk_snippet —
lang: "node".
Funziona solo con docs:read — il tuo account non viene mai toccato.