Identità, skill e memoria

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.

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.

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.

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.

Pagine correlate

• Verifica il comportamento con gli eval
• Dai strumenti a un agente
• Accesso al Workspace