Accedi
Indice della documentazione

Agenti & Skill

Specializza i testi e crea agenti custom per il tuo team.

Agenti & Skill sono il cuore dell'automazione testuale in SMM. Un agente è uno specialista (copywriter, social strategist…) con istruzioni e regole proprie, usato ovunque si scrivano testi: caption, copy, piani editoriali.

Tre Livelli di Agenti

1️⃣ Kit Base

  • Chi lo vede: Tutti
  • Chi lo modifica: Solo l'admin (modifiche valgono per TUTTI)
  • Cosa puoi fare tu:
  • Personalizzare: crea un override personale (non tocchi l'originale)
  • Disattivare: lo nascondi dal tuo elenco
  • Ripristinare: torna alla versione di default quando vuoi

Un agente personalizzato vale SOLO per te. L'originale rimane intatto per gli altri.

2️⃣ I Miei Agenti

  • Chi lo vede: Solo tu
  • Chi lo modifica: Tu
  • Cosa puoi fare: CRUD completo (crea, leggi, modifica, elimina)

Usa questa sezione per creare specialisti custom (es. "Copywriter Fashion", "Social Strategist TikTok", "Email Marketing Pro").

3️⃣ Default Globale (Admin Solo)

Se sei admin:

  • Vedi un pulsante Nuovo Default Globale
  • Le modifiche al kit base valgono per TUTTI gli utenti
  • Perfetto per standardizzare processi team-wide

Usa con cautela: quando aggiungi un agente al kit base, appare nel dashboard di tutti.

Anatomia di un Agente

Ogni agente ha:

📛 Icona + Nome

  • Emoji o simbolo per riconoscerlo rapidamente
  • Nome descrittivo (es. "Copywriter e-commerce")

👤 Ruolo

  • Una riga che descrive chi è (es. "esperto di copy per ads di moda femminile")
  • Usato dall'AI per capire il contesto

📝 Istruzioni (System Prompt)

  • Come deve scrivere, quale tono usare
  • Regole del brand da rispettare
  • Esempi di output desiderato
  • Parole vietate, claim standard

Es:

Sei un copywriter specializzato in e-commerce di moda.
Scrivi sempre in tono amichevole ma autorevole.
Massimo 280 caratteri per X, 2000 per email.
Usa sempre «taglia» non «fit», «colore» non «shade».
Finisci con una CTA chiara: "Scopri di più" o "Acquista ora".

🔧 Skill (opzionale)

  • File di linee guida aggiuntive (tone of voice, glossario, esempi…)
  • Puoi aggiungerne N per agente

⚙️ Parametri (opzionale)

  • Coppie chiave-valore personalizzate
  • Es. tono: "ironico", target: "millennial"
  • L'AI riceve questi valori quando esegue l'agente

Come Usare un Agente

Nel Testi AI (Copy Studio)

  • Apri il form, sezione "Agente"
  • Scegli un agente da kit base o I Miei
  • Scrivi il brief
  • Quando generi, l'AI usa le istruzioni dell'agente

Nel Piano Editoriale

  • Nel wizard, se hai installato agenti da Market:
  • "Stratega Social" guida il piano (sceglie format/angoli)
  • "Copywriter Social" scrive le caption della produzione

Se non hai agenti, la generazione usa i default globali.

Skill: Linee Guida Aggiuntive

Una Skill è un file markdown/txt con regole, glossario, esempi.

Esempi di Skill:

  • Tone of Voice 2026 — 5 toni disponibili, con 10 esempi ciascuno
  • Glossario Moda — termini corretti vs vietati
  • Linee Guida Brand XYZ — cosa fare/evitare con il brand
  • SEO Keywords — parole chiave da usare in copy

Come aggiungerla a un agente:

  1. Apri l'agente (personalizza o crea nuovo)
  2. Tab Skill
  3. Carica file (markdown o txt) oppure Scrivi una nuova skill
  4. Dai un nome (es. "Tone of Voice")
  5. Salva

L'AI leggerà la skill quando scrive.

Market: Agenti Pronti

Nel tab Market, trovi:

  • ~10 agenti specializzati SMM (Copywriter Social, Strategist, Email Pro, ecc.)
  • Un click per installarli nei tuoi agenti
  • Importa skill da GitHub/skills.sh — incolla un link a una SKILL.md e la importa

Attenzione: L'import carica la skill da GitHub. Usa solo repo fidati.

Permessi nel Team

  • Collaboratori: Vedono I Miei Agenti + Kit Base personalizzato, NON vedono Agenti Globali
  • Owner/Manager: Vedono e modificano tutto (I Miei + Kit Base + Globale)

Esempio Pratico

Scenario: Sei un'agenzia con 3 clienti. Tutti hanno toni diversi.

Soluzione:

  1. Crea 3 agenti in I Miei Agenti:
  • "Copywriter Luxury" (tono autorevole)
  • "Copywriter Fast Food" (tono energico)
  • "Copywriter SaaS" (tono tecnico-chiaro)
  1. Nel wizard piano per il cliente Luxury:
  • Scegli "Copywriter Luxury"
  • La produzione userà quel tone per tutte le caption
  1. Nel wizard piano per Fast Food:
  • Scegli "Copywriter Fast Food"
  • Output completamente diverso (più energy)

Problemi comuni

L'agente non si applica nei testi?

  • Nel form Copy Studio, controlla di aver selezionato il tuo agente
  • Se scegli "Nessuno", usa i default globali
  • Salva il form prima di generare

Le istruzioni sono troppo lunghe?

  • Max ~2000 caratteri di istruzioni (la AI le legge, ma troppo lungo = confusione)
  • Metti il dettaglio in una Skill separata

Voglio condividere un agente con il team?

  • Come owner/admin, copia le istruzioni e le skill
  • Crealo nel Default Globale
  • Apparirà nel kit base di tutti

Agenti ben costruiti = output 10x migliore. Investici tempo: scrivere prompt chiari paga enormemente.