GitHub Spoke

Apps im Store anfordern

Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.

IntegrationHub-Abonnement

Diese Spoke erfordert ein Integration Hub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht.

Spoke-Version

GitHub-Spokev 3. 3 . 0 Ist die neueste Version.

Unterstützte Versionen

Diese Spoke wurde für erstellt GitHubAPI-Version v 3, kann jedoch mit späteren Versionen kompatibel sein.

Spoke-Anforderungen

GitHub Account
Anwender mit Administratoranmeldeinformationen
Token zur Authentifizierung von ServiceNow Instanz

Siehe GitHub Dokumentation Für Anweisungen zum Erstellen von GitHub Account und Generieren eines Tokens.

GitHub Webhooks-Modul

Bidirektionale Webhooks können eingerichtet werden, um über die erforderlichen Ereignisse benachrichtigt zu werden. Die Weiterleitungsrichtlinie definiert Bedingungen, die erfüllt sein müssen, um zu benachrichtigen ServiceNow App. Diese Bedingungen basieren auf den Ereignissen in GitHubÜber die Sie benachrichtigt werden möchten. Wenn die Bedingungen erfüllt sind, löst die Weiterleitungsrichtlinie den zugehörigen Subflow aus, der wiederum automatisiert GitHubAufgaben.

Die bidirektionalen Webhooks erfordern ein separates Setup und können unabhängig verwendet werden, ohne die Spoke-Aktionen zu verwenden. Standardmäßig ist die Anwendung GitHub-Webhooks in verfügbar GitHub-SpokeUnd verfügt über die folgenden Module:

GitHub Webhook-Registrierungen
GitHub Webhook-Weiterleitungsrichtlinien

Verwenden Sie GitHubWebhook-Registrierungsmodul zum Zuweisen eines Tokens und Bereitstellen des API-Pfads. Sie müssen hier eine Rückruf-URL generieren und diese URL in angeben GitHub. Eine standardmäßige Weiterleitungsrichtlinie wird in bereitgestellt GitHubModul „Webhook-Weiterleitungsrichtlinien“. Die standardmäßige Weiterleitungsrichtlinie unterstützt diese GitHubFelder:


Unterstützt GitHubFelder
Aktion	Projektkartenersteller	Ref
Basisreferenz	Projektkartenhinweis	Referenztyp
Commit-Kommentar-Text	Vorheriger Hinweis zur Projektkarte	Assets freigeben
Commit-Kommentar erstellt um	Projektkarte aktualisiert um	Release-Autor
Pfad des Commit-Kommentars	Projektspalte erstellt um	Release-Text
Commit-Kommentar aktualisiert um	Name der Projektspalte	Release erstellt um
Anwender des Commit-Kommentars	Vorheriger Name der Projektspalte	Release-Entwurf
Push erzwingen	Projektspalte aktualisiert um	Release-Name
URL der GitHub-Instanz	Projekt erstellt um	Release veröffentlicht um
Problem zugewiesen zu	Projektname	Name des Release-Tag
Problembeauftragte	Vorheriger Text zum Projekt	Release-Ziel-Commits
Problemtext	Vorheriger Name des Projekts	Repository archiviert
Problem geschlossen um	Projektstatus	Repository erstellt um
Problemkommentar	Projekt aktualisiert am	Repository-Beschreibung
Problemkommentar-Anzahl	Pull Request zugewiesen zu	Repository inaktiv
Problemkommentar erstellt um	Beauftragte für Pull Request	Vollständiger Repository-Name
Problemkommentar aktualisiert um	Text des Pull Request	Repository hat Probleme
Problem erstellt um	Pull Request geschlossen um	Repository hat Projekte
Problem bezeichnet als	Anzahl des Pull Request-Kommentare	Repository-Importstatus
Problembezeichnungen	Pull Request erstellt um	Repository-Lizenz
Problem gesperrt	Pull Request-Entwurf	Anzahl offener Probleme im Repository
Problemmeilenstein	Pull Request bezeichnet als	Repository-Besitzer
Vorheriger Text des Problems	Pull Request-Bezeichnungen	Repository privat
Vorheriger Kommentar des Problems	Pull Request gesperrt	Repository zuletzt gepusht am
Vorheriger Meilenstein des Problems	Pull Request zusammenführbar	Repository mit Stern versehen am
Vorheriger Titel des Problems	Pull Request zusammengeführt	Repository aktualisiert um
Problem zuvor zugewiesen an	Pull Request zusammengeführt um	Von Repository-Schwachstellenwarnung betroffener Bereich
Problem zuvor bezeichnet als	Pull Request-Meilenstein	Externer Bezeichner der Repository-Schwachstellenwarnung
Problemstatus	Vorheriger Text des Pull Request	Repository-Schwachstellenwarnung behoben in
Problemtitel	Vorheriger Titel des Pull Request	Paketname der Repository-Schwachstellenwarnung
Problem aktualisiert um	Pull Request zuvor zugewiesen zu	Beschreibung der Sicherheitswarnung
Problemanwender	Pull Request zuvor bezeichnet als	Sicherheitswarnungs-ID
Meilenstein geschlossen um	Rebase von Pull Request möglich	Sicherheitswarnung veröffentlicht um
Meilenstein erstellt um	Text des Pull Request Review	Schweregrad der Sicherheitswarnung
Ersteller des Meilensteins	Kommentar zum Pull Request Review	Zusammenfassung der Sicherheitswarnung
Beschreibung des Meilensteins	Anzahl der Kommentare zum Pull Request Review	Sicherheitswarnung aktualisiert um
Meilenstein fällig am	Kommentar zum Pull Request Review erstellt um	Sicherheitswarnung zurückgezogen um
Status des Meilensteins	Pfad der Kommentardatei zum Pull Request Review	Absenderanmeldung
Titel des Meilensteins	Vorheriger Kommentar zum Pull Request Review	Status-Commit-Nachricht
Meilenstein aktualisiert um	Kommentar zum Pull Request Review aktualisiert um	Statuskontext
Organisationsbeschreibung	Vorheriger Text des Pull Request Review	Status erstellt um
Organisationsanmeldung	Status des Pull Request Review	Statusbeschreibung
Vorabversion	Status des Pull Request	Statusname
Projekttext	Titel des Pull Request	Statuszustand
Projektkarte archiviert	Pull Request aktualisiert um	Status aktualisiert um
Projektkarte erstellt um	Pull Request-Anwender	Webhook-Ereignis

Um andere Bedingungen in der Weiterleitungsrichtlinie zu verwenden, erstellen Sie im eine Weiterleitungsrichtlinie GitHubWebhook-Weiterleitungsrichtlinien-Modul und geben Sie Bedingungen entsprechend Ihren Anforderungen an. Siehe Richten Sie einen bidirektionalen Webhook für die GitHub-Spoke ein Informationen zum Einrichten und Konfigurieren der Webhooks.

Spoke-Auslöser

ServiceNow Unterstützt bestimmte Ereignisse in GitHub Die Auslöser erstellen. Sie müssen zuerst einen Flow mit einer unterstützten Auslöserdefinition konfigurieren. Wenn ein Ereignis, z. B. eine Push-Anforderung, auf der auftritt GitHub, Sendet die Nutzlast über einen Webhook an die ServiceNow Instanz. Danach wird der von Ihnen konfigurierte Flow am ausgelöst ServiceNow Instanz zum Automatisieren eines Workflows. Die unterstützten Ereignisse sind:


Kategorie	Auslöser	Beschreibung
Branch-Verwaltung	Branch erstellt	Flow wird ausgelöst, wenn Sie eine Verzweigung in erstellen GitHub.
Repository-Verwaltung	Pull Request geöffnet	Flow wird ausgelöst, wenn Sie eine neue Abrufanforderung für initiieren GitHub.
	Pull Request bearbeitet	Flow wird ausgelöst, wenn Sie eine Abrufanforderung für aktualisieren GitHub.
	Pull Request geschlossen	Flow wird ausgelöst, wenn Sie eine Abrufanforderung für schließen GitHub.
	Pull Request zugewiesen	Flow wird ausgelöst, wenn Sie einem Anwender in eine Abrufanforderung zuweisen GitHub.
	Pull Request erneut geöffnet	Flow wird ausgelöst, wenn Sie eine Abrufanforderung für erneut öffnen GitHub.
	Repository-Fork	Flow wird ausgelöst, wenn Sie ein Repository in verlinken GitHub.
	Repository-Push	Flow wird ausgelöst, wenn Sie in ein Repository verschieben GitHub.
Releasemanagement	Release erstellt	Flow wird ausgelöst, wenn die Details eines Release am erstellt werden GitHub.
	Release bearbeitet	Flow wird ausgelöst, wenn die Details eines Release am aktualisiert werden GitHub.
	Release gelöscht	Flow wird ausgelöst, wenn ein Release in entfernt wird GitHub.
	Release veröffentlicht	Flow wird ausgelöst, wenn ein Release am freigegeben wird GitHub.

Informationen zum Einrichten der Auslöser für GitHub Spoke, siehe Aktivieren Sie die Auslöserdefinition für ServiceNow Instanz. Weitere Informationen zur eingehenden Integration finden Sie unter Bedingte und ereignisgesteuerte eingehende Integration.

Spoke-Subflows

Die GitHub-SpokeStellt einen Beispiel-Subflow bereit, um verschiedene zu verarbeiten GitHubWebhook-Ereignisse. Verfügbare Beispiel-Subflows sind:

Tabelle : 1. Spoke-Subflows
Subflow	Beschreibung	Unterstützt GitHubEreignis
Verarbeiten Sie GitHub-Verzweigungs- und Tag-Webhook-Ereignisse	Verarbeitet Verzweigungs- und Tag-Webhook-Ereignisse.	Verzweigung und Tag
Verarbeitet GitHub-Commit-Webhook-Ereignisse	Verarbeitet Commit-Webhook-Ereignisse.	Commit
Verarbeiten Sie Webhook-Ereignisse für GitHub-Problem	Verarbeitet Problem-Webhook-Ereignisse.	Problem
Verarbeitet GitHub-Meilenstein-Webhook-Ereignisse	Verarbeitet Meilenstein-Webhook-Ereignisse.	Meilenstein
Verarbeitet Webhook-Ereignisse des GitHub-Projekts	Verarbeitet Projekt-Webhook-Ereignisse.	Projekt
Verarbeiten Sie Webhook-Ereignisse für GitHub-Abrufanforderungen	Verarbeitet Webhook-Ereignisse für Abrufanforderungen.	Pull Request
Verarbeiten Sie GitHub-Push-Webhook-Ereignisse	Verarbeitet Webhook-Ereignisse für Push-Anforderungen.	Push-Anforderung
Verarbeitet GitHub-Release-Webhook-Ereignisse	Verarbeitet Release-Webhook-Ereignisse.	Release
Verarbeiten Sie Webhook-Ereignisse des GitHub-Repositorys	Verarbeitet Repository-Webhook-Ereignisse.	Repository
Verarbeitet GitHub-Sicherheits-Webhook-Ereignisse	Verarbeitet Sicherheits-Webhook-Ereignisse.	Sicherheit
Verarbeiten Sie GitHub-Webhook-Ereignisse	Verarbeitet alle GitHubWebhook-Ereignisse.	Hinweis: Dieser Subflow verarbeitet alle GitHubEreignisse. Sie können diesen Subflow anpassen, um andere zu verarbeiten GitHubWebhook-Ereignisse, die standardmäßig nicht unterstützt werden.

Dient zum Erstellen von Subflows zur Verarbeitung anderer GitHubWebhook-Ereignisse oder verarbeiten unterstützte GitHubWebhook-Ereignisse anders. Passen Sie den Subflow „GitHub-Webhook-Ereignisse verarbeiten“ an. Dazu müssen Sie eine Kopie des Subflows erstellen, die Nutzlast analysieren und den Subflow entsprechend Ihren Anforderungen anpassen. Nutzlast ist eine der Eingaben für den Subflow.

Beim Anpassen von Subflows müssen Sie bestätigen, dass die Subflows so konfiguriert sind, dass unendliche Schleifen vermieden werden.

Hinweis:

Sie müssen Webhooks konfigurieren, um den Spoke-Subflow zu verwenden. Siehe Richten Sie einen bidirektionalen Webhook für die GitHub-Spoke ein Informationen zum Einrichten und Konfigurieren des Webhooks.
Die Beispiel-Subflows werden standardmäßig als Anwender ausgeführt. Sie kann so konfiguriert werden, dass sie als System ausgeführt wird.
GitHub-Spoke Unterstützt Anwendungs-/JSON-Nutzlast. Konfigurieren Sie GitHubWebhook entsprechend. Siehe GitHub Entwickler Dokumentation für Anweisungen zum Erstellen und Konfigurieren eines Webhooks.

Spoke-Aktionen

Die GitHub-SpokeBietet Aktionen zur Verwaltung von Verzweigungen, Problemen, Repositorys und Quellcode, wenn Ereignisse in auftreten ServiceNow. Folgende Aktionen sind verfügbar:


Kategorie	Aktion	Beschreibung
Branch-Verwaltung	Branch erstellen	Erstellt eine Verzweigung in GitHubBasierend auf einer bestimmten Commit-SHA.
	Branch löschen	Löscht eine Verzweigung aus der GitHubRepository.
	Branch abrufen	Ruft die Details einer Verzweigung in ab GitHubRepository.
	Schutz des Branch abrufen	Ruft die Einschränkungsdetails der erforderlichen Verzweigung ab.
	Listen Sie Verzweigungen Auf	Ruft die Liste aller Verzweigungen in einem Repository ab.
	Schutz des Branch entfernen	Entfernt den Schutz für die erforderliche Verzweigung.
	Schutz des Branch aktualisieren	Aktualisiert den Schutz für die erforderliche Verzweigung.
Problemverwaltung	Kommentar zu Problem erstellen	Erstellt einen Kommentar zu einem erforderlichen Problem.
	Problem erstellen	Erstellt ein Problem für das erforderliche Repository.
	Kommentar zu Problem löschen	Löscht einen Kommentar zu einem erforderlichen Problem.
	Problem sperren	Sperrt das erforderliche Problem. Dadurch wird die Konversation nur auf Mitarbeitende beschränkt.
	Kommentare zum Problem nachschlagen	Ruft die Liste der Kommentare zu einem Problem ab.
	Suchen Sie Nach Problemen	Ruft die Liste der Probleme für ein Repository ab.
	Problem entsperren	Entsperrt das erforderliche Problem. Dadurch wird eine Konversation für alle Anwender geöffnet.
	Kommentar zu Problem aktualisieren	Aktualisiert einen Kommentar zu einem Problem.
	Problem aktualisieren	Aktualisiert die Details des erforderlichen Problems.
Metadatenabruf	Felder anhand der Aktion nachschlagen	Ruft die Liste der Felder für einen Aktionsfilter in ab GitHubFeldtabelle.
	Metadaten von Branches nachschlagen	Ruft Metadaten der Verzweigungen ab.
	Metadaten von Problemen nachschlagen	Ruft Metadaten der Probleme ab.
	Metadaten von Meilensteinen nachschlagen	Ruft Metadaten der Meilensteine ab.
	Metadaten von Pull Requests nachschlagen	Ruft Metadaten der Abrufanforderungen ab.
Organisationsmanagement	Organisationsplan abrufen	Ruft den Plannamen einer Organisation ab.
	Liste der Organisationsmitglieder	Ruft die Liste aller Mitglieder in einer Organisation ab.
	Organisations-Repositorys auflisten	Ruft die Liste aller Repositorys in einer Organisation ab.
	Organisationsmitglied entfernen	Entfernt einen Anwender aus einer Organisation.
	Stream mit Organisationsereignissen nachschlagen	Ruft die Liste der Ereignisse in einer Organisation bis zum angegebenen Rückblicktag ab.
	Stream „Externe Mitarbeitende einer Organisation“ suchen	Ruft die Liste aller externen Mitarbeitenden in einer Organisation ab.
	Externen Mitarbeitenden aus Organisation entfernen	Entfernt einen externen Mitarbeitenden aus einer Organisation.
	Stream „Ausstehende externe Mitarbeitende einer Organisation“ suchen	Ruft eine Liste der ausstehenden Mitarbeitenden in einem Repository ab.
	Stream mit Organisationseinladungen suchen	Ruft eine Liste von Einladungen innerhalb einer Organisation ab.
Repository-Verwaltung	Mitarbeitenden hinzufügen	Fügt dem erforderlichen Repository einen Mitarbeitenden hinzu.
	Kommentar zum Pull Request erstellen	Erstellen Sie Überprüfungskommentare für eine Abrufanforderung.
	Meilenstein erstellen	Erstellt einen Meilenstein für das erforderliche Repository.
	Pull Request erstellen	Erstellt eine Abrufanforderung für ein Repository.
	Antwort auf Kommentar zum Pull Request Review erstellen	Erstellt eine Antwort auf einen Überprüfungskommentar für eine Abrufanforderung.
	Repository erstellen	Erstellt ein Repository in GitHub.
	Kommentar zum Pull Request löschen	Löscht den Überprüfungskommentar zu einer Abrufanforderung.
	Meilenstein löschen	Löscht den Meilenstein aus dem erforderlichen Repository.
	Kommentare zu Pull Request auflisten	Ruft die Liste aller Überprüfungskommentare zu einer Abrufanforderung ab.
	Meilensteine auflisten	Ruft die Liste aller Meilensteine in einem Repository ab.
	Repository-Ereignisse auflisten	Ruft die Liste der Ereignisse in einem Repository ab.
	Suchen Sie Nach Abrufanforderungen	Ruft die Details von Abrufanforderungen für ein Repository ab.
	Repositorys Suchen	Ruft die Details von Repositorys basierend auf einem bestimmten Anwender oder einer bestimmten Organisation ab.
	Pull Request zusammenführen	Führt die Abrufanforderung mit einem Repository zusammen.
	Mitarbeitenden entfernen	Entfernt den mitarbeitenden aus einem Repository.
	Kommentar zu Pull Request aktualisieren	Aktualisiert Überprüfungskommentare, die für eine Abrufanforderung bereitgestellt wurden.
	Meilenstein aktualisieren	Aktualisiert die Details eines Meilensteins in einem Repository.
	Pull Request aktualisieren	Aktualisiert die Details einer Abrufanforderung in einem Repository.
	Repository aktualisieren	Aktualisiert die Details eines Repositorys in GitHub.
Quellcodeverwaltung	Kommentar zu Commit erstellen	Erstellt einen Kommentar für den erforderlichen Commit mit mit seiner SHA.
	Erstellen oder aktualisieren Sie eine Datei	Erstellt eine Datei oder aktualisiert eine vorhandene Datei in einem Repository.
	Kommentare nach Commit-ID abrufen	Ruft Kommentare ab, die für einen einzelnen Commit angegeben wurden.
	Commit-Informationen anhand der ID abrufen	Ruft den Inhalt der erforderlichen Commit-Referenz ab.
	Dateiinhalt abrufen	Ruft den Inhalt einer Datei in einem Repository ab. Hinweis: Diese Aktion unterstützt Dateien mit einer Dateigröße bis zu 1 MB.
	Commits in einem Repository auflisten	Ruft die Details aller Commits ab, die in einem Repository vorgenommen wurden.
Anwenderverwaltung	Ruft alle Anwender für Enterprise Server ab	Ruft die Liste aller ab GitHub Enterprise-Server-Anwender.
	Listet Organisationen für den authentifizierten Anwender auf	Ruft die Liste der Organisationen ab, in denen der angemeldete Anwender Mitglied ist.
	Anwender sperren	Hält an GitHub Anwenderaccount.
	Authentifizierten Anwender suchen	Ruft Informationen zum authentifizierten Anwender ab.

Verfügbare KI-Agents

Installieren Now Assist Für Spokes und beginnen Sie mit der Verwendung der verfügbaren KI-Agents. Weitere Informationen finden Sie unter Now Assist Für Spokes.

Diese Spoke bietet eigenständige KI-Agents, die menschliche Intelligenz nachahmen, um Aufgaben in auszuführen ServiceNow Instanz.

In ServiceNow Agentic-System können Sie einen agentischen Workflow erstellen, der aus einem Satz von Anweisungen für ein großes Sprachmodell (LLM) zusammen mit einem oder mehreren eigenständigen KI-Agents besteht, um ein Ziel auszuführen. Siehe Create an agentic workflow Informationen zum Hinzufügen von KI-Agents zum Erstellen von agentischen Workflows gemäß Ihren Anforderungen und zum Bereitstellen des erforderlichen Auslösers.
Sie können auch nach anderen verfügbaren KI-Agents suchen und sie Ihrem agentischen Workflow hinzufügen. Weitere Informationen finden Sie unter Find AI agents.
Sie können einen Klon des erforderlichen Spoke-KI-Agents erstellen und entsprechend Ihren Anforderungen anpassen. Siehe Duplicate an AI agent Weitere Informationen zum Erstellen eines Klons.
Siehe Now Assist AI agents Für Informationen zu KI-Agents.

Verfügbare KI-Agents:


KI-Agent	Beschreibung
KI-Agent für die Branch-Verwaltung in GitHub	Verwaltet und verwaltet GitHub Verzweigungen. Ruft außerdem Informationen zu ab GitHub Verzweigungen.
KI-Agent für Problemmanagement in GitHub	Verwaltet und automatisiert GitHub-bezogene Aufgaben in Integration Hub.
KI-Agent für Repository-Verwaltung in GitHub	Verwaltet die GitHub-Repositorys, indem die Repository-Vorgänge, Abrufanforderungen, Kommentare zu Abrufanforderungen und Meilensteinen verarbeitet werden.
KI-Agent für Quellcodeverwaltung in GitHub	Verwaltet Quellcode und verarbeitet die Repository-Dateien, Commits und Kommentare.

Suchen Sie nach einem KI-Agenten?

Möglicherweise sind KI-Agenten mit installiert Now AssistAnwendung, die nicht in Agenten-Workflows verwendet wird. Informationen zum Anzeigen aller in Ihrer Instanz verfügbaren Agenten finden Sie unter Suchen Sie KI-Agenten .
Um Agenten zu finden, die möglicherweise nicht auf Ihrer Instanz installiert sind, besuchen Sie die KI-Agenten-Marktplatz Auf ServiceNow Store.

Hinweis:

Stellen Sie sicher, dass der Anwender, der einen KI-Agent ausführt, über die erforderlichen Rollen und Berechtigungen verfügt, um auf Daten zuzugreifen oder Vorgänge für Daten in der Tabelle auszuführen, die dem KI-Agent zugeordnet ist.

Spoke-Module

Die GitHub Spoke fügt diese Module zu hinzu ServiceNow Instanz.


Modul	Beschreibung
GitHub Besitzer	Zeigt an GitHub Von Ihnen erstellte Besitzerdatensätze.
GitHub Repositorys	Zeigt die Details von an GitHub Repositorys, die dem zugeordnet sind GitHub Besitzer.

Alias-Anforderungen für Verbindungen und Anmeldeinformationen

IntegrationHub Verwendet Aliasse, um Verbindungs- und Anmeldeinformationen sowie OAuth-Anmeldeinformationen zu verwalten. Wenn Sie ein Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie mehrere Umgebungen verwenden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie die Aktionen, die die Verbindung verwenden, nicht aktualisieren.

Informationen zum Einrichten der Spoke finden Sie unter Richten Sie ein GitHub Spoke.