# Identità, skill e memoria

> Definisci l’autorità, insegna procedure riutilizzabili e controlla le lezioni che l’agente conserva.

Usa **Istruzioni** per mantenere il comportamento. Tieni breve l’identità, metti le procedure ricorrenti nelle skill e usa la memoria per lezioni verificate.

## Prima di iniziare

Serve accesso owner o editor della dashboard per modificare le istruzioni. Prepara input rappresentativi e risultati attesi per i compiti basati su documenti.

## Identità

1. Apri la scheda **Istruzioni** dell’agente.
2. Seleziona **Modifica** su **Identità**, oppure **Scrivi identità** se un vecchio agente non ne ha una.
3. Descrivi ruolo, ambito, decisioni, regole ferree, tono e quando chiedere a una persona.
4. Seleziona **Salva**.

L’identità vive in AGENTS.md e accompagna ogni conversazione ed esecuzione. Un agente senza identità non può ricevere lavoro. Sposta i dettagli procedurali in una skill, così ogni esecuzione porta solo ciò che serve.

L’identità è testo formattato: digita `/` per aggiungere titoli, elenchi, tabelle o immagini e `@` per collegare un file che l’agente può aprire. Le immagini aggiunte vengono salvate nella Home dell’agente, accanto ad AGENTS.md. Scegli **Sorgente** per modificare direttamente il Markdown.

> **Regola** — Non inserire mai segreti in identità, memoria o skill. Usa le [credenziali](/it/docs/tools/credentials). Tieni i dettagli temporanei nella conversazione e i fatti aziendali nei file aziendali.

## Skill

1. Seleziona **Aggiungi skill**, poi **Scrivi una nuova skill**.
2. Dai un nome e una descrizione che indica compito e situazioni d’uso. Per esempio: «Prepara un preventivo quando un cliente richiede una proposta o prezzi personalizzati».
3. Scrivi la procedura con passaggi numerati, regole ed esempi. Indica le fonti necessarie e definisci un risultato verificabile. Digita `/` per titoli, elenchi, tabelle o immagini; quando la skill esiste, le immagini vengono salvate nella sua cartella.
4. Aggiungi modelli, esempi o listini con **Aggiungi file** o **Aggiungi cartella**.
5. Digita @ per inserire un link Markdown a un file di supporto o del Workspace. I file condivisi richiedono comunque l’accesso dell’agente.
6. Seleziona **Crea skill**, oppure **Salva** quando modifichi.

All’avvio, l’agente vede nomi e descrizioni delle skill. Una descrizione pertinente lo porta a caricare SKILL.md, poi i file citati. Gli script usano l’Esecutore di codice.

Le skill usano il formato aperto Agent Skills: `skills/<nome>/SKILL.md` contiene nome e descrizione nell’intestazione, seguiti dalle istruzioni Markdown. Riferimenti, risorse e script possono usare percorsi relativi dentro la cartella della skill.

Per rinominare una skill, cambia il nome nella sua pagina e salva: la cartella e i file di supporto la seguono. Il Workspace non rinomina né sposta mai la cartella di una skill o il suo SKILL.md. Gli altri documenti che citano il vecchio nome lo mantengono.

I file di supporto aggiunti e rimossi si applicano al salvataggio; quelli rimossi finiscono nel Cestino. Se un caricamento fallisce, conserva la bozza e riprova. Se qualcuno ha salvato una versione più recente, confrontala e uniscila prima di salvare; la bozza non la sovrascrive silenziosamente.

Eliminare una skill sposta tutta la sua cartella nel Cestino. Puoi ripristinarla per sette giorni.

## Importa una skill

1. Seleziona **Aggiungi skill**, poi **Importa da un comando o URL**.
2. Incolla l’URL di un repository o un comando `npx skills add`.
3. Seleziona **Anteprima**.
4. Controlla skill selezionate, file, script, compatibilità e stato dell’audit.
5. Seleziona **Importa** per installare la copia esaminata.

Botchi interpreta il comando come testo; non lo esegue mai. Puoi anche usare **Sfoglia il catalogo della community** e **Importa** nella pagina di una skill. Sfogliare non installa nulla.

La skill installata è una copia dell’account. **Importato** identifica la fonte; **Modificata dalla sorgente** indica una modifica locale. Le esecuzioni non dipendono dalla fonte online. Audit di sicurezza falliti e nomi duplicati bloccano l’installazione; se la fonte cambia serve una nuova anteprima.

> **Attenzione** — Importare non concede strumenti, connessioni o accesso ai file. Sono supportati script Node.js e Python; gli altri runtime risultano non supportati. Controlla gli script prima di importare.

## Script

1. Apri **Workspace** sull’agente.
2. Salva codice riutilizzabile Node.js o Python in scripts/, oppure includilo in una skill.
3. Cita lo script e gli input necessari nella skill che lo usa.
4. Prova il risultato in **Chat**, poi riesegui gli [eval](/it/docs/agents/evals).

Usa le skill per procedure che richiedono discernimento. Usa gli script per calcoli, conversioni ed elaborazioni ripetibili. L’Esecutore di codice legge e scrive solo entro l’accesso al Workspace dell’agente.

## Memoria

1. Apri **Istruzioni** e trova **Memoria**.
2. Seleziona **Apri** per controllare MEMORY.md nell’editor dei file.
3. Correggi mappature o lezioni obsolete ed elimina i fatti aziendali duplicati.
4. Salva le modifiche e prova un compito che dipende da esse.

L’agente cura la memoria e la legge quando serve il contesto passato. Conserva procedure durature, mappature verificate, particolarità degli strumenti e correzioni. Consolida invece di aggiungere senza fine.

| Elemento | Limite |
| --- | --- |
| Identità | 16.000 caratteri |
| Memoria | Consigliati meno di 8.000 caratteri; limite massimo 12.000 |
| Skill | 30 per agente |
| Nome della skill | 64 caratteri |
| Descrizione della skill | 1.024 caratteri |

## Pagine correlate

- [Verifica il comportamento con gli eval](/it/docs/agents/evals)
- [Dai strumenti a un agente](/it/docs/agents/tools)
- [Accesso al Workspace](/it/docs/agents/workspace-access)
