Applications

Application Knowledge copie le contenu externe sélectionné dans Ciele sous la forme de Sources consultables. Chaque Source suit le parcours d'ingestion normal, apparaît dans les citations et répond uniquement pour les Assistants associés. L'intégration est directe. Elle n'utilise pas Merge ni aucun autre courtier d'intégration.

Connexion, Importation et Source

Un Application Connection stocke un compte externe autorisé. Un Application Import sélectionne le contenu au sein de ce compte, un calendrier et les Assistants autorisés à le rechercher. Une synchronisation crée ou met à jour une Ciele Source pour chaque élément distant.

Utilisez une seule Connection pour plusieurs Imports lorsque leur périmètre ou leurs liens vers les Assistants diffèrent. Par exemple, une connexion Slack peut alimenter des ensembles de canaux distincts vers des assistants distincts.

Les connexions Salesforce, ServiceNow et Slack appartiennent à l'organisation. Chaque organisation peut disposer d'une connexion pour chacun de ces fournisseurs. Les connexions OneDrive et Google Drive appartiennent au membre qui les autorise. Chaque Membre peut connecter un compte pour chaque fournisseur personnel.

Un administrateur de l'organisation peut consulter les métadonnées d'une connexion personnelle et supprimer cette connexion. Seul le Membre propriétaire peut la reconnecter. Les informations d'identification du fournisseur ne dépassent jamais le cadre du Membre. Les sources importées constituent la connaissance de l'organisation et suivent les liens d'assistant configurés.

Connecter un compte

Un administrateur ou un propriétaire de l'organisation peut connecter Salesforce, ServiceNow ou Slack. Un membre disposant de l'autorisation Knowledge edit peut connecter son OneDrive ou son Google Drive et gérer les importations.

1. Ouvrez Library et sélectionnez Applications, ou ouvrez le Knowledge d'un Assistant et sélectionnez Applications.
2. Sélectionnez Connect sur le fournisseur.
3. Pour Salesforce ou ServiceNow, saisissez un nom de connexion, une URL d'instance, un identifiant client et un secret client.
4. Pour Slack, OneDrive ou Google Drive, sélectionnez Continue connecting sur la page de connexion de Ciele.
5. Connectez-vous sur le site Web du fournisseur et autorisez l'accès. Ciele actualise ensuite la liste des applications.
6. Créez une importation, sélectionnez son périmètre et associez-lui au moins un Assistant.
7. Choisissez la synchronisation Daily ou Manual.
8. Enregistrez l'Import et attendez que ses Sources deviennent Ready.
9. Testez une réponse et ouvrez sa citation de Source nommée.

Slack, OneDrive et Google Drive vous demandent de vous connecter et d'autoriser l'accès. Les membres ne saisissent pas d'OAuth client ID ni d'OAuth client secret. Le déploiement Ciele fournit ces identifiants. Not now ferme la fenêtre de connexion sans associer de compte.

L'éditeur de l'assistant affiche les Importations de l'organisation que vous pouvez associer. La Library est la vue complète de l'organisation et inclut toutes les sources importées.

Portées du fournisseur

Ciele signale les fichiers non pris en charge, les éléments vides et les exclusions spécifiques au fournisseur en tant qu'éléments ignorés. Un élément incorrect n'arrête pas le contenu valide lors du même traitement.

Synchronisation et état

Sélectionnez Sync now pour une exécution immédiate. Pause arrête les exécutions planifiées sans supprimer les Sources. Resume met une nouvelle exécution en file d'attente. La modification d'un scope réinitialise son checkpoint et planifie une actualisation complète de la nouvelle sélection.

La ligne Import indique sa dernière synchronisation et la prochaine, le nombre de Sources et de liens vers l'Assistant, ainsi que les totaux des éléments découverts, mis à jour, supprimés, ignorés et en échec lors de la dernière exécution. Les échecs d'autorisation du fournisseur marquent la Connection pour une reconnexion et créent une Alert. Une exécution ultérieure réussie efface l'alerte.

L'identité distante reste stable. La modification d'un élément distant met à jour la Source existante, de sorte que les liens et les citations ne changent pas. Un élément distant supprimé supprime sa Source active, mais conserve une « tombstone » interne, ce qui permet, en cas de réapparition ultérieure, de créer le bon élément de remplacement sans le dupliquer.

Les limites de taux du fournisseur utilisent le délai de nouvelle tentative renvoyé. Les importations quotidiennes sont également exécutées selon le calendrier normal des tâches Ciele, de sorte que le processus Web n'a pas besoin de rester ouvert.

Répondre aux mentions dans Slack

Les importations Slack et les réponses conversationnelles sont des fonctionnalités distinctes. Les importations copient les connaissances dans Ciele. Les réponses conversationnelles exécutent un Assistant publié lorsque quelqu'un mentionne @Ciele dans un canal activé.

1. Demandez à votre administrateur de déploiement de configurer l'API Slack Events décrite ci-dessous.
2. Ouvrez la connexion Slack dans Applications et sélectionnez Slack assistant.
3. Sélectionnez Authorize conversational permissions et autorisez l'accès dans Slack. Les connexions importées ne peuvent pas publier tant que vous n'avez pas effectué cette étape.
4. Sélectionnez un Assistant publié de votre Organisation.
5. Invitez Ciele à chaque canal, puis sélectionnez le Channels autorisé dans la liste. Vous ne pouvez pas sélectionner les canaux auxquels Ciele n'a pas rejoint ni les canaux Slack Connect.
6. Sélectionnez Save Slack assistant.
7. Mentionnez @Ciele en posant une question. Ciele répond dans le fil de discussion de ce message.

L'assistant utilise ses connaissances liées, sa configuration publiée et le contexte Slack récent. Il lit jusqu'à 15 messages du canal et 15 messages du fil de discussion précédant la mention. Les limites de taux de Slack peuvent réduire ce contexte. Ciele ne lit pas l'ensemble de l'espace de travail pour chaque réponse. Ciele considère la transcription du canal comme un document de référence non fiable, et non comme des instructions. Chaque personne présente dans un fil de discussion a sa propre conversation Ciele. Cette conversation se poursuit à travers leurs mentions ultérieures dans le fil de discussion. Les messages directs ne déclenchent pas cette fonctionnalité.

Chaque espace de travail et canal Slack doit être associé à une connexion Ciele Organization activée. Lorsque deux organisations activent le même canal, Ciele n'y répond pas. Ciele déclenche une alerte dans les deux organisations jusqu'à ce que l'une d'elles supprime le canal. La reconnexion à un autre espace de travail ou à une autre application Slack réinitialise la configuration conversationnelle. La connexion Slack doit appartenir à la même application Slack que le SLACK_APPLICATION_APP_ID du déploiement. Sinon, Ciele refuse d'enregistrer les paramètres.

Configurez l'API Slack Events

Déployez la migration de la base de données Slack avant d'activer les événements. Configurez ces valeurs réservées au serveur depuis la page Basic Information de Slack :

SLACK_APPLICATION_APP_ID=
SLACK_SIGNING_SECRET=

Conservez l'ID client OAuth existant, le secret client et le rappel HTTPS OAuth. Le secret de signature est différent du secret client. Ne placez jamais l'un ou l'autre de ces secrets dans une variable d'environnement publique.

1. Ajoutez app_mentions:read et chat:write sous OAuth & Permissions, en plus des étendues d'importation existantes.
2. Activez Event Subscriptions et définissez l'URL de la requête sur {origin}/api/slack/events.
3. Abonnez-vous à l'événement bot app_mention et enregistrez la configuration.
4. Configurez un fournisseur de modèles d'organisation capable de gérer le trafic des Assistants publiés.

Ciele ne demande les deux portées de réponse que lorsqu'un Member sélectionne Authorize conversational permissions. Une Connection utilisée uniquement pour les importations conserve un token en lecture seule.

Le point de terminaison vérifie les signatures Slack et stocke chaque événement avant de l'accuser réception. Le worker s'exécute après l'acquittement et utilise le même runtime de conversation que les Assistants publiés. Les abonnements de fournisseur personnels ne gèrent pas le trafic Slack.

Le déploiement expose également /api/cron/run-slack, protégé par CRON_SECRET, pour les nouvelles tentatives mises en file d'attente et les workers interrompus. Le planificateur auto-hébergé l'exécute toutes les 5 minutes. Le planificateur Vercel fourni s'exécute quotidiennement, car le forfait Hobby n'autorise que les planifications quotidiennes. Configurez un planificateur authentifié fréquent lorsqu'un déploiement hébergé nécessite une reprise rapide des tentatives.

Ciele crée une alerte lorsqu'il ne peut pas répondre à une mention. Parmi les causes possibles figurent un canal auquel Ciele n'a pas rejoint, un canal archivé ou partagé, un Assistant non publié et une livraison ayant échoué. Si la livraison Slack a un résultat incertain, Ciele supprime les republications automatiques et crée une alerte. Vérifiez le fil de discussion Slack avant de relancer manuellement un événement concerné. Lorsque le token Slack est révoqué ou expire, Ciele marque la Connection pour une reconnexion. La liste Applications affiche alors Reconnect.

Reconnecter ou supprimer

Sélectionnez Reconnect lorsque le consentement expire ou que le compte change. La Connexion conserve la même identité et ses Importations restent configurées.

La suppression d'un Import supprime ses Sources synchronisées pour chaque Assistant associé. La suppression d'une Connection entraîne la suppression de tous ses Imports et de toutes ses Sources. La confirmation indique le nombre d'importations, de sources et de liens d'assistant concernés. Ciele tente de révoquer le token du fournisseur lorsque celui-ci le prend en charge, puis supprime systématiquement les identifiants locaux.

Configurer OAuth pour un déploiement auto-hébergé

Définissez APP_ENCRYPTION_KEY avant de connecter un fournisseur. Ciele scelle les jetons OAuth et les secrets clients Salesforce et ServiceNow par connexion avec cette clé.

Le service géré Ciele fournit les enregistrements OAuth partagés pour Slack, Microsoft et Google. Chaque déploiement auto-hébergé fournit ses propres enregistrements par le biais de variables d'environnement. Ces enregistrements identifient le déploiement Ciele. Ils n'identifient pas un compte d'organisation ou de membre.

Créez des applications OAuth de fournisseur et définissez les paires que vous activez :

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

Les trois limites concernent : le nombre d'éléments distants synchronisés par Connection, le volume d'octets d'Application stockés par Organization, et le nombre de claims de synchronisation actifs par Organization. Réduisez-les pour les déploiements de plus petite taille. Ciele effectue des points de contrôle du curseur du fournisseur et poursuit les importations volumineuses dans des revendications durables ultérieures.

Les identifiants client Salesforce et ServiceNow sont spécifiques à l'organisation connectée. L'administrateur les saisit dans le formulaire protégé Connection. Ciele les scelle avant leur stockage et ne les renvoie jamais au navigateur. ServiceNow utilise l'Authorization Code et ne stocke ni nom d'utilisateur ni mot de passe.

Enregistrez une seule URL de rappel exacte par fournisseur. Remplacez {origin} par l'origine HTTPS publique de votre console Ciele :

L'absence d'une paire de variables d'environnement pour Slack, Microsoft ou Google empêche l'autorisation pour ce fournisseur. Connect ouvre toujours la page de connexion Ciele, qui indique que le déploiement nécessite une configuration. Les administrateurs et les propriétaires peuvent ouvrir le guide de configuration à partir de cette page. Salesforce et ServiceNow restent disponibles car l'administrateur saisit leur enregistrement OAuth dans le formulaire de connexion. Les deux utilisent le code d'autorisation (Authorization Code). Salesforce, Microsoft et Google utilisent également PKCE. Chaque transaction est de courte durée et liée à l'organisation, au membre initiateur, au fournisseur et à l'URL de rappel exacte.

Dépannage

Les importations d'application sont en lecture seule pour le contenu source, et le jeton d'une connexion d'importation ne peut pas publier. Seule une Connection disposant de l'ensemble des autorisations conversationnelles peut publier des réponses sur Slack. Ciele n'applique pas les listes de contrôle d'accès des fournisseurs au moment de la réponse et ne prend pas en charge les bibliothèques SharePoint.