Aplicaciones

Application Knowledge copia el contenido externo seleccionado a Ciele como Fuentes en las que se puede buscar. Cada Fuente sigue la ruta de ingesta normal, aparece en las citas y responde solo a los Asistentes vinculados. La integración es directa. No utiliza Merge ni ningún otro bróker de integración.

Conexión, importación y origen

Un Application Connection almacena una cuenta externa autorizada. Un Application Import selecciona el contenido dentro de esa cuenta, una programación y los Asistentes autorizados para buscar en él. Una sincronización crea o actualiza una fuente de Ciele para cada elemento remoto.

Utiliza una sola Connection para varias Import cuando su ámbito o sus enlaces de Assistant sean distintos. Por ejemplo, una conexión de Slack puede proporcionar conjuntos de canales independientes a distintos asistentes.

Las conexiones de Salesforce, ServiceNow y Slack pertenecen a la organización. Cada Organización puede tener una Conexión para cada uno de estos proveedores. Las conexiones de OneDrive y Google Drive pertenecen al miembro que las autoriza. Cada Miembro puede conectar una cuenta por cada proveedor personal.

Un administrador de la organización puede ver los metadatos de una conexión personal y eliminar dicha conexión. Solo el Miembro propietario puede volver a conectarla. Las credenciales del proveedor nunca traspasan el límite del Miembro. Las Imported Sources constituyen el conocimiento de la organización y siguen los enlaces de los asistentes que se hayan configurado.

Conecta una cuenta

Un administrador o propietario de la organización puede conectar Salesforce, ServiceNow o Slack. Un Member con permiso de edición de Knowledge puede conectar su OneDrive o Google Drive y gestionar las importaciones.

1. Abre Library y selecciona Applications, o bien abre el Knowledge de un asistente y selecciona Applications.
2. Selecciona Connect en el proveedor.
3. Para Salesforce o ServiceNow, introduce un nombre de conexión, la URL de la instancia, el ID de cliente y el secreto de cliente.
4. Para Slack, OneDrive o Google Drive, selecciona Continue connecting en la página de conexión de Ciele.
5. Inicia sesión en el sitio web del proveedor y aprueba el acceso. A continuación, Ciele actualiza la lista de Aplicaciones.
6. Crea una importación, selecciona su ámbito y vincula al menos un asistente.
7. Elige la sincronización Daily o Manual.
8. Guarda la importación y espera a que sus Sources pasen a ser Ready.
9. Prueba una respuesta y abre su cita de fuente con nombre.

Slack, OneDrive y Google Drive te piden que inicies sesión y autorices el acceso. Los miembros no introducen un ID de cliente OAuth ni un secreto. La implementación de Ciele proporciona esas credenciales. Not now cierra la ventana de conexión sin conectar ninguna cuenta.

El editor del asistente muestra las importaciones de la organización que puedes vincular. La Biblioteca es la vista completa de la Organización e incluye todas las Fuentes importadas.

Ámbitos del proveedor

Ciele informa de los archivos no compatibles, los elementos vacíos y las exclusiones específicas del proveedor como elementos omitidos. Un elemento incorrecto no detiene el contenido válido en la misma ejecución.

Sincronización y estado

Selecciona Sync now para una ejecución inmediata. Pause detiene las ejecuciones programadas sin eliminar los orígenes. Resume pone en cola una nueva ejecución. Al editar un ámbito, se restablece su punto de control y se programa una actualización completa de la nueva selección.

La fila Import muestra su última sincronización y la siguiente, los recuentos de Source y de enlaces de Assistant, así como los totales de elementos descubiertos, actualizados, eliminados, omitidos y con error de la última ejecución. Los errores de autorización del proveedor marcan la Connection para que se vuelva a conectar y crean una Alert. Una ejecución posterior correcta borra la alerta.

La identidad remota se mantiene estable. Cuando se edita un elemento remoto, se actualiza el Source existente, por lo que los enlaces y las citas no cambian. Cuando se elimina un elemento remoto, se borra su Source activo, pero se conserva una «tombstone» interna, lo que permite que, si vuelve a aparecer más adelante, se cree el reemplazo correcto sin duplicarlo.

Los límites de tasa del proveedor utilizan el tiempo de espera para reintentos devuelto. Las importaciones diarias también se ejecutan según la programación habitual de los workers de Ciele, por lo que no es necesario que el proceso web permanezca abierto.

Responde a las menciones en Slack

Las importaciones de Slack y las respuestas conversacionales son funciones independientes. Las importaciones copian conocimiento a Ciele. Las respuestas conversacionales ejecutan un asistente publicado cuando alguien menciona a @Ciele en un canal habilitado.

1. Pide a tu administrador de implementación que configure la API de eventos de Slack que se describe a continuación.
2. Abre la conexión de Slack en Applications y selecciona Slack assistant.
3. Selecciona Authorize conversational permissions y aprueba el acceso en Slack. Las Import Connections no pueden publicar hasta que completes este paso.
4. Selecciona un asistente publicado de tu organización.
5. Invita a Ciele a cada canal y, a continuación, selecciona el Channels permitido de la lista. No puedes seleccionar canales a los que Ciele no se haya unido ni canales de Slack Connect.
6. Selecciona Save Slack assistant.
7. Menciona a @Ciele con una pregunta. Ciele responde en el hilo de ese mensaje.

El asistente utiliza su conocimiento vinculado, la configuración publicada y el contexto reciente de Slack. Lee hasta 15 mensajes del canal y 15 mensajes del hilo anteriores a la mención. Los límites de tasa de Slack pueden reducir ese contexto. Ciele no lee el espacio de trabajo completo para cada respuesta. Ciele trata la transcripción del canal como material de referencia no fiable, no como instrucciones. Cada persona de un hilo tiene su propia conversación de Ciele. Esa conversación continúa a través de sus menciones posteriores en el hilo. Los mensajes directos no activan esta función.

Cada espacio de trabajo y canal de Slack debe resolverse en una única conexión habilitada con una organización de Ciele. Cuando dos organizaciones habilitan el mismo canal, Ciele no responde en él. Ciele genera una alerta en ambas organizaciones hasta que una de ellas elimine el canal. Si te vuelves a conectar a un espacio de trabajo o a una aplicación de Slack diferente, se borrará la configuración de la conversación. La conexión de Slack debe pertenecer a la misma aplicación de Slack que el SLACK_APPLICATION_APP_ID de la implementación. De lo contrario, Ciele se niega a guardar la configuración.

Configura la API de eventos de Slack

Implementa la migración de la base de datos de Slack antes de habilitar los eventos. Configura estos valores exclusivos del servidor desde la página Basic Information de Slack:

SLACK_APPLICATION_APP_ID=
SLACK_SIGNING_SECRET=

Conserva el OAuth client ID, el client secret y la HTTPS OAuth callback existentes. El signing secret es diferente del client secret. Nunca coloques ninguno de los dos secretos en una variable de entorno pública.

1. Añade app_mentions:read y chat:write bajo OAuth & Permissions, además de los ámbitos de importación existentes.
2. Habilita Event Subscriptions y establece la URL de la solicitud en {origin}/api/slack/events.
3. Suscríbete al evento del bot app_mention y guarda la configuración.
4. Configura un proveedor de modelos de organización que pueda atender el tráfico de los Asistentes publicados.

Ciele solicita los dos ámbitos de respuesta solo cuando un Miembro selecciona Authorize conversational permissions. Una conexión que se utiliza solo para importaciones mantiene un token de solo lectura.

El punto de conexión verifica las firmas de Slack y almacena cada evento antes de acusar su recepción. El proceso de trabajo se ejecuta después del acuse de recibo y utiliza el mismo entorno de ejecución de conversación que los Asistentes publicados. Las suscripciones de proveedores personales no atienden el tráfico de Slack.

La implementación también expone /api/cron/run-slack, protegido por CRON_SECRET, para los reintentos en cola y los workers interrumpidos. El programador autoalojado lo ejecuta cada 5 minutos. La programación de Vercel proporcionada se ejecuta diariamente, ya que el plan Hobby solo permite programaciones diarias. Configura un programador autenticado que se ejecute con frecuencia cuando una implementación alojada requiera una recuperación rápida mediante reintentos.

Ciele crea una alerta cuando no puede responder a una mención. Las causas incluyen un canal al que Ciele no se ha unido, un canal archivado o compartido, un Asistente no publicado y una entrega fallida. Si la entrega en Slack tiene un resultado incierto, Ciele suprime las republicaciones automáticas y crea una alerta. Revisa el hilo de Slack antes de reintentar manualmente un evento afectado. Cuando el token de Slack se revoca o caduca, Ciele marca la Connection para que se vuelva a conectar. A continuación, la lista Applications muestra Reconnect.

Vuelve a conectar o elimina

Selecciona Reconnect cuando venza el consentimiento o cambie la cuenta. La Conexión mantiene la misma identidad y sus Importaciones permanecen configuradas.

Al eliminar una importación, se eliminan sus fuentes sincronizadas para cada asistente vinculado. Al eliminar una Connection, se eliminan todas sus Imports y Sources. La confirmación muestra los recuentos de importaciones, fuentes y enlaces de asistente afectados. Ciele intenta revocar el token del proveedor cuando este lo admite y, a continuación, siempre elimina las credenciales locales.

Configura OAuth para una implementación autohospedada

Establece APP_ENCRYPTION_KEY antes de conectar cualquier proveedor. Ciele sella con esa clave los tokens de OAuth y los secretos de cliente de Salesforce y ServiceNow de cada conexión.

El servicio gestionado de Ciele proporciona los registros OAuth compartidos para Slack, Microsoft y Google. Cada implementación autoalojada proporciona sus propios registros mediante variables de entorno. Estos registros identifican la implementación de Ciele. No identifican una cuenta de Organization ni de Member.

Crea aplicaciones OAuth de proveedor y establece los pares que habilites:

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

Los tres límites son: elementos remotos sincronizados por Connection, bytes de Application almacenados por Organization y solicitudes de sincronización activas por Organization. Redúcelos para implementaciones más pequeñas. Ciele realiza un punto de control del cursor del proveedor y continúa las importaciones grandes en solicitudes duraderas posteriores.

Las credenciales de cliente de Salesforce y ServiceNow son específicas de la Organization conectada. El administrador las introduce en el formulario protegido de Connection. Ciele las sella antes de almacenarlas y nunca las devuelve al navegador. ServiceNow utiliza Authorization Code y no almacena ni nombre de usuario ni contraseña.

Registra una URL de devolución de llamada exacta por proveedor. Sustituye {origin} por el origen HTTPS público de tu consola de Ciele:

Si falta un par de variables de entorno de Slack, Microsoft o Google, no se autoriza a ese proveedor. Connect sigue abriendo la página de conexión de Ciele, que explica que la implementación necesita configuración. Los administradores y los propietarios pueden abrir la guía de configuración desde esa página. Salesforce y ServiceNow siguen estando disponibles porque el administrador introduce su registro de OAuth en el formulario Connection. Ambos utilizan el método Authorization Code. Salesforce, Microsoft y Google también utilizan PKCE. Cada transacción tiene una duración breve y está vinculada a la organización, al miembro iniciador, al proveedor y a la URL de devolución de llamada exacta.

Resolución de problemas

Las importaciones de aplicaciones son de solo lectura para el contenido de origen, y el token de una conexión de importación no puede realizar publicaciones. Solo una conexión con permisos de conversación completos puede publicar respuestas en Slack. Ciele no aplica las listas de control de acceso de los proveedores en el momento de generar la respuesta ni admite bibliotecas de SharePoint.