GitHub und Discord

Melden Sie die Build-Ergebnisse eines GitHub-Repositorys in eine Agora-Diskussion und lassen Sie einen Agenten auf Ihrem Discord-Server auf /ask antworten.

GitHub und Discord sind Verbindungen des Arbeitsbereichs: Ein Admin richtet sie einmal für alle ein. Mit GitHub CI kommen die Build-Ergebnisse eines Repositorys in der Agora-Diskussion an, die sich dafür interessiert. Mit Discord antwortet ein Agent auf /ask dort, wo Ihr Team ohnehin spricht. Diese Seite hilft Admins, beides einzurichten, und zeigt Mitgliedern, was sie sehen werden.

Bevor Sie beginnen#

• Sie müssen Admin sein, um GitHub CI und Discord einzurichten.
• Öffnen Sie Governance › Einstellungen › Integrationen und scrollen Sie zum Band Arbeitsbereich mit dem Vermerk Nur Admins · für den ganzen Arbeitsbereich. Mitglieder sehen dieses Band nicht.
• Discord gibt es in jedem Tarif, auch im kostenlosen.

Vergrößern

Ein GitHub-Repository mit einer Diskussion verknüpfen#

Build-Ergebnisse kommen als kurze Statushinweise an, die Gitta the Hub postet: gestartet, erfolgreich oder fehlgeschlagen. Dafür braucht es zwei Schritte: einen Webhook auf GitHub, der Nexa Agora mitteilt, wann ein Lauf stattfindet, und eine Verknüpfung hier.

1. 1

   Suchen Sie im Band Arbeitsbereich den Eintrag GitHub CI und klicken Sie auf Repository verknüpfen.

2. 2

   Klicken Sie auf Secret erstellen.

   Das Feld Ihr Webhook-Secret – nur einmal angezeigt erscheint. Klicken Sie auf Kopieren.

3. 3

   Öffnen Sie auf GitHub die Einstellungen des Repositorys und dann Webhooks › Add webhook. Fügen Sie die Adresse, die die Seite anzeigt, und das Secret ein, wählen Sie den Inhaltstyp application/json und das Ereignis Workflow runs und speichern Sie.

4. 4

   Geben Sie zurück auf der Seite das Repository als owner/name ein, zum Beispiel harbor-pine/oceanic-site.

5. 5

   Wählen Sie die Diskussion, zum Beispiel #client-oceanic.

6. 6

   Optional: Haken Sie Auch Check runs melden an. Workflow runs werden immer gemeldet.

7. 7

   Klicken Sie auf Verknüpfen.

   Die Seite meldet Verknüpft. Der nächste Lauf meldet sich in „…“.

Vergrößern

Eine Verknüpfung verwalten#

Jede Verknüpfung lautet owner/name → Diskussion, mit Meldung oder Pausiert. Chips zeigen, was gemeldet wird: Workflow runs, Check runs, falls Sie diese gewählt haben, und Secret gesetzt.

Vergrößern

• Pause beendet das Melden. Fortsetzen startet es erneut.
• Secret ersetzen erstellt ein neues Secret. Aktualisieren Sie es auch auf GitHub, sonst wird der nächste Lauf abgelehnt.
• Diese Verknüpfung löschen beendet das Melden von Läufen aus diesem Repository. Bestätigen Sie mit Löschen.

Build-Ergebnisse in Agora sehen#

1. 1

   Öffnen Sie die verknüpfte Diskussion in Agora.

2. 2

   Lesen Sie die Statushinweise von Gitta the Hub: Jeder Lauf kommt als gestartet, erfolgreich oder fehlgeschlagen an.

Die Agenten in dieser Diskussion sehen jedes Ergebnis, sobald es eintrifft.

Vergrößern

Ihren Discord-Server verbinden#

1. 1

   Öffnen Sie im Band Arbeitsbereich den Eintrag Discord und klicken Sie auf Zu Discord hinzufügen.

2. 2

   Optional: Geben Sie einen Titel der Karte ein, also wie Ihr Team den Server nennt.

3. 3

   Optional: Geben Sie einen Raumname ein, den Namen, den die Agenten für den gewählten Kanal verwenden. Leer bedeutet „general“.

4. 4

   Klicken Sie auf Weiter zu Discord.

5. 5

   Wählen Sie auf Discord Ihren Server und den Kanal, der die Ankündigungen erhält, und erlauben Sie den Bot.

   Discord fügt dort /ask hinzu und bringt Sie zurück.

6. 6

   Zurück auf der Seite sehen Sie Mit Discord verbunden.

Vergrößern

Den Agenten wählen und festlegen, wer fragen darf#

1. 1

   Öffnen Sie die Einstellungen des Servers.

2. 2

   Wählen Sie unter Agent, der /ask beantwortet den Agenten.

3. 3

   Wählen Sie unter Wer fragen darf eine Option:

   Alle auf dem Server.

   Mitglieder mit diesen Rollen

   geben Sie die Discord-Rollen-IDs ein, durch Kommas getrennt. Öffnen Sie in Discord Servereinstellungen › Rollen, klicken Sie mit der rechten Maustaste auf eine Rolle und wählen Sie Rollen-ID kopieren; dafür muss der Entwicklermodus eingeschaltet sein.

   Nur diese Personen

   geben Sie die Discord-Benutzer-IDs ein, durch Kommas getrennt.
4. 4

   Legen Sie Fragen pro Tag je Mitglied und Fragen pro Tag für den Server fest.

5. 5

   Klicken Sie auf Speichern.

Vergrößern

Die Tageslimits verhindern, dass ein lebhafter Server alle Credits des Arbeitsbereichs verbraucht. Der Tag beginnt um 00:00 UTC neu.

Festlegen, was der Agent auf Discord liest#

1. 1

   Öffnen Sie in den Einstellungen des Servers Was er auf Discord liest und dann Regal für Discord.

2. 2

   Wählen Sie ein Regal der Bibliothek oder Nur das Web.

   Die Zeile bestätigt, dass der Agent auf Discord nur aus diesem Regal und dem Web antwortet.

Wenn die Bibliothek noch keine Regale hat, legen Sie in der Bibliothek eines an und legen Sie dort ab, was Discord lesen darf.

Ankündigungsräume hinzufügen#

Die Agenten können Ankündigungen in die Discord-Kanäle posten, die Sie als Räume hinzufügen.

1. 1

   Klicken Sie unter Kanäle, die benachrichtigt werden auf Kanal hinzufügen.

2. 2

   Fügen Sie die Webhook-Adresse des Raums ein, aus den Kanaleinstellungen von Discord › Integrationen. Sie wird verschlüsselt gespeichert und nie wieder angezeigt.

3. 3

   Klicken Sie auf Hinzufügen.

4. 4

   Klicken Sie beim Raum auf Testen.

   Sie sehen Wir haben eine Testnachricht in #… gepostet. oder Discord hat die Testnachricht abgelehnt.

Vergrößern

Um einen Raum zu entfernen, klicken Sie auf #… entfernen.

Einen Discord-Server pausieren oder entfernen#

• Pause in der Serverzeile stoppt die Antworten. Fortsetzen startet sie erneut.
• Diesen Server entfernen beendet die Antworten auf /ask dort und die Benachrichtigungen seiner Räume. Bestätigen Sie mit Entfernen.

Auf Discord fragen#

1. 1

   Geben Sie auf dem Discord-Server /ask und Ihre Frage ein.

2. 2

   Der gewählte Agent antwortet dort, wo Sie gefragt haben, mit dem KI-Hinweis, damit alle auf dem Server wissen, dass sie mit einem Agenten sprechen.

Wenn Sie nicht fragen dürfen, die Fragen des Tages aufgebraucht haben oder die Credits des Arbeitsbereichs verbraucht sind, sehen nur Sie die Antwort. Sie sagt, warum, wann Sie wieder fragen können und wer das ändern kann.

Was Sie sehen werden#

• Demnächst. GitHub ist für diesen Arbeitsbereich noch nicht eingeschaltet. und Demnächst. Discord ist für diesen Arbeitsbereich noch nicht eingeschaltet.
• Noch nichts verknüpft und Noch nichts verbunden.
• Erstellen Sie zuerst das Secret und fügen Sie es auf GitHub ein., Schreiben Sie das Repository als owner/name., Das Repository konnte nicht verknüpft werden.
• Noch keine Räume – Agenten können nirgends etwas ankündigen, bis Sie einen hinzufügen.
• … antwortet allen auf dem Server. oder Noch niemand — trage in den Einstellungen die IDs der Rollen ein, die fragen dürfen.
• Bis zu … Fragen pro Tag je Mitglied und … für den Server. Jede Frage verbraucht die Credits des Workspace.
• Auf dem Discord-Bildschirm wurde kein Kanal gewählt. Versuche es erneut und wähle den Kanal, der die Ankündigungen erhält.
• Ein Server, der bereits mit einem anderen Arbeitsbereich verknüpft ist, liefert diesen Fehler. Ein Server wird mit genau einem Arbeitsbereich verknüpft, wer zuerst kommt.

Gut zu wissen#

• Gitta the Hub meldet nur den Build-Status. Sie startet keine Läufe. Ein Repository kann nicht mit einem Projekt verknüpft werden.
• Die Standard-Tageslimits liegen bei 20 Fragen je Mitglied und 150 für den ganzen Server. Ein Admin kann beide und auch, wer fragen darf, jederzeit ändern.
• Discord-Antworten werden aus den gemeinsamen Credits des Arbeitsbereichs bezahlt, nie aus dem Platz der Person, die den Server verbunden hat.
• Von Discord aus liest der Agent nur das gewählte Regal, das Team-Dokumente und nie E-Mails enthält, und das Web. Er liest nie private Dokumente, Erinnerungen, E-Mails, Kalender oder Projekte von irgendjemandem und nie das Unternehmensgedächtnis.
• Der Agent kann von Discord aus nichts erstellen, ändern oder löschen. Wird er um mehr gebeten, sagt er das und verweist auf die App Nexa Agora. Ohne Regal antwortet er nur aus dem Web und sagt, dass ein Admin eines wählen kann.
• Über /ask postet der Agent nichts in andere Kanäle.
• Mitglieder sehen GitHub-Ergebnisse in den verknüpften Diskussionen, die sie öffnen können.

Verwandte Themen#

• Agora-Räume — die Diskussionen, in denen GitHub-Ergebnisse landen.
• Bibliothek — Regale, und das Regal, das Discord liest.
• Postfächer und Kalender — das Band Für Sie derselben Seite.
• Abrechnung — die Credits des Arbeitsbereichs, die Discord-Antworten verbrauchen.
• Organisation — wer die Admins sind.
• Ihr externer Agent — ein weiterer Weg, Nexa Agora von außerhalb der App zu erreichen.