Jitterbit HR Agent
Übersicht
Jitterbit stellt den HR Agent für Kunden über den Jitterbit Marketplace bereit. Dieser Agent wurde entwickelt, um das interne HR-Team deiner Organisation zu unterstützen. Der Agent nutzt die Retrieval-Augmented Generation (RAG)-Technik, die LLM-Reasoning mit Zugriff auf externe Tools und Datenquellen kombiniert. Der KI-Agent führt die folgenden Funktionen aus:
-
Verbindung zu BambooHR oder anderen Human Resources Information Systems (HRIS), um Echtzeit-Onboarding-Daten für neue Mitarbeiter mittels Jitterbit Studio abzurufen.
-
Verbindung zu Jira (oder anderen Service- und Work-Management-Lösungen), um Anfragen einzuleiten und nachzuverfolgen.
-
Integration mit einem LLM zur Unterstützung eines intelligenten HR KI-Assistenten, auf den du über eine benutzerdefinierte API zugreifst, die mit Jitterbit API Manager erstellt wurde.
Diese Dokumentation erläutert die Einrichtung und den Betrieb dieses KI-Agenten. Sie behandelt die Architektur und Voraussetzungen, Beispiel-Prompts, die zeigen, was der Agent kann, sowie Schritte zur Installation, Konfiguration und Bedienung des KI-Agenten.
Architektur des KI-Agenten
Die folgenden Diagramme zeigen die im HR Agent implementierte Architektur.
Vorbereitung (Vor dem ersten Tag)
Onboarding am ersten Tag
Die ersten Wochen und Training
Allgemeine Nutzung
Voraussetzungen
Um den HR Agent zu nutzen, benötigst du folgende Komponenten.
Harmony-Komponenten
Du benötigst eine Jitterbit Harmony-Lizenz mit Zugriff auf die folgenden Komponenten:
- Jitterbit Studio
- Jitterbit API Manager
- Jitterbit HR Agent als Lizenz-Add-on erworben
- Jitterbit Cloud Datastore (optional)
Unterstützte Endpunkte
Die Architektur des KI-Agenten beinhaltet die folgenden Endpunkte. Du kannst andere Systeme einbinden, indem du die Endpunkt-Konfigurationen und Workflows des Projekts anpasst.
Human Resources Information System (HRIS)
Der KI-Agent nutzt BambooHR als Quelle für Mitarbeiterdaten, einschließlich erforderlicher Aufgaben, Dokumente und Jobanforderungen.
Hinweis
Du musst über die entsprechenden Berechtigungen in deinem HRIS verfügen, um API-Schlüssel zu erstellen und auf die erforderlichen Daten für diese Integration zuzugreifen.
Large Language Model (LLM)
Der KI-Agent nutzt OpenAI als LLM-Anbieter. Um OpenAI zu nutzen, benötigst du ein OpenAI-Abonnement, um einen OpenAI API-Schlüssel zu erstellen und zu verwalten. Weitere Informationen findest du unter OpenAI-Dokumentation.
Service-Management
Der KI-Agent nutzt Jira als Service- und Work-Management-System zur Ticketerstellung.
Dokumentation
Der KI-Agent nutzt Confluence als Quelle für IT-Dokumentation.
Chat-Schnittstelle
Die Architektur des KI-Agenten sieht Slack als Chat-Schnittstelle für die Interaktion mit dem KI-Agenten vor.
Wenn du eine andere Anwendung als Chat-Schnittstelle nutzen möchtest, enthält dieser KI-Agent einen separaten Workflow und Anweisungen für eine generische API-Einrichtung.
Kernfunktionen
Wenn du den HR Agent mit den entsprechenden Endpunkten verbindest, bietet er die folgende Kernfunktionalität.
Vorbereitung von Mitarbeitern vor Arbeitsbeginn
- Benachrichtigt das Einstellungsteam über ein angenommenes Angebot.
- Erstellt eine Willkommens-E-Mail und fordert Genehmigung an, um sie an den neuen Mitarbeiter zu senden.
- Benachrichtigt den neuen Mitarbeiter über erforderliche Aufgaben und zugeordnete Unterlagen basierend auf den lokalen Gesetzen und Vorschriften des Wohnortes des Kandidaten.
- Erstellt ein Ticket für das IT-Onboarding mit Angabe erforderlicher Ausrüstung, Anwendungen und E-Mail-Gruppen.
Onboarding am ersten Tag
- Bietet eine Einführung in den Manager, das Team und andere nützliche Kontakte in der Organisation.
- Überwacht ausstehende Aufgaben für den neuen Mitarbeiter, HR- und IT-Teams und bietet Updates, während Aufgaben abgeschlossen werden.
- Bietet Unterstützung an, wenn Onboarding-Schritte nach einem bestimmten Zeitraum noch nicht abgeschlossen sind.
- Bietet eine dedizierte Chat-Schnittstelle für neue Mitarbeiter, um Fragen im Zusammenhang mit dem Onboarding zu stellen und Support anzufordern. Der KI-Agent kann IT-Service-Tickets in deinem Namen einreichen.
Erste Wochen und Training
- Bietet einen personalisierten Lernpfad basierend auf der Abteilung.
Beispiel-Prompts
Im Folgenden finden Sie Beispiel-Prompts, die der HR Agent mit Zugriff auf die entsprechenden Daten verarbeiten kann.
HR-bezogene Fragen
- „Wer ist mein Manager?"
- „Wer ist nächste Woche abwesend?"
- „Wer war letzte Woche abwesend?"
- „Wer ist morgen abwesend?"
- „Ist [Name einfügen] heute abwesend?"
IT-Service-bezogene Fragen
- „Wie setze ich mein Passwort zurück?"
- „Ich benötige Hilfe beim Einrichten meines Computers."
- „Kannst du mir beim Einrichten meines E-Mail-Kontos helfen?"
- „Meine Maus ist defekt. Was sollte ich tun?"
- „Mein Laptop wird nicht aufgeladen. Was sollte ich tun?"
- „Ich benötige eine neue Maus. Kannst du dafür ein Ticket erstellen?"
Installation, Konfiguration und Betrieb
Führe diese Schritte aus, um diesen AI Agent zu installieren, zu konfigurieren und zu betreiben:
- Benutzerdefinierte Komponenten herunterladen und das Studio-Projekt installieren.
- BambooHR vorbereiten.
- Jira vorbereiten.
- Google Form erstellen.
- Slack App erstellen.
- Jitterbit Cloud Datastore vorbereiten.
- Projektvariablen konfigurieren.
- Verbindungen testen.
- E-Mail-Vorlagen hinzufügen.
- Zeitpläne erstellen.
- Projekt bereitstellen.
- Jitterbit Custom API erstellen.
- Projekt-Workflows überprüfen.
- Projekt-Workflows auslösen.
- Fehlerbehebung.
- Verschiedene Endpoint-Nutzung.
Benutzerdefinierte Komponenten herunterladen und das Projekt installieren
Führe diese Schritte aus, um Anpassungsdateien herunterzuladen und das Studio-Projekt zu installieren:
-
Melde dich beim Harmony-Portal unter https://login.jitterbit.com an und öffne Marketplace.
-
Suche den AI Agent namens Jitterbit HR Agent. Du kannst die Suchleiste verwenden oder im Bereich Filter unter Type die Option AI Agent auswählen, um die Ansicht so zu filtern, dass nur verfügbare AI Agents angezeigt werden.
-
Klicke auf den Documentation-Link des AI Agents, um dessen Dokumentation in einem neuen Tab zu öffnen. Halte den Tab offen, damit du nach dem Start des Projekts auf die Dokumentation verweisen kannst.
-
Klicke auf Start Project, um einen zweischrittigen Konfigurationsdialog zu öffnen. Mit diesem Dialog lassen sich benutzerdefinierte Komponenten herunterladen und der AI Agent als Studio-Projekt importieren.
Hinweis
Wenn der AI Agent noch nicht erworben wurde, wird stattdessen Get agent angezeigt. Klicke auf Get agent, um einen Informationsdialog zu öffnen, und klicke dann auf Submit, um anzufordern, dass ein Vertreter dich zum Kauf des AI Agents kontaktiert.
-
In Konfigurationsschritt 1 Download Customizations werden die folgenden Dateien bereitgestellt, um die Struktur von CSV-Dateien zu zeigen, die Slack App zu erstellen und das Google Form-App-Skript zu erstellen. Wähle die Dateien aus und klicke auf Download Files:
-
Google Form-App-Skript
googleForm_appScript.js
-
CSV-Vorlagendateien
TEMPLATE - IT_Apps_JobRole.csvTEMPLATE - IT_G-Suite Groups.csvTEMPLATE - IT_LaptopChoice_JobRole.csvTEMPLATE - HR Agent Onboarding Courses - Job Role.csv
-
Slack-App-Manifestdatei
slack_app_manifest.json
Tipp
Der Konfigurationsdialog enthält eine Warnung, die Vorlage vor dem Anwenden von Endpoint-Anpassungen nicht zu importieren. Diese Warnung gilt nicht für diesen AI Agent und kann ignoriert werden. Folge der empfohlenen Reihenfolge der Schritte in dieser Dokumentation.
-
-
Klicke auf Next.
-
In Konfigurationsschritt 2 Create a New Project wählst du eine Umgebung, in der du das Studio-Projekt erstellen möchtest, und klickst auf Create Project.
-
Ein Fortschrittsdialog wird angezeigt. Nachdem dieser angibt, dass das Projekt erstellt wurde, verwendest du den Dialog-Link Go to Studio oder öffnest das Projekt direkt über die Seite Studio Projects.
BambooHR vorbereiten
Die folgenden wesentlichen Komponenten müssen in BambooHR für den HR Agent erstellt werden. Diese Komponenten sind notwendig, um die für die Workflow-Ausführung erforderlichen Informationen abzurufen.
Ordner in BambooHR erstellen
Erstelle die folgenden Ordner in BambooHR. Der HR Agent nutzt diese Ordner, um relevante Ressourcen für die Workflow-Funktionalität zu finden.
-
Öffne vom BambooHR-Dashboard aus den Bereich Files.
-
Klicke auf + Add Folder.
-
Gib im Dialogfeld einen der folgenden Ordnernamen ein:
Training DocumentsOnboarding Documents (ALL)IT Documents
-
Klicke auf Save oder Create, um den Ordner zu erstellen.
-
Wiederhole die Schritte 2–4 für jeden verbleibenden Ordner.
Dateien in Ordner hinzufügen
Damit die HR Agent-Workflows funktionieren, müssen bestimmte Dateien in den entsprechenden BambooHR-Ordnern abgelegt werden. Das HR Agent-Paket stellt beispielhafte CSV-Dateien bereit. Es ist entscheidend, dass die Struktur von Ersatzdateien identisch bleibt. Allerdings können Dateinamen geändert werden. Wenn ein Dateiname geändert wird, muss diese Änderung in allen anderen Teilen des Projekts, in denen auf den Dateinamen verwiesen wird, einheitlich angewendet werden, da diese Dateien für die Funktionsweise der Workflows essentiell sind.
Schulungsdokumente hochladen
Das HR Agent-Paket enthält eine beispielhafte CSV-Datei namens TEMPLATE - HR Agent Onboarding Courses - Job Role.csv. Diese Datei listet die Pflichtschulungen auf, die den einzelnen Abteilungen zugewiesen sind.
-
Öffne
TEMPLATE - HR Agent Onboarding Courses - Job Role.csvaus dem HR Agent-Paket. -
Aktualisiere die Datei mit den unternehmensabhängigen Schulungsinformationen. Behalte die Spaltenstruktur und Formatierung bei.
-
Speichere die aktualisierte Datei.
-
Melde dich bei BambooHR an.
-
Wähle aus dem linken Menü Files aus.
-
Klicke auf den Ordner Training Documents.
-
Klicke auf Upload.
-
Wähle deine aktualisierte CSV-Datei aus und klicke auf Open.
IT-Dokumente hochladen
Das HR Agent-Paket enthält drei beispielhafte CSV-Dateien für den IT-Onboarding-Ticketerstellungs-Workflow (Pre Onboarding | ITSM Request). Lade nur die Dateien hoch, die für den IT-Onboarding-Prozess deines Unternehmens relevant sind:
TEMPLATE - IT_Apps_JobRole.csv: Listet die Anwendungen auf, auf die die einzelnen Abteilungen zugreifen können.TEMPLATE - IT_G-Suite Groups.csv: Listet die Google Workspace-Gruppen auf, auf die die einzelnen Abteilungen zugreifen können.TEMPLATE - IT_LaptopChoice_JobRole.csv: Listet den Laptop-Typ auf, der den einzelnen Abteilungen zugewiesen ist.
Gehe wie folgt vor, um die IT-Dokumente hochzuladen:
-
Öffne alle CSV-Dateien, die du aus dem HR Agent-Paket benötigst.
-
Ersetze die Beispieldaten durch die Abteilungen und IT-Ressourcen deines Unternehmens. Ändere nicht die Spaltenüberschriften oder die Dateistruktur.
-
Speichere alle aktualisierten Dateien.
-
Gehe in BambooHR zu Files.
-
Klicke auf den Ordner IT Documents, um ihn zu öffnen.
-
Klicke auf Upload.
-
Wähle eine oder mehrere deiner aktualisierten CSV-Dateien aus und klicke auf Open.
Onboarding-Dokumente hochladen
Lade Dokumente wie Unternehmenskultur-Leitfäden, Übersichten zu Arbeitnehmerleistungen, Unternehmensveranstaltungskalender, Unternehmensnachrichten und Updates, Bürorichtlinien und -verfahren sowie Kontaktinformationen zum Team hoch.
So lädst du Dateien in diesen Ordner hoch:
-
Sammle die Onboarding-Dokumente, die du an neue Mitarbeiter senden möchtest.
-
Gehe in BambooHR im linken Menü zu Files.
-
Klicke auf den Ordner Onboarding Documents (ALL), um ihn zu öffnen.
-
Klicke auf Upload.
-
Wähle eine oder mehrere Dateien von deinem Computer aus und klicke auf Open.
Benutzerdefinierte Berichte in BambooHR erstellen
Du musst zwei benutzerdefinierte Berichte in BambooHR für den HR Agent erstellen:
- Eine umfassende Liste mit allen aktuellen Mitarbeitern.
- Eine Liste mit allen unvollständigen HR-Aufgaben für jeden Mitarbeiter, unabhängig davon, ob sie dem Mitarbeiter direkt oder seinem designierten HR-Kontakt zugewiesen sind.
Mitarbeiterbericht erstellen
Um die erforderlichen Mitarbeiterdaten für das HR Agent-Projekt zu generieren, erstelle einen Bericht, der alle wesentlichen Mitarbeiterinformationen enthält:
-
Melde dich bei deinem BambooHR-Dashboard an.
-
Klicke in der oberen Navigationsleiste auf Reports.
-
Klicke auf + New Report (normalerweise oben rechts).
-
Gib einen Berichtsnamen ein:
Employees Report. -
Füge die folgenden Felder zum Bericht hinzu:
-
Vorname
- Nachname
- Einstellungsdatum
- Land
- E-Mail (Arbeit)
- E-Mail (Privat)
- E-Mail des Vorgesetzten
- Name des Vorgesetzten
- LinkedIn-URL
- Abteilung
- Berufsbezeichnung
- Berichtet an
-
SRE-Benutzerregion
Hinweis
SRE-Benutzerregionist ein benutzerdefiniertes Feld. Dieses Feld wird beim Erstellen eines IT-Onboarding-Tickets verwendet. Falls Ihr Unternehmen diese Informationen nicht benötigt, ist dieses Feld optional. Andernfalls müssen Sie dieses benutzerdefinierte Feld in BambooHR gemäß der Dokumentation zum benutzerdefinierten Feld-Generator erstellen.BambooHR stellt bestimmte Mitarbeiterfelder erst nach dem Einstellungsdatum eines Mitarbeiters zur Verfügung. Um die Workflows vor dem Onboarding zu unterstützen, müssen Sie die folgenden benutzerdefinierten Felder erstellen und beim Hinzufügen eines neuen Mitarbeiterdatensatzes manuell ausfüllen:
NewHireDepartmentNewHireJobTitleNewHireReportsTo
Um diese benutzerdefinierten Felder in BambooHR zu erstellen, folgen Sie der Dokumentation zum benutzerdefinierten Feld-Generator.
-
Filterergebnisse sollten Alle Mitarbeiter sein.
-
Klicken Sie auf Speichern.
Bericht über Mitarbeiteraufgaben erstellen
Um die erforderlichen ausstehenden HR-Aufgaben für das HR-Agent-Projekt zu generieren, erstellen Sie mit dem folgenden Verfahren einen Bericht, der alle wesentlichen Mitarbeiteraufgaben enthält, die für das Projekt erforderlich sind:
-
Melden Sie sich bei Ihrem BambooHR-Dashboard an.
-
Klicken Sie in der oberen Navigationsleiste auf Berichte.
-
Klicken Sie auf + Neuer Bericht (normalerweise oben rechts).
-
Geben Sie einen Berichtnamen ein:
Employee Tasks Report. -
Fügen Sie die folgenden Felder zum Bericht hinzu:
- Aufgabe
- Kategorie
- Aufgabenliste
- Zugewiesen an
- Fälligkeitsdatum
- Abschlussdatum
- Abgeschlossen
-
Filterergebnisse sollten Alle Mitarbeiter sein.
-
Klicken Sie auf Speichern.
BambooHR-API-Schlüssel erstellen
Sie müssen einen API-Schlüssel generieren, um BambooHR innerhalb des Projekts zu verbinden. Folgen Sie den BambooHR-Anweisungen zum Erstellen eines neuen API-Schlüssels (Berechtigungen erforderlich). Nach der Erstellung des API-Schlüssels speichern Sie ihn. Dieser Schlüssel wird in den nächsten Konfigurationsschritten verwendet.
Jira vorbereiten
Erstellen Sie die folgenden benutzerdefinierten Felder und fügen Sie sie zum Objekt Aufgabe hinzu:
- Vollständiger Name
- Berichtet an
- Abteilung
- Berufsbezeichnung
- Region
Jedes benutzerdefinierte Feld muss den Typ text verwenden.
Anleitungen zum Erstellen benutzerdefinierter Felder finden Sie in der Atlassian-Dokumentation zum Verwalten benutzerdefinierter Felder.
Hinweis
Sie können diese benutzerdefinierten Felder nach Bedarf ändern. Beispielsweise können Sie Felder entfernen, neue hinzufügen oder vorhandene Felder umbenennen. Wenn Sie Änderungen an den benutzerdefinierten Feldern vornehmen, müssen Sie auch die Transformationszuordnungen im Vorgang ITSM - Create Task in JIRA Request aktualisieren.
Nach Abschluss aller Schritte bis Verbindungen testen müssen Sie auch die Jira-Aktivität Problem aktualisieren. Siehe Jira-Issue-Aktivität aktualisieren.
Ein Google-Formular erstellen
Dieses Formular ist für neue Kandidaten konzipiert. Es wird in deren Willkommens-E-Mail eingefügt, um wichtige Informationen zu sammeln und den Prozess zur Erstellung von IT-Service-Management-Tickets einzuleiten (Pre Onboarding | ITSM Request). Diese Schritte können übersprungen werden, wenn eine Alternative zu Google Forms bevorzugt wird. Allerdings sollten die benutzerdefinierten Jitterbit-APIs in den folgenden Schritten Die benutzerdefinierte Jitterbit-API erstellen immer noch befolgt werden, und die API sollte durch Ihr bevorzugtes Formular ausgelöst werden.
Das Formular erstellen
-
Gehen Sie zu Google Forms.
-
Erstellen Sie ein leeres Formular.
-
Fügen Sie die folgenden erforderlichen Felder hinzu:
-
Vollständiger Name (Fragetyp: Kurze Antwort)
-
Adresse (Fragetyp: Absatz)
-
Telefonnummer (Fragetyp: Kurze Antwort)
-
E-Mail (Fragetyp: Kurze Antwort, mit aktivierter E-Mail-Validierung)
-
Geben Sie Ihrem Formular einen Namen:
Onboarding Form.
-
Das Formular mit einem Google Sheet verknüpfen
-
Klicken Sie im Formular-Editor auf Responses.
-
Klicken Sie auf das grüne Google Sheets-Symbol in der oberen rechten Ecke.
-
Wählen Sie Create a new spreadsheet aus.
-
Geben Sie den Tabellenkalkulationsnamen ein:
Onboarding Form (Responses). -
Klicken Sie auf Create, um das Formular mit der Tabellenkalkulation zu verknüpfen.
Die Tabellenkalkulation erstellt automatisch Spalten basierend auf den Formularfragen. Vergewissern Sie sich, dass die Spalten in der folgenden Reihenfolge angezeigt werden, da das Skript von dieser genauen Reihenfolge abhängt:
- Timestamp
- Full Name
- Address
- Phone Number
Wenn die Spaltenreihenfolge unterschiedlich ist, stimmen die Formularfragen möglicherweise nicht mit der erwarteten Reihenfolge überein. Ordnen Sie die Fragen im Formular so an, dass sie der obigen Reihenfolge entsprechen.
Apps Script einrichten
- Gehen Sie in der verknüpften Google Sheet zu Extensions > Apps Script.
- Der Apps Script-Editor wird geöffnet. Das Skript heißt standardmäßig
Untitled project. - Klicken Sie oben im Editor auf Untitled project und benennen Sie es in
Onboarding Form (Responses)um. - Löschen Sie im Apps Script-Editor vorhandenen Code.
- Öffnen Sie die Datei
googleForm_appScript.jsaus dem HR Agent-Paket. - Kopieren Sie den gesamten Code aus
googleForm_appScript.jsund fügen Sie ihn in den Apps Script-Editor ein. - Lassen Sie
YOUR_ENDPOINT_HEREundYOUR_API_KEY_HEREim eingefügten Code als Platzhalter. Sie werden diese Werte später in Create the Jitterbit custom API aktualisieren. - Klicken Sie auf Save.
Formularabsende-Trigger einrichten
Konfigurieren Sie das Skript so, dass es automatisch ausgeführt wird, wenn ein Formular abgesendet wird.
-
Klicken Sie im Apps Script-Editor auf das Symbol Triggers in der linken Seitenleiste.
-
Klicken Sie auf Add Trigger.
-
Konfigurieren Sie die Trigger-Einstellungen:
- Choose which function to run: Wählen Sie onFormSubmit aus.
- Select event source: Wählen Sie From spreadsheet aus.
- Select event type: Wählen Sie On form submit aus.
- Failure notification settings: Wählen Sie Notify me immediately aus.
-
Klicken Sie auf Save.
Wenn ein Benutzer das Formular absendet, sendet das Skript die Antwort an das HR Agent-Projekt und löst den Vorgang Create ITSM Request API aus.
Formular freigeben
-
Gehen Sie zu forms.google.com und öffnen Sie das Onboarding-Formular.
-
Klicken Sie auf Send.
-
Klicken Sie auf das Link-Symbol, um den teilbaren Link zu erhalten.
-
Ändern Sie unter Get link die Zugangseinstellung in Anyone with the link.
-
Klicken Sie auf Copy link, um die Formular-URL zu kopieren.
-
Teilen Sie diesen Link mit neuen Mitarbeitern, damit diese das Formular aufrufen und absendenkönnnen.
Slack-App erstellen
Führen Sie die folgenden Schritte aus, um die Slack-Chat-Schnittstelle zu erstellen:
-
Erstellen Sie eine Slack-App mit der Slack-App-Manifestdatei (
slack_app_manifest.json), die mit den Anpassungsdateien dieses KI-Agents bereitgestellt wird. Alternativ können Sie die App von Grund auf erstellen. -
Wenn Sie die bereitgestellte Manifestdatei verwenden, ersetzen Sie die folgenden Platzhalter durch Ihre eigenen Konfigurationswerte:
Platzhalter Beschreibung {{Replace with Slack bot name}}Der Name, den Ihr Slack-Bot haben soll, wie er Benutzern angezeigt wird. Ersetzen Sie diesen Wert an zwei Stellen im Manifest. {{Replace with Jitterbit API URL}}Die Service-URL der Jitterbit-Custom-API, die Sie in Create the Slack bot API request handler erstellt haben. -
Installieren Sie die App in Ihrem Slack-Workspace.
-
Rufen Sie das Bot-Token ab (für das Feld Bot User OAuth Token der Slack-Verbindung) und geben Sie seinen Wert für die Projektvariable
slack.bot.user.tokenein. -
Testen Sie die Slack-Verbindung und stellen Sie das Projekt erneut bereit.
Hinweis
Fügen Sie den Slackbot zu Ihren IT- und HR-Kanälen hinzu. Führen Sie die folgenden Schritte aus:
- Navigieren Sie zu dem Kanal, dem der Bot beitreten soll. Geben Sie im Nachrichteneingabefeld
/invite @YourBotNameein, wobeiYourBotNameder Name des Bots ist. - Wiederholen Sie diesen Schritt für jeden Kanal, in dem Sie den Bot hinzufügen möchten (IT und HR).
Jitterbit Cloud Datastore vorbereiten
Falls Sie noch kein Cloud Datastore-Zugriffstoken haben, folgen Sie der Dokumentation, um eines zu generieren. Speichern Sie das Zugriffstoken nach dem Erstellen. Dieses Token wird in den nächsten Konfigurationsschritten verwendet.
Erstellen Sie einen Schlüsselspeicher im Jitterbit Cloud Datastore mit dem Namen candidate_welcome_emails. Die Felder Key, AlternativeKey und Value sind standardmäßig vorhanden. Fügen Sie die benutzerdefinierten Felder mit den Namen und Typen aus der folgenden Tabelle hinzu.
candidate_welcome_emails
Dieser Schlüsselspeicher enthält die Liste der Kandidatennamen, E-Mails und personalisierten Willkommens-E-Mail-Inhalte.
| Feldname | Typ | Beschreibung |
|---|---|---|
Key |
Text | Wird automatisch ausgefüllt. Name und Nachname des Kandidaten mit Präfix WE- ohne Leerzeichen. Beispiel: WE-FirstLast. Dieser Wert wird im Workflow Pre Onboarding \| Offer Signed generiert. |
AlternativeKey |
Text | Nicht verwendet. |
Value |
Text | Wird automatisch ausgefüllt. Name und Nachname des Kandidaten ohne Leerzeichen. Dieser Wert wird im Workflow Pre Onboarding Offer Signed generiert. |
CandidateEmail |
Text | Wird automatisch ausgefüllt. Die E-Mail-Adresse des Kandidaten. Dieser Wert wird im Workflow Pre Onboarding \| Offer Signed generiert. |
CandidateEmailBody |
Big Text | Wird automatisch ausgefüllt. Der E-Mail-Inhalt, der für den Kandidaten generiert wird. Dieser enthält den personalisierten E-Mail-Inhalt. Der Wert wird im Workflow Pre Onboarding \| Offer Signed generiert. |
Projektvariablen konfigurieren
Im Studio-Projekt, das früher über den Marketplace installiert wurde, müssen Sie Werte für die folgenden Projektvariablen festlegen.
Um Projektvariablen zu konfigurieren, verwenden Sie das Aktionsmenü des Projekts und wählen Sie Project Variables aus. Dies öffnet eine Schublade am unteren Rand der Seite, in der Sie die Werte überprüfen und festlegen können.
BambooHR
Tipp
Wir empfehlen, mit Ihren HR- und IT-Abteilungen zusammenzuarbeiten, um die Variablenwerte in diesem Abschnitt auszufüllen.
| Variablenname | Beschreibung |
|---|---|
bambooHr.base.url |
BambooHR-Basis-URL für HTTP-Anfragen. Beispiel: https://{companyDomain}.bamboohr.com/ |
bamboo.password |
BambooHR-Passwort für die Standardauthentifizierung. |
bamboo.apiKey |
Ihr API-Schlüssel für den Benutzernamen der BambooHR-Standardauthentifizierung. Siehe Dokumentation für Informationen zum Abrufen eines API-Schlüssels. |
bamboo.path.reports.employeeTasks |
ID des benutzerdefinierten Berichts für Mitarbeiteraufgaben. Diese ID wird in der URL angezeigt, wenn Sie den Bericht besuchen. Beispielsweise ist in der URL https://{companyDomain}.bamboohr.com/reports/custom/Employee+Tasks+Reports/103 die ID 103. |
bamboo.path.reports.employees |
ID des benutzerdefinierten Mitarbeiterberichts. Diese ID wird in der URL angezeigt, wenn Sie den Bericht besuchen. Beispielsweise ist in der URL https://{companyDomain}.bamboohr.com/reports/custom/Employee+Tasks+Reports die ID 101 |
bamboo.folder.trainingDocuments |
Ordnername, in dem Schulungsdokumente gespeichert sind. |
bamboo.folder.onboarding |
Ordnername mit Onboarding-Dokumenten, die eine Woche vor dem Startdatum an neue Mitarbeiter gesendet werden sollten. Dieser Ordner sollte keine Signaturdokumente enthalten. |
bamboo.folder.itDocuments |
Ordnername, in dem IT-Dokumente gespeichert sind. |
bamboo.folder.file.itLaptopChoice |
Dateiname, in dem Details zur Laptop-Auswahl gespeichert sind. |
bamboo.folder.file.itGSuite |
Dateiname, in dem Google Workspace-Details gespeichert sind. |
bamboo.folder.file.itApps |
Dateiname, in dem App-Details gespeichert sind. |
bamboo.folder.file.courses |
Dateiname, in dem Kursdetails gespeichert sind. |
Jira
| Variablenname | Beschreibung |
|---|---|
jira.username |
Benutzername für die Jira-Basisauthentifizierung. |
jira.task.reporter |
Interne Jira-ID des Berichterstatters. |
jira.task.assignee |
Interne Jira-ID des Beauftragten. |
jira.project.name |
Jira-Projektname. |
jira.baseUrl |
Jira-Basis-URL für HTTP-Anfragen. |
jira.api.token |
Jira API-Token. Weitere Informationen finden Sie unter Jira-Verbindung, um hilfreiche Links zum Erstellen des API-Tokens zu erhalten. |
Confluence
| Variablenname | Beschreibung |
|---|---|
confluence.username |
Benutzername für die Confluence-Basisauthentifizierung. |
confluence.apiKey |
Passwort für die Confluence-Basisauthentifizierung. Weitere Informationen zum Abrufen des API-Schlüssels finden Sie unter API-Token verwalten. |
confluence.base.url |
Die Basis-URL zum Abrufen der IT-Onboarding-Dokumentation. |
Weitere Informationen zur Verwendung der Variablen finden Sie in der Dokumentation.
| Variablenname | Beschreibung |
|---|---|
email.smtp.username |
Benutzername für die Authentifizierung mit dem SMTP-Server. |
email.smtp.password |
Passwort für die Authentifizierung mit dem SMTP-Server. |
email.smtp.host |
SMTP-Serverhostname oder IP-Adresse zum Versenden von E-Mails. |
email.from |
Absender-E-Mail-Adresse, die im Feld „Von" für alle ausgehenden E-Mails verwendet wird. |
email.to.it |
E-Mail-Adresse der IT-Abteilung zum Empfangen von Systembenachrichtigungen während des Projekts. |
email.to.hr |
E-Mail-Adresse der Personalabteilung zum Empfangen von Benachrichtigungen während des Projekts. |
Hinweis
Der E-Mail-Connector verwendet SMTP-Sicherheit mit SSL und SMTP-Port 465.
OpenAI
| Variablenname | Beschreibung |
|---|---|
openAI.apiKey |
OpenAI API-Schlüssel für die Authentifizierung. Weitere Informationen finden Sie unter OpenAI. |
openAi.url.path |
URL-Pfad für OpenAI API-Aufrufe. Wird von der Anwendung dynamisch zugewiesen. Leer lassen. |
gpt.toolChoice |
Werkzeugauswahlmodus für die GPT-Funktionsaufrufe. Sollte auf auto gesetzt werden. |
gpt.temperature |
Steuert die Zufälligkeit in GPT-Antworten (0,0–2,0). Leer lassen, um den Standardwert zu verwenden, oder einen benutzerdefinierten Wert angeben. |
gpt.model |
GPT-Modellkennung. Muss auf GPT-4o gesetzt werden. |
gpt.maxTokens |
Maximale Anzahl von Token in GPT-Antworten. Leer lassen, um den Standardwert zu verwenden, oder einen benutzerdefinierten Wert angeben. |
Slack
| Variablenname | Beschreibung |
|---|---|
slack.bot.user.token |
Bot-Benutzer OAuth-Zugriffstoken, das nach dem Erstellen der Slack-App erhalten wird. Wird für die Authentifizierung in der Slack-Verbindung verwendet. |
slack.itChannel.ID |
Slack-Kanal-ID für IT-Benachrichtigungen. Befindet sich in den Kanaldetails. |
slack.hrChannel.ID |
Slack-Kanal-ID für HR-Benachrichtigungen. Befindet sich in den Kanaldetails. |
slack.bot.id |
Slack-Bot-Benutzer-ID (Mitglieds-ID). Wird verwendet, um zu verhindern, dass der Bot auf seine eigenen Nachrichten antwortet. Befindet sich in den App-Details. |
Hinweis
Die Slack-App wird in einem späteren Schritt erstellt. Vorerst können die Variablen slack.bot.id und slack.bot.user.token leer gelassen werden.
Sonstige
| Variablenname | Beschreibung |
|---|---|
your.company |
Der Name deines Unternehmens. Beispiel: Jitterbit |
welcome.form |
Die URL des Formulars, das an Kandidaten in der Willkommens-E-Mail gesendet wird. Falls du ein Google-Formular erstellt hast, siehe Google-Formular erstellen. |
learningPath.enrollment.key |
Die URL deines Organigramms. |
Introduction.helpfulIT.url |
Die URL mit hilfreichen IT-Links oder Informationen. |
Introduction.companyContact.url |
Die URL mit wichtigen Unternehmenskontakten. |
hr.tasks.link |
Eine URL, die Mitarbeiter durch das Abschließen ihrer verbleibenden HR-Aufgaben führt. Wenn keine dedizierte URL vorhanden ist, gib die Startseite deiner HR-Plattform an. |
cloud.datastore.key |
Dein Cloud-Datastore-Schlüssel. Weitere Informationen findest du unter Jitterbit Cloud Datastore vorbereiten. |
resource.IT.page |
Die Seiten-ID der IT-Onboarding-Seite. Der Chatbot verweist auf diese Seite, wenn er Fragen zum IT-Onboarding beantwortet. |
Introduction.orgChart.url |
Die URL deines Organigramms. |
offerSigned.LastModifiedDate.Manual.Date |
Das Datum der manuellen Workflow-Ausführung, das das zwischengespeicherte Datum für den Workflow Pre Onboarding \| Offer Signed überschreibt. |
offerSigned.LastModifiedDate.Manual |
Auf true setzen, um die Überschreibung des manuellen Ausführungsdatums für den Workflow Pre Onboarding \| Offer Signed zu aktivieren. |
Verbindungen testen
Testen Sie die Endpunktkonfigurationen, um die Konnektivität mithilfe der definierten Projektvariablenwerte zu überprüfen.
Um Verbindungen zu testen, rufen Sie die Registerkarte Projektendpunkte und Konnektoren in der Designkomponentenpalette auf, bewegen Sie den Mauszeiger über jeden Endpunkt und klicken Sie auf Testen.
E-Mail-Vorlagen hinzufügen
Im Workflow Common Operations, in dessen Operation Common Scripts, finden Sie ein Skript namens HTML Email Templates. Dieses Skript enthält alle E-Mail-Vorlagen für das Projekt. Referenz-Jitterbit-Beispielvorlagen sind zur Orientierung enthalten, müssen aber durch die tatsächlichen E-Mail-Vorlagen Ihres Unternehmens ersetzt werden.
Jira-Issue-Aktivität aktualisieren
Sie müssen die Jira-Issue-Aktivität aktualisieren, um die in Jira vorbereiten erstellten benutzerdefinierten Felder einzubeziehen:
- Gehen Sie zur Operation
ITSM - Create Task in JIRA. - Öffnen Sie die Jira-Aktivität Issue.
- In Schritt 2: Projekt auswählen klicken Sie auf Aktualisieren und wählen Sie Ihr Projekt aus.
- In Schritt 3: Objekt auswählen klicken Sie auf Aktualisieren und wählen Sie Task aus.
- Klicken Sie auf Weiter und dann auf Fertig.
Zeitpläne erstellen
Bestimmte Workflows erfordern eine geplante Ausführung. Der KI-Agent enthält einen vorkonfigurierten Zeitplan, Daily Schedule, der für tägliche Auslöser eingerichtet ist.
Sie können den vorhandenen Daily Schedule verwenden (dies kann im Menü Aktionen der Operation unter Einstellungen > Zeitpläne durchgeführt werden) oder neuen Zeitplan erstellen. Die nachfolgend aufgeführten Operationen müssen einen zugeordneten Zeitplan aufweisen:
Controller - Search Offer SignedController - Search New Hire - Week BeforeController - Search IntroductionsController - Search Write LI PostController - Search - Personalized Learning PathController - Search - Employee Remaining HR TasksController - Search - In-progress IT Tickets
Projekt bereitstellen
-
Öffnen Sie den Workflow Datastore Calls.
-
Suchen Sie die folgenden drei Cloud Datastore-Endpunktaktivitäten:
Insert Welcome EmailQuery Welcome EmailDelete Items
-
Klicken Sie auf jede Cloud Datastore-Endpunktaktivität und wählen Sie den Speicher namens
candidate_welcome_emailsStudioaus, den Sie im Schritt Jitterbit Cloud Datastore vorbereiten erstellt haben. -
Klicken Sie auf Weiter und dann auf Fertig.
-
Wiederholen Sie die Schritte 3 und 4 für jede Cloud Datastore-Endpunktaktivität.
-
Stellen Sie das Studio-Projekt bereit.
Um das Projekt bereitzustellen, wählen Sie im Menü Aktionen des Projekts die Option Bereitstellen aus.
Benutzerdefinierte Jitterbit-API erstellen
Erstellen Sie eine benutzerdefinierte API mit dem API Manager für eines der folgenden Elemente:
-
Slack-Bot-API-Request-Handler: Erforderlich, wenn die im Design dieses KI-Agenten enthaltene Slack-Benachrichtigung verwendet wird.
-
Google Forms-API-Request-Handler: Erforderlich, wenn das im Design dieses KI-Agenten enthaltene Google Form verwendet wird.
Slack-Bot-API-Request-Handler erstellen
Diese benutzerdefinierte Jitterbit-API löst die Operation PlatformBot | Inbound Event aus. Konfigurieren und veröffentlichen Sie die benutzerdefinierte API mit den folgenden Einstellungen:
- API Service:
HR Agent - PlatformBot | Inbound Event - Path:
/ - Project: Wählen Sie das aus dem
Jitterbit HR Agentin Marketplace erstellte Studio-Projekt aus - Operation to Trigger:
PlatformBot | Inbound Event - Method:
POST - Response Type:
System Variable
Behalten Sie die Service-URL der veröffentlichten API zur Verwendung beim Erstellen der Slack-App bei. Die Service-URL finden Sie in der API-Details-Schublade auf der Registerkarte Services, indem Sie den Mauszeiger auf die Spalte Actions des Service bewegen und auf API-Service-URL kopieren klicken.
Google Form API Request Handler erstellen
Dieser benutzerdefinierte Jitterbit API löst die Operation Create ITSM Request API aus. Konfigurieren und veröffentlichen Sie die benutzerdefinierte API mit den folgenden Einstellungen:
- Servicename:
HR Agent - Create ITSM Request API - Projekt: Wählen Sie das Studio-Projekt aus, das aus dem
Jitterbit HR Agentim Marketplace erstellt wurde - Operation:
Create ITSM Request API - Methode:
POST - Antworttyp:
System Variable - Sicherheitsprofil: Neues Profil erstellen
- Profilname:
HR Agent - Umgebung: Wählen Sie die Umgebung aus, in der das Jitterbit HR Agent-Projekt bereitgestellt ist
- Typ:
API Key - Schlüssel:
X-APIKey - Wert: Sie erhalten einen eindeutigen Schlüssel. Kopieren Sie diesen Wert vorerst. Dies ist erforderlich, um die Google Form-Konfiguration abzuschließen.
- Klicken Sie auf Speichern.
- Profilname:
Stellen Sie sicher, dass Sie das Sicherheitsprofil der API-Konfiguration zuweisen und diese speichern. Behalten Sie die Service-URL der veröffentlichten API zur Verwendung in dem Google Form. Sie finden die Service-URL in der API-Detaildatei auf der Registerkarte Dienste. Zum Kopieren der URL bewegen Sie den Mauszeiger über die Spalte Aktionen des Dienstes und klicken Sie auf API-Service-URL kopieren. Nachdem Sie sowohl den API-Schlüssel als auch die Service-URL haben, schließen Sie die Google Form-Konfiguration App Script ab. Stellen Sie sicher, dass Sie das App Script speichern, nachdem Sie die Service-URL und den API-Schlüssel hinzugefügt haben.
Projekt-Workflows überprüfen
Im geöffneten Studio-Projekt überprüfen Sie die Workflows sowie die folgenden Beschreibungen, um zu verstehen, was sie tun. Verwenden Sie die folgende Zusammenfassungstabelle, um zu ermitteln, welche Workflows konfiguriert werden müssen und wie sie ausgelöst werden.
Hinweis
Im Projekt zeigen Workflow-Namen, denen ein Asterisk (*) vorangestellt ist, Haupt-Workflows an, die Aktionsketten einleiten. Diese Haupt-Workflows werden normalerweise geplant oder API-ausgelöst und rufen die Core Infrastructure-Workflows nach Bedarf auf. Workflows ohne Asterisks sind unterstützende Workflows.
| Workflow-Name | Kategorie | Auslösertyp | Wichtige Abhängigkeiten |
|---|---|---|---|
| Common Operations | Core Infrastructure | Manuell | Keine |
| HR Calls | Core Infrastructure | Wird von anderen Workflows aufgerufen | BambooHR |
| Platform Calls | Core Infrastructure | Wird von anderen Workflows aufgerufen | Slack oder Alternative |
| ITS Calls | Core Infrastructure | Wird von anderen Workflows aufgerufen | Jira oder Alternative |
| Emails | Core Infrastructure | Wird von anderen Workflows aufgerufen | SMTP-Konfiguration |
| Datastore Call | Core Infrastructure | Wird von anderen Workflows aufgerufen | Cloud Datastore |
| Communication Platform Bot | Core Infrastructure | API | Platform Calls, Custom API |
| OpenAI - Function Calling | OpenAI | Wird von geplanten Workflows aufgerufen | OpenAI API |
| OpenAI - Code Interpreter | OpenAI | Wird von anderen Workflows aufgerufen | OpenAI API |
| OpenAI - PDF Analysis | OpenAI | Wird von anderen Workflows aufgerufen | OpenAI API |
| OpenAI - AskHR Router | OpenAI | Wird von Chatbot-Workflows aufgerufen | OpenAI API |
| OpenAI - AskHR Function Calling | OpenAI | Wird von Chatbot aufgerufen | OpenAI API, AskHR Router |
| AskHR - After Tool - Start | OpenAI | Wird von AskHR Function Calling aufgerufen | Variiert je nach Tool |
| Pre Onboarding - Offer Signed | Pre-Boarding | Geplant | HR Calls, OpenAI Function Calling |
| Pre Onboarding - Week Before Documents | Pre-Boarding | Geplant | HR Calls, Emails |
| Pre Onboarding - ITSM Request | Pre-Boarding | API | HR Calls, ITS Calls, Custom API |
| First Day - Introductions | Erster Tag | Geplant | HR Calls, Emails |
| First Day - Write LI Post | Erster Tag | Geplant | HR Calls, OpenAI |
| First Week - Personalized Learning Path | Erste Woche | Geplant | HR Calls, OpenAI Code Interpreter |
| General - Employee Remaining HR Tasks | Laufend | Geplant | HR Calls |
| First Week - In-progress IT Tickets | Laufend | Geplant | HR Calls, ITS Calls |
Workflows der Kerninfrastruktur
Diese Workflows bieten grundlegende Operationen, die im gesamten Projekt verwendet werden.
Häufige Operationen
Dieser Workflow enthält häufig verwendete Skripte für das Projekt. Sie müssen das Skript HTML Email Templates aktualisieren, um es an die E-Mail-Vorlagen Ihres Unternehmens anzupassen. Stellen Sie dabei sicher, dass alle vorhandenen Variablen in den Vorlagen unverändert bleiben oder nach Ihren Anforderungen angepasst werden.
HR-Aufrufe
Dieser Workflow zentralisiert die wichtigsten HR-Operationen für das Projekt. Diese grundlegenden HR-Operationen werden in nachfolgenden einzelnen Workflows verwendet, wobei alle Antworten standardisiert und in gemeinsame Schemas abgebildet werden.
Plattform-Aufrufe
Dieser Workflow konsolidiert die grundlegenden Operationen für die gewählte Kommunikationsplattform (z. B. Slack). Diese standardisierten Plattform-Operationen werden von nachfolgenden Workflows verwendet. Eine Schlüsselfunktion besteht darin, wesentliche Werte in Variablen zu erfassen oder Operationsantworten in nachgelagerte Workflows zu verschieben, um sie in gemeinsame Schemas zu standardisieren und konsistent zu nutzen.
ITS-Aufrufe
Dieser Workflow konsolidiert die grundlegenden Operationen für die gewählte IT-Service-Plattform (z. B. Jira). Diese standardisierten IT-Service-Operationen werden von nachfolgenden Workflows verwendet. Eine Schlüsselfunktion besteht darin, wesentliche Werte in Variablen zu erfassen oder Operationsantworten in nachgelagerte Workflows zu verschieben, um sie in gemeinsame Schemas zu standardisieren und konsistent zu nutzen.
Hinweis
Bei der Verwendung von Jira nutzt der KI-Agent zwei Operationen zum Erstellen von Tickets: ITSM - Create Task in JIRA und Update Task in JIRA. Aufgrund von Jira API-Einschränkungen müssen beide Operationen zusammen als einzelner Ticketerstellungsprozess funktionieren.
E-Mails
Dieser Workflow verwaltet die erforderlichen E-Mail-Kommunikationen des Projekts und wird häufig während des gesamten Projektlebenszyklus verwendet.
Datastore-Aufruf
Dieser Workflow verwaltet personalisierte Willkommens-E-Mails durch folgende Aktionen:
- Speichert sie in einer Datenbank mit eindeutigen Schlüsseln.
- Ruft sie durch eine Abfrage ab, wenn sie für das Projekt benötigt werden.
- Löscht den Datensatz, sobald er nicht mehr erforderlich ist.
Communication Platform Bot
Hinweis
Falls Sie Slack nicht verwenden, können Sie diesen Workflow ignorieren, da er nicht ausgelöst wird.
Dieser Workflow verwaltet eingehende Slack Bot-Anfragen. Er wird jedes Mal über eine benutzerdefinierte Jitterbit-API ausgelöst, wenn ein Benutzer mit der Slack Bot-Chatoberfläche interagiert. Die Konfiguration der benutzerdefinierten Jitterbit-API wird in Create the Jitterbit custom API weiter unten auf dieser Seite beschrieben.
OpenAI-Workflows
Diese Workflows integrieren sich mit OpenAI, um intelligente Automation und Chatbot-Funktionalität zu ermöglichen.
OpenAI - Function Calling
Dieser Workflow dient als zentraler Function-Calling-Mechanismus für das LLM und verarbeitet Anfragen, die von geplanten Workflows eingeleitet werden (wie Pre Onboarding | Offer Signed). Seine Hauptaufgabe besteht darin, basierend auf den dem LLM bereitgestellten Benutzereingaben zu bestimmen, welches Tool ausgeführt werden soll. Er wurde so konzipiert, dass er von Aktionen ausgelöst wird, die außerhalb der Kommunikationsplattform oder des Chatbots stammen.
OpenAI - Code Interpreter
Dieser Workflow führt eine bedarfsgerechte Analyse von CSV-Dokumenten durch, um spezifische Übereinstimmungsergebnisse für verschiedene Anwendungsfälle zu ermitteln. So bestimmt er beispielsweise, welche Anwendungen basierend auf der Abteilung des neuen Mitarbeiters Zugriff erhalten sollten.
OpenAI - PDF Analysis
Dieser Workflow analysiert PDF-Lebensläufe, um deren Inhalte zusammenzufassen und es dem LLM zu ermöglichen, personalisierte Willkommens-E-Mails zu erstellen.
OpenAI - AskHR Router
Dieser Workflow dient als zwischengeschalteter Verbindungspunkt innerhalb der Gesamtnutzung des AskHR-Chatbots und verwaltet die Umformulierung von Dialoganforderungen, die Inhaltszusammenfassung und die Antworterstellung.
OpenAI - AskHR Function Calling
Dieser Workflow dient als zentraler Function-Calling-Mechanismus für das LLM und verarbeitet Anfragen, die von Benutzern über den AskHR-Chatbot eingeleitet werden. Seine Hauptaufgabe besteht darin, basierend auf den Nachrichten des Benutzers zu bestimmen, welches Tool ausgeführt werden soll. Er wurde so konzipiert, dass er von Aktionen ausgelöst wird, die von der Kommunikationsplattform oder dem Chatbot stammen.
AskHR - After Tool
Dieses Workflow-Muster leitet eine Abfolge von Aktionen ein, nachdem der AskHR-Funktionsaufruf-Workflow ein Tool auswählt. Es existieren mehrere Instanzen dieses Workflows mit unterschiedlichen Tool-Namen (beispielsweise AskHR | After Tool | Start - null_tool). Die null_tool-Variante signalisiert, dass das LLM festgestellt hat, dass die Chatbot-Anfrage des Benutzers für keines der derzeit verfügbaren Tools geeignet ist.
Pre-Boarding-Workflows
Diese Workflows automatisieren Aufgaben vor dem ersten Arbeitstag des neuen Mitarbeiters.
Pre Onboarding - Offer Signed
Dieser Workflow prüft regelmäßig nach Kandidaten, die ein Angebot unterzeichnet haben, und führt die folgenden Aktionen aus:
- Identifiziert Kandidaten, die Angebote angenommen haben.
- Sendet Warnmeldungen an interne Teams.
- Entwirft eine Willkommens-E-Mail mit einem Onboarding-Formular für den Kandidaten.
- Sendet die Willkommens-E-Mail an den zukünftigen Manager des Kandidaten zusammen mit einer Slack-Nachricht zur endgültigen Genehmigung.
Ausführliche Informationen zur Planung des Zeitplans finden Sie im Abschnitt Create schedules.
Pre Onboarding - Week Before Documents
Dieser Workflow wird nach einem Zeitplan ausgeführt, um Mitarbeiter zu identifizieren, deren Einstellungsdatum (erster Arbeitstag) für die folgende Woche geplant ist. Nach der Identifikation führt er automatisch die folgenden Aktionen aus:
- Benachrichtigt die zuständigen Manager-, IT- und HR-Teams.
- Sendet eine E-Mail mit wichtigen Onboarding-Dokumenten, z. B. Informationen zur Unternehmenskultur und zu Arbeitnehmerleistungen.
Pre Onboarding - ITSM Request
Dieser Workflow wird von einer Jitterbit-Custom-API gestartet, wenn ein neuer Mitarbeiter ein Formular einreicht. Er führt die folgenden Aktionen aus:
- Analysiert die Position des neuen Mitarbeiters anhand mehrerer CSV-Dokumente.
- Erstellt ein IT-Ticket für den Onboarding-Prozess.
- Benachrichtigt HR- und IT-Teams per E-Mail und über eine Kommunikationsplattform (beispielsweise Slack).
Die Konfiguration der Jitterbit-Custom-API wird später auf dieser Seite unter Create the Jitterbit custom API beschrieben.
First Day-Workflows
Diese Workflows werden nach einem Zeitplan ausgeführt, um automatisch Mitarbeiter zu identifizieren, deren Einstellungsdatum (erster Arbeitstag) heute ist, und führen dann bestimmte Aktionen wie unten beschrieben aus.
First Day - Introductions
Dieser Workflow führt die folgenden Aktionen aus:
- Sendet Warnmeldungen an den Manager des neuen Mitarbeiters.
- Entwirft eine Einführungs-E-Mail mit wichtigen Informationen zum ersten Arbeitstag und Unternehmenslinks.
First Day - Write LI Post
Dieser Workflow sendet eine E-Mail mit einem LinkedIn-Beitrag, der im Profil des neuen Mitarbeiters geteilt werden kann.
First Week-Workflows
Dieser Workflow unterstützt neue Mitarbeiter während ihrer ersten Woche.
First Week - Personalized Learning Path
Dieser Workflow wird nach einem Zeitplan ausgeführt, um Mitarbeiter zu identifizieren, deren Einstellungsdatum heute ist, und führt die folgenden Aktionen aus:
- Führt eine CSV-Analyse durch, um ihre Positionen mit relevanten Schulungskursen abzugleichen.
- Generiert und sendet eine personalisierte E-Mail mit Anleitung zu erforderlichen Schulungen.
Ongoing Operations-Workflows
Diese Workflows verwalten kontinuierliche HR- und IT-Operationen über den gesamten Mitarbeiterzyklus hinweg.
General - Employee Remaining HR Tasks
Dieser Workflow wird nach einem Zeitplan ausgeführt, um Erinnerungen für ausstehende HR-Aufgaben zu automatisieren. Er führt die folgenden Aktionen aus:
- Prüft auf Mitarbeiter mit unvollständigen Aufgaben innerhalb eines 90-Tage-Fensters.
- Generiert separate E-Mails sowohl für den Mitarbeiter als auch für das HR-Team mit Details zu den spezifischen Aufgaben, die jede Partei abschließen muss.
First Week - In-progress IT Tickets
Dieser Workflow wird nach einem Zeitplan ausgeführt, um ausstehende IT-Service-Onboarding-Aufgaben für neue Mitarbeiter proaktiv zu verwalten. Er führt die folgenden Aktionen aus:
- Scannt nach Mitarbeitern, die sich in ihrer ersten Woche befinden und noch unvollständige IT-Service-Tickets haben.
- Benachrichtigt IT und HR mit separaten Warnmeldungen, wenn ein IT-Service-Ticket eines neuen Mitarbeiters noch nicht abgeschlossen ist.
- Sendet eine direkte Nachricht an den Mitarbeiter und bietet Unterstützung an, um sicherzustellen, dass er die erforderliche IT-Unterstützung erhält.
Projekt-Workflows auslösen
Bereiten Sie zu Testzwecken Ihre Testdatensätze vor und führen Sie die folgenden Operationen aus. Sie können eine Operation über die Option Ausführen ausführen, die angezeigt wird, wenn Sie den Mauszeiger über die Operation bewegen:
Controller - Search Offer SignedController - Search New Hire - Week BeforeController - Search IntroductionsController - Search Write LI PostController - Search - Personalized Learning PathController - Search - Employee Remaining HR TasksController - Search - In-progress IT Tickets
Die zwei anderen Hauptworkflows werden durch die benutzerdefinierten Jitterbit-APIs ausgelöst:
PlatformBot | Inbound Event: Slack löst diesen Workflow über die benutzerdefinierte APIHR Agent - PlatformBot | Inbound Eventaus. Das Senden einer direkten Nachricht an die Slack-App löst den Trigger der benutzerdefinierten API aus.Create ITSM Request API: Google Form löst diesen Workflow über die benutzerdefinierte APIHR Agent - Create ITSM Request APIaus. Das Senden eines Beispielformulars löst den Trigger der benutzerdefinierten API aus.
Alle anderen Workflows werden durch andere Operationen ausgelöst und sind nachgelagert gegenüber den oben aufgeführten. Sie sollen nicht einzeln ausgeführt werden.
Fehlerbehebung
Lesen Sie die folgenden Protokolle durch, wenn Probleme auftreten, um detaillierte Informationen zur Fehlerbehebung zu erhalten:
Wenden Sie sich bei weiterer Unterstützung an den Jitterbit-Support.
Unterschiedliche Endpoint-Nutzung
Wenn Sie den in der Vorlage verwendeten Endpoint ändern, müssen Sie mehrere Projektkomponenten anpassen. In diesem Abschnitt werden die erforderlichen Aktualisierungen für jeden Workflow beschrieben, der den Endpoint nutzt.
Wichtig
Überprüfen Sie die Komponenten, die Sie ändern möchten, bevor Sie das Projekt anpassen. Die Überprüfung der Komponenten hilft Ihnen zu verstehen, wie diese funktionieren, und könnte es Ihnen ermöglichen, vorhandene Skripte für Ihre Endpoints zu nutzen.
HRIS-Plattformen
Wenn Ihr Unternehmen eine andere HR-Plattform als BambooHR nutzt, verwenden Sie die Anleitung in diesem Abschnitt, um Ihr Projekt anzupassen.
Der Workflow HR Calls enthält alle Operationen, die Daten aus HR-Plattformen extrahieren. Da jede HR-Plattform über eindeutige API-Dokumentation und Funktionen verfügt, variieren die Schritte zum Abrufen von Informationen zwischen verschiedenen HR-Plattformen.
Signierte Angebote erkennen und verarbeiten
Die folgenden Operationen erkennen Kandidaten, die Angebote signiert haben, und lösen den Workflow zur Verarbeitung von Angeboten aus:
Get Applicant Status: Ruft den aktuellen Status von Kandidaten ab.Get Applicant Status - Prep for Details: Bereitet Kandidatendaten für den detaillierten Abruf vor.Get Applicant Details: Ruft detaillierte Informationen über Kandidaten ab.
Diese Operationen werden auf dem Controller Controller - Search Offer Signed ausgeführt. Wenn die Operationen einen Kandidaten mit dem Status „Angebot signiert" erkennen, lösen sie die Operation Start - Single Offer aus, um den Workflow zu verarbeiten.
Führen Sie die folgenden Schritte aus, um die Operation Start - Single Offer zu konfigurieren:
- Öffnen Sie die Transformation Offer Signed Data to Common Model Employee Schema.
- Aktualisieren Sie das Quellschema.
- Führen Sie die Feldzuordnungen durch, um die erforderlichen Variablen zuzuweisen (z. B.
offerSigned_manager).
Wenn Sie neue Operationen für Ihre HR-Plattformanforderungen erstellen, fügen Sie diese zum Controller Controller - Search Offer Signed hinzu.
Benutzerdefinierte Berichte von Ihrer HR-Plattform abrufen
Die Operation GET Custom Report by ID erfüllt zwei Zwecke:
- Eine Liste von Mitarbeitern abrufen.
- Verbleibende HR-Aufgaben abrufen.
Nachdem die Operation die Berichtsdaten abgerufen hat, ruft der Agent eine nachfolgende Operation auf, die die Quelldaten einem gemeinsamen Schema (common_schema_employeeInfo) zuordnet und Variablen zuweist, die der Workflow benötigt.
Die folgenden Workflows verwenden diese Operation:
| Workflow | Aufrufende Operation | Verarbeitungsoperation |
|---|---|---|
| AskHR | After Tool | Start - find_manager | Start - find_manager |
AskHr - find_manager - Employees Directory to Common Employee schema |
| Pre Onboarding | Week before documents | Controller - Search New Hire - Week Before |
GET Report - Week Before Data to Common Model Employee Schema |
| Pre Onboarding | ITSM Request | Start | ITSM Request API |
GET Report - Employee Directory to ITSM Common Model Employee Schema |
| First Day | Introductions | Controller - Search Introductions |
GET Report - First Day Introductions Data to Common Model Employee Schema |
| First Day | Write LI Post | Controller - Search Write LI Post |
GET Report Employee - LI Post Data to Common Model Employee Schema |
| First Week | Personalized Learning Path | Controller - Search - Personalized Learning Path |
Personalized Learning Path - Employees Data to Common Model Employee Schema |
| General | Employee Remaining HR Tasks | Controller - Search - Employee Remaining HR Tasks |
Employee Remaining HR Tasks to Flat HR Tasks |
| First Week | In-progress IT Tickets | Controller - Search - In-progress IT Tickets |
GET Report Employee - Filter First Week to Common Model Employee Schema |
Für jeden Workflow öffnen Sie die Verarbeitungsvorgänge und führen Sie die folgenden Schritte aus:
- Aktualisieren Sie das Quellenschema, um es mit Ihrer HR-Plattform abzugleichen.
- Vervollständigen Sie die Feldzuordnungen, um die erforderlichen Variablen zuzuweisen.
Hinweis
Der Workflow General | Employee Remaining HR Tasks verwendet GET Custom Report by ID für den Bericht zu verbleibenden HR-Aufgaben. Wenn Sie denselben Vorgang für diesen Workflow nicht verwenden können, erstellen Sie einen neuen Vorgang und rufen Sie ihn über den Controller Controller - Search - Employee Remaining HR Tasks auf.
Mitarbeiterdaten nach ID abrufen
Der Vorgang Get Employee by Id ruft Daten für einen einzelnen Mitarbeiter von Ihrer HR-Plattform ab. Der Vorgang Get Employee Details by Id ordnet die Quelldaten dem gemeinsamen Schema zu (common_schema_employeeInfo).
Führen Sie die folgenden Schritte aus, um diese Vorgänge zu konfigurieren:
- Aktualisieren Sie den Vorgang
Get Employee by Idmit dem API-Aufruf Ihrer HR-Plattform. - Öffnen Sie die Transformation Get Employee Details by Id, um das Quellenschema zu aktualisieren und die Feldzuordnungen zur Zuweisung der erforderlichen Variablen auszufüllen.
Dateien von Ihrer HR-Plattform herunterladen
Die folgenden Vorgänge laden Dateien von Ihrer HR-Plattform herunter:
Get List of Files: Ruft eine Liste der Ordner ab.Get List of Files - Filter for Folders v2: Filtert die Ordnerliste, um den richtigen Ordner zu identifizieren.Get List of Files - Filter & Download Single File: Lädt eine einzelne Datei aus einem Ordner herunter.Get List of Files - Download All Files: Lädt alle Dateien aus einem Ordner herunter.Get List of Files - Download File v2: Handhabt den Dateidownload über die API.
Get List of Files konfigurieren
- Aktualisieren Sie den Vorgang mit dem API-Aufruf Ihrer HR-Plattform, um eine Liste der Ordner abzurufen.
- Aktualisieren Sie in den Variableneinstellungen BambooHR die Variablen, die mit
bamboo.folderbeginnen. Diese Variablen identifizieren den richtigen Ordner für jeden Workflow. - Öffnen Sie die Transformation Get List of Files - Filter for Folders v2, um das Quellenschema zu aktualisieren.
- Vervollständigen Sie die Transformationszuordnungen gemäß den Kommentaren im Zielschema.
Get List of Files - Filter & Download Single File konfigurieren
Aktualisieren Sie in den Variableneinstellungen BambooHR die Variablen, die mit bamboo.folder.file beginnen. Diese Variablen identifizieren die richtige Datei für jeden Workflow, wenn Sie eine einzelne Datei aus einem Ordner herunterladen.
Get List of Files - Download All Files konfigurieren
Dieser Vorgang lädt alle Dateien aus dem gefilterten Ordner herunter. Der Vorgang wird hauptsächlich im Workflow Pre Onboarding | Week before documents zum Versenden von Onboarding-Dokumenten verwendet. Weitere Informationen finden Sie unter Projektworkflows überprüfen.
Get List of Files - Download File v2 konfigurieren
Dieser Vorgang ist mit Get List of Files - Filter & Download Single File und Get List of Files - Download All Files als nächster Schritt verknüpft. Aktualisieren Sie den Vorgang mit dem API-Aufruf Ihrer HR-Plattform, um den Dateidownload zu handhaben.
Urlaubsdaten von Mitarbeitern abrufen
Der Vorgang Get a list of Who's Out wird in AskHR-Workflows verwendet, um Benutzerfragen wie „Wer ist morgen nicht im Büro?" zu beantworten.
Führen Sie die folgenden Schritte aus, um diesen Vorgang zu konfigurieren:
- Aktualisieren Sie den Vorgang, um den API-Endpunkt Ihrer HR-Plattform aufzurufen, der Abwesenheitsdaten abruft.
-
Verwenden Sie die folgenden Variablen, um den Datumsbereich in Ihrer HTTP-Anforderung zu filtern:
-
$llm_response_start_date: Das Startdatum, das der LLM basierend auf der Anforderung des Benutzers auf einer Kommunikationsplattform wie Slack generiert. -
$llm_response_end_date: Das Enddatum, das der LLM basierend auf der Anforderung des Benutzers auf einer Kommunikationsplattform wie Slack generiert.
-
ITSM-Plattformen
Wenn Ihr Unternehmen eine IT-Service-Management-(ITSM-)Plattform neben Jira verwendet, nutzen Sie die Anleitung in diesem Abschnitt, um Ihr Projekt zu ändern.
IT-Onboarding-Tickets erstellen
Führen Sie die folgenden Schritte aus, um diese Vorgänge für eine andere ITSM-Plattform zu konfigurieren:
-
Aktualisieren Sie den Vorgang
ITSM - Create Task in JIRA, um den API-Endpunkt Ihrer ITSM-Plattform zu verwenden. -
(Optional.) Erwägen Sie, diese häufig verwendeten Variablen im Vorgang zu nutzen, um Konsistenz zu gewährleisten:
-
$it_laptopChoice_list: Die Laptop-Auswahl des neuen Mitarbeiters. $it_application_list: Die Liste der bereitzustellenden Anwendungen.$it_gSuite_list: Die Liste der bereitzustellenden Google Workspace-Dienste.$newHire_department: Die Abteilung des neuen Mitarbeiters.-
$newHire_region: Die Region des neuen Mitarbeiters. -
Stellen Sie sicher, dass Ihr Vorgang die Variable
$newHire_itTicketmit der IT-Ticket-URL aus der API-Antwort füllt.
In Bearbeitung befindliche IT-Tickets abrufen
Der Vorgang Search ITSM Issue ruft In-Bearbeitung-IT-Onboarding-Tickets ab. Dieser Vorgang wird als Teil des Workflows First Week | In-progress IT Tickets ausgeführt.
So konfigurieren Sie diesen Vorgang für eine andere ITSM-Plattform:
- Aktualisieren Sie den Vorgang
Search ITSM Issue, um den API-Endpunkt Ihrer ITSM-Plattform zum Abrufen von In-Bearbeitung-IT-Onboarding-Tickets zu verwenden. - Öffnen Sie die Transformation GET IT Newhire In-progress tickets - to Common Model IT Ticket Schema, um das Quellschema zu aktualisieren und die Feldzuordnungen abzuschließen.
Wissensmanagement-Plattformen
Wenn Ihr Unternehmen eine andere Wissensmanagement-Plattform als Confluence verwendet, nutzen Sie die Anleitung in diesem Abschnitt, um Ihr Projekt zu ändern.
IT-Onboarding-Inhalte abrufen
Der Vorgang AskHr - Get IT Onboarding Content ruft Inhalte von Ihrer IT-Onboarding-Dokumentationsseite ab. Der KI-Agent nutzt diese Inhalte, um IT-bezogene Fragen im Slack-Bot zu beantworten. Dieser Vorgang verwendet die Projektvariable confluence.base.url.
So konfigurieren Sie diesen Vorgang für eine andere Wissensmanagement-Plattform:
-
(Optional) Fügen Sie im Abschnitt Projektvariablen eine Variable für die Basis-URL Ihrer Plattform hinzu.
-
Aktualisieren Sie den Vorgang
AskHr - Get IT Onboarding Content, um den API-Endpunkt Ihrer Plattform zu verwenden. -
Aktualisieren Sie die Transformation des Vorgangs, um dem Antwortschema Ihrer Plattform zu entsprechen.
-
Stellen Sie sicher, dass Ihr Vorgang die Variable
$it_onboarding_contentmit dem abgerufenen Inhalt füllt. Der KI-Agent nutzt diese Variable in einer LLM-Eingabeaufforderung, um Benutzerfragen im Slack-Bot zu beantworten.
CSV-Vorlagen
CSV-Vorlagen sind eine Kernkomponente dieses Projekts. Die Vorlagen ermöglichen Workflows, die Dateien analysieren und benutzerdefinierte E-Mails und IT-Tickets generieren. Sie können die Daten in diesen Vorlagen für Ihr Unternehmen anpassen. Wenn Sie jedoch die Vorlagenstruktur ändern, müssen Sie die zugehörigen Eingabeaufforderungen aktualisieren.
Die folgenden Vorgänge enthalten Eingabeaufforderungen, die für bestimmte CSV-Vorlagendateien ausgelegt sind:
| Vorgang | CSV-Vorlagendatei | Zweck |
|---|---|---|
Prompt - Courses List |
TEMPLATE - HR Agent Onboarding Courses - Job Role.csv |
Generiert Kursempfehlungen basierend auf der Abteilung |
Prompt - Application List |
TEMPLATE - IT_Apps_JobRole.csv |
Bestimmt Anwendungen zum Bereitstellen basierend auf Abteilung |
Prompt - GSuite List |
TEMPLATE - IT_G-Suite Groups.csv |
Weist Google Workspace-Gruppen zu |
Prompt - Laptop Choice List |
TEMPLATE - IT_LaptopChoice_JobRole.csv |
Bietet Laptop-Optionen basierend auf der Abteilung |
Wenn Sie die Struktur einer CSV-Vorlagendatei ändern, aktualisieren Sie die entsprechende Eingabeaufforderung des Vorgangs, um der neuen Struktur zu entsprechen.
Formulareinreichungsplattformen
Wenn Ihr Unternehmen eine andere Formulareinreichungsplattform als Google Forms verwendet, nutzen Sie die Anleitung in diesem Abschnitt, um Ihr Projekt zu ändern.
Der KI-Agent verwendet ein Formular, um Informationen zum Starten des Workflows ITS Calls zu erfassen.
So konfigurieren Sie den KI-Agent für die Verwendung einer anderen Formularplattform:
-
Konfigurieren Sie Ihr Formular, um Benutzerdaten an den benutzerdefinierten Jitterbit-API zu senden.
-
Öffnen Sie die Transformation Form Response to Common Employee Schema, um das Quellschema zu aktualisieren und die Feldzuordnungen abzuschließen.
Datenspeicherplattformen
Wenn Ihr Unternehmen eine andere Datenspeicherplattform als Cloud Datastore verwendet, nutzen Sie die Anleitung in diesem Abschnitt, um Ihr Projekt anzupassen.
Der KI-Agent verwendet Cloud Datastore, um entworfene Willkommens-E-Mails und E-Mail-Adressen von Kandidaten zu speichern. Der Datenspeicher ermöglicht das Einfügen, Abfragen und Löschen von Datensätzen. Sie benötigen die gespeicherte E-Mail-Adresse des Kandidaten, um die Willkommens-E-Mail nach der Genehmigung durch den Manager zu versenden.
Wichtig
Ändern Sie keine globalen Variablennamen. Verwenden Sie die Variablennamen wie definiert.
Um den KI-Agent für die Verwendung einer anderen Datenspeicherplattform zu konfigurieren, aktualisieren Sie folgende Operationen:
Willkommens-E-Mail-Daten speichern
Die Operation Datastore | Insert Welcome Email fügt folgende Daten in den Datenspeicher ein:
| Datenfeld | Variable oder Wert |
|---|---|
| Entworfener E-Mail-Text | $llm_response_email_body |
| Vollständiger Name des Kandidaten (ohne Leerzeichen) | fullname = $offerSigned_name + $offerSigned_surName;fullname_cleaned = Replace(fullname, " ", "");fullname_cleaned |
| E-Mail-Adresse des Kandidaten | $offerSigned_email |
| Datensatzschlüssel | fullname = $offerSigned_name + $offerSigned_surName;fullname_cleaned = Replace(fullname, " ", "");"WE-" + fullname_cleaned |
Willkommens-E-Mail-Daten löschen
Die Operation Datastore | Delete Welcome Email entfernt Datensätze, nachdem die E-Mail an den Kandidaten versendet oder der entworfene Text vom Manager abgelehnt wurde.
Konfigurieren Sie die Operation, um die interne Datensatz-ID aus der Variable $dataStore_item_id zu akzeptieren. Die Operation enthält Logging-Anweisungen zur Verfolgung des Löschvorgangs:
WriteToOperationLog("------------------------------");
WriteToOperationLog("Deleting Key: WE-" + $dataStore_Key + " With itemID: " + $dataStore_item_id);
WriteToOperationLog("------------------------------");
$dataStore_item_id
Die Abfrageoperation ruft den Wert $dataStore_item_id ab, der den zu löschenden Datensatz identifiziert.
Kommunikationsplattformen
Wenn Ihr Unternehmen eine andere Kommunikationsplattform als Slack verwendet, nutzen Sie die Anleitung in diesem Abschnitt, um Ihr Projekt anzupassen.
Der KI-Agent nutzt Slack für IT-, HR- und Manager-Benachrichtigungen sowie alle Benutzerinteraktionen.
Inbound-Event-Handler konfigurieren
Konfigurieren Sie Ihre Kommunikationsplattform so, dass Benutzeranfrage-Events an die benutzerdefinierte Jitterbit-API gesendet werden. Die Operation PlatformBot | Inbound Event empfängt diese Events und triggert die Operationskette, die Benutzernachrichten verarbeitet.
Projektvariablen aktualisieren
Aktualisieren Sie folgende Projektvariablen, um sie an Ihre Kommunikationsplattform anzupassen:
| Variablenname | Beschreibung |
|---|---|
slack.itChannel.ID |
IT-Benachrichtigungskanal-ID |
slack.hrChannel.ID |
HR-Benachrichtigungskanal-ID |
slack.bot.id |
Bot-Benutzer-ID (verhindert, dass der Bot auf seine eigenen Nachrichten antwortet) |
slack.bot.user.token |
Bot-Benutzer-OAuth-Zugriffstoken |
Tipp
Sie können diese Variablen umbenennen, um sie an Ihre Plattform anzupassen (ändern Sie beispielsweise slack.itChannel.ID in teams.itChannel.ID). Wenn Sie eine Variable umbenennen, werden alle Verweise auf diese Variable automatisch in Ihrem gesamten Projekt aktualisiert, einschließlich Scripts und Transformationen.
Plattformnachrichten validieren
Die Operation Validate Platform Message überprüft, dass eingehende Nachrichten von einem Endbenutzer und nicht vom Bot selbst stammen, und extrahiert Variablen für die anschließende Verwendung.
Konfigurieren Sie den Vorgang so, dass er die folgenden Variablen ausfüllt:
| Variable | Beschreibung | Wert |
|---|---|---|
$platform_bot_id_pass |
Validierung der Nachrichtenquelle | Setzen Sie auf "true", wenn die Nachricht von einem echten Benutzer stammt |
$platform_userID |
Benutzer-ID | Benutzer-ID des Nachrichtensenders |
$platform_ts |
Nachrichtenzeit | Zeitstempel der Nachricht |
$platform_thread_ts |
Zeitstempel der Thread-Antwort | Zeitstempel der Antwortnachricht, wenn sie in einem Thread gesendet wird |
$platform_channel |
Kanal-ID | Kanal-ID, in dem die Nachricht gesendet wurde |
Aktualisieren Sie die Quell- und Zielschemas der Transformation entsprechend der API Ihrer Kommunikationsplattform.
Benachrichtigungsmeldungen senden
Der Vorgang Post Notification Message to Channel sendet Nachrichten oder Antworten an Plattformkanäle.
Konfigurieren Sie den Vorgang für die Verwendung der folgenden Variablen:
| Variable | Beschreibung |
|---|---|
$platform_channel |
Kanal-ID, in den die Nachricht gesendet wird |
$platform_thread_ts |
Thread-Zeitstempel der ursprünglichen Nachricht |
$platform_notification_text |
Inhalt der zu sendenden Nachricht |
Wenn $platform_thread_ts einen Wert enthält (größer als 0), sendet der Vorgang die Antwort an diesen Thread. Andernfalls sendet der Vorgang eine neue Nachricht an den Kanal. Konfigurieren Sie diese Logik in der Transformationszuordnung:
if($platform_thread_ts > 0, $platform_thread_ts)
Aktualisieren Sie die Quell- und Zielschemas der Transformation entsprechend der API Ihrer Kommunikationsplattform.
Konversationsverlauf abrufen
Der Vorgang Conversation History ruft die letzten fünf Nachrichten aus dem Konversationsverlauf ab und ordnet die Nachrichten dem gemeinsamen Zielschema common_conversation_history_schema.json zu.
Das Zielschema enthält einen Knoten thread_latest_reply, der die neueste Antwort in einem Thread darstellt. Dieser Knoten wird mit Variablen aus dem Vorgang Validate Platform Message ausgefüllt.
Aktualisieren Sie das Quellschema der Transformation entsprechend der API Ihrer Kommunikationsplattform.
Tipp-Anzeige senden
Der Vorgang Post Typing to Channel sendet eine Tipp-Anzeige an den Kanal.
Konfigurieren Sie den Vorgang für die Verwendung der folgenden Variablen:
| Variable | Beschreibung |
|---|---|
$platform_channel |
Kanal-ID, an den die Anzeige gesendet wird |
$platform_thread_ts |
Thread-Zeitstempel der ursprünglichen Nachricht |
| Nachrichtentext | Tipp-Anzeige-Format Ihrer Plattform |
$platform_typing_ts |
Zeitstempel der Tipp-Anzeige-Nachricht (für späteres Löschen verwendet) |
Wenn $platform_thread_ts einen Wert enthält, sendet der Vorgang die Tipp-Anzeige an diesen Thread. Andernfalls sendet er die Anzeige an den Kanal. Konfigurieren Sie diese Logik in der Transformationszuordnung:
if(Length($platform_thread_ts) > 0, $platform_thread_ts, unmap());
Aktualisieren Sie die Quell- und Zielschemas der Transformation entsprechend der API Ihrer Kommunikationsplattform.
Tipp-Indikator löschen
Die Operation Delete Message entfernt den Tipp-Indikator aus dem Channel, nachdem der Bot seine Antwort gesendet hat.
Konfigurieren Sie Ihre Operation so, dass folgende Variablen verwendet werden:
| Variable | Beschreibung |
|---|---|
$platform_channel |
Channel-ID, in der der Tipp-Indikator gesendet wurde |
$platform_typing_ts |
Zeitstempel der zu löschenden Tipp-Indikator-Nachricht |
Aktualisieren Sie die Quell- und Zielschemas der Transformation, um die API Ihrer Kommunikationsplattform widerzuspiegeln.
E-Mail-Adresse eines Benutzers nach Benutzer-ID abrufen
Die Operation Get User Email by UserId ruft die E-Mail-Adresse eines Benutzers mithilfe seiner Benutzer-ID ab.
Konfigurieren Sie Ihre Operation so, dass folgende Variablen verwendet werden:
| Variable | Beschreibung |
|---|---|
$platform_userID |
Benutzer-ID zum Suchen |
$slack.bot.user.token |
Authentifizierungstoken |
Aktualisieren Sie die Quell- und Zielschemas der Transformation, um die API Ihrer Kommunikationsplattform widerzuspiegeln.
Benutzerinformationen nach Name abrufen
Die Operation Get UserID & Email by Name and Surname ruft die E-Mail-Adresse und Benutzer-ID eines Benutzers mithilfe des vollständigen Namens ab.
Konfigurieren Sie Ihre Operation so, dass folgende Variablen verwendet werden:
-
Request-Schema
Variable Beschreibung $slack.bot.user.tokenAuthentifizierungstoken -
Response-Schema
Die Operation füllt folgende Variablen:
Variable Beschreibung $platform_emailE-Mail-Adresse des Benutzers $platform_userIDBenutzer-ID
Die Operation vergleicht den vollständigen Namen des Benutzers von Ihrer Plattform mit entweder $llm_response_manager_full_name oder $newHire_fullName, um den richtigen Benutzer zu finden. Aktualisieren Sie diese Logik, um die Benutzerdatenstruktur Ihrer Plattform widerzuspiegeln:
pass = false;
real_name = json$get_response$item.members$item.profile$real_name$;
if($llm_response_manager_full_name == real_name || $newHire_fullName == real_name,
pass = true;
WriteToOperationLog("We found a matching slack user for: " + $llm_response_manager_full_name + " " + $newHire_fullName);
);
//pass = true;
Pass
Aktualisieren Sie die Quell- und Zielschemas der Transformation, um die API Ihrer Kommunikationsplattform widerzuspiegeln.