Numas Field · Guida
Configurare le funzioni AI
La bozza di relazione AI di Numas Field è opzionale e usa una tua chiave personale (modello BYOK). Qui trovi come ottenerla e dove inserirla.
✓
L'app funziona già senza chiave
Rilievi, foto georiferite con hash, disegni, misure LiDAR, prove idranti, PDF firmato ed export della pratica non richiedono alcuna configurazione. Il modulo AI — la bozza della relazione tecnica generata dai dati del rilievo — è un di più facoltativo, da attivare solo se vuoi.
Come funziona (BYOK)
Le funzioni AI si appoggiano alla tua chiave personale di un provider esterno: Claude (Anthropic), OpenAI o Google Gemini. Crei la chiave sul sito del provider e la incolli nell'app in Impostazioni → Provider AI. Numas non fa da intermediario: il rapporto è diretto tra te e il provider, e la bozza resta tale — la relazione la firmi tu, dopo averla verificata.
Quanto costa
Le chiamate AI si pagano a consumo, direttamente al provider, mai a Numas. Per l'uso tipico — qualche bozza di relazione a settimana — si parla in genere di pochi euro al mese. Conviene impostare un limite di spesa nel pannello del provider, così non hai sorprese.
Da dove iniziare senza spendere
Se vuoi solo provare, Google Gemini offre un piano gratuito senza carta di credito (con limiti giornalieri): è il punto di partenza più semplice. Claude e OpenAI richiedono invece un piccolo credito prepagato.
Sicurezza della chiave
La chiave è come una password: personale e privata, da non condividere con nessuno. Nell'app è salvata nel Keychain del dispositivo. Ogni dispositivo ha il proprio archivio: la chiave inserita su iPad non si sincronizza sul Mac, va reinserita su ciascun dispositivo.
Ottenere la chiave, provider per provider
Claude (Anthropic)
console.anthropic.com ↗
- Crea un account Anthropic, o accedi se ne hai già uno.
- Vai in Settings → API Keys.
- Clicca "Create Key" e dai un nome alla chiave.
- Copia subito la chiave: viene mostrata una sola volta.
- Incollala in Numas Field → Impostazioni → Provider AI.
Richiede un metodo di pagamento o l'acquisto di crediti prima dell'uso. La chiave inizia con sk-ant-.
OpenAI
platform.openai.com ↗
- Crea un account OpenAI, o accedi con le credenziali di ChatGPT.
- Verifica il numero di telefono.
- Vai in API keys → "Create new secret key" e dai un nome.
- Copia subito la chiave: viene mostrata una sola volta.
- Incollala in Numas Field → Impostazioni → Provider AI.
Richiede un credito prepagato (minimo ~5 $). Attenzione: l'abbonamento ChatGPT Plus non include l'accesso API, è separato. La chiave inizia con sk-proj- o sk-.
Google Gemini
Gratis per iniziare
aistudio.google.com ↗
- Accedi con un account Google.
- Clicca "Get API key" / "Crea chiave API".
- Seleziona o crea un progetto Google Cloud.
- Crea e copia la chiave.
- Incollala in Numas Field → Impostazioni → Provider AI.
Ha un piano gratuito senza carta di credito (con limiti giornalieri), ideale per iniziare. La chiave inizia con AIza.
Avvertenze
- Non condividere mai la chiave pubblicamente e non inserirla in siti o codice di terzi.
- Imposta un limite di spesa nel pannello del provider per evitare addebiti imprevisti.
- La bozza generata dall'AI va sempre riletta e verificata: la responsabilità professionale della relazione resta di chi la firma.
- Le procedure e le schermate dei provider possono cambiare nel tempo: in caso di dubbio fai riferimento alla documentazione ufficiale del provider.
Le funzioni AI sono facoltative. Numas non riceve la tua chiave né alcun compenso dall'uso delle API: il costo lo gestisci direttamente con il provider.