Costruire a mano un grafico premi significa sapere quale carta legge cosa, quale campo è obbligatorio e quale combinazione non fa nulla in silenzio. Il Graph Assistant fa questa parte insieme a te: descrivi ciò che vuoi, lui propone un grafo e sei tu a decidere se entra.
✨ Cos'è
Un pannello di chat nell'editor dei grafi - sia nel grafico premi dei Livelli sia nei Comandi personalizzati in modalità grafo. Aprilo con il pulsante ✨ in alto a destra nell'area di lavoro.
Appartiene al tuo team, non a te personalmente. Tutti nel team vedono la stessa conversazione, quindi un collega può riprendere da dove avevi lasciato, e tu puoi vedere cosa ha già chiesto invece di chiederlo di nuovo.
✏️ Modifica il tuo grafo - non lo sostituisce mai
L'assistente invia solo le modifiche che vuole fare: aggiungi questa carta, cambia quel campo, collega queste due, rimuovi quell'altra. Tutto ciò che non nomina resta esattamente com'era.
Conta più di quanto sembri. La prima versione rispondeva con un grafo sostitutivo completo, e su un grafo lungo il modello lo ricostruiva a memoria e lasciava cadere rami in silenzio - producendo un grafo più piccolo che sembrava comunque perfettamente valido.
Una precisazione onesta: un modello che ignora l'istruzione e risponde comunque con un grafo intero viene accontentato, perché rifiutarsi di rispondere sarebbe peggio. Quella risposta ora è etichettata come tale - nella conversazione e di nuovo nella finestra di revisione, proprio sopra il pulsante Applica - così sai quando stai guardando una ricostruzione e non una modifica. Tutto ciò che sparirebbe è elencato sotto rimosse, nero su bianco. Con i modelli più piccoli vale la pena leggere quell'elenco invece di scorrerlo.
Due effetti collaterali arrivano gratis: gli identificatori delle carte sono assegnati dal pannello e non dal modello, quindi non possono esserci duplicati, e rimuovere una carta porta via anche i suoi collegamenti, quindi nessun collegamento resta mai puntato nel vuoto.
🔒 Propone. Applichi tu.
Nulla di ciò che suggerisce viene mai applicato da solo. Una proposta compare nella conversazione con un pulsante Vedi le modifiche e uno Scarta, e finché non applichi dalla finestra di revisione il tuo grafo resta intatto.
👀 La finestra di revisione
Vedi le modifiche apre un riepilogo di ciò che la proposta farebbe:
- ogni carta aggiunta,
- ogni campo modificato, con il valore precedente e quello nuovo affiancati,
- ogni carta e collegamento rimosso.
Viene calcolato rispetto al grafo che hai sullo schermo in quel momento, non rispetto a quello che esisteva quando è arrivata la risposta - quindi se nel frattempo hai modificato qualcosa, ciò che leggi è ciò che succederà davvero. Una proposta che non cambierebbe nulla lo dice, e Applica resta disattivato.
Non è una formalità. Un grafico premi è un'automazione in funzione sul tuo server - assegna ruoli, invia DM e dà XP a membri reali. La decisione di eseguirlo spetta a una persona.
Se puoi parlare con l'assistente ma non modificare un server, vedi comunque le proposte - il pulsante Applica è semplicemente grigio. Leggere ciò che è stato suggerito è utile anche quando agire non spetta a te.
🧪 Una proposta viene verificata prima che ti venga offerta
Ogni grafo proposto viene validato rispetto all'elenco reale delle carte prima che compaia il pulsante Applica. Quando qualcosa non va, vengono elencati invece i problemi:
- una carta che non esiste,
- un'azione a cui manca un campo obbligatorio - un Assegna ruolo senza ruolo verrebbe saltato in silenzio quando il grafo gira,
- un collegamento che punta a una carta che non c'è,
- un grafo di comando senza la sua Risposta, che il pannello si rifiuterebbe comunque di salvare.
Ora cerca di correggerli da solo. Quando una proposta viene respinta, il rifiuto e le operazioni esatte che l'hanno causato tornano all'assistente, che ha fino a due tentativi in più prima che la risposta ti venga consegnata. Vedi ogni tentativo comparire nella conversazione mentre accade, quindi una correzione è qualcosa che guardi, non qualcosa che devi chiedere.
Se viene comunque respinta dopo questo, i problemi vengono elencati con un pulsante Chiedi di nuovo. Tre tentativi sono il limite volutamente: un modello che non riesce a soddisfare il validatore due volte è bloccato su qualcosa che una domanda formulata diversamente risolverà più in fretta di un quarto tentativo.
È anche per questo che un tentativo fallito resta visibile nella conversazione invece di essere sistemato via. È ciò che l'assistente legge per correggersi al tentativo successivo.
👀 Guardarlo ragionare
Ogni risposta porta il ragionamento dell'assistente, ripiegato sotto Mostra il ragionamento. Vale la pena aprirlo quando una proposta ti sorprende: di solito spiega quale condizione pensava volessi, ed è più veloce che leggere il grafo carta per carta.
Le domande sono etichettate con chi le ha poste, perché la conversazione è condivisa.
⏳ Una richiesta alla volta
Mentre l'assistente lavora, il campo di scrittura è disattivato per tutto il team, in ogni conversazione, e tutti vedono per chi sta lavorando. Un team condivide un solo modello e un solo conto, quindi due domande contemporanee costerebbero il doppio e si risponderebbero sopra.
💬 Più conversazioni
I grafici premi e i comandi personalizzati non condividono più un'unica conversazione. Avvia una nuova conversazione ogni volta che cambi argomento - ognuna ha la propria cronologia, e quella cronologia è tutto ciò che l'assistente vede, quindi una discussione precedente non correlata non può confonderlo.
Chiedi di nuovo su qualsiasi risposta rimette nel campo la tua domanda precedente, così puoi ritoccare una parola invece di riscriverla. La risposta che sostituisce smette di offrire Applica.
Una conversazione conclusa può essere eliminata con il pulsante 🗑 accanto ad essa - porta via con sé i suoi messaggi, e tutti nel team la vedono sparire. Il pulsante è nascosto quando resta una sola conversazione, perché il pannello ha sempre bisogno di una conversazione in cui scrivere, e l'eliminazione di una in cui l'assistente sta lavorando viene rifiutata invece di permettere che interrompa l'esecuzione.
Se una richiesta fallisce, la conversazione lo dice e l'assistente si libera subito. Quando l'endpoint rifiuta la chiamata - un nome di modello che non conosce è il motivo più comune - nella conversazione compare la sua spiegazione, così puoi leggere cosa cambiare.
🌍 Cosa può vedere, e cosa gli lasci vedere
Il pulsante ⚙ nella finestra di chat apre Ciò che l'assistente può leggere: due interruttori, ognuno una fonte di contesto, ognuno solo tuo. Ti seguono da un server e da una conversazione all'altra, e non cambiano nulla per i tuoi colleghi - ognuno nel team decide per sé.
Gli altri server del tuo team
Attivo per impostazione predefinita. Può vedere ogni server di proprietà del tuo team - quali funzioni sono attive, come sono configurate e i loro grafi. È ciò che rende "configura questo come fa il mio altro server" una domanda a cui può davvero rispondere.
Disattivalo e smette del tutto di essere informato su di loro. L'inventario non viene costruito e poi nascosto: non viene costruito.
Ciò che il bot ricorda qui
Disattivato per impostazione predefinita. Se AI Memory è attiva, il bot annota ciò che impara sul tuo server dalle conversazioni su Discord. Concederlo consegna quelle note all'assistente insieme alla tua domanda, così può tenerne conto.
È disattivato finché non lo attivi per una ragione: è un contesto che l'assistente prima non aveva, viene reinviato a ogni domanda che fai, e ciò che contiene è stato scritto dai tuoi membri e non da te.
Quando è attivo, ciò che riceve è limitato di proposito:
- il server che hai attualmente aperto, e nessun altro,
- le note sul server stesso - mai quelle che il bot ha registrato su un singolo membro, che appartengono alla conversazione di quel membro con il bot e lì restano,
- un numero fisso delle note più recenti, ciascuna tagliata a una lunghezza ragionevole, così una memoria che cresce non può far crescere di nascosto il costo di ogni domanda.
- solo finché l'impostazione di memoria del server è attiva. Disattivarla ferma la registrazione da parte del bot, e ferma anche questo - le note già scritte restano dove sono, e non viene consegnato nulla.
Due limiti che non sono opzionali
- Non vede mai le tue credenziali. Chiavi API, token e segreti vengono mascherati prima che gli venga detto qualcosa, esattamente come ovunque nel pannello.
- Scrive sempre e soltanto un grafo, sul server che hai attualmente aperto. Non può modificare la configurazione delle funzioni e non può toccare un altro server.
⚙️ Quale modello usa
Per impostazione predefinita usa il modello configurato dalla piattaforma. Un team può portarne uno proprio - la propria chiave API, il proprio modello o il proprio endpoint. Funziona qualsiasi endpoint compatibile con OpenAI e in quel caso non serve alcuna chiave API.
L'endpoint deve essere raggiungibile via HTTPS a un indirizzo pubblico. Un modello che gira sul tuo portatile dietro il tuo router non lo è - il pannello è un server altrove, e lasciargli chiamare su richiesta indirizzi privati è un modo ben noto per trasformare un prodotto in uno scanner della propria rete. Il self-hosting funziona quando l'endpoint è pubblicato; una macchina sulla tua scrivania no.
Lo imposti nella pagina delle impostazioni del team, sotto Modello dell'assistente. Solo il proprietario del team può cambiarlo, perché è una credenziale e non una preferenza. La chiave viene salvata e non viene mai più mostrata: lascia vuoto il campo quando salvi e quella salvata viene mantenuta.
Elenca i modelli, accanto al campo del modello, chiede all'endpoint cosa serve davvero e offre la risposta come suggerimenti - usa l'URL e la chiave presenti nel modulo in quel momento, così puoi controllare un endpoint prima di salvarlo. Il campo resta testo libero: pubblicare un elenco di modelli è facoltativo, e diversi server self-hosted non lo fanno, quindi quando non torna nulla viene mostrato il motivo e scrivi tu il nome.
💡 Ottenere una buona risposta
Di' cosa deve succedere e a chi, non quali carte usare - deciderlo è compito suo:
- "Dai il ruolo Veterano al livello 25, ma solo ai booster."
- "Quando qualcuno risolve il Wordle in tre tentativi o meno, assegna 200 XP e congratulati con lui in #general."
- "Come il grafo del mio altro server, ma con l'annuncio in #levels."
Poi leggi il ragionamento, controlla le carte che ha scelto e applica.
Chiedigli di cambiare una cosa alla volta. Una richiesta breve e specifica produce un breve elenco di modifiche, molto più facile da controllare nella finestra di revisione di una dozzina tutte insieme.