Anwendungen

Application Knowledge kopiert ausgewählte externe Inhalte als durchsuchbare Quellen in Ciele. Jede Source durchläuft den normalen Ingestionspfad, wird in Citations angezeigt und liefert Antworten nur für die verknüpften Assistants. Die Integration erfolgt direkt. Es verwendet weder Merge noch einen anderen Integrationsbroker.

Verbindung, Import und Quelle

Ein Application Connection speichert ein autorisiertes externes Konto. Ein Application Import wählt Inhalte innerhalb dieses Kontos, einen Zeitplan sowie die Assistenten aus, die darin suchen dürfen. Eine Synchronisierung erstellt oder aktualisiert für jedes Remote-Element eine Ciele Source.

Verwenden Sie eine Connection für mehrere Imports, wenn deren Scope oder die Verknüpfungen zu den Assistants unterschiedlich sind. Beispielsweise kann eine Slack Connection separate Kanalgruppen an separate Assistants weiterleiten.

Salesforce-, ServiceNow- und Slack-Verbindungen gehören zur Organisation. Jede Organisation kann für jeden dieser Anbieter eine Connection haben. OneDrive- und Google Drive-Verbindungen gehören dem Mitglied, das sie autorisiert. Jedes Mitglied kann für jeden persönlichen Anbieter ein Konto verbinden.

Ein Organisationsadministrator kann persönliche Verbindungs-Metadaten einsehen und eine persönliche Verbindung entfernen. Nur das besitzende Mitglied kann sie erneut verbinden. Anbieter-Anmeldeinformationen überschreiten niemals die Grenze des Mitglieds. Importierte Quellen zählen zum Wissen der Organisation und folgen den für sie konfigurierten Assistant-Links.

Ein Konto verbinden

Ein Organisationsadministrator oder -besitzer kann Salesforce, ServiceNow oder Slack verbinden. Ein Mitglied mit der Berechtigung „Knowledge edit“ kann sein OneDrive oder Google Drive verbinden und Importe verwalten.

1. Öffnen Sie Library und wählen Sie Applications aus, oder öffnen Sie die Knowledge eines Assistenten und wählen Sie Applications aus.
2. Wählen Sie Connect beim Provider aus.
3. Geben Sie für Salesforce oder ServiceNow einen Connection-Namen, die Instance-URL, die Client-ID und das Client-Secret ein.
4. Wählen Sie für Slack, OneDrive oder Google Drive Continue connecting auf der Ciele-Verbindungsseite aus.
5. Melden Sie sich auf der Website des Providers an und genehmigen Sie den Zugriff. Ciele aktualisiert dann die Liste der Anwendungen.
6. Erstellen Sie einen Import, wählen Sie seinen Umfang aus und verknüpfen Sie mindestens einen Assistenten.
7. Wählen Sie die Synchronisierung Daily oder Manual.
8. Speichern Sie den Import und warten Sie, bis seine Quellen Ready werden.
9. Testen Sie eine Antwort und öffnen Sie die zugehörige benannte Source-Fundstelle.

Slack, OneDrive und Google Drive fordern Sie auf, sich anzumelden und den Zugriff zu autorisieren. Mitglieder geben keine OAuth Client ID oder kein OAuth Secret ein. Die Ciele-Bereitstellung stellt diese Anmeldeinformationen bereit. Not now schließt das Verbindungsfenster, ohne ein Konto zu verbinden.

Der Assistant Editor zeigt Organization Imports an, die Sie verknüpfen können. Die Bibliothek ist die vollständige Organisationsansicht und enthält jede importierte Quelle.

Berechtigungsbereiche des Providers

Ciele meldet nicht unterstützte Dateien, leere Elemente und anbieterspezifische Ausschlüsse als übersprungene Elemente. Ein fehlerhaftes Element verhindert nicht die Verarbeitung gültiger Inhalte im selben Durchlauf.

Synchronisierung und Status

Wählen Sie Sync now für einen sofortigen Lauf aus. Pause stoppt geplante Läufe, ohne Sources zu löschen. Resume stellt einen neuen Lauf in die Warteschlange. Durch das Bearbeiten eines Bereichs wird dessen Prüfpunkt zurückgesetzt und eine vollständige Aktualisierung der neuen Auswahl geplant.

Die Zeile Import zeigt die letzte und die nächste Synchronisierung, die Anzahl der Quellen- und Assistenten-Links sowie die Gesamtzahlen der erkannten, aktualisierten, entfernten, übersprungenen und fehlgeschlagenen Elemente des letzten Laufs an. Fehler bei der Provider-Autorisierung kennzeichnen die Verbindung für eine erneute Verbindung und erzeugen eine Warnung. Ein späterer erfolgreicher Lauf löscht den Alert.

Die Remote-Identität bleibt stabil. Ein bearbeitetes Remote-Element aktualisiert die vorhandene Quelle, sodass sich Links und Zitate nicht ändern. Ein entferntes Remote-Element löscht seine aktive Quelle, behält aber einen internen Tombstone, der bei einem späteren Wiederauftreten die Erstellung des korrekten Ersatzes ermöglicht, ohne es zu duplizieren.

Die Ratenbegrenzungen des Providers verwenden die zurückgegebene Verzögerung für Wiederholungsversuche. Tägliche Importe werden ebenfalls im normalen Ciele-Worker-Zeitplan ausgeführt, sodass der Webprozess nicht geöffnet bleiben muss.

Erwähnungen in Slack beantworten

Slack Imports und Conversational Replies sind separate Funktionen. Imports kopieren Wissen in Ciele. Konversationsantworten führen einen veröffentlichten Assistenten aus, wenn jemand @Ciele in einem aktivierten Kanal erwähnt.

1. Bitten Sie Ihren Bereitstellungsadministrator, die unten beschriebene Slack Events API zu konfigurieren.
2. Öffnen Sie die Slack Connection in Applications und wählen Sie Slack assistant aus.
3. Wählen Sie Authorize conversational permissions aus und genehmigen Sie den Zugriff in Slack. Import Connections können erst dann Beiträge veröffentlichen, wenn Sie diesen Schritt abgeschlossen haben.
4. Wählen Sie einen veröffentlichten Assistenten aus Ihrer Organisation aus.
5. Laden Sie Ciele in jeden Kanal ein und wählen Sie anschließend das zulässige Channels aus der Liste aus. Kanäle, denen Ciele nicht beigetreten ist, und Slack-Connect-Kanäle können nicht ausgewählt werden.
6. Wählen Sie Save Slack assistant aus.
7. Erwähnen Sie @Ciele mit einer Frage. Ciele antwortet im Thread dieser Nachricht.

Der Assistent verwendet seine verknüpften Wissensquellen, die veröffentlichte Konfiguration und den aktuellen Slack-Kontext. Er liest bis zu 15 Kanal-Nachrichten und 15 Thread-Nachrichten vor der Erwähnung. Slack-Ratenbegrenzungen können diesen Kontext einschränken. Ciele liest bei jeder Antwort nicht den gesamten Workspace. Ciele behandelt das Kanaltranskript als nicht vertrauenswürdiges Referenzmaterial, nicht als Anweisungen. Jede Person in einem Thread hat ihre eigene Ciele-Konversation. Diese Konversation wird bei späteren Erwähnungen im Thread fortgesetzt. Direct Messages lösen diese Funktion nicht aus.

Jeder Slack-Workspace und -Kanal muss auf eine aktivierte Ciele-Organisationsverbindung verweisen. Wenn zwei Organisationen denselben Kanal aktivieren, antwortet Ciele dort nicht. Ciele löst in beiden Organisationen einen Alert aus, bis eine von ihnen den Kanal entfernt. Wenn Sie die Verbindung zu einem anderen Arbeitsbereich oder einer anderen Slack-Anwendung wiederherstellen, wird die Konversationskonfiguration gelöscht. Die Slack-Verbindung muss zur selben Slack-Anwendung gehören wie das SLACK_APPLICATION_APP_ID der Bereitstellung. Andernfalls lehnt Ciele das Speichern der Einstellungen ab.

Konfigurieren Sie die Slack Events API

Stellen Sie die Slack-Datenbankmigration bereit, bevor Sie Ereignisse aktivieren. Konfigurieren Sie diese nur serverseitigen Werte auf der Basic Information-Seite von Slack:

SLACK_APPLICATION_APP_ID=
SLACK_SIGNING_SECRET=

Behalten Sie die vorhandene OAuth Client ID, das Client Secret und den HTTPS OAuth Callback bei. Das Signing Secret unterscheidet sich vom Client Secret. Platzieren Sie keines der beiden Geheimnisse jemals in einer öffentlichen Umgebungsvariablen.

1. Fügen Sie app_mentions:read und chat:write unter OAuth & Permissions hinzu, zusätzlich zu den bereits vorhandenen Importbereichen.
2. Aktivieren Sie Event Subscriptions und setzen Sie die Anforderungs-URL auf {origin}/api/slack/events.
3. Abonnieren Sie das app_mention-Bot-Ereignis und speichern Sie die Konfiguration.
4. Konfigurieren Sie einen Organisationsmodell-Provider, der den veröffentlichten Assistant-Datenverkehr bedienen kann.

Ciele fordert die beiden Antwortbereiche nur dann an, wenn ein Member Authorize conversational permissions auswählt. Eine Connection, die ausschließlich für Imports verwendet wird, behält ein schreibgeschütztes Token.

Der Endpoint überprüft Slack-Signaturen und speichert jedes Event, bevor er es bestätigt. Der Worker wird nach der Bestätigung ausgeführt und verwendet dieselbe Conversation Runtime wie veröffentlichte Assistants. Abonnements persönlicher Provider bedienen keinen Slack-Traffic.

Die Bereitstellung stellt außerdem /api/cron/run-slack bereit, geschützt durch CRON_SECRET, für in der Warteschlange befindliche Wiederholungsversuche und unterbrochene Worker. Der selbst gehostete Scheduler führt ihn alle 5 Minuten aus. Der mitgelieferte Vercel-Scheduler wird täglich ausgeführt, da der Hobby-Tarif nur tägliche Zeitpläne zulässt. Konfigurieren Sie einen häufigen authentifizierten Scheduler, wenn eine gehostete Bereitstellung eine schnelle Wiederholungsversuchs-Wiederherstellung erfordert.

Ciele erstellt eine Warnung, wenn es eine Erwähnung nicht beantworten kann. Mögliche Ursachen sind ein Kanal, dem Ciele nicht beigetreten ist, ein archivierter oder freigegebener Kanal, ein unveröffentlichter Assistant sowie eine fehlgeschlagene Zustellung. Wenn die Slack-Zustellung ein unsicheres Ergebnis aufweist, unterdrückt Ciele automatische Reposts und erstellt einen Alert. Überprüfen Sie den Slack-Thread, bevor Sie ein betroffenes Event manuell erneut versuchen. Wenn das Slack-Token widerrufen wird oder abläuft, markiert Ciele die Connection für eine erneute Verbindung. In der Liste „Anwendungen“ wird dann Reconnect angezeigt.

Erneut verbinden oder löschen

Wählen Sie Reconnect, wenn die Einwilligung abläuft oder sich das Konto ändert. Die Verbindung behält dieselbe Identität, und ihre Imports bleiben konfiguriert.

Wenn Sie einen Import löschen, werden dessen synchronisierte Sources für jeden verknüpften Assistant gelöscht. Wenn Sie eine Verbindung löschen, werden alle zugehörigen Importe und Quellen gelöscht. Die Bestätigung zeigt die Anzahl der betroffenen Importe, Quellen und Assistant-Links an. Ciele versucht, das Provider-Token zu widerrufen, wenn der Provider dies unterstützt, und entfernt dann immer die lokalen Anmeldeinformationen.

OAuth für eine selbst gehostete Bereitstellung konfigurieren

Legen Sie APP_ENCRYPTION_KEY fest, bevor Sie einen Provider verbinden. Ciele versiegelt OAuth-Token sowie die Salesforce- und ServiceNow-Client-Geheimnisse pro Verbindung mit diesem Schlüssel.

Der verwaltete Ciele-Dienst stellt die gemeinsamen OAuth-Registrierungen für Slack, Microsoft und Google bereit. Jede selbst gehostete Bereitstellung stellt ihre eigenen Registrierungen über Umgebungsvariablen bereit. Diese Registrierungen identifizieren die Ciele-Bereitstellung. Sie identifizieren weder ein Organisations- noch ein Mitgliedskonto.

Erstellen Sie Provider-OAuth-Anwendungen und legen Sie die Paare fest, die Sie aktivieren:

SLACK_APPLICATION_CLIENT_ID=
SLACK_APPLICATION_CLIENT_SECRET=
MICROSOFT_APPLICATION_CLIENT_ID=
MICROSOFT_APPLICATION_CLIENT_SECRET=
GOOGLE_APPLICATION_CLIENT_ID=
GOOGLE_APPLICATION_CLIENT_SECRET=
APPLICATION_IMPORT_MAX_REMOTE_ITEMS=100000
APPLICATION_IMPORT_MAX_ORG_BYTES=5368709120
APPLICATION_IMPORT_MAX_CONCURRENT=3

Die drei Grenzwerte begrenzen synchronisierte Remote-Elemente pro Verbindung, gespeicherte Anwendungsbytes pro Organisation und aktive Synchronisierungsanforderungen pro Organisation. Senken Sie diese Werte für kleinere Bereitstellungen. Ciele führt Checkpoints für den Provider-Cursor durch und setzt große Importe in späteren Durable Claims fort.

Salesforce- und ServiceNow-Client-Anmeldeinformationen sind spezifisch für die verbundene Organisation. Der Administrator gibt sie im geschützten Formular „Connection“ ein. Ciele versiegelt sie vor der Speicherung und gibt sie niemals an den Browser zurück. ServiceNow verwendet den Authorization Code und speichert weder einen Benutzernamen noch ein Passwort.

Registrieren Sie genau eine Callback-URL pro Provider. Ersetzen Sie {origin} durch den öffentlichen HTTPS-Ursprung Ihrer Ciele-Konsole:

Ein fehlendes Umgebungsvariablen-Paar für Slack, Microsoft oder Google verhindert die Autorisierung für diesen Anbieter. Connect öffnet dennoch die Ciele-Verbindungsseite, auf der erklärt wird, dass die Bereitstellung eingerichtet werden muss. Admins und Owners können den Setup-Leitfaden von dieser Seite aus öffnen. Salesforce und ServiceNow bleiben verfügbar, da der Administrator deren OAuth-Registrierung im Verbindungsformular eingibt. Beide verwenden den Authorization Code. Salesforce, Microsoft und Google verwenden ebenfalls PKCE. Jede Transaktion ist kurzlebig und an die Organization, das initiierende Member, den Provider sowie die exakte Callback-URL gebunden.

Fehlerbehebung

Anwendungsimporte sind für Quellinhalte schreibgeschützt, und das Token einer Importverbindung kann nicht posten. Nur eine Verbindung mit vollständigen Konversationsberechtigungen kann Slack-Antworten posten. Ciele setzt zum Zeitpunkt der Beantwortung keine Zugriffskontrolllisten für Anbieter durch und unterstützt keine SharePoint-Bibliotheken.