Cloudflare Developers: sviluppare applicazioni web e IA

Guide ufficiali per collegare codice, modelli IA, agenti e servizi cloud.

Vai al sito ↗developers.cloudflare.com
developers.cloudflare.com
Cloudflare Developers screenshot

Cloudflare Developers raccoglie documentazione tecnica, riferimenti API ed esempi della piattaforma Cloudflare. Aiuta a scegliere i servizi per pubblicare codice, usare modelli di intelligenza artificiale, conservare dati e gestire la sicurezza di un’applicazione.

A cosa serve questo sito, in parole semplici?

È il manuale di una serie di componenti cloud. Se vuoi pubblicare un’API, salvare file o aggiungere una funzione IA, puoi trovare il servizio adatto e capire come collegarlo al tuo codice. Leggere la documentazione non crea un’applicazione: le risorse si gestiscono con un account Cloudflare, il pannello, la riga di comando o le API.

È pensato per sviluppatori, fondatori con competenze tecniche e team operativi. Si può iniziare da un piccolo esempio, ma un progetto reale richiede programmazione, autorizzazioni, test e controllo dei consumi.

Distinguere inferenza, gateway e agenti

Workers AI esegue modelli sulle GPU di Cloudflare. Puoi richiamarli da un Worker oppure da un backend esterno tramite REST. Generazione di testo, embeddings e operazioni sulle immagini hanno formati di ingresso e uscita diversi in base al modello.

AI Gateway gestisce le richieste verso i fornitori supportati. Analisi, log, cache, limiti di frequenza, tentativi successivi e modelli alternativi aiutano a osservare gli errori e governare l’utilizzo.

Agents fornisce stato persistente, connessioni in tempo reale, attività pianificate e strumenti come MCP. Il comportamento dell’agente, i permessi concessi e la verifica dei risultati restano decisioni dello sviluppatore.

Pubblicare un primo Worker e provare una chiamata

La guida ufficiale alla CLI parte da un account Cloudflare e da un ambiente Node.js supportato.

  1. Esegui npm create cloudflare@latest -- my-first-worker e scegli un esempio semplice di Worker.
  2. Entra nella cartella e avvia npx wrangler dev, quindi apri l’indirizzo locale mostrato.
  3. Cambia il testo della risposta nel sorgente, salva e ricarica per verificare la modifica.
  4. Esegui npx wrangler deploy, completa le autorizzazioni richieste e controlla l’URL workers.dev restituito.

Per provare solo un modello, segui l’introduzione REST a Workers AI: recupera Account ID e token, invia la richiesta autenticata del modello scelto e verifica il JSON con gli eventuali errori. Conserva il token sul server. Le chiamate effettuate durante lo sviluppo locale possono comunque consumare i limiti di inferenza.

Scegliere dove mettere file e dati applicativi

R2 conserva oggetti e file; D1 gestisce dati relazionali tramite SQL; KV contiene coppie chiave-valore. Durable Objects coordina lo stato e Vectorize archivia embeddings per la ricerca per similarità.

Per un assistente documentale potresti usare R2 per gli originali, D1 per i record applicativi e Vectorize per i vettori. Importazione, controllo degli accessi e verifica delle risposte vanno comunque implementati. La guida alla scelta dello storage chiarisce i casi d’uso dei singoli componenti.

Valutare dati, log e licenze prima dell’integrazione

La politica di Workers AI dichiara che i contenuti del cliente non vengono usati per addestrare modelli o migliorare servizi senza consenso esplicito. I servizi di archiviazione collegati possono conservarli, mentre i fornitori esterni hanno condizioni proprie.

I log di AI Gateway sono attivi per impostazione predefinita e possono includere prompt e risposte. Controlla la raccolta prima di trattare informazioni sensibili e verifica la licenza del modello per l’uso commerciale.

Documentazione gratuita e costi dei servizi

I documenti sono pubblici; l’utilizzo cloud ha tariffe specifiche. Al 7 ottobre 2026, la pagina prezzi di Workers AI indica 10.000 Neurons gratuiti al giorno, con rinnovo alle 00:00 UTC. Oltre la quota serve Workers Paid; alcuni modelli richiedono un metodo di fatturazione a pagamento.

Analisi di base, cache e rate limiting di Gateway sono gratuiti, ma inferenza, log e altre funzioni possono comportare costi. Le condizioni di Gateway distinguono anche i log per data di creazione del primo gateway. Le cifre ufficiali in dollari non sono un prezzo complessivo in euro comprensivo di imposte.

Gestire protezione e prestazioni dopo il rilascio

Il sito include guide per DNS, cache, TLS, WAF e Turnstile. Quest’ultimo può essere integrato senza far passare tutto il traffico da Cloudflare. Pubblicare un Worker non configura automaticamente questi servizi: occorre scegliere le funzioni appropriate per il proprio sito.

Domande frequenti

Il piano gratuito permette chiamate IA illimitate?

No. Si applicano quota giornaliera, limiti di frequenza e requisiti dei modelli. Il consumo dipende dal modello e dalle dimensioni di input e output.

Posso usare le API senza distribuire un Worker?

Sì. Un backend esistente può chiamare REST usando Account ID, token autorizzato e il formato previsto dal modello.

Con AI Gateway l’inferenza è inclusa gratuitamente?

Le funzioni di gestione gratuite non eliminano il costo dei fornitori. Controlla separatamente inferenza, modalità di pagamento e log.

Risorse ufficiali e comunità