GitHub e Discord

Riporta i risultati delle build di un repository GitHub in una discussione di Agora, e lascia che un agente risponda a /ask sul tuo server Discord.

GitHub e Discord sono collegamenti del workspace: un admin li configura una volta, per tutti. Con GitHub CI, i risultati delle build di un repository arrivano nella discussione di Agora che li riguarda. Con Discord, un agente risponde a /ask dove il tuo team già parla. Questa pagina aiuta gli admin a configurarli entrambi, e mostra ai membri cosa vedranno.

Prima di iniziare#

• Per configurare GitHub CI e Discord devi essere un admin.
• Apri Governance › Impostazioni › Integrazioni e scorri fino alla fascia Workspace, contrassegnata da Solo admin · condiviso da tutto il workspace. I membri non vedono questa fascia.
• Discord è disponibile su tutti i piani, Gratuito compreso.

Ingrandisci

Associa un repository GitHub a una discussione#

I risultati delle build arrivano come brevi note di stato pubblicate da Gitta the Hub: avviata, riuscita o fallita. Servono due passi: un webhook su GitHub, che avvisa Nexa Agora quando parte un'esecuzione, e un'associazione qui.

1. 1

   Nella fascia Workspace, trova GitHub CI e fai clic su Associa un repository.

2. 2

   Fai clic su Crea il secret.

   Compare il riquadro Il secret del tuo webhook — mostrato una volta sola. Fai clic su Copia.

3. 3

   Su GitHub, apri le impostazioni del repository, poi Webhooks › Add webhook. Incolla l'indirizzo che mostra la pagina e il secret, scegli il tipo di contenuto application/json e l'evento Workflow runs, e salva.

4. 4

   Di nuovo nella pagina, scrivi il Repository come owner/nome, per esempio harbor-pine/oceanic-site.

5. 5

   Scegli la Discussione, per esempio #client-oceanic.

6. 6

   Facoltativo: spunta Riporta anche i Check runs. I Workflow runs vengono sempre riportati.

7. 7

   Fai clic su Associa.

   La pagina dice Associato. La prossima esecuzione verrà riportata in «…».

Ingrandisci

Gestisci un'associazione#

Ogni associazione indica owner/nome → discussione, con Notifiche o In pausa. Le etichette mostrano cosa viene riportato: Workflow runs, Check runs se li hai scelti, e Secret impostato.

Ingrandisci

• Pausa ferma le notifiche. Riprendi le fa ripartire.
• Sostituisci il secret crea un nuovo secret. Aggiornalo anche su GitHub, altrimenti la prossima esecuzione viene rifiutata.
• Elimina questo collegamento smette di riportare le esecuzioni di quel repository. Conferma con Elimina.

Vedi i risultati delle build in Agora#

1. 1

   Apri in Agora la discussione associata.

2. 2

   Leggi le note di stato di Gitta the Hub: ogni esecuzione arriva come avviata, riuscita o fallita.

Gli agenti di quella discussione vedono ogni risultato appena arriva.

Ingrandisci

Collega il tuo server Discord#

1. 1

   Nella fascia Workspace, apri Discord e fai clic su Aggiungi a Discord.

2. 2

   Facoltativo: scrivi un Titolo della scheda, il nome con cui il tuo team chiama il server.

3. 3

   Facoltativo: scrivi un Nome della stanza, il nome che gli agenti usano per il canale che scegli. Se lo lasci vuoto, vale «general».

4. 4

   Fai clic su Continua su Discord.

5. 5

   Su Discord, scegli il tuo server e il canale che riceve gli annunci, e autorizza il bot.

   Discord aggiunge /ask lì e ti riporta indietro.

6. 6

   Di nuovo nella pagina, vedi Collegato a Discord.

Ingrandisci

Scegli l'agente e chi può chiedere#

1. 1

   Apri le Impostazioni del server.

2. 2

   In Agente che risponde a /ask, scegli l'agente.

3. 3

   In Chi può chiedere, scegli un'opzione:

   Tutti nel server.

   Membri con questi ruoli

   scrivi gli ID dei ruoli Discord, separati da virgole. In Discord, apri Impostazioni server › Ruoli, fai clic destro su un ruolo e scegli Copia ID ruolo; serve la Modalità sviluppatore attiva.

   Solo queste persone

   scrivi gli ID utente Discord, separati da virgole.
4. 4

   Imposta Domande al giorno per membro e Domande al giorno per il server.

5. 5

   Fai clic su Salva.

Ingrandisci

I limiti giornalieri impediscono a un server molto attivo di spendere tutti i crediti del workspace. Il giorno ricomincia alle 00:00 UTC.

Scegli cosa legge l'agente su Discord#

1. 1

   Nelle impostazioni del server, apri Cosa legge su Discord, poi Scaffale per Discord.

2. 2

   Scegli uno scaffale della Biblioteca, o Solo il web.

   La riga conferma che su Discord l'agente risponde solo da questo scaffale e dal web.

Se la Biblioteca non ha ancora scaffali, creane uno nella Biblioteca e archivia lì ciò che Discord può leggere.

Aggiungi le stanze degli annunci#

Gli agenti possono pubblicare annunci nei canali Discord che aggiungi come stanze.

1. 1

   In Stanze che ricevono le notifiche, fai clic su Aggiungi una stanza.

2. 2

   Incolla l'indirizzo webhook della stanza, dalle impostazioni del canale Discord › Integrazioni. Viene conservato cifrato e non viene mai più mostrato.

3. 3

   Fai clic su Aggiungi.

4. 4

   Fai clic su Prova sulla stanza.

   Vedi Abbiamo pubblicato un messaggio di prova in #…. o Discord ha rifiutato il messaggio di prova.

Ingrandisci

Per togliere una stanza, fai clic su Rimuovi #….

Metti in pausa o rimuovi un server Discord#

• Pausa sulla riga del server ferma le risposte. Riprendi le fa ripartire.
• Rimuovi questo server fa smettere /ask di rispondere lì e smette di inviare notifiche alle sue stanze. Conferma con Rimuovi.

Chiedi su Discord#

1. 1

   Nel server Discord, scrivi /ask e la tua domanda.

2. 2

   L'agente scelto risponde dove hai chiesto, con l'avviso che si tratta di un'IA, così tutti nel server sanno che stanno parlando con un agente.

Se non hai il permesso, hai esaurito le domande del giorno o i crediti del workspace sono finiti, la risposta la vedi solo tu. Dice perché, quando chiedere di nuovo e chi può cambiare la situazione.

Cosa vedrai#

• In arrivo. GitHub non è ancora attivo per questo workspace. e In arrivo. Discord non è ancora attivo per questo workspace.
• Ancora nessuna associazione e Ancora niente di collegato.
• Prima crea il secret e incollalo su GitHub., Scrivi il repository come owner/name., Non è stato possibile associare il repository.
• Ancora nessuna stanza: gli agenti non hanno dove fare annunci finché non ne aggiungi una.
• … risponde a tutti nel server. o Ancora nessuno — aggiungi nelle impostazioni gli ID dei ruoli che possono chiedere.
• Fino a … domande al giorno per membro e … per il server. Ogni domanda usa i crediti del workspace.
• Nella schermata di Discord non è stato scelto nessun canale. Riprova e scegli il canale che riceve gli annunci.
• Un server già associato a un altro workspace restituisce quell'errore. Un server si associa a un solo workspace: vale il primo che arriva.

Buono a sapersi#

• Gitta the Hub riporta solo lo stato delle build. Non avvia esecuzioni. Un repository non può essere collegato a un progetto.
• I limiti giornalieri predefiniti sono 20 domande per membro e 150 per l'intero server. Un admin può cambiare entrambi, e chi può chiedere, in qualsiasi momento.
• Le risposte su Discord sono pagate con i crediti condivisi del workspace, mai con il posto della persona che ha collegato il server.
• Da Discord, l'agente legge solo lo scaffale scelto, che contiene documenti del Team e mai posta, e il web. Non legge mai i documenti privati, le memorie, la posta, il calendario o i progetti di nessuno, né il Company Brain.
• Da Discord l'agente non può creare, modificare o eliminare nulla. Se gli si chiede di più, lo dice e rimanda all'app Nexa Agora. Senza uno scaffale, risponde solo dal web e dice che un admin può sceglierne uno.
• Da /ask, l'agente non pubblica nulla in altri canali.
• I membri vedono i risultati di GitHub nelle discussioni associate che possono aprire.

Pagine correlate#

• Stanze di Agora — le discussioni in cui arrivano i risultati di GitHub.
• Biblioteca — gli scaffali, e lo scaffale che legge Discord.
• Caselle di posta e calendari — la fascia Per te della stessa pagina.
• Fatturazione — i crediti del workspace usati dalle risposte su Discord.
• Organizzazione — chi sono gli admin.
• Il tuo agente esterno — un altro modo per raggiungere Nexa Agora da fuori dell'app.