# General Translation Platform: Definire il contesto per le traduzioni URL: https://generaltranslation.com/it/docs/platform/dashboard/guides/defining-context-for-translations.mdx Docs index: https://generaltranslation.com/llms.txt Description: Come mantenere coerenti terminologia, tono di voce e stile nelle traduzioni usando i Gruppi di contesto. Ottieni traduzioni di altissima qualità per il tuo prodotto, inclusi terminologia chiave, tono di voce del brand e stile. Usa i Gruppi di contesto per applicare linee guida condivise alla tua app, al sito web, alla documentazione, alle presentazioni e a ogni altra superficie. ## Flusso di lavoro di base per il contesto [#basic-context-workflow] 1. Apri la tua Organization nel **[Dashboard](https://dash.generaltranslation.com)**. 2. Vai alla pagina **contesto**. 3. Crea un **gruppo di contesto**. 4. Aggiungi un **Glossario** (per la terminologia) e **prompt personalizzati** (per lo stile e il tono). 5. **Assegna** il tuo gruppo di contesto ai progetti pertinenti. 6. Genera le traduzioni oppure applica gli aggiornamenti alle traduzioni esistenti. ## Cosa sono i gruppi di contesto? [#context-groups] I **gruppi di contesto** sono istruzioni riutilizzabili per la traduzione. Assegna un gruppo a uno o più progetti per garantire terminologia e tono coerenti in tutte le traduzioni. *Ad esempio, puoi applicare lo stesso gruppo di contesto all'app, al sito web, alla documentazione e alle presentazioni commerciali.* a) Il **Glossario** definisce la terminologia e come gestire i termini chiave, inclusi termini di prodotto, nomi di brand, funzionalità e termini tecnici. *Esempio: mantieni "Locadex" non tradotto in ogni impostazione regionale.* b) I **prompt personalizzati** definiscono il tono delle traduzioni, inclusi pubblico, livello di formalità, tono di voce, convenzioni e formattazione. *Esempio: usa la forma attiva, evita il gergo e utilizza il formale "Sie".* I gruppi di contesto sono disponibili a livello di Organization. Ti consigliamo di applicare un gruppo di contesto a tutti i tuoi progetti e di aggiungere poi ulteriori gruppi di contesto specifici per progetto se le diverse aree presentano differenze di terminologia o stile. ## Utilizzare i termini chiave nel Glossario [#using-key-terms] Usa il Glossario per parole e frasi che richiedono un trattamento coerente nelle traduzioni. I termini del Glossario sono utili per: * Nomi di marchi * Nomi di prodotti * Nomi di funzionalità * Termini tecnici * Frasi che devono rimanere non tradotte Aggiungi i termini al Gruppo di contesto che deve gestirli. Se lo stesso termine compare in più gruppi assegnati, prevale il gruppo con priorità più alta. Se quel gruppo non ha una traduzione per un'impostazione regionale di destinazione, viene usata la traduzione di un gruppo con priorità più bassa, mentre resta valida la definizione del gruppo con priorità più alta (vedi [Impostare la priorità quando i gruppi si sovrappongono](#priority)). Usa **Cerca termini** per trovare una voce esistente nel Glossario. I termini creati dai file sorgente mostrano l'indicatore **Aggiunto automaticamente**. Usa il filtro accanto alla ricerca per visualizzare solo i termini **Aggiunti manualmente** o **Aggiunti automaticamente**. Se rinomini un termine aggiunto automaticamente, ne modifichi la definizione o aggiungi manualmente una traduzione, al salvataggio il termine viene considerato aggiunto manualmente. ## Uso dello stile e del tono nei prompt personalizzati [#using-style-tone] Usa i prompt personalizzati per fornire istruzioni di traduzione più generali rispetto a un singolo termine. I prompt personalizzati sono utili per: * Stile e tono * Pubblico di destinazione * Registro formale o informale * Regole di stile specifiche per impostazione regionale * Istruzioni specifiche per prodotto o dominio Ogni prompt personalizzato può essere applicato globalmente o a una singola impostazione regionale. Usa un prompt personalizzato specifico per impostazione regionale quando le indicazioni devono applicarsi solo a una lingua di destinazione o a una regione. Quando l'impostazione regionale sorgente e quella di destinazione condividono la stessa lingua e lo stesso sistema di scrittura, come `en-US` e `en-GB`, la traduzione è un adattamento regionale: mantiene la formulazione del testo sorgente e modifica una parola solo per ragioni di ortografia, lessico regionale, grammatica, punteggiatura o convenzioni su date, numeri e unità di misura. I prompt relativi a tono e scelte lessicali si applicano solo a queste modifiche. Le impostazioni regionali che condividono una lingua ma usano sistemi di scrittura diversi, come `zh-Hans` e `zh-Hant`, vengono tradotte normalmente. Usa **Cerca prompt personalizzati** per filtrare il gruppo di contesto corrente. ## Come creare e assegnare un gruppo di contesto [#create-assign-context] Puoi creare un gruppo di contesto dalla pagina dell'Organization o dalla pagina di un progetto specifico. *Nota: i gruppi di contesto si applicano alle nuove traduzioni, ma non aggiornano automaticamente quelle esistenti. (Vedi [Applicare le traduzioni del glossario](#apply-glossary)).* ### a) Crea un gruppo di contesto per più progetti *Usa il flusso a livello di Organization se vuoi creare prima un gruppo condiviso e poi assegnarlo a uno o più progetti.* 1. Apri **Contesto** nella barra laterale di **[Organization](https://dash.generaltranslation.com)**. 2. Fai clic sul segno più, quindi su **Crea nuovo gruppo**. 3. Inserisci un nome e conferma. 4. Usa le schede **Glossario** e **Prompt personalizzati** per aggiungere il contesto pertinente. 5. Apri ciascun progetto pertinente. 6. Assegna il gruppo dalla scheda **Contesto** del progetto. 7. Usa il pulsante **Traduci** per generare con l'IA le traduzioni dei termini del Glossario per ogni impostazione regionale di destinazione. I gruppi di contesto assegnati forniscono indicazioni per le nuove traduzioni, incluse quelle generate da Locadex. ### b) Crea un gruppo di contesto per il progetto corrente *Usa il flusso a livello di progetto se stai già lavorando in un progetto e vuoi assegnarvi immediatamente il gruppo.* 1. Apri **Contesto** nella barra laterale del progetto. 2. Fai clic sul segno più, quindi su **Crea nuovo gruppo**. 3. Inserisci un nome. Per popolare il gruppo a partire dai file sorgente attuali del progetto, seleziona **Genera automaticamente dai file del progetto**, quindi fai clic su **Crea**. 4. Usa le schede **Glossario** e **Prompt personalizzati** per aggiungere il contesto pertinente. 5. Usa il pulsante **Traduci** per generare con l'IA le traduzioni dei termini del Glossario per ogni impostazione regionale di destinazione. Quando crei un gruppo di contesto da un progetto, questo viene comunque creato a livello di Organization. La Dashboard lo assegna automaticamente al progetto corrente. ### c) Importare o esportare un gruppo di contesto esistente *Utilizza il flusso di importazione/esportazione per gestire i gruppi di contesto esistenti.* **Sviluppatori:** per automatizzare importazioni, esportazioni o qualsiasi altra modifica a un gruppo di contesto, utilizza la [Context Management API](/docs/platform/openapi/reference/context-groups/list-context-groups) o i relativi strumenti MCP con una chiave di Organization dotata delle autorizzazioni **contesto**. Nella maggior parte dei casi, assegna o riassegna direttamente i progetti ai gruppi di contesto. Tuttavia, per modifiche importanti, puoi anche utilizzare **Esporta** per scaricare il Glossario e i prompt personalizzati di un gruppo. **Importa** accetta file CSV, TSV, JSON e di testo. L'anteprima ignora i prompt personalizzati, le definizioni e le traduzioni già esistenti, ma può includere le traduzioni mancanti di un termine esistente. Il CSV esportato utilizza due sezioni: * Custom Prompts, con le colonne `name`, `description`, `locale` e `value`. * Glossary, con `term`, `definition` e una colonna `translation_` per ogni impostazione regionale tradotta. È valido anche un Glossario privo di colonne di traduzione. L'importatore legge esattamente questo formato, inclusi i CSV con intestazioni di foglio di calcolo sovrapposte. Accetta anche esportazioni precedenti in cui la sezione dei prompt è denominata Directives. I contenuti al di fuori del formato riconosciuto vengono interpretati dall'IA. Ogni colonna `translation_` mantiene nella propria intestazione il codice locale esatto, incluse le varianti regionali e di sistema di scrittura, e qualsiasi [impostazione regionale supportata](/docs/platform/dashboard/reference/supported-locales) può essere importata anche se il progetto non la prevede come destinazione. Controlla il **Riepilogo importazione** prima di confermare: elenca i prompt personalizzati, i termini, le definizioni e le traduzioni che verranno aggiunti. Seleziona un'impostazione regionale importata nel riepilogo per rimapparne le traduzioni prima di salvare. Puoi scegliere qualsiasi impostazione regionale supportata, tranne quella di origine o una già utilizzata da un'altra colonna importata. Le traduzioni del Glossario per impostazioni regionali non supportate vengono ignorate e tali impostazioni regionali sono elencate nell'anteprima. ## Impostare la priorità in caso di sovrapposizione dei gruppi [#priority] Quando a un progetto sono assegnati più gruppi, la priorità del contesto determina quali indicazioni prevalgono in caso di sovrapposizione. * Riordina i gruppi in **Progetto > Contesto** (il gruppo in alto ha la priorità più alta). * I termini appena generati vengono salvati nel gruppo sbloccato con la priorità più alta (vedi [Controllare gli aggiornamenti automatici](#automatic-updates)). ## Controllare gli aggiornamenti automatici [#automatic-updates] Attiva **Automatic Context Update** in **progetto > Settings** per consentire alle esecuzioni di traduzione di aggiungere contesto e termini del Glossario ricavati dai tuoi file sorgente. Per impostazione predefinita, i nuovi gruppi di contesto accettano gli aggiornamenti automatici. Per proteggere un gruppo dalle modifiche automatiche, apri il relativo menu delle azioni in **progetto > contesto** o **Organization > contesto** e scegli **Lock**. Accanto al gruppo comparirà un lucchetto. I gruppi bloccati continuano a guidare le traduzioni e si possono comunque modificare manualmente, ma le esecuzioni di traduzione non vi aggiungono contesto, termini o traduzioni mancanti del Glossario. Scegli **Unlock** per riattivare gli aggiornamenti automatici. Il contesto e i termini appena generati vengono inseriti nel gruppo sbloccato con la priorità più alta tra quelli assegnati al progetto. Le traduzioni mancanti dei termini già presenti nel Glossario possono essere completate anche in altri gruppi sbloccati assegnati. Se tutti i gruppi assegnati sono bloccati, non viene scritto nulla. Se al progetto non è assegnato alcun gruppo, il primo aggiornamento automatico ne crea uno e lo assegna al progetto. ## Genera le traduzioni del Glossario [#generate-glossary] Usa il pulsante **Traduci** nella pagina **Contesto** del progetto per generare traduzioni con l'AI dei termini del Glossario per ogni impostazione regionale di destinazione. ## Applicare le traduzioni del glossario [#apply-glossary] *Le modifiche a un gruppo di contesto si applicano a tutte le nuove traduzioni, ma non aggiornano automaticamente quelle esistenti.* Usa il pulsante **Applica** nella pagina **Contesto** del progetto per aggiornare i contenuti già tradotti con i termini del glossario e le impostazioni regionali selezionati. Per i file HTML, **Applica** aggiorna i termini del glossario selezionati nella traduzione esistente. L'AI è istruita a preservare il testo non interessato dalle modifiche, comprese quelle manuali; dopo l'applicazione, rivedi il risultato. Per ritradurre completamente un file, usa invece la [CLI](/docs/cli/quickstart) o avvia una traduzione con [Locadex](/docs/platform/locadex/quickstart). ## Next steps - /docs/platform/dashboard/guides/reviewing-translations - /docs/platform/dashboard/guides/adding-annotations - /docs/platform/dashboard/guides/using-ask-ai - /docs/platform/dashboard/guides/managing-billing ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.