Scrivere una buona competenza

Competenze, poi Crea competenza. Quattro cose da compilare.

Oppure chiedila semplicemente in una conversazione. Descrivi la competenza che vuoi («scrivi come formattiamo i casi studio: il titolo, poi il problema in una frase, poi i numeri») e Asteria ne prepara la bozza. Una scheda ti mostra le istruzioni scritte, la descrizione che decide quando la competenza si attiva e se si caricherà da sola o aspetterà una /, e non viene creato nulla finché non approvi quella scheda. Ottieni una competenza ordinaria: aprila qui dopo per modificarla, condividerla o disattivare il caricamento automatico.

Nome

Cos'è, in un paio di parole. Formato Caso Studio, Appunti di Riunione, Risposte sulla Politica Spese.

È quello che vedi nell'elenco del /, quindi rendilo facile da scorrere.

Descrizione

Duecento caratteri, e il campo più importante della pagina.

Il riquadro chiede "Quando il tuo assistente dovrebbe usare questa competenza?" e lo intende letteralmente. Con il Caricamento automatico attivo, è questo testo che Asteria legge per decidere se la competenza si applica. È un innesco, non un riassunto.

Scrivila come una condizione, non come una descrizione.

Debole, perché descrive invece di innescare:

Il nostro formato aziendale per i casi studio dei clienti.

Forte, perché dice quando:

Impaginare un caso studio o una storia di successo di un cliente. Copre l'ordine delle sezioni, la lunghezza e la citazione in evidenza obbligatoria. Caricala prima di scrivere qualsiasi caso studio.

Le competenze integrate sono tutte scritte così, e vale la pena copiarle. Una di loro dice:

Richieste di diagrammi (diagramma di flusso, architettura, pipeline, macchina a stati). Usa create_diagram, non generate_image. Caricala prima di qualsiasi richiesta del tipo "disegna / diagramma / rappresenta il flusso".

Nota cosa fa: nomina le situazioni, elenca le parole che un utente scriverebbe davvero e finisce con un esplicito "caricala prima di X". È quest'ultima frase a lavorare parecchio.

Se la tua competenza sembra non scattare mai, la ragione è quasi sempre la descrizione. Aggiungi il vocabolario che userebbero i tuoi colleghi, comprese le parole informali.

Caricamento automatico

Attivo significa che Asteria può raccogliere la competenza da sola. Giusto per qualsiasi cosa debba applicarsi ogni volta che si presenta la situazione, cioè la maggior parte delle competenze.

Disattivato significa solo /. Giusto quando:

• La competenza ha un'opinione forte e deve applicarsi solo su richiesta
• Si applica a un caso ristretto che preferisci decidere tu
• Contraddice un'altra competenza, e vuoi scegliere tra le due

Istruzioni

La competenza vera e propria, in Markdown, con una scheda Modifica e una Anteprima.

Scrivila come una procedura per qualcuno di capace che però non ha mai fatto questo compito specifico qui. Cosa funziona:

Sii concreto sulla forma. Numera le sezioni, di' quanto è lunga ciascuna, dai l'ordine.

Fai un esempio. Un breve esempio svolto vale tre paragrafi di descrizione.

Di' cosa non fare, soprattutto dove l'approccio ovvio è sbagliato. "Non aprire con la storia dell'azienda del cliente. Parti dal problema."

Di' cosa fare quando non calza. "Se non c'è un risultato misurabile, dillo chiaramente invece di inventarne uno morbido, e segnalalo a chi scrive."

Cosa non funziona:

Ripetere le buone pratiche. "Sii chiaro e conciso" è già in vigore e spreca lo spazio.

Farla enorme. Una competenza viene caricata nella conversazione quando scatta, e una dilagante soffoca la tua vera domanda. Se la tua si sta allungando, probabilmente sono due competenze.

Duplicare le istruzioni di un agente. Se si applica solo dentro un agente, e quell'agente lo dice già, la competenza non ti serve.

Testarla

Avvia una chat e descrivi la situazione senza nominare la competenza:

Scrivi un caso studio sull'implementazione per Acme.

Se il Caricamento automatico è attivo e la descrizione è buona, scatta. Se non scatta, alla descrizione mancano le parole che hai appena usato.

Poi controllala con / per confermare che le istruzioni producano quello che volevi. Due test separati, perché falliscono per motivi diversi: una competenza che scatta ma produce la forma sbagliata è un problema di istruzioni, e una competenza che non scatta mai è un problema di descrizione.

Ricordati di togliere la pillola dopo, altrimenti resta in vigore per tutto il resto di quella conversazione.

Condivisione

La normale finestra di condivisione, oppure Pubblica per metterla sul marketplace della tua organizzazione dove chiunque può aggiungerla alla propria libreria.

Quando pubblichi puoi consentire o vietare la duplicazione. Consentila se preferisci che le persone adattino la tua competenza piuttosto che partire da zero. Vietala se il punto è proprio che tutti seguano una sola versione.

Rimuovere dalla pubblicazione toglie la competenza dal marketplace e revoca la voce di libreria di tutti, quindi quello che avevano duplicato resta con loro e quello che avevano solo aggiunto sparisce.