Jitterbit Sales Quote Agent

Übersicht

Jitterbit stellt den Sales Quote Agent Kunden über Jitterbit Marketplace zur Verfügung. Dieser Agent nutzt das Retrieval-Augmented Generation (RAG) Verfahren, das LLM-Reasoning (Large Language Model) mit Zugriff auf externe Tools und Datenquellen kombiniert. Der Agent orchestriert den End-to-End-Prozess der Angebotserstellung in Salesforce über eine Konversationsschnittstelle, wendet Geschäftslogik wie Aufschlagprozentsätze, anteilige Berechnung, Rundung und mehrjährige Verlängerungssequenzierung an und gewährleistet die Einhaltung historischer Vertragsbedingungen. Dies ermöglicht Sales Ops-, Customer Success- und Account Executive-Benutzern, Angebote ohne manuelle Dateneingabe zu erstellen.

Der Agent erhält Anfragen in natürlicher Sprache über Slack und nutzt ein LLM, um die Benutzerabsicht zu bestimmen und das geeignete Tool für jeden Schritt des Angebotsprozesses auszuwählen. Je nach Anfrage sucht der Agent Salesforce-Konten und -Opportunities, ruft verfügbare Angebotstypen, Preisbücher und Produkte ab und erstellt das Angebot und seine Zeilenpositionen in Salesforce. Nachdem alle Zeilenpositionen hinzugefügt wurden, fordert der Agent den Benutzer auf, diese zu überprüfen und zu bestätigen, bevor das endgültige Angebots-PDF über einen von einem installierten Salesforce Managed Package bereitgestellten Apex REST-Endpunkt generiert wird. Der Agent speichert Konversations- und Sitzungsverlauf in Jitterbit Cloud Datastore, um kontextbewusste Antworten während einer Sitzung zu ermöglichen.

Der Agent führt die folgenden Aufgaben aus:

• Erhält Anfragen in natürlicher Sprache von Benutzern über Slack.
• Nutzt ein LLM, um die Benutzerabsicht zu bestimmen und jede Anfrage an das geeignete Tool weiterzuleiten.
• Sucht Salesforce-Konten und deren zugehörige Opportunities.
• Ruft verfügbare Salesforce-Angebotstypen, Preisbücher und Produkte ab, aus denen der Benutzer wählen kann.
• Erstellt ein Angebot und dessen zugehörige Angebotszeilenpositionen in Salesforce, wobei Aufschlagprozentsätze, anteilige Berechnungen, Rundungen und mehrjährige Verlängerungsberechnungen angewendet werden, und gewährleistet die Einhaltung historischer Vertragsbedingungen.
• Fordert den Benutzer auf, das Angebot vor der PDF-Generierung zu überprüfen und zu bestätigen.
• Generiert das Angebots-PDF durch Aufrufen eines von einem installierten Salesforce Managed Package bereitgestellten Apex REST-Endpunkts.
• Speichert Konversations- und Sitzungsverlauf im Cloud Datastore, um den Kontext über Nachrichten hinweg zu bewahren.

In diesem Dokument wird erläutert, wie dieser KI-Agent eingerichtet und betrieben wird. Es behandelt die Architektur und Voraussetzungen, Anleitung zu Agent-Prompts und Schritte zur Installation, Konfiguration und zum Betrieb des KI-Agenten.

KI-Agent-Architektur

Dieser KI-Agent orchestriert die Angebotserstellung in Salesforce über eine Konversations-Slack-Schnittstelle. Eine typische Interaktion verläuft in folgenden Schritten:

1. Ein Benutzer sendet eine Nachricht in natürlicher Sprache an den Sales Quote Agent über Slack.
2. Der Agent ruft Konversations- und Sitzungsverlauf aus Cloud Datastore ab, um den Kontext zu bewahren, ruft dann das LLM mit einer Reihe verfügbarer Tools auf, um die Benutzerabsicht zu bestimmen.
3. Basierend auf dem ausgewählten Tool fragt der Agent Salesforce ab, um das Konto, dessen Opportunities, verfügbare Angebotstypen, Preisbücher oder Produkte zu suchen, und gibt die Ergebnisse an das LLM zurück, damit der Benutzer sie in Slack überprüfen kann.
4. Sobald der Benutzer einen Angebotstyp, ein Preisbuch und Produkte ausgewählt hat, erstellt der Agent das Angebot und die Angebotszeilenpositionen in Salesforce und wendet dabei den angeforderten Aufschlagprozentsatz und mehrjährige Verlängerungslogik an.
5. Der Agent fordert den Benutzer auf, das Angebot zu überprüfen und zu bestätigen.
6. Nach der Bestätigung ruft der Agent den von dem installierten Salesforce Managed Package bereitgestellten Apex REST-Endpunkt auf, um das Angebots-PDF zu generieren.
7. Der Agent sendet die Antwort an den Benutzer in Slack zurück, und Konversations- und Sitzungsverlauf werden im Cloud Datastore gespeichert, um in nachfolgenden Nachrichten verwendet zu werden.

Workflow-Diagramm

Das folgende Diagramm zeigt den Haupt-Request-Handling-Workflow für den Sales Quote Agent.

Voraussetzungen

Sie benötigen die folgenden Komponenten, um diesen KI-Agenten zu verwenden.

Harmony-Komponenten

Sie benötigen eine Jitterbit-Harmony-Lizenz mit Zugriff auf die folgenden Komponenten:

• Jitterbit Studio.
• Jitterbit API Manager zum Bereitstellen des Slack-Request-Handlers des Agenten als benutzerdefinierte API.
• Jitterbit Cloud Datastore zum Speichern von Konversations- und Sitzungsverlauf.
• Jitterbit Sales Quote Agent als Lizenz-Add-on erworben.

Unterstützte Endpoints

Der KI-Agent verbindet sich mit den folgenden Endpoints. Sie können andere Systeme unterstützen, indem Sie die Endpoint-Konfigurationen und Workflows des Projekts ändern.

Large Language Model (LLM)

Der KI-Agent nutzt Azure OpenAI als LLM-Anbieter. Um Azure OpenAI zu verwenden, benötigen Sie ein Microsoft-Azure-Abonnement mit Berechtigungen zum Erstellen einer Azure-OpenAI-Ressource mit einem bereitgestellten Modell.

CRM-System

Der Agent sucht nach Accounts, Opportunities, Angebotstypen, Preislisteneinträgen und Produkten, und erstellt Angebote sowie Angebotspositionszeilen in Salesforce. Um Salesforce zu verwenden, benötigen Sie ein Salesforce-Konto, das für 2-legged OAuth 2.0 konfiguriert ist, mit Berechtigungen zum Lesen und Schreiben von Angebots-, Angebotspositions-, Opportunity- und Account-Datensätzen.

Der Agent erfordert zudem, dass die Funktion Quotes in der Salesforce-Organisation aktiviert ist (Setup > Quote Settings > Enable Quotes) und dass das verwaltete Package Standard Quote API installiert ist, um Angebots-PDFs zu generieren. Installationsanweisungen finden Sie unter Installieren Sie das verwaltete Salesforce-Package.

Messaging-Plattform

Der Agent nutzt Slack als seine Konversationsschnittstelle. Um Slack zu verwenden, benötigen Sie einen Slack-Workspace mit einer konfigurierten Slack-App zum Empfangen und Beantworten von Nachrichten. Detaillierte Anweisungen zum Erstellen einer Slack-App finden Sie unter Erstellen Sie eine Slack-App.

Cloud Datastore

Der Agent nutzt Cloud Datastore zur Verwaltung autorisierter Slack-Benutzerdatensätze sowie des Konversations- und Sitzungsverlaufs in zwei Schlüsselspeichern (siehe Konfigurieren Sie Cloud Datastore). Cloud Datastore ist Teil der Jitterbit-Harmony-Plattform und erfordert keinen separaten Dienstkonto, aber die Anzahl der verfügbaren Schlüsselspeicher hängt vom gekauften Cloud-Datastore-Plan Ihrer Organisation ab.

Agent-Prompts

Der Sales Quote Agent empfängt alle Anfragen als Nachrichten in natürlicher Sprache, die hauptsächlich über die Slack-App gesendet werden. In diesem Abschnitt werden die Regeln für effektive Prompts beschrieben und Beispiel-Prompts bereitgestellt.

Richtlinien für Prompts

Beachten Sie diese Richtlinien beim Senden von Nachrichten an den Agenten:

• Geben Sie den Salesforce-Accountnamen in Ihrem anfänglichen Prompt ein. Der Agent nutzt dies, um den Account und seine Opportunities in Salesforce nachzuschlagen.
• Um einen Aufschlagsprozentsatz anzuwenden, geben Sie den Prozentsatz in Ihrem Prompt ein (zum Beispiel mit einem Aufschlag von 5 %).
• Zum Erstellen eines mehrjährigen Erneuerungsangebots geben Sie die Anzahl der Jahre in Ihrem Prompt an. Der Agent wendet Anteilberechnung und mehrjährige Sequenzierungslogik basierend auf historischen Vertragsbedingungen an.
• Nach dem anfänglichen Prompt leitet Sie der Agent durch die Auswahl eines Angebotstyps, einer Preisliste und von Produkten, bevor das Angebot erstellt wird.
• Überprüfen und bestätigen Sie die Angebotsdetails, wenn Sie aufgefordert werden, bevor der Agent die Angebots-PDF generiert.

Beispiel-Prompts

Die folgenden Beispiel-Prompts zeigen die Arten von Prompts, die der Agent verarbeiten kann. Ersetzen Sie {Account Name} durch den Namen des Salesforce-Accounts.

Angebotserstellung

Verwenden Sie diese Prompts, um die Generierung eines Verkaufsangebots für einen Account zu starten:

Installation, Konfiguration und Betrieb

Führen Sie diese Schritte aus, um diesen KI-Agent zu installieren, zu konfigurieren und zu betreiben:

1. Projekt herunterladen und installieren
2. Microsoft Azure-Ressourcen erstellen
3. Slack-App erstellen
4. Salesforce Managed Package installieren
5. Cloud Datastore konfigurieren
6. Projektvariablen konfigurieren
7. Verbindungen testen
8. Projekt bereitstellen
9. Jitterbit Custom API erstellen
10. Projekt-Workflows überprüfen
11. Projekt-Workflows auslösen

Anleitungen zur Fehlerbehebung finden Sie unter Fehlerbehebung.

Projekt herunterladen und installieren

Führen Sie diese Schritte aus, um das Studio-Projekt für den KI-Agent zu installieren:

1. Melden Sie sich beim Harmony Portal unter https://login.jitterbit.com an und öffnen Sie Marketplace.

2. Suchen Sie den KI-Agent Jitterbit Sales Quote Agent. Nutzen Sie die Suchleiste oder wählen Sie im Bereich Filter unter Typ die Option KI-Agent aus, um die Anzeige auf KI-Agents zu beschränken.

3. Klicken Sie auf den Link Dokumentation des Agents, um die Dokumentation in einem separaten Tab zu öffnen. Halten Sie den Tab offen, um später darauf zu verweisen.

4. Klicken Sie auf Projekt starten, um ein Konfigurationsdialogfeld mit zwei Schritten zu öffnen.

   Hinweis

   Falls Sie den KI-Agent noch nicht gekauft haben, wird stattdessen Agent abrufen angezeigt. Klicken Sie darauf, um ein Informationsdialogfeld zu öffnen, und klicken Sie dann auf Senden, damit ein Vertreter Sie zum Kauf des KI-Agents kontaktiert.

5. Laden Sie in Konfigurationsschritt 1 Customizations herunterladen die bereitgestellte Slack-App-Manifestdatei herunter. Diese Datei verwenden Sie beim Erstellen der Slack-App.

6. Klicken Sie auf Weiter.

7. Wählen Sie in Konfigurationsschritt 2 Neues Projekt erstellen eine Umgebung aus, in der das Studio-Projekt erstellt wird, und klicken Sie auf Projekt erstellen.

8. Nachdem das Fortschrittsdialogfeld anzeigt, dass das Projekt erstellt wurde, verwenden Sie den Dialog-Link Zu Studio wechseln oder öffnen Sie das Projekt direkt über die Seite Studio Projekte.

Microsoft Azure-Ressourcen erstellen

Erstellen Sie die folgenden Microsoft Azure-Ressourcen und notieren Sie die Informationen zum Konfigurieren des KI-Agents. Um diese Ressourcen zu erstellen und zu verwalten, benötigen Sie ein Microsoft Azure-Abonnement mit den entsprechenden Berechtigungen.

Sie müssen eine Azure OpenAI-Ressource erstellen und ein Modell über das Azure AI Foundry-Portal bereitstellen.

Notieren Sie den Bereitstellungsnamen, die Endpunkt-URL und den API-Schlüssel. Geben Sie diese Werte ein, wenn Sie Projektvariablen konfigurieren.

Führen Sie diese Schritte aus, um diese Werte zu ermitteln:

1. Öffnen Sie im Azure AI Foundry-Portal die spezifische OpenAI-Ressource.

2. Kopieren Sie auf der Landingpage der Ressource die Endpunkt-URL (für die Projektvariable azure_openai_base_url) und den API-Schlüssel (für die Projektvariable azure_openai_api_key).

3. Wählen Sie im Navigationsmenü unter Gemeinsame Ressourcen die Option Bereitstellungen aus. Kopieren Sie den Bereitstellungsnamen (für die Projektvariable Azure_OpenAI_Deployment_Name).

Slack-App erstellen

Führen Sie diese Schritte aus, um die Slack-Schnittstelle des Agents zu aktivieren:

1. Erstellen Sie eine Slack-App mithilfe der im Schritt Projekt herunterladen und installieren heruntergeladenen Manifestdatei. Das Manifest konfiguriert den Bot-Benutzer, OAuth-Bereiche und Event-Abos für den Sales Quote Agent vor. Installieren Sie die App in Ihrem Slack-Workspace.

2. Rufen Sie das Bot-Token ab und bewahren Sie es für die Projektvariable bot_oauth_user_token auf.

Salesforce Managed Package installieren

Der Agent generiert Quote-PDFs mithilfe einer Apex REST-Klasse aus dem Standard Quote API Unlocked Salesforce Managed Package. Installieren Sie dieses Package in Ihrer Salesforce-Organisation, bevor Sie das Projekt bereitstellen.

Aktivieren Sie vor der Installation des Packages die Funktion Quotes in Ihrer Salesforce-Organisation unter Setup > Quote Settings. Die Installation schlägt fehl, wenn diese Funktion nicht aktiviert ist.

Verwenden Sie eine der folgenden Methoden zur Installation des Packages:

• Browser-Link: Öffnen Sie den Installationslink für Ihren Org-Typ und folgen Sie den Anweisungen zur Installation des Packages.

  Org-Typ	Installationslink
  Production oder Developer	https://login.salesforce.com/packaging/installPackage.apexp?p0=04tfj000000aNkTAAU
  Sandbox	https://test.salesforce.com/packaging/installPackage.apexp?p0=04tfj000000aNkTAAU

• Salesforce CLI: Führen Sie den folgenden Befehl aus und ersetzen Sie <your-org-alias> durch Ihren Ziel-Org-Alias:

  sf package install --package 04tfj000000aNkTAAU --target-org <your-org-alias> --wait 10
  

Notieren Sie sich nach der Installation die Template-IDs für Ihre Quote-PDF-Templates. Sie geben diese ein, wenn Sie den Workflow Tool - Generate Quote Pdf überprüfen.

Cloud Datastore konfigurieren

Der Agent verwendet zwei Cloud Datastore Key Storages, um autorisierte Benutzer sowie Konversations- und Sitzungsverlauf zu verwalten:

Führen Sie für jeden Key Storage folgende Schritte aus:

1. Erstellen Sie den Key Storage mit dem unten angegebenen Namen und benutzerdefinierten Feldern.
2. Suchen Sie auf der Registerkarte Components des Studio-Projekts unter Endpoints nach jeder Cloud Datastore-Activity, die diesem Storage zugeordnet ist. Activities sind nicht mit dem Storage-Namen gekennzeichnet. Identifizieren Sie sie stattdessen nach ihrer Funktion: Activities wie Query All Users, Create User Session und Update User Session verwenden den Bot Authorized Users Storage, und Activities wie Insert QA, Query Conversation History By Session Id und Delete Old Conversation History of User verwenden den Quoting Q and A Storage. Doppelklicken Sie auf jede Activity, um sie zu öffnen, weisen Sie den Storage-Namen zu und speichern Sie.

Bot Authorized Users

Erstellen Sie einen Key Storage namens Bot Authorized Users. Die Felder Key, AlternativeKey und Value sind standardmäßig vorhanden. Es sind keine benutzerdefinierten Felder erforderlich.

Quoting Q and A

Erstellen Sie einen Key Storage namens Quoting Q and A. Die Felder Key, AlternativeKey und Value sind standardmäßig vorhanden. Fügen Sie die folgenden benutzerdefinierten Felder hinzu:

Projektvariablen konfigurieren

Legen Sie im aus dem Marketplace installierten Studio-Projekt Werte für die folgenden Projektvariablen fest.

Um Projektvariablen zu konfigurieren, verwenden Sie das Aktionsmenü des Projekts und wählen Sie Project Variables aus, um die Konfigurationsschublade zu öffnen.

Salesforce

Azure OpenAI

Cloud Datastore

Slack

Verbindungen testen

Testen Sie die Endpunktkonfigurationen, um die Konnektivität mit den definierten Projektvariablenwerten zu überprüfen.

Um Verbindungen zu testen, gehen Sie zur Registerkarte Project endpoints and connectors der Design-Komponentenpalette, halten Sie den Mauszeiger über jeden Endpunkt und klicken Sie auf Test.

Projekt bereitstellen

Stellen Sie das Studio-Projekt bereit.

Um das Projekt bereitzustellen, verwenden Sie das Aktionsmenü des Projekts und wählen Sie Deploy aus.

Custom API für Jitterbit erstellen

Erstellen Sie eine Custom API mit den folgenden Diensten.

Für den Slack-Request-Handler verwenden Sie diese Einstellungen:

Für den generischen Request-Handler, der von anderen Clientanwendungen wie einbettbaren Widgets verwendet wird, verwenden Sie diese Einstellungen:

Publizieren Sie nach dem Konfigurieren der Dienste die Custom API. Verwenden Sie in der Konfiguration Ihrer Slack-App die resultierende API-Service-URL für den /-Pfad als Request-URL für Ereignisse und Slash-Befehle.

Projekt-Workflows überprüfen

Das Studio-Projekt enthält 12 Workflows, die die Sales Quote Agent-Funktionalität implementieren und in drei funktionale Gruppen organisiert sind.

Einstiegspunkt und Routing

Main Entry - Slack API Request Handler

Dieser Workflow wird von der benutzerdefinierten Jitterbit-API jedes Mal ausgelöst, wenn ein Benutzer eine Nachricht an den Slack-Bot sendet. Er verwaltet eingehende Slack-Bot-Anfragen und führt autorisierte Benutzerdatensätze im Cloud Datastore-Speicher Bot Authorized Users auf. Außerdem wird der Speicher Quoting Q and A nach dem Gesprächsverlauf abgefragt. Nach dem Sammeln dieser Informationen wird die Anfrage an den Workflow Main - AI Agent Tools Logic weitergeleitet.

Main - Generic API Request Handler

Dieser Workflow wird von der benutzerdefinierten Jitterbit-API ausgelöst, wenn eine Anfrage von einem anderen Client als Slack kommt, z. B. von einem einbettbaren Chat-Widget. Er unterstützt einen Reset-Context-Befehl, der den Gesprächsverlauf des Aufrufers löscht, und leitet die Anfrage ansonsten mithilfe der gleichen Gesprächsverlauf- und Benutzersuche-Logik wie am Slack-Einstiegspunkt an den Workflow Main - AI Agent Tools Logic weiter.

Main - AI Agent Tools Logic

Dieser Workflow empfängt die eingehende Anfrage vom Workflow Main Entry - Slack API Request Handler oder Main - Generic API Request Handler, analysiert sie mit dem LLM, um die beabsichtigte Funktion zu ermitteln, und bereitet eine Nutzlast vor, um den entsprechenden Agent-Tool-Workflow aufzurufen. Dieser Workflow verwaltet auch alle LLM-Anfragen und erfasst LLM-Antworten zur nachgelagerten Verwendung.

Salesforce-Angebotswerkzeuge

Tool - Get SalesForce Account Details

Dieser Workflow sucht den in der Slack-Eingabeaufforderung vom Benutzer angegebenen Kontonamen und gibt die Kontoinformationen an das LLM zur weiteren Verarbeitung und Antwort an den Benutzer in Slack zurück.

Tool - Get SalesForce Opportunities

Dieser Workflow ruft alle Chancen ab, die dem vom Benutzer angegebenen Konto zugeordnet sind, und gibt die Liste an das LLM zur weiteren Verarbeitung und Antwort an den Benutzer in Slack zurück.

Tool - Get Quote Types

Dieser Workflow führt eine Abfrage für das Salesforce-Objekt RecordType aus und ruft alle Datensätze vom Typ Quote ab. Diese Liste wird dem Benutzer angezeigt, um einen geeigneten Datensatztyp für das Angebot auszuwählen.

Tool - Generate Quote

Nachdem das LLM alle erforderlichen Informationen für ein Angebot wie Name, Daten und Aufschlagsprozentsatz erfasst hat, erstellt dieser Workflow ein Angebot in Salesforce.

Tool - Get PriceBook List

Nachdem ein Angebot erstellt wurde, müssen Produktdetails als Angebots-Positionen hinzugefügt werden. Dieser Workflow ruft die Liste der verfügbaren Preisbücher aus Salesforce ab und stellt die Liste dem LLM zur Verfügung, um sie dem Benutzer zur Auswahl anzubieten.

Tool - Get PricebookProductList

Dieser Workflow ruft die Produktliste aus dem vom Benutzer ausgewählten Preisbuch ab und gibt die Liste an das LLM zurück, um sie dem Benutzer anzubieten. Der Benutzer wählt dann die Produkte aus, die zum Angebot hinzugefügt werden sollen.

Tool - Angebotszeilenpositionen einfügen

Nachdem der Nutzer die Produktliste ausgewählt und freigegeben hat, führt das LLM Berechnungen durch, um Zeilenpositionen für mehrjährige Szenarien vorzubereiten, falls erforderlich. Die mehrjährigen Zeilenpositionen werden dann als Eingabe für diesen Workflow bereitgestellt, um die Angebotszeilenpositionen in Salesforce zu generieren.

Tool - Angebots-PDF generieren

Nachdem Angebotszeilenpositionen erstellt wurden, fordert das LLM den Nutzer auf, die PDF-Generierung für das Angebot zu überprüfen und zu bestätigen. Nach der Bestätigung ruft dieser Workflow einen Salesforce-REST-API-Endpunkt auf, der ein Apex-Skript zum Generieren der Angebots-PDF auslöst.

Dieser Workflow führt das Skript Set_templateID aus, um Vorlagen-IDs aus Salesforce festzulegen, und wählt dann die entsprechende PDF-Vorlagen-ID im Skript Main -Generate Quote Pdf basierend auf der Produktlinie des Angebots aus (ob der Angebotyp ein eBridge- oder ein Standard-Jitterbit-Angebot ist), ob ein Abonnement-Startdatum vorhanden ist, und ob die anfängliche Laufzeit größer oder kleiner als 12 Monate ist. Legen Sie die Vorlagen-IDs fest, die beim Installieren des verwalteten Salesforce-Pakets erhalten wurden, im Skript Set_templateID fest, und passen Sie die Auswahllogik im Skript Main -Generate Quote Pdf nach Bedarf für die Angebotvorlagen Ihrer Organisation an.

Dienstprogramme

Utility - Bot Chat Cloud Datastore

Dieser Workflow ist eine Sammlung aller Cloud-Datastore-Vorgänge, die im Projekt verwendet werden, einschließlich Abfragen und Aktualisieren von Datensätzen in den Schlüsselspeichern Bot Authorized Users und Quoting Q and A.

Projektworkflows auslösen

Der Sales Quote Agent wird durch eingehende Nachrichten von der Slack-App ausgelöst, die mit dem Workflow Main Entry - Slack API Request Handler verbunden ist. Um den Agent zu starten, müssen Sie keinen Vorgang manuell ausführen. Die Slack-App verarbeitet die Auslösung automatisch, wenn Nutzer Nachrichten senden.

Fehlerbehebung

Wenn Probleme auftreten, überprüfen Sie die folgenden Protokolle für ausführliche Informationen zur Fehlerbehebung:

• API-Protokolle
• Vorgangsprotokolle

Für weitere Unterstützung wenden Sie sich an den Jitterbit-Support.