---
lastModified: 2026-09-08
title: Allegati, modelli e competenze
description: Aggiungi immagini di riferimento o documenti supportati e scegli le funzionalità Runner adatte alla richiesta.
---

Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.

**Cosa copre questa guida:** Darai a Runner il contesto giusto e gli strumenti di lavoro prima di inviare una richiesta.

Le immagini mostrano a Runner cosa intendi. I modelli e le competenze cambiano le capacità disponibili per
la prossima richiesta. Quando compare **Allega**, puoi fornire anche documenti supportati come contesto. Usali con criterio: una richiesta chiara resta l'input più importante.

**Percorso di accesso:** Apri un progetto del negozio → compositore di conversazione.

## Prima di iniziare

- Usa solo immagini che sei autorizzato a condividere con l'area di lavoro corrente.
- Rimuovi segreti, dati di pagamento e informazioni cliente non necessarie.
- Verifica l'accesso al piano e al browser quando un modello, una Competenza o un'azione di acquisizione dello schermo manca.

## Controlli del compositore

| Controllo | Cosa succede quando lo selezioni |
| --- | --- |
| **Aggiungi** | Su desktop apre **Carica immagine** oppure **Allega** quando i documenti sono abilitati, più **Cattura schermata** se supportato. |
| **Allega**, se disponibile | Apre il selettore di documenti e immagini supportati. |
| **Carica immagine** | Apre il selettore di immagini per file JPG/JPEG, PNG, GIF, WebP, BMP o TIFF. |
| **Dalla libreria multimediale**, se disponibile | Apre media esistenti del progetto per scegliere un riferimento per la bozza. |
| **Cattura schermata** | Avvia l'acquisizione dello schermo quando il browser e l'account lo supportano. Il browser potrebbe chiedere il permesso. |
| **Immagine** su mobile | Apre il selettore di immagini mobile. Se i documenti sono abilitati, compare invece **Allega**. |
| Selettore modello | Elenca i modelli Runner disponibili per l'account. Un modello bloccato apre il percorso **Piano e Fatturazione** pertinente invece di selezionarlo. |
| **Comandi rapidi** o **Competenze** | Apre le scorciatoie disponibili che possono essere aggiunte alla richiesta. |
| **Altre azioni** | Rivela gli strumenti del compositore che non si adattano al layout corrente. |

Nel selettore di sole immagini, Runner ignora un'immagine con nome e dimensione uguali a una già in bozza e mostra
**Immagine duplicata ignorata**. I file non supportati vengono ignorati con **Usa un'immagine JPG, PNG, GIF, WebP, BMP,
o TIFF**. In una selezione mista restano disponibili le immagini supportate. Runner accetta fino a 10 allegati per messaggio. Ogni immagine può arrivare a 32 MB; se i documenti sono abilitati, ciascuno può arrivare a 10 MB.

<Frame>

[![Annotazioni in inglese: Menu Aggiungi con Allega, Acquisisci screenshot e Dalla libreria multimediale](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgedkCrZ0t0K8TVvF5tOkun9rDY6WCahRXSMdG)](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgedkCrZ0t0K8TVvF5tOkun9rDY6WCahRXSMdG)

</Frame>

Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.

In questo spazio i documenti sono abilitati, quindi il menu mostra **Allega**. Aprirlo non carica file e non invia la richiesta.

## Aggiungi un'immagine

1. Scrivi abbastanza della richiesta per spiegare perché il file è importante.
2. Seleziona **Aggiungi** su desktop, o il pulsante di caricamento su mobile.
3. Scegli **Carica immagine**, **Immagine** o **Cattura schermata**, a seconda di cosa è mostrato.
4. Scegli o acquisisci l'immagine pertinente.
5. Verifica che la miniatura corretta compaia nella bozza e che il caricamento sia terminato.
6. Rimuovila prima di inviare se è il riferimento sbagliato.
7. Seleziona **Invia messaggio**.

Se l'acquisizione dello schermo non è disponibile o il permesso è negato, acquisisci uno screenshot con il tuo dispositivo e
carica l'immagine salvata invece.

## Allega un documento quando disponibile

1. Apri **Aggiungi** e seleziona **Allega**. Se compare solo **Carica immagine** o **Immagine**, questo spazio non supporta documenti nel compositore.
2. Scegli un file supportato, come PDF, documento Word, presentazione, foglio di calcolo o CSV.
3. Verifica che l'allegato compaia accanto alla bozza.
4. Spiega cosa usare, ad esempio «Usa nomi e descrizioni dei prodotti in questo CSV per preparare i testi delle collezioni; non cambiare i prezzi».
5. Seleziona **Invia messaggio** e attendi la preparazione del documento.
6. Verifica che la risposta rifletta il documento desiderato prima di chiedere modifiche al negozio.

Se il file non è leggibile, segui l'errore mostrato. Documenti protetti da password, danneggiati, troppo complessi o vuoti possono fallire. Usa un'esportazione sbloccata e più piccola o incolla il testo pertinente; conserva la bozza finché il sostituto viene accettato. Questo flusso non supporta video.

## Scegli un modello

1. Seleziona il modello corrente nel compositore.
2. Esamina i modelli disponibili. L'interfaccia registrata mostra **Runner 2.0 Pro**; usa l'etichetta nel tuo selettore perché i profili possono cambiare.
3. Scegli il modello che corrisponde al compito.
4. Conferma che il modello selezionato sia mostrato prima di inviare.

Se un modello è bloccato, mantieni il modello corrente o segui il percorso di informazioni sul piano che Runner apre. Una
scelta bloccata non viene applicata alla bozza.

## Aggiungi una competenza

1. Apri **Comandi rapidi** o **Competenze** nel compositore, quando disponibili.
2. Cerca o sfoglia la capacità di cui hai bisogno.
3. Seleziona una [competenza disponibile](/it/guides/agent/create-import-manage-skills). **Comandi rapidi** può inserire un comando slash nel compositore, come `/store-seo`: selezionarlo non lo esegue.
4. Torna al compositore e verifica la presenza della competenza o del comando desiderato. Aggiungi le istruzioni specifiche prima di inviare.
5. Invia la richiesta.

La [tavolozza dei comandi dell'Agente](../agent/command-palette) separata gestisce lo stato delle funzionalità: scegliere una riga può installare, attivare o sospendere una competenza. Non equivale a selezionarla nel compositore.

Quando il piano corrente non include una competenza, Runner può aprire il percorso **Agente** o di aggiornamento
invece. Le scelte di memoria appaiono solo quando la memoria è abilitata per l'account.

<Frame>

![Comandi rapidi con suggerimento del comando store-seo](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZLDAg8X1SeWCnfPOVJ4KlBMuoAdXFahgI3R)

</Frame>

Selezionare un comando prepara la bozza. Aggiungi la richiesta e controllala prima dell'invio.

### Guarda: prepara un comando rapido

<video controls playsInline preload="metadata" poster="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgxZLDAg8X1SeWCnfPOVJ4KlBMuoAdXFahgI3R" aria-label="prepara un comando rapido" style={{ width: '100%', aspectRatio: '460 / 420' }}>
  <source src="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgEPlUiehdR6T0uwqnz73letZimQpFvYfSrhLM" type="video/mp4" />
  <a href="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgEPlUiehdR6T0uwqnz73letZimQpFvYfSrhLM">Apri la registrazione</a>
</video>

La registrazione seleziona **store-seo** nel compositore e lo lascia non inviato. Non avvia analisi SEO.

## Risoluzione dei problemi

| Problema | Cosa fare |
| --- | --- |
| L'immagine non viene aggiunta | Usa un formato di immagine supportato, mantienila sotto 32 MB e mantieni il messaggio a 10 immagini o meno. |
| **Immagine duplicata ignorata** | La stessa immagine con lo stesso nome e dimensione è già nella bozza. Mantieni la copia esistente o rimuovila prima di selezionare di nuovo l'immagine. |
| Avviso di file non supportato | Scegli JPG/JPEG, PNG, GIF, WebP, BMP o TIFF. Se **Allega** è disponibile, puoi scegliere un documento supportato; altrimenti usa un'immagine o incolla il testo pertinente. |
| **Cattura schermata** manca | Usa un'immagine salvata; l'acquisizione diretta è disponibile solo in determinate condizioni. |
| L'acquisizione dello schermo si interrompe | Consenti il permesso del browser quando appropriato, o allega uno screenshot normale. |
| Una competenza non si attiva/disattiva | Termina qualsiasi azione del compositore in conflitto e conferma che il piano include la competenza. |
| Un modello bloccato apre la fatturazione | Chiudi la schermata del piano per mantenere il modello corrente, o rivedi l'accesso con il proprietario dell'area di lavoro. |

## Guide correlate

- [Scrivi richieste efficaci](/it/guides/work-with-runner/write-effective-requests)
- [Tavolozza dei comandi Agent](../agent/command-palette)
- [Chatta con Runner](/it/guides/work-with-runner/chat-with-runner)
- [Impostazioni dell'area di lavoro](/it/guides/workspace/settings)
