Click: agenti AI gestiti via API per la tua applicazione

A cosa serve Click, spiegato in modo semplice

Click permette agli sviluppatori di eseguire agenti AI tramite un’API gestita. Tu fornisci chiave del modello, istruzioni e strumenti autorizzati; Click gestisce le chiamate al modello e agli strumenti, la cronologia e il recupero dell’esecuzione. L’applicazione riceve i risultati tramite API, flussi di eventi o webhook.

Un caso concreto è un assistente nel tuo prodotto che legge un CSV e prepara un rapporto. Interfaccia, utenti, accesso ai dati e approvazioni restano nell’app; Click fornisce l’esecuzione dell’agente. Il servizio di Click AI Labs, Inc. è adatto a funzionalità integrate e attività lunghe in background. Richiede sviluppo backend e verifica dei risultati prodotti.

Un primo agente AI con chiavi e sessioni

1. Prepara una chiave API Click e quella di un fornitore di modelli supportato. Per creare o modificare risorse la documentazione richiede la verifica di una carta, con possibili esenzioni per account esistenti. La verifica non addebita costi né avvia un abbonamento a pagamento.
2. Salva la chiave del modello con POST /credentials e conserva l’ID restituito. Entrambe le chiavi devono restare nel backend.
3. Consulta GET /models e scegli un modello compatibile con il fornitore della credenziale.
4. Con POST /agents imposta modello, istruzioni e permessi degli strumenti. Conserva latest_version.id e usalo in POST /sessions.
5. Invia il lavoro a POST /sessions/{session_id}/submissions. Una request_id consente ai tentativi ripetuti di recuperare lo stesso invio.
6. Attendi done, cancelled o failed. Nel primo caso leggi la voce di risposta indicata; negli altri controlla il motivo.

HTTP 202 significa solo che l’input è stato salvato. Associa l’ID di sessione al tuo documento o ticket per continuare con la stessa cronologia e verifica i diritti dell’utente prima di restituire i dati.

Strumenti aziendali, sandbox e file di output

Click collega server MCP Streamable HTTP ed endpoint HTTP personalizzati raggiungibili su HTTPS pubblico. Dopo aver creato la connessione, devi concedere esplicitamente gli strumenti. Gli strumenti HTTP definiscono gli argomenti con JSON Schema e ricevono un POST JSON; il timeout documentato è di 120 secondi.

Un endpoint per i ticket può autorizzare un token temporaneo limitato al cliente corretto. L’applicazione resta responsabile di autenticazione, budget, approvazioni e controlli di business.

Sono disponibili ricerca web, automazione del browser e operazioni su file e shell in sandbox. La documentazione comprende anche Blaxel, Daytona e credenziali Browserbase proprie. Ogni servizio esterno può avere requisiti e costi distinti.

Per i file, usa la sandbox gestita da Click: carica l’input con POST /files, cita l’ID nell’invio e fai usare all’agente publish_file per salvare il risultato durevole. Elenca gli artifacts e scarica con GET /files/{file_id}. Il file di lavoro nella sandbox non basta come consegna: verifica che sia pubblicato e che il contenuto sia corretto.

Come seguire il lavoro in background

GET /sessions/{session_id}/events restituisce prima uno snapshot completo, poi aggiornamenti su testo, strumenti e stato. A ogni riconnessione il nuovo snapshot sostituisce lo stato locale. Una disconnessione non ferma il lavoro; lo stream si chiude quando la sessione passa in standby.

Per ricevere risultati dopo la chiusura della pagina, registra webhook firmati per submission.updated e artifact.created. Dopo la notifica, leggi la risorsa per conoscerne lo stato corrente prima di aggiornare il prodotto.

Piano gratuito e Pro: cosa si paga davvero

Prezzi pubblici mensili in USD, verificati il 3 novembre 2026 sulla pagina ufficiale. Non sono importi finali in euro con IVA confermata.

• Free: 0 USD/mese. Due sessioni residenti simultanee, 100 MB di spazio e, al mese, un’ora di sandbox, un’ora di browser gestito e 100 ricerche.
• Pro: 199 USD/mese. 50 sessioni residenti simultanee, 10 GB e, al mese, 100 ore di sandbox, 100 di browser e 5.000 ricerche.
• Enterprise: prezzo e capacità personalizzati.

BYOK significa usare le proprie chiavi del modello: i consumi del fornitore vanno considerati separatamente, come quelli di eventuali servizi esterni. Lo spazio è capacità corrente, non un nuovo pacchetto mensile. Le quote gestite sono condivise nel tenant; Free segue il mese solare UTC e Pro il periodo di fatturazione pagato.

Nel limite di concorrenza rientrano le sessioni attive o inattive con runtime, mentre standby è escluso. Le quote esaurite possono bloccare strumenti e interrompere lavori. La documentazione esclude addebiti automatici per superamento.

Privacy e controlli da mantenere nell’app

L’informativa privacy comprende istruzioni, messaggi, file, richieste e risultati degli strumenti e credenziali. I dati possono essere inviati ai fornitori di modelli e strumenti per completare le attività; valgono anche le loro politiche.

Il personale Click può accedere ai contenuti per introduzione al servizio, supporto, diagnosi e miglioramento. La conservazione dipende dalle necessità ragionevoli, senza un termine fisso universale. Il trattamento può avvenire negli Stati Uniti e in altri Paesi: non implica hosting italiano, conservazione zero o una garanzia generale di mancato addestramento.

Inserisci i segreti nei campi o endpoint dedicati alle credenziali, non nei messaggi o nei file. La politica chiede di non inviare informazioni regolamentate altamente sensibili.

Domande frequenti

Click permette di creare agenti AI gratis?

Sì, entro i limiti Free. Il modello può generare costi presso il proprio fornitore e per creare risorse è normalmente necessaria la verifica della carta.

Serve una chiave API del modello?

Sì. Il percorso ufficiale salva una chiave del fornitore e seleziona un modello da GET /models. La chiave Click e quella del modello hanno funzioni diverse e restano nel backend.

Come si collegano strumenti e API aziendali?

Con connessioni MCP o strumenti HTTPS autorizzati esplicitamente. Autorizzazione del cliente, token e approvazioni delle operazioni importanti rimangono nell’applicazione.

Risorse ufficiali per sviluppatori

• Riferimento API: strumenti, eventi, webhook e file.
• Avvio rapido: prima configurazione di credenziali, agente e sessione.
• Termini e supporto: condizioni del servizio e canale ufficiale di assistenza.