Documentazione Oriloq

Che cos'è una Smart Action?

Una Smart Action è una ricetta vocale registrata nella tua libreria. Detti la parola chiave di trigger (maestro per impostazione predefinita) seguita da un'istruzione in linguaggio naturale, e Oriloq seleziona la Smart Action esistente più vicina alla tua intenzione, quindi la esegue. Il risultato viene incollato al posto della tua dettatura o copiato negli appunti. Dalla 1.0.32, le azioni integrate sono attivabili a voce e disponibili in cinque lingue.

Trigger vocale

La parola chiave predefinita è maestro. Puoi modificarla o aggiungere varianti per tenere conto di diverse formulazioni (ad esempio «maestro», «hey maestro», «ok maestro»). Oriloq rileva il trigger nella tua dettatura, quindi utilizza il linguaggio naturale che segue per cercare la Smart Action esistente più vicina nella tua libreria ed eseguirla.

Prompt e istruzioni

Il prompt definisce la trasformazione da applicare alla trascrizione. Sii esplicito: precisa il formato di output atteso (elenco puntato, email, JSON, paragrafo), il pubblico di destinazione e il tono. Le variabili come {{transcript}} vengono sostituite con la trascrizione al momento dell'esecuzione. Un editor integrato e un selettore di icone SF Symbols permettono di personalizzare ogni Smart Action.

Motore di esecuzione

Scegli il motore che esegue il prompt: I provider di modelli personalizzati sono supportati e la loro convalida è stata resa più affidabile (1.0.26).

• •Gemma 4 (locale) — motore predefinito dalla versione 1.0.14, esecuzione 100% locale, multimodale (testo, immagini, audio), nessun dato lascia il tuo Mac.
• •Apple Intelligence — utilizza i modelli integrati in macOS quando il dispositivo è compatibile.
• •Cloud (opzionale) — per modelli più potenti se hai configurato un fornitore di terze parti.

Agente Smart Action gerarchico

Dalla versione 1.0.14, può essere attivato un agente intelligente per scoprire automaticamente le Smart Actions disponibili e concatenarle in modo gerarchico. Invece di richiamare una singola azione, l'agente analizza la tua richiesta, seleziona le azioni pertinenti e le esegue nell'ordine corretto, per un'automazione più fluida.

Formato di output

Ogni Smart Action può produrre:

• →Testo grezzo — incollato direttamente nell'applicazione attiva.
• →Struttura — elenchi, tabelle Markdown, JSON.
• →Email — corpo pronto per essere inviato, con oggetto suggerito.

Un'icona personalizzabile appare nella notifica prodotta da ogni Smart Action per identificare l'azione di origine a colpo d'occhio.

Importa / Esporta

Dalla versione 1.0.13, le tue Smart Actions possono essere esportate in formato JSON portatile e condivise tra Mac. I percorsi dei file referenziati (ad esempio una cartella di output) vengono automaticamente convertiti in percorsi relativi durante l'esportazione e ripristinati all'importazione. Utile per sincronizzare più macchine o condividere una libreria di azioni con il tuo team.

Buone pratiche

• •Una Smart Action = un solo obiettivo chiaro. Evita i prompt che cercano di fare tutto contemporaneamente.
• •Specifica sempre il formato di output atteso nel prompt.
• •Indica il pubblico di destinazione («per un destinatario non tecnico», «tono formale», ecc.).
• •Testa la Smart Action tramite l'area di prova nella schermata iniziale prima di attivarla in condizioni reali.