Asteria Docs
Agenti

Tutorial: il tuo primo agente

Costruisci un agente funzionante dall'inizio alla fine in una ventina di minuti, usando un lavoro che hai davvero.

Costruiremo Controllo Tono di Voce, un agente che revisiona i testi confrontandoli con la tua guida di stile. Sostituisci il soggetto con il tuo mentre procedi: lo schema funziona per la maggior parte dei lavori.

Alla fine avrai un agente che puoi chiamare con @, e che potresti condividere con il tuo team.

Prima di iniziare

Tieni a portata di mano un documento che descriva come scrive la tua organizzazione: una guida di stile, una pagina sul tono di voce, o anche solo un buon esempio di testo di cui eri soddisfatto. Una pagina sola basta.

Metti il materiale di riferimento dove l'agente possa raggiungerlo

Se è una o due pagine, lo allegherai direttamente all'agente più avanti. Per adesso non devi fare niente.

Se è un mucchio vero (una guida di stile più le campagne passate più i messaggi di prodotto), crea prima una raccolta e mettili lì dentro. Chiamala Linee Guida di Marca.

Crea l'agente

Agenti nella barra laterale, poi Crea agente.

Nome: Controllo Tono di Voce

Descrizione: Revisiona i testi confrontandoli con il nostro tono di voce e segnala tutto ciò che non è in linea con il marchio.

Scrivi le istruzioni

È la parte che vale dodici dei tuoi venti minuti. Adatta:

Controlli i testi scritti rispetto alla nostra voce di marca, per una
fintech B2B che vende a direttori finanziari di aziende di medie
dimensioni.

Come scriviamo:
- Sicuri e semplici. Frasi corte. Nomi concreti.
- Spieghiamo, non vendiamo. Niente superlativi.
- Italiano, senza anglicismi evitabili.

Non usare mai: rivoluzionario, innovativo, all'avanguardia,
a 360 gradi, chiavi in mano, sinergia.

Quando revisioni un testo:
1. Dai prima la versione corretta, pronta da incollare.
2. Poi elenca cosa hai cambiato e perché, una riga per voce.
3. Poi segnala a parte tutto ciò che è un'affermazione fattuale
   che dovremmo poter documentare. Quelle non riscriverle.
   Chiedi.

Se il testo è già in linea con la marca, dillo chiaramente invece di
inventare modifiche per giustificarti.

Se non sei sicuro che qualcosa infranga una regola, di' che non sei
sicuro e spiega la tensione. Non decidere in silenzio.

Gli ultimi due paragrafi sono quelli che lo rendono utile. Senza di loro un agente troverà sempre qualcosa da cambiare, perché è quello che pensa tu gli abbia chiesto.

Dagli il materiale di riferimento

Scorri fino a Conoscenza.

Una raccolta: sotto Raccolte fissate, fissa Linee Guida di Marca. Adesso l'agente ci cerca automaticamente, senza che nessuno la nomini.

Una pagina o due: sotto File caricati, carica la guida di stile. Il suo contenuto è davanti all'agente a ogni turno.

Non fare entrambe le cose con lo stesso documento. Scegli quella adatta alla dimensione.

Decidi sugli strumenti

Per questo agente, probabilmente nessuno. Legge testi e dà un parere.

Resisti alla tentazione di aggiungere la ricerca web "non si sa mai". Uno strumento che il lavoro non richiede è un modo per far divagare l'agente, e rende ogni risposta più lenta.

Aggiungi i suggerimenti

Sotto Suggerimenti, aggiungine due o tre:

  • Controlla il titolo e il sottotitolo di questa landing page.
  • Questa email è troppo commerciale?
  • Riscrivi questo paragrafo con la nostra voce.

Salta questo passaggio e un collega che apre il tuo agente dovrà tirare a indovinare.

Salva, poi testalo come si deve

Conferma per salvare. Adesso usa il pannello Test sulla destra, e non testare il caso facile.

Dagli un testo che va già bene. Lo dice, oppure si inventa dei cambiamenti? Se se li inventa, rafforza quell'istruzione.

Dagli un testo con un'affermazione fattuale. "La nostra piattaforma riduce del 90% i tempi di riconciliazione." Segnala l'affermazione invece di lucidarla?

Dagli qualcosa fuori tema. "Scrivimi un piano di progetto." Rifiuta con criterio?

Aggiusta le istruzioni e testa di nuovo. Due o tre giri sono normali, e questo ciclo è il vero lavoro di costruire un agente.

Usalo

Torna nella chat, digita @ e scegli Controllo Tono di Voce, oppure cliccalo nella barra laterale sotto I miei agenti. Metti la stella per fissarlo in cima.

Migliorarlo nelle prossime due settimane

Un agente non è finito quando lo salvi. Il ciclo utile:

Quando sbaglia qualcosa, correggi le istruzioni, non il messaggio. Riformulare la tua richiesta rattoppa una conversazione. Modificare l'incarico sistema tutte quelle future.

Aggiungi le eccezioni man mano che le incontri. La prima volta che segnala qualcosa che non avrebbe dovuto, aggiungi una riga che lo dice.

Tienilo corto. Istruzioni che si allargano a 4000 caratteri di casi particolari diventano peggiori, non migliori: le regole importanti affogano. Se si sta allungando, forse il lavoro è due agenti, oppure i dettagli specifici appartengono a una competenza.

Quando sei pronto a condividerlo

Prima dallo a un collega o due e guarda cosa scrivono. Chiederanno cose che a te non verrebbero mai in mente, ed è il feedback più economico che esista. Poi vedi Condivisione e marketplace.

Prossimi passi

  • Competenze per le procedure che vuoi in qualsiasi conversazione, non solo in quelle di questo agente.
  • Trigger per far girare un agente su una programmazione.
  • Workflow per lavori a più passaggi che girano senza di te.

On this page