Questa è una traduzione automatica del documento originale in inglese. In caso di discrepanze tra la presente traduzione e la versione originale in inglese, prevarrà la versione inglese. Leggi la versione originale in inglese


Variabili: Personalizza i tuoi prompt

Le variabili sono segnaposto che si compilano automaticamente con le tue informazioni, la data corrente, la tua posizione o qualsiasi altra cosa tu definisca. Usale nei messaggi, nelle competenze e nelle impostazioni della modalità per personalizzare le risposte e automatizzare le informazioni ripetitive.

Come usare le variabili

Digita una variabile nel tuo messaggio o Skill con doppie parentesi graffe, così:

Invia un'email di ringraziamento a {{email}}

o in un prompt di Skill:

Aiutami a pianificare una riunione per {{currentDate}} con il mio team

Quando la invii, la variabile viene sostituita con il suo valore effettivo.

Le variabili del tuo profilo (Globali)

Queste sono sempre disponibili, ovunque. Impostale in Impostazioni > Personalizzazione e privacy > Personalizzazione:

Variabile Cosa contiene
{{userName}} Il tuo nome
{{occupation}} La tua professione
{{email}} Il tuo indirizzo email
{{phoneNumber}} Il tuo numero di telefono
{{homeAddress}} La tua città o indirizzo di casa
{{workAddress}} La tua sede di lavoro
{{preferredLanguage}} La tua lingua (in cui l'IA deve scrivere)

Esempio: "Bozza un'email in cui dico che sono disponibile presso {{workAddress}} dopo le 15:00 e che posso essere contattato al numero {{phoneNumber}}"

Variabili di sistema precompilate (Sola lettura)

Queste si aggiornano automaticamente e non puoi modificarle:

Variabile Cosa ottieni
{{currentDate}} La data di oggi (ad es. "20 gennaio 2026")
{{currentTime}} L'ora attuale (ad es. "14:30 PST")
{{currentDateTime}} Data e ora insieme
{{userTimezone}} Il tuo fuso orario (ad es. "America/Los_Angeles")
{{currentUrl}} L'URL della pagina web che stai visualizzando
{{currentPageTitle}} Il titolo della pagina web che stai visualizzando
{{currentLocation}} La tua città e stato (richiede autorizzazione)
{{currentPreciseLocation}} Indirizzo completo con coordinate (richiede autorizzazione)
{{currentCity}}, {{currentState}}, {{currentCountry}} Singole parti della posizione
{{currentCountryCode}} Codice paese ISO (ad es. "IT")
{{currentPostalCode}} Codice postale / CAP
{{currentNeighborhood}} Quartiere o sobborgo
{{currentLatitude}}, {{currentLongitude}} Coordinate GPS grezze
{{uiLanguage}} La lingua in cui è visualizzato Caiioo

Le variabili di posizione provengono tutte da un'unica ricerca di geolocalizzazione: concedi l'autorizzazione una volta e ogni campo si compilerà automaticamente. Il nome del luogo viene calcolato sul tuo dispositivo da un database integrato, quindi le tue coordinate non vengono inviate da nessuna parte solo per compilarle. La condivisione della posizione (in Impostazioni > Personalizzazione e privacy > Personalizzazione) ha due livelli: Condividi posizione città compila i campi generali ({{currentLocation}}, città/stato/paese), mentre Condividi posizione precisa compila anche il quartiere, il codice postale e le coordinate ({{currentPreciseLocation}}).

Esempio: "Riassumi questa pagina: {{currentUrl}} "

Variabili specifiche per modalità

Ciascuna modalità può avere le proprie variabili. Ad esempio, la modalità Workplace include {{taskingSystem}} e {{communicationsPlatform}}.

Puoi impostarle in Impostazioni > Strumenti, modalità e app > Modalità agente mentre utilizzi la modalità desiderata.

Overlay delle Variabili per Discussione

A partire dalla v0.9.722, le variabili di modalità non sono più persistenti tra le discussioni. Invece, ogni discussione porta il proprio overlay di variabili. Questo è utile quando lavori su più progetti, casi o clienti nella stessa modalità.

Esempio: Sei nella modalità Lavoro. Una discussione è per il "Progetto Acme" dove imposti {{taskingSystem}} su Jira. Un'altra discussione è per il "Progetto Beta" dove lo imposti su Asana. Non si sovrascriveranno più a vicenda: ogni discussione ricorda le proprie impostazioni.

Questo si applica a ogni variabile di modalità. Quando modifichi una variabile in una discussione, influisce solo su quella discussione e non trapelerà in altre conversazioni della stessa modalità.

Le app dell'Hub possono anche essere installate con una finestra di dialogo delle variabili che mostra un pulsante nel composer per quell'app, così ogni app installata ha la propria interfaccia per le variabili configurabile senza dover entrare nelle impostazioni.

Creare variabili personalizzate

Vuoi riutilizzare un dato personale non presente nell'elenco predefinito? Crea una variabile personalizzata:

  1. Vai su Impostazioni > Personalizzazione e privacy > Personalizzazione per le variabili disponibili ovunque, oppure su Impostazioni > Strumenti, modalità e app > Modalità agente per le variabili limitate a una singola modalità
  2. Fai clic su "Aggiungi variabile"
  3. Assegnale un nome descrittivo (ad es. {{myCompanyName}} o {{customerServiceEmail}})
  4. Impostane il valore
  5. Le variabili a livello di profilo sono disponibili ovunque; quelle a livello di modalità sono attive solo all'interno di quella specifica modalità

Nota sulla sintassi: sia {{varName}} sia {{ varName }} sono validi: gli spazi all'interno delle parentesi graffe sono consentiti.

Vedi anche

  • Skills — Usa le variabili nei tuoi prompt riutilizzabili
  • Modalità e personalità — Variabili specifiche per modalità per diversi flussi di lavoro

This guide is maintained by the Caiioo team using Slate, our built-in editor.