Jitterbit HR Agent
Übersicht
Der Jitterbit HR Agent (HR Agent) ist ein KI-Agent, der über den Jitterbit Marketplace bereitgestellt wird und darauf ausgelegt ist, das interne HR-Team Ihrer Organisation zu unterstützen. Dieser Agent verwendet die Technik der Retrieval-Augmented Generation (RAG), die das Denken von LLM mit dem Zugriff auf externe Tools und Datenquellen kombiniert. Der KI-Agent führt die folgenden Funktionen aus:
-
Stellt eine Verbindung zu BambooHR oder anderen Human Resources Information Systems (HRIS) her, um Echtzeit-Onboarding-Daten für neue Mitarbeiter über Jitterbit Studio abzurufen.
-
Stellt eine Verbindung zu Jira (oder anderen Service- und Arbeitsmanagementlösungen) her, um Anfragen zu initiieren und zu verfolgen.
-
Integriert sich mit dem OpenAI Large Language Model (LLM), um einen intelligenten HR KI-Assistenten zu betreiben, auf den Sie über eine benutzerdefinierte API zugreifen, die mit Jitterbit API Manager erstellt wurde.
Dieses Dokument erklärt, wie man den KI-Agenten einrichtet und betreibt. Zunächst werden die Architektur und die Voraussetzungen behandelt, gefolgt von Beispielaufforderungen, um zu zeigen, was der Agent leisten kann, und schließlich werden Schritte zur Installation, Konfiguration und Betrieb des Agenten bereitgestellt.
Architektur des KI-Agenten
Die folgenden Diagramme zeigen die Architektur, die im HR Agent implementiert ist.
Pre-Boarding (Vor dem ersten Tag)
Onboarding am ersten Tag
Erste Wochen und Schulung
Allgemeine Nutzung
Voraussetzungen
Um den HR Agenten zu nutzen, benötigen Sie die folgenden Komponenten.
Harmony-Komponenten
Sie müssen über eine Jitterbit Harmony-Lizenz mit Zugriff auf die folgenden Komponenten verfügen:
- Jitterbit Studio
- Jitterbit API Manager
- Jitterbit HR Agent, der als Lizenz-Add-On erworben wurde
- Jitterbit Cloud Datastore (optional)
OpenAI
Sie müssen über ein OpenAI-Abonnement verfügen, um die folgenden Ressourcen zu erstellen und zu verwalten:
- OpenAI API-Schlüssel. Weitere Informationen finden Sie in der OpenAI-Anleitung.
Unterstützte Endpunkte
Das Design des KI-Agenten umfasst die folgenden Endpunkte. Sie können andere Systeme integrieren, indem Sie die Endpunktkonfigurationen und Workflows des Projekts anpassen.
Human Resources Information System (HRIS)
Der KI-Agent verwendet BambooHR als Quelle für Mitarbeiterdaten, einschließlich erforderlicher Aufgaben, Dokumente und Stelleninformationen.
Hinweis
Sie müssen über die entsprechenden Berechtigungen in Ihrem HRIS verfügen, um API-Schlüssel zu erstellen und auf die für diese Integration erforderlichen Daten zuzugreifen.
Service-Management
Der KI-Agent verwendet Jira als System für Service- und Arbeitsmanagement zur Erstellung von Tickets.
Dokumentation
Der KI-Agent verwendet Confluence als Quelle für IT-Dokumentation.
Chat-Schnittstelle
Das Design des KI-Agenten umfasst Slack als Chat-Schnittstelle zur Interaktion mit dem KI-Agenten.
Wenn Sie eine andere Anwendung als Chat-Schnittstelle verwenden möchten, enthält dieser KI-Agent einen separaten Workflow und Anweisungen für eine generische API-Einrichtung.
Kernfunktionen
Wenn Sie den HR-Agenten mit den entsprechenden Endpunkten verbinden, bietet er die folgenden Kernfunktionen.
Mitarbeiter-Vorbereitung
- Benachrichtigt das Einstellungsteam über ein akzeptiertes Angebot.
- Erstellt eine Willkommens-Email und fordert die Genehmigung an, um sie an den neuen Mitarbeiter zu senden.
- Benachrichtigt den neuen Mitarbeiter über erforderliche Aufgaben und zugewiesene Unterlagen basierend auf dem lokalen Recht und den Vorschriften des Wohnsitzlandes des Kandidaten.
- Erstellt ein Ticket für die IT-Einarbeitung, das die erforderliche Ausrüstung, Anwendungen und Email-Gruppen angibt.
Einarbeitung am ersten Tag
- Bietet eine Einführung beim Manager, im Team und bei anderen nützlichen Kontakten in der Organisation.
- Verfolgt ausstehende Aufgaben für den neuen Mitarbeiter, HR- und IT-Teams und bietet Updates, wenn Aufgaben abgeschlossen sind.
- Bietet Unterstützung an, wenn Einarbeitungsschritte nach einem bestimmten Zeitraum unvollständig bleiben.
- Stellt eine dedizierte Chat-Schnittstelle für neue Mitarbeiter zur Verfügung, um Fragen zur Einarbeitung zu stellen und Unterstützung anzufordern. Der KI-Agent kann im Namen des Benutzers IT-Service-Tickets einreichen.
Erste Wochen und Schulung
- Bietet einen personalisierten Lernpfad basierend auf der Berufsrolle.
Beispielaufforderungen
Die folgenden sind Beispielaufforderungen, die der HR-Agent mit Zugriff auf die entsprechenden Daten bearbeiten kann.
HR-bezogene Fragen
- "Wer ist mein Vorgesetzter?"
- "Wer ist nächste Woche nicht da?"
- "Wer war letzte Woche nicht da?"
- "Wer ist morgen nicht da?"
- "Ist [Name einfügen] heute nicht da?"
IT-Service-bezogene Fragen
- "Wie setze ich mein Passwort zurück?"
- "Ich benötige Hilfe bei der Einrichtung meines Computers."
- "Können Sie mir helfen, mein Email-Konto einzurichten?"
- "Meine Maus ist kaputt. Was soll ich tun?"
- "Mein Laptop lädt nicht. Was soll ich tun?"
- "Ich brauche eine neue Maus. Können Sie ein Ticket für mich erstellen?"
Installation, Konfiguration und Betrieb
Befolgen Sie diese Schritte, um diesen KI-Agenten zu installieren, zu konfigurieren und zu betreiben:
- Laden Sie Anpassungen herunter und installieren Sie das Studio-Projekt.
- Überprüfen Sie die Projekt-Workflows.
- Bereiten Sie BambooHR vor.
- Erstellen Sie ein Google-Formular.
- Bereiten Sie den Jitterbit Cloud Datastore vor.
- Konfigurieren Sie die Projektvariablen.
- Testen Sie die Verbindungen.
- Fügen Sie Email-Vorlagen hinzu.
- Erstellen Sie Zeitpläne.
- Stellen Sie das Projekt bereit.
- Erstellen Sie die Jitterbit benutzerdefinierte API.
- Erstellen Sie die Slack-App, testen Sie die Slack-Verbindung und stellen Sie das Projekt erneut bereit.
- Lösen Sie die Projekt-Workflows aus.
- Fehlerbehebung.
- Verschiedene Endpunktnutzungen.
Anpassungen herunterladen und das Projekt installieren
Befolgen Sie diese Schritte, um Anpassungsdateien herunterzuladen und das Studio-Projekt für den KI-Agenten zu installieren:
-
Melden Sie sich im Harmony-Portal unter https://login.jitterbit.com an und öffnen Sie den Marktplatz.
-
Suchen Sie den KI-Agenten mit dem Namen Jitterbit HR Agent. Um den Agenten zu finden, können Sie die Suchleiste verwenden oder im Filter-Bereich unter Typ KI-Agent auswählen, um die Anzeige auf die verfügbaren KI-Agenten zu filtern.
-
Klicken Sie auf den Dokumentations-Link des KI-Agenten, um dessen Dokumentation in einem separaten Tab zu öffnen. Halten Sie den Tab geöffnet, damit Sie auf die Dokumentation zugreifen können, nachdem Sie das Projekt gestartet haben.
-
Klicken Sie auf Projekt starten, um einen zweistufigen Konfigurationsdialog zu öffnen. Der Dialog ermöglicht es Ihnen, Anpassungen herunterzuladen und den KI-Agenten als Studio-Projekt zu importieren.
Hinweis
Wenn Sie den KI-Agenten noch nicht gekauft haben, wird stattdessen Diesen Agenten erhalten angezeigt. Klicken Sie auf Diesen Agenten erhalten, um einen Informationsdialog zu öffnen, und klicken Sie dann auf Absenden, um zu beantragen, dass ein Vertreter Sie bezüglich des Kaufs des KI-Agenten kontaktiert.
-
Im Konfigurationsschritt 1, Anpassungen herunterladen, werden die folgenden Dateien bereitgestellt, um die Struktur von CSV-Dateien einzuführen, die Slack-App zu erstellen und das Google Form-App-Skript zu erstellen. Wählen Sie die Dateien aus und klicken Sie auf Dateien herunterladen:
-
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 besagt, dass die Vorlage nicht importiert werden soll, bevor die Endpunktanpassungen angewendet werden. Diese Warnung gilt nicht für diesen KI-Agenten und kann ignoriert werden. Befolgen Sie die empfohlene Reihenfolge der Schritte in dieser Dokumentation.
-
-
Klicken Sie auf Weiter.
-
Im Konfigurationsschritt 2, Neues Projekt erstellen, wählen Sie eine Umgebung, in der das Studio-Projekt erstellt wird, und klicken Sie dann auf Projekt erstellen.
-
Ein Fortschrittsdialog wird angezeigt. Sobald er anzeigt, dass das Projekt erstellt wurde, verwenden Sie den Dialoglink Gehe zu Studio oder öffnen Sie das Projekt direkt von der Studio Projekte Seite.
Überprüfung der Projekt-Workflows
Überprüfen Sie im offenen Studio-Projekt die Workflows sowie die nachstehenden Beschreibungen, um zu verstehen, was sie tun. Verwenden Sie die Zusammenfassungstabelle unten, um zu identifizieren, welche Workflows konfiguriert werden müssen und wie sie ausgelöst werden.
Hinweis
Im Projekt zeigen Workflow-Namen, die mit einem Sternchen (*) beginnen, Haupt-Workflows an, die Ketten von Aktionen initiieren. Diese Haupt-Workflows sind typischerweise geplant oder API-getriggert und rufen bei Bedarf die Kerninfrastruktur-Workflows auf. Workflows ohne Sternchen sind unterstützende Workflows.
| Workflow-Name | Kategorie | Auslösetyp | Wichtige Abhängigkeiten |
|---|---|---|---|
| Gemeinsame Operationen | Kerninfrastruktur | Manuell | Keine |
| HR-Anrufe | Kerninfrastruktur | Wird von anderen Workflows aufgerufen | BambooHR |
| Plattform-Anrufe | Kerninfrastruktur | Wird von anderen Workflows aufgerufen | Slack oder Alternative |
| ITS-Anrufe | Kerninfrastruktur | Wird von anderen Workflows aufgerufen | Jira oder Alternative |
| Emails | Kerninfrastruktur | Wird von anderen Workflows aufgerufen | SMTP-Konfiguration |
| Datenspeicher-Anruf | Kerninfrastruktur | Wird von anderen Workflows aufgerufen | Cloud Datastore |
| Kommunikationsplattform-Bot | Kerninfrastruktur | API | Plattform-Anrufe, Benutzerdefinierte API |
| OpenAI - Funktionsaufruf | OpenAI/LLM | Wird von geplanten Workflows aufgerufen | OpenAI API |
| OpenAI - Code-Interpreter | OpenAI/LLM | Wird von anderen Workflows aufgerufen | OpenAI API |
| OpenAI - PDF-Analyse | OpenAI/LLM | Wird von anderen Workflows aufgerufen | OpenAI API |
| OpenAI - AskHR-Router | OpenAI/LLM | Wird von Chatbot-Workflows aufgerufen | OpenAI API |
| OpenAI - AskHR Funktionsaufruf | OpenAI/LLM | Wird von Chatbot aufgerufen | OpenAI API, AskHR-Router |
| AskHR - Nach dem Tool - Start | OpenAI/LLM | Wird von AskHR Funktionsaufruf aufgerufen | Variiert je nach Tool |
| Pre-Onboarding - Angebot Unterzeichnet | Pre-boarding | Geplant | HR-Anrufe, OpenAI Funktionsaufruf |
| Pre-Onboarding - Woche vor Dokumenten | Pre-boarding | Geplant | HR-Anrufe, Emails |
| Pre-Onboarding - ITSM-Anfrage | Pre-boarding | API | HR-Anrufe, ITS-Anrufe, Benutzerdefinierte API |
| Erster Tag - Einführungen | Erster Tag | Geplant | HR-Anrufe, Emails |
| Erster Tag - LI-Beitrag schreiben | Erster Tag | Geplant | HR-Anrufe, OpenAI |
| Erste Woche - Personalisierter Lernpfad | Erste Woche | Geplant | HR-Anrufe, OpenAI Code-Interpreter |
| Allgemein - Verbleibende HR-Aufgaben für Mitarbeiter | Laufend | Geplant | HR-Anrufe |
| Erste Woche - In Bearbeitung befindliche IT-Tickets | Laufend | Geplant | HR-Anrufe, ITS-Anrufe |
Workflow-Kategorien und Beschreibungen
Kerninfrastruktur-Workflows
Diese Workflows bieten grundlegende Operationen, die im gesamten Projekt verwendet werden.
Gemeinsame Operationen
Dieser Workflow enthält gemeinsame Skripte für das Projekt. Sie müssen das Skript HTML-Email-Vorlagen aktualisieren, um es an die Email-Vorlagen Ihres Unternehmens anzupassen, während sichergestellt wird, dass alle vorhandenen Variablen innerhalb der Vorlagen unverändert bleiben oder gemäß Ihren Bedürfnissen geändert werden.
HR-Anrufe
Dieser Workflow zentralisiert die grundlegenden HR-Operationen für das Projekt. Diese grundlegenden HR-Operationen werden in den nachfolgenden einzelnen Workflows verwendet, wobei alle Antworten standardisiert und auf gemeinsame Schemata abgebildet sind.
Plattform-Anrufe
Dieser Workflow konsolidiert die grundlegenden Operationen für die gewählte Kommunikationsplattform (zum Beispiel Slack). Diese standardisierten Plattformoperationen werden von nachfolgenden Workflows verwendet. Eine wichtige Funktion besteht darin, wesentliche Werte in Variablen zu erfassen oder die Antworten von Operationen in nachgelagerte Workflows zu verschieben, um sie in gemeinsame Schemata zu standardisieren und eine konsistente Nutzung zu gewährleisten.
ITS-Anrufe
Dieser Workflow konsolidiert die grundlegenden Operationen für die gewählte IT-Service-Plattform (zum Beispiel Jira). Diese standardisierten IT-Service-Operationen werden von nachfolgenden Workflows verwendet. Eine wichtige Funktion besteht darin, wesentliche Werte in Variablen zu erfassen oder die Antworten von Operationen in nachgelagerte Workflows zu verschieben, um sie in gemeinsame Schemata zu standardisieren und eine konsistente Nutzung zu gewährleisten.
Hinweis
Bei der Verwendung von Jira verwendet der KI-Agent zwei Operationen zur Erstellung von Tickets: ITSM - Create Task in JIRA und Update Task in JIRA. Aufgrund von Einschränkungen der Jira-API müssen beide Operationen zusammen als ein einzelner Ticket-Erstellungsprozess funktionieren.
Emails
Dieser Workflow verwaltet die erforderlichen Email-Kommunikationen des Projekts und wird häufig während des Projektlebenszyklus verwendet.
Datenspeicher-Anruf
Dieser Workflow verwaltet personalisierte Willkommens-Emails, indem er die folgenden Aktionen ausführt:
- Speichert sie in einer Datenbank mit eindeutigen Schlüsseln.
- Ruft sie bei Bedarf über eine Abfrage für das Projekt ab.
- Löscht den Datensatz, sobald er nicht mehr benötigt wird.
Kommunikationsplattform-Bot
Hinweis
Wenn Sie Slack nicht verwenden, können Sie diesen Workflow ignorieren, und er wird nicht ausgelöst.
Dieser Workflow verwaltet eingehende Slack-Bot-Anfragen. Er wird über eine benutzerdefinierte Jitterbit-API ausgelöst, jedes Mal, wenn ein Benutzer mit der Slack-Bot-Chatoberfläche interagiert. Die Konfiguration der benutzerdefinierten Jitterbit-API wird in Erstellen der benutzerdefinierten Jitterbit-API weiter unten auf dieser Seite beschrieben.
OpenAI/LLM-Workflows
Diese Workflows integrieren sich mit dem OpenAI LLM, um intelligente Automatisierung und Chatbot-Funktionalität bereitzustellen.
OpenAI - Funktionsaufruf
Dieser Workflow dient als zentraler Funktionsaufrufmechanismus für das LLM und verarbeitet Anfragen, die von geplanten Workflows (wie Pre Onboarding | Angebot unterzeichnet) initiiert werden. Seine Hauptaufgabe besteht darin, zu bestimmen, welches Tool basierend auf den vom Benutzer an das LLM übermittelten Eingabeaufforderungen ausgeführt werden soll. Er ist so konzipiert, dass er durch Aktionen ausgelöst wird, die außerhalb der Kommunikationsplattform oder des Chatbots stattfinden.
OpenAI - Code-Interpreter
Dieser Workflow führt auf Abruf Analysen von CSV-Dokumenten durch, um spezifische Übereinstimmungsergebnisse für verschiedene Anwendungsfälle zu identifizieren. Zum Beispiel bestimmt er, welche Anwendungen basierend auf der Stellenbezeichnung des neuen Mitarbeiters Zugriff gewährt werden sollten.
OpenAI - PDF-Analyse
Dieser Workflow analysiert PDF-Lebensläufe, um deren Inhalt zusammenzufassen, sodass das LLM personalisierte Willkommens-Emails generieren kann.
OpenAI - AskHR-Router
Dieser Workflow dient als Zwischenverbindungspunkt innerhalb der gesamten Nutzung des AskHR-Chatbots und verwaltet die Umformulierung von Dialogen, die Zusammenfassung von Inhalten und die Erstellung von Antworten.
OpenAI - AskHR Funktionsaufruf
Dieser Workflow dient als zentraler Funktionsaufrufmechanismus für das LLM und verarbeitet Anfragen, die von Benutzern über den AskHR-Chatbot initiiert werden. Seine Hauptaufgabe besteht darin, zu bestimmen, welches Tool basierend auf den Nachrichten des Benutzers ausgeführt werden soll. Er ist so konzipiert, dass er durch Aktionen ausgelöst wird, die von der Kommunikationsplattform oder dem Chatbot stammen.
AskHR - Nach dem Tool
Dieses Workflow-Muster initiiert eine Folge von Aktionen, nachdem der AskHR-Funktionsaufruf ein Tool ausgewählt hat. Es gibt mehrere Instanzen dieses Workflows mit unterschiedlichen Toolnamen (zum Beispiel AskHR | Nach dem Tool | Start - null_tool). Die null_tool-Variante bedeutet, dass das LLM festgestellt hat, dass die Anfrage des Benutzers an den Chatbot für keines der derzeit verfügbaren Tools geeignet war.
Pre-Boarding-Workflows
Diese Workflows automatisieren Aufgaben vor dem ersten Arbeitstag des neuen Mitarbeiters.
Pre Onboarding - Angebot Unterzeichnet
Dieser Workflow überprüft regelmäßig, ob Kandidaten ein Angebot unterzeichnet haben, und führt die folgenden Aktionen aus:
- Identifiziert Kandidaten, die Angebote angenommen haben.
- Sendet Alarmnachrichten an interne Teams.
- Entwirft eine Willkommens-Email mit einem Onboarding-Formular für den Kandidaten.
- Sendet die Willkommens-Email an den zukünftigen Manager des Kandidaten zusammen mit einer Slack-Nachricht zur endgültigen Genehmigung.
Für Details zur Einrichtung des Zeitplans siehe den Abschnitt Zeitpläne erstellen.
Pre Onboarding - Woche Vor Dokumente
Dieser Workflow läuft nach einem Zeitplan, um Mitarbeiter zu identifizieren, deren Einstellungsdatum (erster Arbeitstag) für die folgende Woche geplant ist. Nach der Identifizierung führt er automatisch die folgenden Aktionen aus:
- Benachrichtigt den zuständigen Manager, die IT- und HR-Teams.
- Sendet eine Email mit wichtigen Onboarding-Dokumenten, wie Informationen zur Unternehmenskultur und zu Mitarbeiterleistungen.
Pre Onboarding - ITSM-Anfrage
Dieser Workflow wird von einer benutzerdefinierten Jitterbit-API initiiert, wann immer 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 die HR- und IT-Teams per Email und über eine Kommunikationsplattform (zum Beispiel Slack).
Die Konfiguration der benutzerdefinierten Jitterbit-API wird im Abschnitt Erstellen der benutzerdefinierten Jitterbit-API weiter unten auf dieser Seite beschrieben.
Erste Tag Arbeitsabläufe
Diese Arbeitsabläufe laufen nach einem Zeitplan, um automatisch Mitarbeiter zu identifizieren, deren Einstellungsdatum (erster Arbeitstag) heute ist, und führen dann spezifische Aktionen aus, wie unten beschrieben.
Erster Tag - Einführungen
Dieser Arbeitsablauf führt die folgenden Aktionen aus:
- Sendet Benachrichtigungsnachrichten an den Vorgesetzten des neuen Mitarbeiters.
- Entwirft eine Einführungs-Email mit wichtigen Informationen zum ersten Tag und Unternehmenslinks.
Erster Tag - LinkedIn-Beitrag schreiben
Dieser Arbeitsablauf sendet eine Email mit einem LinkedIn-Beitrag, der auf dem Profil des neuen Mitarbeiters geteilt werden kann.
Erste Woche Arbeitsabläufe
Dieser Arbeitsablauf unterstützt neue Mitarbeiter während ihrer ersten Woche.
Erste Woche - Personalisierter Lernpfad
Dieser Arbeitsablauf läuft nach einem Zeitplan, 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 Email mit Anweisungen zu erforderlichen Schulungen.
Laufende Betriebsabläufe
Diese Arbeitsabläufe verwalten kontinuierliche HR- und IT-Operationen während des gesamten Mitarbeiterlebenszyklus.
Allgemein - Verbleibende HR-Aufgaben des Mitarbeiters
Dieser Arbeitsablauf läuft nach einem Zeitplan, um Erinnerungen für ausstehende HR-Aufgaben zu automatisieren. Er führt die folgenden Aktionen aus:
- Überprüft Mitarbeiter mit unvollständigen Aufgaben innerhalb eines 90-Tage-Fensters.
- Generiert separate Emails sowohl für den Mitarbeiter als auch für das HR-Team, in denen die spezifischen Aufgaben aufgeführt sind, für die jede Partei verantwortlich ist.
Erste Woche - Ausstehende IT-Tickets
Dieser Arbeitsablauf läuft nach einem Zeitplan, um proaktiv ausstehende IT-Service-Onboarding-Aufgaben für neue Mitarbeiter zu verwalten. Er führt die folgenden Aktionen aus:
- Durchsucht nach Mitarbeitern, die sich in ihrer ersten Woche befinden und noch unvollständige IT-Service-Tickets haben.
- Benachrichtigt IT und HR mit separaten Warnungen, wenn das 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 notwendige IT-Unterstützung erhält.
BambooHR vorbereiten
Die folgenden wesentlichen Komponenten müssen in BambooHR für den HR-Agenten erstellt werden. Diese Komponenten sind notwendig, um die Informationen abzurufen, die für die Ausführung des Workflows erforderlich sind.
Ordner in BambooHR erstellen
Erstellen Sie die folgenden Ordner in BambooHR. Der HR-Agent verwendet diese Ordner, um relevante Ressourcen für die Funktionalität des Workflows zu finden.
-
Öffnen Sie im BambooHR-Dashboard den Abschnitt Dateien.
-
Klicken Sie auf + Ordner hinzufügen.
-
Geben Sie im Dialogfeld einen der folgenden Ordnernamen ein:
SchulungsdokumenteOnboarding-Dokumente (ALLE)IT-Dokumente
-
Klicken Sie auf Speichern oder Erstellen, um den Ordner zu erstellen.
-
Wiederholen Sie die Schritte 2-4 für jeden verbleibenden Ordner.
Dateien in Ordner hinzufügen
Für die HR-Agent-Workflows müssen bestimmte Dateien in den entsprechenden BambooHR-Ordnern abgelegt werden. Das HR-Agent-Paket stellt Beispiel-CSV-Dateien zur Verfügung. Es ist entscheidend, dass die Struktur aller Ersatzdateien identisch bleibt; jedoch können die Dateinamen geändert werden. Wenn ein Dateiname geändert wird, muss diese Änderung konsequent in allen anderen Teilen des Projekts angewendet werden, in denen der Dateiname referenziert wird, da diese Dateien für den Betrieb der Workflows unerlässlich sind.
Schulungsdokumente hochladen
Das HR-Agent-Paket enthält eine Beispiel-CSV-Datei mit dem Namen TEMPLATE - HR Agent Onboarding Courses - Job Role.csv. Diese Datei listet die obligatorischen Kurse auf, die jedem Jobrolle zugewiesen sind.
-
Öffnen Sie
TEMPLATE - HR Agent Onboarding Courses - Job Role.csvaus dem HR-Agent-Paket. -
Aktualisieren Sie die Datei mit den unternehmensspezifischen Kursinformationen. Behalten Sie die Spaltenstruktur und das Format bei.
-
Speichern Sie die aktualisierte Datei.
-
Melden Sie sich bei BambooHR an.
-
Wählen Sie im linken Menü Dateien aus.
-
Klicken Sie auf den Ordner Schulungsdokumente.
-
Klicken Sie auf Hochladen.
-
Wählen Sie Ihre aktualisierte CSV-Datei aus und klicken Sie auf Öffnen.
IT-Dokumente hochladen
Das HR-Agent-Paket enthält drei Beispiel-CSV-Dateien für den IT-Onboarding-Ticket-Erstellungsworkflow (Pre Onboarding | ITSM Request). Laden Sie nur die Dateien hoch, die für den IT-Onboarding-Prozess Ihres Unternehmens relevant sind:
TEMPLATE - IT_Apps_JobRole.csv: Listet die Anwendungen auf, auf die jede Berufsrolle zugreifen kann.TEMPLATE - IT_G-Suite Groups.csv: Listet die Google Workspace-Gruppen auf, auf die jede Berufsrolle zugreifen kann.TEMPLATE - IT_LaptopChoice_JobRole.csv: Listet den Laptoptyp auf, der jeder Berufsrolle zugewiesen ist.
Befolgen Sie diese Schritte, um die IT-Dokumente hochzuladen:
-
Öffnen Sie jede CSV-Datei, die Sie aus dem HR-Agenten-Paket benötigen.
-
Ersetzen Sie die Beispieldaten durch die Berufsrollen und IT-Ressourcen Ihres Unternehmens. Ändern Sie nicht die Spaltenüberschriften oder die Dateistruktur.
-
Speichern Sie jede aktualisierte Datei.
-
Gehen Sie in BambooHR zu Dateien.
-
Klicken Sie auf den Ordner IT-Dokumente, um ihn zu öffnen.
-
Klicken Sie auf Hochladen.
-
Wählen Sie eine oder mehrere Ihrer aktualisierten CSV-Dateien aus und klicken Sie auf Öffnen.
Onboarding-Dokumente hochladen
Laden Sie Dokumente wie Leitfäden zur Unternehmenskultur, Übersichten zu Mitarbeiterleistungen, Kalender für Unternehmensveranstaltungen, Unternehmensnachrichten und -aktualisierungen, Büropolitiken und -verfahren sowie Teamkontaktinformationen hoch.
Um Dateien in diesen Ordner hochzuladen:
-
Sammeln Sie die Onboarding-Dokumente, die Sie neuen Mitarbeitern senden möchten.
-
Gehen Sie in BambooHR im linken Menü zu Dateien.
-
Klicken Sie auf den Ordner Onboarding-Dokumente (ALLE), um ihn zu öffnen.
-
Klicken Sie auf Hochladen.
-
Wählen Sie eine oder mehrere Dateien von Ihrem Computer aus und klicken Sie auf Öffnen.
Erstellen Sie benutzerdefinierte Berichte in BambooHR
Sie müssen zwei benutzerdefinierte Berichte in BambooHR erstellen, damit der HR-Agent sie abrufen kann:
- Eine umfassende Liste, die alle aktuellen Mitarbeiter detailliert auflistet.
- Eine Liste für jeden Mitarbeiter, die alle unvollständigen HR-Aufgaben auflistet, die entweder direkt dem Mitarbeiter oder seinem zugewiesenen HR-Kontakt zugewiesen sind.
Mitarbeiterbericht erstellen
Um die erforderlichen Mitarbeiterdaten für das HR-Agenten-Projekt zu generieren, erstellen Sie einen Bericht, der alle wesentlichen Mitarbeiterinformationen enthält:
-
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 Berichtsnamen ein:
Mitarbeiterbericht. -
Fügen Sie die folgenden Felder zum Bericht hinzu:
- Vorname
- Nachname
- Einstellungsdatum
- Land
- Arbeits-Email
- Privat-Email
- Email des Vorgesetzten
- Name des Vorgesetzten
- LinkedIn-URL
- Abteilung
- Berufsbezeichnung
- Berichtet an
-
SRE-Benutzerregion
Hinweis
SRE User Regionist ein benutzerdefiniertes Feld. Dieses Feld wird verwendet, wenn ein IT-Onboarding-Ticket erstellt wird. Wenn Ihr Unternehmen diese Informationen nicht benötigt, ist dieses Feld optional. Andernfalls stellen Sie sicher, dass Sie dieses benutzerdefinierte Feld in BambooHR gemäß der Dokumentation zum Erstellen benutzerdefinierter Felder erstellen.
BambooHR stellt bestimmte Mitarbeiterfelder erst nach dem Einstellungsdatum eines Mitarbeiters zur Verfügung. Um die Pre-Onboarding-Workflows zu unterstützen, müssen Sie die folgenden benutzerdefinierten Felder erstellen und manuell ausfüllen, wenn Sie einen neuen Mitarbeitereintrag hinzufügen:
NewHireDepartmentNewHireJobTitleNewHireReportsTo
Um diese benutzerdefinierten Felder in BambooHR zu erstellen, folgen Sie der Dokumentation zum Erstellen benutzerdefinierter Felder.
-
Die Filterergebnisse sollten Alle Mitarbeiter sein.
-
Klicken Sie auf Speichern.
Erstellen Sie einen Bericht über Mitarbeiteraufgaben
Um die erforderlichen verbleibenden HR-Aufgaben für das HR-Agent-Projekt zu generieren, verwenden Sie das folgende Verfahren, um einen Bericht zu erstellen, 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 Berichtsnamen ein:
Mitarbeiteraufgabenbericht. -
Fügen Sie die folgenden Felder zum Bericht hinzu:
- Aufgabe
- Kategorie
- Aufgabenliste
- Zugewiesen an
- Fälligkeitsdatum
- Abschlussdatum
- Abgeschlossen
-
Die Filterergebnisse sollten Alle Mitarbeiter sein.
-
Klicken Sie auf Speichern.
Erstellen Sie einen BambooHR-API-Schlüssel
Sie müssen einen API-Schlüssel generieren, um BambooHR im Projekt zu verbinden. Um Ihren API-Schlüssel zu erstellen, folgen Sie den Anweisungen von BambooHR, um einen neuen API-Schlüssel zu erstellen (Berechtigungen erforderlich). Sobald der API-Schlüssel erstellt ist, stellen Sie sicher, dass Sie ihn speichern. Dieser Schlüssel wird in den nächsten Schritten der Konfiguration verwendet.
Erstellen Sie ein Google-Formular
Dieses Formular ist für neue Kandidaten gedacht. Es ist in ihrer Willkommens-Email enthalten, um wichtige Informationen zu sammeln und den Prozess zur Erstellung eines IT-Service-Management-Tickets (Pre Onboarding | ITSM-Anfrage) zu initiieren. Diese Schritte können umgangen werden, wenn eine Alternative zu Google-Formularen bevorzugt wird. Die benutzerdefinierten Jitterbit-APIs in den folgenden Schritten Erstellen Sie die benutzerdefinierte Jitterbit-API sollten jedoch weiterhin befolgt werden, und die API sollte durch Ihr bevorzugtes Formular ausgelöst werden.
Erstellen Sie das Formular
-
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)
-
Email (Fragetyp: Kurze Antwort, mit aktivierter Email-Validierung)
-
Geben Sie Ihrem Formular einen Namen:
Onboarding Form.
-
Verknüpfen Sie das Formular mit einem Google Sheet
-
Klicken Sie im Formulareditor auf Antworten.
-
Klicken Sie auf das grüne Google Sheets-Symbol in der oberen rechten Ecke.
-
Wählen Sie Ein neues Spreadsheet erstellen.
-
Geben Sie den Namen des Spreadsheets ein:
Onboarding Form (Responses). -
Klicken Sie auf Erstellen, um das Formular mit dem Spreadsheet zu verknüpfen.
Das Spreadsheet erstellt automatisch Spalten basierend auf Ihren Formularfragen. Überprüfen Sie, ob die Spalten in der folgenden Reihenfolge erscheinen, da das Skript von dieser genauen Reihenfolge abhängt:
- Zeitstempel
- Vollständiger Name
- Adresse
- Telefonnummer
Wenn die Spaltenreihenfolge anders ist, stimmen die Formularfragen möglicherweise nicht mit der erwarteten Reihenfolge überein. Um dies zu beheben, ändern Sie die Reihenfolge der Fragen in Ihrem Formular, um die oben angegebene Sequenz zu entsprechen.
Richten Sie das Apps Script ein
- Gehen Sie im verknüpften Google Sheet zu Erweiterungen > Apps Script.
- Der Apps Script-Editor öffnet sich. Standardmäßig heißt das Skript
Unbenanntes Projekt. - Klicken Sie oben im Editor auf Unbenanntes Projekt und benennen Sie es in
Onboarding Form (Responses)um. - Löschen Sie im Apps Script-Editor jeglichen 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 in dem eingefügten Code
YOUR_ENDPOINT_HEREundYOUR_API_KEY_HEREals Platzhalter. Sie werden diese Werte später in Erstellen Sie die Jitterbit benutzerdefinierte API aktualisieren. - Klicken Sie auf Speichern.
Richten Sie den Trigger für die Formularübermittlung ein
Konfigurieren Sie das Skript so, dass es automatisch ausgeführt wird, wenn jemand das Formular absendet.
-
Klicken Sie im Apps Script-Editor auf das Trigger-Symbol in der linken Seitenleiste.
-
Klicken Sie auf Trigger hinzufügen.
-
Konfigurieren Sie die Trigger-Einstellungen:
- Wählen Sie aus, welche Funktion ausgeführt werden soll: Wählen Sie onFormSubmit.
- Wählen Sie die Ereignisquelle: Wählen Sie Aus Tabelle.
- Wählen Sie den Ereignistyp: Wählen Sie Bei Formularübermittlung.
- Einstellungen für Fehlermeldungen: Wählen Sie Benachrichtigen Sie mich sofort.
-
Klicken Sie auf Speichern.
Wenn ein Benutzer das Formular übermittelt, sendet das Skript die Antwort an Ihr HR-Agent-Projekt und löst die Operation Create ITSM Request API aus.
Formular teilen
-
Gehen Sie zu Ihren Google Formularen unter forms.google.com und öffnen Sie Ihr Onboarding-Formular.
-
Klicken Sie auf Senden.
-
Klicken Sie auf das Link-Symbol, um den teilbaren Link zu erhalten.
-
Ändern Sie unter Link abrufen die Zugriffseinstellung auf Jeder mit dem Link.
-
Klicken Sie auf Link kopieren, um die Formular-URL zu kopieren.
-
Teilen Sie diesen Link mit neuen Mitarbeitern, damit sie auf das Formular zugreifen und es übermitteln können.
Jitterbit Cloud Datastore vorbereiten
Wenn Sie noch kein Cloud Datastore-Zugriffstoken haben, folgen Sie der Dokumentation, um eines zu generieren. Sobald Sie Ihr Zugriffstoken erstellt haben, speichern Sie es. Dieses Token wird in den nächsten Schritten der Konfiguration verwendet.
Erstellen Sie einen Schlüssel-Speicher im Jitterbit Cloud Datastore mit dem Namen candidate_welcome_emails, mit Feldern, die die in der folgenden Tabelle aufgeführten Namen und Typen haben.
Wenn Sie benutzerdefinierte Felder hinzufügen, verwenden Sie die folgende Tabelle, um zu bestimmen, ob jedes im Cloud Datastore-Benutzerinterface auf Erforderlich umgeschaltet werden sollte. Die Felder AlternativeKey und Value sind Standardfelder, die nicht entfernt oder umgeschaltet werden können.
candidate_welcome_emails
Dieser Schlüssel-Speicher enthält die Liste der Namen, Emails und personalisierten Inhalte der Willkommens-Emails für Kandidaten.
| Name | Typ | Erforderlich | Wertdefinition | Beschreibung |
|---|---|---|---|---|
Key |
Text | Ja | Automatisch ausgefüllt | Name und Nachname des Kandidaten mit dem Präfix WE- ohne Leerzeichen. Beispiel: WE-FirstLast. Dieser Wert wird innerhalb des Workflows Pre Onboarding | Offer Signed generiert. |
AlternativeKey |
Text | Nein | Automatisch ausgefüllt | Dies wird nicht verwendet. |
Value |
Text | Nein | Automatisch ausgefüllt | Name und Nachname des Kandidaten ohne Leerzeichen. Dieser Wert wird innerhalb des Workflows Pre Onboarding Offer Signed generiert. |
CandidateEmail |
Text | Nein | Automatisch ausgefüllt | Die Email-Adresse des Kandidaten. Dieser Wert wird innerhalb des Workflows Pre Onboarding | Offer Signed generiert. |
CandidateEmailBody |
Großer Text | Nein | Automatisch ausgefüllt | Der Email-Inhalt, der für den Kandidaten generiert wird. Dieser enthält den personalisierten Email-Inhalt. Sein Wert wird innerhalb des Workflows Pre Onboarding | Offer Signed generiert. |
Projektvariablen konfigurieren
Im im Marketplace installierten Studio-Projekt müssen Werte für die folgenden Projektvariablen festgelegt werden.
Dies kann über das Aktionsmenü des Projekts erfolgen, um Projektvariablen auszuwählen und eine Schublade am unteren Rand der Seite zu öffnen, in der Sie die Werte überprüfen und festlegen können.
BambooHR
Tipp
Wir empfehlen, dass Sie mit Ihren HR- und IT-Abteilungen zusammenarbeiten, um die Variablenwerte in diesem Abschnitt zu vervollständigen.
| Variablenname | Beschreibung |
|---|---|
bambooHr.base.url |
Basis-URL von BambooHR für HTTP-Anfragen. Beispiel: https://{companyDomain}.bamboohr.com/ |
bamboo.password |
Passwort für die grundlegende Authentifizierung von BambooHR. |
bamboo.apiKey |
Ihr API-Schlüssel für den Benutzernamen der grundlegenden Authentifizierung von BambooHR. Siehe Dokumentation zur Erlangung eines API-Schlüssels. |
bamboo.path.reports.employeeTasks |
ID des benutzerdefinierten Berichts für Mitarbeiteraufgaben. Diese ID erscheint in der URL, wenn Sie den Bericht besuchen. Zum Beispiel, in der URL https://{companyDomain}.bamboohr.com/reports/custom/Employee+Tasks+Reports/103, ist die ID 103. |
bamboo.path.reports.employees |
ID des benutzerdefinierten Berichts für Mitarbeiter. Diese ID erscheint in der URL, wenn Sie den Bericht besuchen. Zum Beispiel, in der URL https://{companyDomain}.bamboohr.com/reports/custom/Employee+Tasks+Reports, ist die ID 101 |
bamboo.folder.trainingDocuments |
Ordnername, in dem die Schulungsdokumente gespeichert sind. |
bamboo.folder.onboarding |
Ordnername, der die Einarbeitungsdokumente enthält, die neuen Mitarbeitern eine Woche vor ihrem Startdatum zugesendet werden sollen. Dieser Ordner sollte keine unterschriebenen Dokumente enthalten. |
bamboo.folder.itDocuments |
Ordnername, in dem die IT-Dokumente gespeichert sind. |
bamboo.folder.file.itLaptopChoice |
Dateiname, in dem die Details zur Laptopwahl gespeichert sind. |
bamboo.folder.file.itGSuite |
Dateiname, in dem die Details zu Google Workspace gespeichert sind. |
bamboo.folder.file.itApps |
Dateiname, in dem die Details zu Apps gespeichert sind. |
bamboo.folder.file.courses |
Dateiname, in dem die Details zu Kursen gespeichert sind. |
Jira
| Variablenname | Beschreibung |
|---|---|
jira.username |
Jira-Benutzername für die grundlegende Authentifizierung. |
jira.task.reporter |
Interne Jira-ID des Meldenden. |
jira.task.assignee |
Interne Jira-ID des Zuweisenden. |
jira.project.name |
Jira-Projektname. |
jira.baseUrl |
Basis-URL von Jira für HTTP-Anfragen. |
jira.api.token |
Jira-API-Token. Siehe Jira-Verbindung für nützliche Links zur Unterstützung bei der Erstellung Ihres API-Tokens. |
Confluence
| Variablenname | Beschreibung |
|---|---|
confluence.username |
Confluence-Benutzername für die grundlegende Authentifizierung. |
confluence.apiKey |
Passwort für die grundlegende Authentifizierung von Confluence. Weitere Informationen, wo Sie Ihren API-Schlüssel erhalten, finden Sie unter API-Token verwalten. |
confluence.base.url |
Die Basis-URL zum Abrufen der IT-Onboarding-Dokumentation. |
Für weitere Informationen zur Verwendung der Variablen siehe die Dokumentation.
| Variablenname | Beschreibung |
|---|---|
email.smtp.username |
Benutzername zur Authentifizierung beim SMTP-Server. |
email.smtp.password |
Passwort zur Authentifizierung beim SMTP-Server. |
email.smtp.host |
Hostname oder IP-Adresse des SMTP-Servers zum Versenden von Emails. |
email.from |
Absender-Email-Adresse, die im Feld "Von" für alle ausgehenden Emails verwendet wird. |
email.to.it |
Email-Adresse der IT-Abteilung zum Empfang von Systembenachrichtigungen während des Projekts. |
email.to.hr |
Email-Adresse der Personalabteilung zum Empfang von Benachrichtigungen während des Projekts. |
Hinweis
Der Email-Connector verwendet SMTP-Sicherheit, die auf SSL eingestellt ist, und den SMTP-Port, der auf 465 eingestellt ist.
OpenAI und GPT
| Variablenname | Beschreibung |
|---|---|
openAI.apiKey |
OpenAI API-Schlüssel zur Authentifizierung. Für weitere Informationen besuche OpenAI. |
openAi.url.path |
URL-Pfad für OpenAI API-Aufrufe. Wird dynamisch von der Anwendung zugewiesen. Leer lassen. |
gpt.toolChoice |
Auswahlmodus für das Aufrufen von GPT-Funktionen. Sollte auf auto eingestellt sein. |
gpt.temperature |
Steuert die Zufälligkeit der GPT-Antworten (0.0-2.0). Leer lassen, um den Standardwert zu verwenden, oder einen benutzerdefinierten Wert angeben. |
gpt.model |
Kennung des GPT-Modells. Muss auf GPT-4o eingestellt sein. |
gpt.maxTokens |
Maximale Anzahl von Tokens in den GPT-Antworten. Leer lassen, um den Standardwert zu verwenden, oder einen benutzerdefinierten Wert angeben. |
Slack
| Variablenname | Beschreibung |
|---|---|
slack.bot.user.token |
OAuth-Zugriffstoken für den Bot-Benutzer, das nach dem Erstellen der Slack-App erhalten wurde. Wird zur Authentifizierung in der Slack-Verbindung verwendet. |
slack.itChannel.ID |
Slack-Kanal-ID für IT-Benachrichtigungen. In den Kanal-Details zu finden. |
slack.hrChannel.ID |
Slack-Kanal-ID für HR-Benachrichtigungen. In den Kanal-Details zu finden. |
slack.bot.id |
Slack-Bot-Benutzer-ID (Mitglieds-ID). Wird verwendet, um zu verhindern, dass der Bot auf seine eigenen Nachrichten antwortet. In den App-Details zu finden. |
Hinweis
Die Slack-App wird in einem späteren Schritt erstellt. Für den Moment können die Variablen slack.bot.id und slack.bot.user.token leer gelassen werden.
Andere
| Variablenname | Beschreibung |
|---|---|
your.company |
Der Name Ihres Unternehmens. Beispiel: Jitterbit |
welcome.form |
Die URL des Formulars, das an die Kandidaten in der Willkommens-Email gesendet werden soll. Wenn Sie ein Google-Formular erstellt haben, siehe Erstellen eines Google-Formulars. |
learningPath.enrollment.key |
Die URL Ihres Organigramms. |
Introduction.helpfulIT.url |
Die URL von hilfreichen IT-Links oder Informationen. |
Introduction.companyContact.url |
Die URL von wichtigen Unternehmens-Kontakten. |
hr.tasks.link |
Eine URL, die Mitarbeiter durch das Abschließen ihrer verbleibenden HR-Aufgaben führt. Wenn keine dedizierte URL vorhanden ist, geben Sie die Hauptseite Ihrer HR-Plattform an. |
cloud.datastore.key |
Ihr Cloud Datastore-Schlüssel. Für Details siehe 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 Ihres Organigramms. |
offerSigned.LastModifiedDate.Manual.Date |
Das Datum des manuellen Workflow-Laufs, das das zwischengespeicherte Datum für den Workflow Pre Onboarding | Angebot unterzeichnet überschreibt. |
offerSigned.LastModifiedDate.Manual |
Auf true setzen, um das manuelle Laufdatum für den Workflow Pre Onboarding | Angebot unterzeichnet zu aktivieren. |
Testverbindungen
Test Sie die Endpunktkonfigurationen, um die Konnektivität mit den definierten Projektvariablenwerten zu überprüfen.
Dies kann über die Registerkarte Projektendpunkte und -verbinder in der Designkomponentenpalette erfolgen, indem Sie über jeden Endpunkt fahren und auf Test klicken.
Email-Vorlagen hinzufügen
Im Workflow Common Operations, in seiner Operation Common Scripts, finden Sie ein Skript namens HTML Email Templates. Dieses Skript enthält alle Email-Vorlagen für das Projekt. Referenzvorlagen von Jitterbit sind zur Orientierung enthalten, müssen jedoch durch die tatsächlichen Email-Vorlagen Ihres Unternehmens ersetzt werden.
Zeitpläne erstellen
Bestimmte Workflows erfordern eine geplante Ausführung. Der KI-Agent enthält einen vorkonfigurierten Zeitplan, Täglicher Zeitplan, der für tägliche Trigger eingerichtet ist.
Sie haben die Möglichkeit, diesen bestehenden Täglichen Zeitplan zu verwenden (dies kann über das Aktionsmenü der Operation in Einstellungen > Zeitpläne erfolgen) oder einen neuen Zeitplan zu erstellen. Die unten aufgeführten Operationen müssen mit einem Zeitplan verknüpft sein:
Controller - Suche Angebot unterzeichnetController - Suche Neueinstellungen - Woche davorController - Suche EinführungenController - Suche - LI-Beitrag schreibenController - Suche - Personalisierter LernpfadController - Suche - Verbleibende HR-Aufgaben des MitarbeitersController - Suche - In Bearbeitung befindliche 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 mit dem Namen
candidate_welcome_emailsStudio, den Sie im Schritt Jitterbit Cloud Datastore vorbereiten erstellt haben. -
Klicken Sie auf Weiter und dann auf Fertigstellen.
-
Wiederholen Sie die Schritte 3 und 4 für jede Cloud Datastore-Endpunktaktivität.
-
Bereitstellen des Studio-Projekts. Dies kann über das Aktionsmenü des Projekts erfolgen, um Bereitstellen auszuwählen.
Erstellen Sie die benutzerdefinierte Jitterbit-API
Erstellen Sie eine benutzerdefinierte API mit dem API-Manager für eine der folgenden:
-
Slack-Bot-API-Anforderungs-Handler: Erforderlich, wenn die Slack-Benachrichtigung, die im Design dieses KI-Agenten enthalten ist, verwendet wird.
-
Google-Formular-API-Anforderungs-Handler: Erforderlich, wenn das Google-Formular, das im Design dieses KI-Agenten enthalten ist, verwendet wird.
Erstellen Sie den Slack-Bot-API-Anforderungs-Handler
Diese benutzerdefinierte Jitterbit-API löst die PlatformBot | Inbound Event-Operation aus. Konfigurieren und veröffentlichen Sie die benutzerdefinierte API mit den folgenden Einstellungen:
- API-Dienst:
HR Agent - PlatformBot | Inbound Event - Pfad:
/ - Projekt: Wählen Sie das Studio-Projekt aus, das aus dem
Jitterbit HR Agentim Marketplace erstellt wurde - Zu triggernde Operation:
PlatformBot | Inbound Event - Methode:
POST - Antworttyp:
Systemvariable
Behalten Sie die Dienst-URL der veröffentlichten API für die Erstellung der Slack-App. Die Dienst-URL finden Sie im API-Details-Bereich auf der Registerkarte Dienste, indem Sie über die Aktionen-Spalte des Dienstes fahren und API-Dienst-URL kopieren klicken.
Erstellen Sie den Google-Formular-API-Anforderungs-Handler
Diese benutzerdefinierte Jitterbit-API löst die Create ITSM Request API-Operation aus. Konfigurieren und veröffentlichen Sie die benutzerdefinierte API mit den folgenden Einstellungen:
- Dienstname:
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:
Systemvariable - 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-Schlüssel - Schlüssel:
X-APIKey - Wert: Sie erhalten einen eindeutigen Schlüssel. Kopieren Sie diesen Wert vorerst. Dies ist erforderlich, um die Google-Formular-Konfiguration abzuschließen.
- Klicken Sie auf Speichern.
- Profilname:
Stellen Sie sicher, dass Sie das Sicherheitsprofil der API-Konfiguration zuweisen und es speichern. Behalten Sie die Dienst-URL der veröffentlichten API für die Verwendung im Google Formular. Sie finden die Dienst-URL im API-Details-Bereich auf der Registerkarte Dienste. Um die URL zu kopieren, fahren Sie mit der Maus über die Aktionen-Spalte des Dienstes und klicken Sie auf API-Dienst-URL kopieren. Nachdem Sie sowohl den API-Schlüssel als auch die Dienst-URL haben, vervollständigen Sie die Konfiguration des Google Formulars App-Skripts. Stellen Sie sicher, dass Sie das App-Skript speichern, nachdem Sie die Dienst-URL und den API-Schlüssel hinzugefügt haben.
Erstellen Sie die Slack-App, testen Sie die Verbindung und setzen Sie das Projekt erneut ein
Um die HR-Agent-Chatoberfläche in Slack zu erstellen, erstellen Sie eine Slack-App mit der im Anpassungsdateien dieses KI-Agenten bereitgestellten Slack-App-Manifestdatei. Alternativ können Sie es von Grund auf neu erstellen.
Wenn Sie die bereitgestellte Slack-App-Manifestdatei (slack_app_manifest.json) verwenden, müssen Sie die folgenden Platzhalter durch Ihre eigenen Konfigurationswerte ersetzen:
| Platzhalter | Beschreibung |
|---|---|
{{Replace with Slack bot name}} |
Der Name, den Sie Ihrem Slack-Bot geben möchten, wie er den Benutzern angezeigt wird. Es gibt zwei Stellen im Manifest, an denen Sie diesen Wert ersetzen müssen. |
{{Replace with Jitterbit API URL}} |
Die Dienst-URL der Jitterbit-Custom-API, die Sie in Erstellen Sie den Slack-Bot-API-Anforderungs-Handler erstellt haben. |
Nachdem Sie die Slack-App installiert haben, erhalten Sie deren Bot-Token.
Öffnen Sie die Konfiguration der Projektvariablen erneut und geben Sie das Bot-Token für den Wert der Projektvariablen slack.bot.user.token ein.
Sobald das Bot-Token festgelegt ist, testen Sie die Slack-Verbindung und setzen Sie das Projekt erneut in Betrieb.
Hinweis
Fügen Sie Ihren Slackbot zu Ihren IT- und HR-Kanälen hinzu. Befolgen Sie die folgenden Schritte:
- Navigieren Sie zu dem Kanal, dem der Bot beitreten soll. Geben Sie im Nachrichtenfeld
/invite @YourBotNameein, wobeiYourBotNameder Name Ihres Bots ist. - Wiederholen Sie diesen Schritt für jeden Kanal, in den Sie den Bot hinzufügen möchten (IT und HR).
Triggern Sie die Projekt-Workflows
Bereiten Sie zu Testzwecken Ihre Testdatensätze vor und führen Sie die folgenden Operationen aus. Sie können eine Operation über die Ausführen-Option der Operation ausführen, die erscheint, wenn Sie mit der Maus über die Operation fahren:
Controller - Suche Angebot UnterzeichnetController - Suche Neueinstellungen - Woche VorherController - Suche EinführungenController - Suche LI-Beitrag SchreibenController - Suche - Personalisierter LernpfadController - Suche - Verbleibende HR-AufgabenController - Suche - In Bearbeitung IT-Tickets
Die beiden anderen Haupt-Workflows werden durch die benutzerdefinierten Jitterbit-APIs ausgelöst:
PlatformBot | Eingehendes Ereignis: Slack löst diesen Workflow über die benutzerdefinierte APIHR Agent - PlatformBot | Eingehendes Ereignisaus. Das Senden einer Direktnachricht an die Slack-App initiiert den Trigger der benutzerdefinierten API.Create ITSM Request API: Google Form löst diesen Workflow über die benutzerdefinierte APIHR Agent - Create ITSM Request APIaus. Das Senden eines Beispiel-Formulars initiiert den Trigger der benutzerdefinierten API.
Alle anderen Workflows werden durch andere Operationen ausgelöst und sind nachgelagert zu den oben aufgeführten. Sie sind nicht dafür gedacht, eigenständig ausgeführt zu werden.
Fehlersuche
Überprüfen Sie die API-Protokolle und die Betriebsprotokolle für detaillierte Informationen zur Fehlersuche.
Für zusätzliche Unterstützung kontaktieren Sie den Jitterbit-Support.
Unterschiedliche Nutzung von Endpunkten
Wenn Sie den im Template verwendeten Endpunkt ändern, müssen Sie mehrere Projektkomponenten anpassen. Dieser Abschnitt beschreibt die erforderlichen Aktualisierungen für jeden Workflow, der den Endpunkt verwendet.
Wichtig
Bevor Sie das Projekt ändern, überprüfen Sie die Komponenten, die Sie anpassen möchten. Die Überprüfung der Komponenten hilft Ihnen, zu verstehen, wie sie funktionieren, und ermöglicht es Ihnen möglicherweise, vorhandene Skripte für Ihre Endpunkte wiederzuverwenden.
HRIS-Plattformen
Wenn Ihr Unternehmen eine HR-Plattform verwendet, die nicht BambooHR ist, verwenden Sie die Anweisungen in diesem Abschnitt, um Ihr Projekt anzupassen.
Der HR Calls Workflow enthält alle Operationen, die Daten von HR-Plattformen extrahieren. Da jede HR-Plattform eine einzigartige API-Dokumentation und -Funktionen hat, variieren die Schritte zum Abrufen von Informationen zwischen den verschiedenen HR-Plattformen.
Erkennen und Verarbeiten von unterzeichneten Angeboten
Die folgenden Operationen erkennen Kandidaten, die unterzeichnete Angebote haben, und lösen den Workflow zur Angebotsverarbeitung aus:
Get Applicant Status: Ruft den aktuellen Status der Bewerber ab.Get Applicant Status - Prep for Details: Bereitet Bewerberdaten für die detaillierte Abfrage vor.Get Applicant Details: Ruft detaillierte Informationen über Bewerber ab.
Diese Operationen laufen auf dem Controller - Search Offer Signed Controller. Wenn die Operationen einen Kandidaten mit einem Status für ein unterzeichnetes Angebot erkennen, lösen sie die Operation Start - Single Offer aus, um den Workflow zu verarbeiten.
Vervollständigen Sie die folgenden Schritte, um die Operation Start - Single Offer zu konfigurieren:
- Öffnen Sie die Offer Signed Data to Common Model Employee Schema Transformation.
- Aktualisieren Sie das Quellschema.
- Vervollständigen Sie die Feldzuordnungen, um die erforderlichen Variablen zuzuweisen (zum Beispiel
offerSigned_manager).
Wenn Sie neue Operationen für die Anforderungen Ihrer HR-Plattform erstellen, fügen Sie diese dem Controller - Search Offer Signed Controller hinzu.
Abrufen benutzerdefinierter Berichte von Ihrer HR-Plattform
Die Operation GET Custom Report by ID dient zwei Zwecken:
- Abrufen einer Liste von Mitarbeitern.
- Abrufen verbleibender HR-Aufgaben.
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 | Aufrufoperation | Verarbeitungsoperation |
|---|---|---|
| AskHR | Nach dem Tool | Start - find_manager | Start - find_manager |
AskHr - find_manager - Mitarbeiterverzeichnis zum gemeinsamen Mitarbeiterschema |
| Pre Onboarding | Woche vor Dokumenten | Controller - Suche Neueinstellungen - Woche Vor |
GET Bericht - Woche Vor Daten zum gemeinsamen Modell Mitarbeiterschema |
| Pre Onboarding | ITSM-Anfrage | Start | ITSM-Anfrage API |
GET Bericht - Mitarbeiterverzeichnis zum ITSM gemeinsamen Modell Mitarbeiterschema |
| Erster Tag | Einführungen | Controller - Suche Einführungen |
GET Bericht - Einführungsdaten am ersten Tag zum gemeinsamen Modell Mitarbeiterschema |
| Erster Tag | LI-Beitrag schreiben | Controller - Suche LI-Beitrag schreiben |
GET Bericht Mitarbeiter - LI-Beitragsdaten zum gemeinsamen Modell Mitarbeiterschema |
| Erste Woche | Personalisierter Lernpfad | Controller - Suche - Personalisierter Lernpfad |
Personalisierter Lernpfad - Mitarbeiterdaten zum gemeinsamen Modell Mitarbeiterschema |
| Allgemein | Verbleibende HR-Aufgaben des Mitarbeiters | Controller - Suche - Verbleibende HR-Aufgaben des Mitarbeiters |
Verbleibende HR-Aufgaben des Mitarbeiters zu flachen HR-Aufgaben |
| Erste Woche | In Bearbeitung befindliche IT-Tickets | Controller - Suche - In Bearbeitung befindliche IT-Tickets |
GET Bericht Mitarbeiter - Filter Erste Woche zum gemeinsamen Modell Mitarbeiterschema |
Für jeden Workflow öffnen Sie die Transformation der Verarbeitungsoperation und führen Sie die folgenden Schritte aus:
- Aktualisieren Sie das Quellschema, um Ihrer HR-Plattform zu entsprechen.
- Vervollständigen Sie die Feldzuordnungen, um die erforderlichen Variablen zuzuweisen.
Hinweis
Der Allgemein | Verbleibende HR-Aufgaben des Mitarbeiters Workflow verwendet GET Custom Report by ID für den Bericht über die verbleibenden HR-Aufgaben. Wenn Sie dieselbe Operation für diesen Workflow nicht verwenden können, erstellen Sie eine neue Operation und rufen Sie sie vom Controller - Suche - Verbleibende HR-Aufgaben des Mitarbeiters Controller auf.
Mitarbeiterdaten nach ID abrufen
Die Get Employee by Id Operation ruft Daten für einen einzelnen Mitarbeiter von Ihrer HR-Plattform ab. Die Get Employee Details by Id Operation ordnet die Quelldaten dem gemeinsamen Schema (common_schema_employeeInfo) zu.
Vervollständigen Sie die folgenden Schritte, um diese Operationen zu konfigurieren:
- Aktualisieren Sie die
Get Employee by IdOperation mit dem API-Aufruf Ihrer HR-Plattform. - Öffnen Sie die Get Employee Details by Id Transformation, um das Quellschema zu aktualisieren und die Feldzuordnungen abzuschließen, um die erforderlichen Variablen zuzuweisen.
Dateien von Ihrer HR-Plattform herunterladen
Die folgenden Operationen laden Dateien von Ihrer HR-Plattform herunter:
Get List of Files: Ruft eine Liste von Ordnern 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 die Operation mit dem API-Aufruf Ihrer HR-Plattform, um eine Liste von Ordnern abzurufen.
- Aktualisieren Sie in den BambooHR Variableneinstellungen die Variablen, die mit
bamboo.folderbeginnen. Diese Variablen identifizieren den richtigen Ordner für jeden Workflow. - Öffnen Sie die Get List of Files - Filter for Folders v2 Transformation, um das Quellschema 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 BambooHR Variableneinstellungen 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.
Konfigurieren Sie Get List of Files - Download All Files
Dieser Vorgang lädt alle Dateien aus dem gefilterten Ordner herunter. Der Vorgang wird hauptsächlich im Workflow Pre Onboarding | Woche vor den Dokumenten verwendet, um Onboarding-Dokumente zu senden. Weitere Informationen finden Sie unter Überprüfen Sie die Projekt-Workflows.
Konfigurieren Sie Get List of Files - Download File v2
Dieser Vorgang ist sowohl mit Get List of Files - Filter & Download Single File als auch mit Get List of Files - Download All Files als deren nächsten Schritt verbunden. Aktualisieren Sie den Vorgang mit dem API-Aufruf Ihrer HR-Plattform, um den Datei-Download zu verwalten.
Abrufen von Daten zu Mitarbeiterabwesenheiten
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.
Um diesen Vorgang zu konfigurieren, führen Sie die folgenden Schritte aus:
- Aktualisieren Sie den Vorgang, um den API-Endpunkt Ihrer HR-Plattform aufzurufen, der Daten zu Abwesenheiten abruft.
-
Verwenden Sie die folgenden Variablen, um den Datumsbereich in Ihrer HTTP-Anfrage zu filtern:
-
$llm_response_start_date: Das Startdatum, das das LLM basierend auf der Anfrage des Benutzers auf einer Kommunikationsplattform wie Slack generiert. -
$llm_response_end_date: Das Enddatum, das das LLM basierend auf der Anfrage des Benutzers auf einer Kommunikationsplattform wie Slack generiert.
-
ITSM-Plattformen
Wenn Ihr Unternehmen eine IT-Service-Management (ITSM)-Plattform verwendet, die nicht Jira ist, verwenden Sie die Anweisungen in diesem Abschnitt, um Ihr Projekt zu modifizieren.
IT-Onboarding-Tickets erstellen
Um diese Vorgänge für eine andere ITSM-Plattform zu konfigurieren, führen Sie die folgenden Schritte aus:
-
Aktualisieren Sie den Vorgang
ITSM - Create Task in JIRA, um den API-Endpunkt Ihrer ITSM-Plattform zu verwenden. -
(Optional.) Ziehen Sie in Betracht, diese gängigen Variablen im Vorgang zu verwenden, um Konsistenz zu wahren:
$it_laptopChoice_list: Die Laptopwahl 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 Ihre Operation die Variable
$newHire_itTicketmit der IT-Ticket-URL aus der API-Antwort befüllt.
Abrufen von laufenden IT-Tickets
Die Operation Search ITSM Issue ruft laufende IT-Onboarding-Tickets ab. Diese Operation wird als Teil des First Week | In-progress IT Tickets Workflows ausgeführt.
Um diese Operation für eine andere ITSM-Plattform zu konfigurieren, führen Sie die folgenden Schritte aus:
- Aktualisieren Sie die Operation
Search ITSM Issue, um den API-Endpunkt Ihrer ITSM-Plattform zum Abrufen laufender 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 Anleitungen in diesem Abschnitt, um Ihr Projekt zu modifizieren.
Abrufen von IT-Onboarding-Inhalten
Die Operation AskHr - Get IT Onboarding Content ruft Inhalte von Ihrer IT-Onboarding-Dokumentationsseite ab. Der KI-Agent verwendet diese Inhalte, um IT-bezogene Fragen im Slack-Bot zu beantworten. Diese Operation verwendet die Projektvariable confluence.base.url.
Um diese Operation für eine andere Wissensmanagement-Plattform zu konfigurieren, führen Sie die folgenden Schritte aus:
-
(Optional) Fügen Sie im Abschnitt Projektvariablen eine Variable für die Basis-URL Ihrer Plattform hinzu.
-
Aktualisieren Sie die Operation
AskHr - Get IT Onboarding Content, um den API-Endpunkt Ihrer Plattform zu verwenden. -
Aktualisieren Sie die Transformation der Operation, um dem Antwortschema Ihrer Plattform zu entsprechen.
-
Stellen Sie sicher, dass Ihre Operation die Variable
$it_onboarding_contentmit den abgerufenen Inhalten befüllt. Der KI-Agent verwendet diese Variable in einem LLM-Prompt, um Benutzerfragen im Slack-Bot zu beantworten.
CSV-Vorlagen
CSV-Vorlagen sind ein Kernbestandteil dieses Projekts. Die Vorlagen ermöglichen Workflows, die Dateien analysieren und angepasste Emails sowie IT-Tickets generieren. Während Sie die Daten in diesen Vorlagen für Ihr Unternehmen anpassen können, müssen Sie, wenn Sie die Struktur der Vorlage ändern, die zugehörigen Prompts aktualisieren.
Die folgenden Operationen enthalten Eingabeaufforderungen, die für spezifische CSV-Vorlagendateien entworfen wurden:
| Operation | CSV-Vorlagendatei | Zweck |
|---|---|---|
Prompt - Courses List |
TEMPLATE - HR Agent Onboarding Courses - Job Role.csv |
Generiert Kursempfehlungen basierend auf der Berufsrolle |
Prompt - Application List |
TEMPLATE - IT_Apps_JobRole.csv |
Bestimmt Anwendungen, die basierend auf der Berufsrolle bereitgestellt werden sollen |
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 Berufsrolle |
Wenn Sie die Struktur einer CSV-Vorlagendatei ändern, aktualisieren Sie die entsprechende Eingabeaufforderung, um der neuen Struktur zu entsprechen.
Formulareinreichungsplattformen
Wenn Ihr Unternehmen eine andere Formulareinreichungsplattform als Google Forms verwendet, nutzen Sie die Anweisungen in diesem Abschnitt, um Ihr Projekt zu ändern.
Der KI-Agent verwendet ein Formular, um Informationen für den Start des ITS Calls Workflows zu sammeln.
Um den KI-Agenten so zu konfigurieren, dass er eine andere Formularplattform verwendet, führen Sie die folgenden Schritte aus:
-
Konfigurieren Sie Ihr Formular so, dass Benutzerdaten an die Jitterbit benutzerdefinierte API gesendet werden.
-
Öffnen Sie die Formularantwort in das gemeinsame Mitarbeiterschema-Transformation, um das Quellschema zu aktualisieren und die Feldzuordnungen abzuschließen.
Datenlagerplattformen
Wenn Ihr Unternehmen eine andere Datenlagerplattform als Cloud Datastore verwendet, nutzen Sie die Anweisungen in diesem Abschnitt, um Ihr Projekt zu ändern.
Der KI-Agent verwendet Cloud Datastore, um entworfene Willkommens-Emails und Email-Adressen von Kandidaten zu speichern. Das Datenspeicher ermöglicht das Einfügen, Abfragen und Löschen von Datensätzen. Sie benötigen die gespeicherte Email-Adresse des Kandidaten, um die Willkommens-Email nach der Genehmigung durch den Manager zu senden.
Wichtig
Ändern Sie keine globalen Variablennamen. Verwenden Sie die Variablennamen, wie sie definiert sind.
Um den KI-Agenten so zu konfigurieren, dass er eine andere Datenplattform verwendet, aktualisieren Sie die folgenden Operationen:
Speichern von Daten zur Willkommens-Email
Die Operation Datastore | Insert Welcome Email fügt die folgenden Daten in den Datenspeicher ein:
| Datenfeld | Variable oder Wert |
|---|---|
| Entwurf des Email-Inhalts | $llm_response_email_body |
| Vollständiger Name des Kandidaten (ohne Leerzeichen) | fullname = $offerSigned_name + $offerSigned_surName;fullname_cleaned = Replace(fullname, " ", "");fullname_cleaned |
| Email-Adresse des Kandidaten | $offerSigned_email |
| Datensatzschlüssel | fullname = $offerSigned_name + $offerSigned_surName;fullname_cleaned = Replace(fullname, " ", "");"WE-" + fullname_cleaned |
Löschen von Daten zur Willkommens-Email
Die Operation Datastore | Delete Welcome Email entfernt Datensätze, nachdem die Email an den Kandidaten gesendet wurde oder wenn der Manager die Entwurf-Email ablehnt.
Konfigurieren Sie die Operation so, dass sie die interne Datensatz-ID aus der Variable $dataStore_item_id akzeptiert. Die Operation enthält Protokollanweisungen, um die Löschung zu verfolgen:
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 Hinweise in diesem Abschnitt, um Ihr Projekt zu modifizieren.
Der KI-Agent verwendet Slack für IT-, HR- und Managerbenachrichtigungen sowie für alle Benutzerinteraktionen.
Konfigurieren Sie den eingehenden Ereignishandler
Konfigurieren Sie Ihre Kommunikationsplattform so, dass Benutzeranfrageereignisse an die Jitterbit benutzerdefinierte API gesendet werden. Der PlatformBot | Inbound Event-Betrieb empfängt diese Ereignisse und löst die Kette von Operationen aus, die Benutzer Nachrichten verarbeiten.
Aktualisieren Sie die Projektvariablen
Aktualisieren Sie die folgenden Projektvariablen, um mit Ihrer Kommunikationsplattform übereinzustimmen:
| Variablenname | Beschreibung |
|---|---|
slack.itChannel.ID |
ID des IT-Benachrichtigungskanals |
slack.hrChannel.ID |
ID des HR-Benachrichtigungskanals |
slack.bot.id |
Bot-Benutzer-ID (verwendet, um zu verhindern, dass der Bot auf seine eigenen Nachrichten antwortet) |
slack.bot.user.token |
OAuth-Zugriffstoken des Bot-Benutzers |
Tipp
Sie können diese Variablen umbenennen, um Ihrer Plattform zu entsprechen (zum Beispiel slack.itChannel.ID in teams.itChannel.ID ändern). Wenn Sie eine Variable umbenennen, werden alle Verweise auf diese Variable automatisch in Ihrem Projekt aktualisiert, einschließlich Skripten und Transformationen.
Validieren Sie Plattformnachrichten
Der Validate Platform Message-Betrieb überprüft, ob eingehende Nachrichten von einem Endbenutzer und nicht vom Bot selbst stammen, und extrahiert Variablen für die spätere Verwendung.
Konfigurieren Sie Ihren Betrieb, um die folgenden Variablen zu befüllen:
| Variable | Beschreibung | Wert |
|---|---|---|
$platform_bot_id_pass |
Validierung der Nachrichtenquelle | Auf "true" setzen, wenn die Nachricht von einem tatsächlichen Benutzer stammt |
$platform_userID |
Benutzeridentifikator | Benutzer-ID des Nachrichtenabsenders |
$platform_ts |
Zeitstempel der Nachricht | Zeitstempel der Nachricht |
$platform_thread_ts |
Zeitstempel der Thread-Antwort | Zeitstempel der Antwortnachricht, wenn sie in einem Thread gesendet wurde |
$platform_channel |
Kanalidentifikator | Kanal-ID, in dem die Nachricht gesendet wurde |
Aktualisieren Sie die Quell- und Zielschemata der Transformation, um mit der API Ihrer Kommunikationsplattform übereinzustimmen.
Benachrichtigungsnachrichten senden
Die Operation Post Notification Message to Channel sendet Nachrichten oder Antworten an Plattformkanäle.
Konfigurieren Sie Ihre Operation, um die folgenden Variablen zu verwenden:
| Variable | Beschreibung |
|---|---|
$platform_channel |
Kanal-ID, an den die Nachricht gesendet wird |
$platform_thread_ts |
Thread-Zeitstempel der ursprünglichen Nachricht |
$platform_notification_text |
Textkörper der zu sendenden Nachricht |
Wenn $platform_thread_ts einen Wert enthält (größer als 0), sendet die Operation die Antwort an diesen Thread. Andernfalls sendet die Operation eine neue Nachricht an den Kanal. Konfigurieren Sie diese Logik in Ihrer Transformationszuordnung:
if($platform_thread_ts > 0, $platform_thread_ts)
Aktualisieren Sie die Quell- und Zielschemata der Transformation, um mit der API Ihrer Kommunikationsplattform übereinzustimmen.
Gesprächsverlauf abrufen
Die Operation Conversation History ruft die letzten fünf Nachrichten im Gesprächsverlauf 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 der Operation Validate Platform Message gefüllt.
Aktualisieren Sie das Quellschema der Transformation, um mit der API Ihrer Kommunikationsplattform übereinzustimmen.
Schreibindikator senden
Die Operation Post Typing to Channel sendet einen Schreibindikator an den Kanal.
Konfigurieren Sie Ihre Operation, um die folgenden Variablen zu verwenden:
| Variable | Beschreibung |
|---|---|
$platform_channel |
Kanal-ID, an den der Indikator gesendet wird |
$platform_thread_ts |
Thread-Zeitstempel der ursprünglichen Nachricht |
| Nachrichtenkörper | Das Format des Schreibindikators Ihrer Plattform |
$platform_typing_ts |
Zeitstempel der Schreibindikator-Nachricht (wird für die spätere Löschung verwendet) |
Wenn $platform_thread_ts einen Wert enthält, sendet die Operation den Schreibindikator an diesen Thread. Andernfalls wird der Indikator an den Kanal gesendet. Konfigurieren Sie diese Logik in Ihrer Transformationszuordnung:
if(Length($platform_thread_ts) > 0, $platform_thread_ts, unmap());
Aktualisieren Sie die Quell- und Ziel-Schemas der Transformation, um mit der API Ihrer Kommunikationsplattform übereinzustimmen.
Löschen des Schreibindikators
Die Operation Delete Message entfernt den Schreibindikator aus dem Kanal, nachdem der Bot seine Antwort gesendet hat.
Konfigurieren Sie Ihre Operation, um die folgenden Variablen zu verwenden:
| Variable | Beschreibung |
|---|---|
$platform_channel |
Kanal-ID, an den der Schreibindikator gesendet wurde |
$platform_typing_ts |
Zeitstempel der zu löschenden Schreibindikator-Nachricht |
Aktualisieren Sie die Quell- und Ziel-Schemas der Transformation, um mit der API Ihrer Kommunikationsplattform übereinzustimmen.
Benutzer-Email anhand der Benutzer-ID abrufen
Die Operation Get User Email by UserId ruft die Email-Adresse eines Benutzers anhand seiner Benutzer-ID ab.
Konfigurieren Sie Ihre Operation, um die folgenden Variablen zu verwenden:
| Variable | Beschreibung |
|---|---|
$platform_userID |
Benutzer-ID, nach der gesucht werden soll |
$slack.bot.user.token |
Authentifizierungstoken |
Aktualisieren Sie die Quell- und Ziel-Schemas der Transformation, um mit der API Ihrer Kommunikationsplattform übereinzustimmen.
Benutzerinformationen anhand des Namens abrufen
Die Operation Get UserID & Email by Name and Surname ruft die Email-Adresse und die Benutzer-ID eines Benutzers anhand seines vollständigen Namens ab.
Konfigurieren Sie Ihre Operation, um die folgenden Variablen zu verwenden:
-
Anfrageschema
Variable Beschreibung $slack.bot.user.tokenAuthentifizierungstoken -
Antwortschema
Die Operation füllt die folgenden Variablen aus:
Variable Beschreibung $platform_emailEmail-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 der Datenstruktur der Benutzer Ihrer Plattform zu entsprechen:
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 Ziel-Schemas der Transformation, um mit der API Ihrer Kommunikationsplattform übereinzustimmen.