Glosario

Términos clave usados en la documentación de Syncanix.

El vocabulario transversal que se usa a lo largo de esta documentación. Las secciones posteriores definen sus propios términos de dominio donde aparecen.

Capacidad: Una sola cosa que tu API puede hacer —un endpoint o acción, como «reembolsar un pedido»— descrita para que el asistente sepa qué hace y cuándo usarla.
Catálogo de capacidades: La lista estructurada de todas tus capacidades. Se descubre a partir de tu API y es la única fuente de verdad de la que leen el widget, el chat y el servidor MCP.
Descubrimiento: El proceso de analizar tu código para construir el catálogo de capacidades, ejecutado por la CLI de Syncanix.
Efecto secundario: Lo que una acción hace con tus datos: lectura (consulta algo), escritura (cambia algo) o destructiva (elimina o cambia de forma irreversible). el efecto secundario determina cómo se confirma la acción.
Widget: El componente de chat integrable que añades a tu aplicación con una sola etiqueta de script.
Superficie de chat: La experiencia de asistente con la que interactúan tus usuarios: responde preguntas y ejecuta acciones a través de tu API.
Fundamentación (recuperación): Responder a partir de tu propia documentación y contenido en lugar del conocimiento general del modelo. El asistente recupera el material relevante y lo cita, de modo que las respuestas reflejan tu producto.
Sitios web aprobados: Las páginas y dominios que el agente puede LEER mientras responde: salientes y solo de lectura. Sin ninguna entrada no lee nada fuera de tu propio catálogo, conectores y documentación indexada. No es lo mismo que los orígenes del widget, que rigen la dirección contraria: qué sitios tuyos pueden INCRUSTAR el widget. Cada entrada la aprueba un administrador, se limita a GET, se vuelve a comprobar contra tus reglas en cada solicitud y en cada redirección, y nunca puede apuntar a una dirección privada o interna.
Mapeo del sitio: Syncanix aprende tu producto leyéndolo. Tus propias páginas se abren en tu navegador, con tu sesión iniciada, y Syncanix anota lo que contiene cada una — las secciones, los formularios, los botones y los caminos entre ellos — para que el agente pueda responder sobre tu producto y guiar a las personas por él. No es el sitemap, la lista de direcciones que tu sitio publica para los buscadores: el mapeo trata de lo que hay en una página, no de qué páginas existen. Tampoco es el Mapa de interacciones, que refleja lo que hicieron los usuarios finales una vez que el agente ya estaba en marcha.
Manual del sitio: Una descripción generada y estructurada de tu sitio — sus páginas, controles y flujos — elaborada a partir del descubrimiento para espacios de trabajo sin documentación propia. El agente fundamenta en él las preguntas sobre el sitio y lo cita como cualquier otra fuente, en el idioma del visitante.
Guías de tareas: Un flujo con nombre, ya publicado, por el que el agente puede acompañar a un visitante en tus propias páginas: los pasos en sí, señalados de uno en uno, no un artículo que los describe. Syncanix propone guías a partir de lo que observó el descubrimiento y de los flujos que demuestras; ninguna se ofrece a nadie hasta que la publicas.
Interacción: El único lugar donde se configura cómo tu asistente se dirige a los visitantes: qué ofrece antes de que escriban (sugerencias), cuándo habla primero (avisos) y dónde aparece siquiera (reglas de página). No es una página de métricas: todas las superficies de analítica del producto miden la interacción, y aquí es donde se define el comportamiento en sí. Sustituye a tres páginas separadas que describían cada una una parte de la misma experiencia del visitante.
MCP (Model Context Protocol): Un estándar abierto que permite a clientes de IA como Claude Desktop, Cursor y ChatGPT conectarse a herramientas y datos externos.
Servidor MCP: El endpoint por espacio de trabajo que Syncanix te proporciona para que los clientes MCP accedan a tus capacidades.
Desarrollador / administrador: Tu equipo: las personas que integran el widget, configuran el panel y gestionan el espacio de trabajo.
Usuario final: El usuario autenticado de tu cliente, que conversa con el widget o conecta un cliente MCP. Para cada acción se usa su propia identidad, no una compartida.
Aprendizaje del usuario: Una capacidad opcional que permite al asistente aprender preferencias y contexto duraderos de cada usuario final con sesión iniciada a partir de sus conversaciones, inyectando un resumen compacto y limitado por presupuesto en los turnos futuros para personalizar las respuestas y las acciones disponibles.
Impacto del agente: La superficie de analítica que mide el valor de negocio que aporta el agente: cuántas solicitudes de usuarios finales resolvió sin ayuda humana (desvío), los resultados de esas conversaciones y un retorno de la inversión estimado, agregados cada noche por espacio de trabajo con una divulgación honesta del muestreo.
Interacción: Un turno cobrado: una pregunta y la respuesta del asistente, incluidas las llamadas a herramientas, MCP y endpoints que esa respuesta haga, o bien una única llamada a herramienta independiente. Cada uno tiene un precio publicado: 3 créditos de uso por responder, 6 si además ejecutó una acción, 9 si además consultó información y 12 si hizo ambas cosas. Una conversación son varias interacciones, no una. No tiene relación con el Mapa de interacciones, que visualiza recorridos en lugar de ponerles precio.
Mapa de interacciones: Un mapa visual del grafo de capacidades del agente y de los recorridos que hacen los usuarios finales por él: a qué áreas, rutas y capacidades llegan, dónde se concentra la demanda y dónde quedan huecos de capacidad, representado como un lienzo interactivo con una vista de tabla accesible. No lleva precios: la unidad que sí los lleva es la interacción.
Proveedor de identidad (IdP): El servicio que autentica a tus usuarios —por ejemplo Auth0, Clerk, Cognito o WorkOS—. Syncanix lo usa en lugar de almacenar credenciales él mismo.
Federación: Delegar el inicio de sesión en tu proveedor de identidad, de modo que el mismo acceso y permisos que ya tienen tus usuarios se apliquen dentro de Syncanix.
token web JSON (JWT): Un token compacto y firmado que demuestra quién es un usuario con sesión iniciada. Tu proveedor de identidad lo emite; Syncanix verifica su firma para confiar en la identidad.
JWKS (conjunto de claves web JSON): El conjunto de claves públicas que publica tu proveedor de identidad para que los servicios puedan verificar las firmas de sus tokens, sin compartir nunca un secreto.
Protocolo OpenID Connect (OIDC): El protocolo estándar de inicio de sesión que habla la mayoría de los proveedores de identidad. Si el tuyo lo admite, Syncanix puede verificar a tus usuarios a través de él.
PKCE (clave de prueba para el intercambio de código): Un paso de seguridad en el flujo de inicio de sesión de OAuth que impide que un código de autorización interceptado sea usado por otra persona. Los clientes MCP inician sesión de esta forma.
Ámbito: Un permiso con nombre asociado a un token: lo que su portador tiene autorizado a hacer. Las acciones del asistente están acotadas por los ámbitos del usuario, nunca más allá.
Intercambio de tokens: Una forma estándar (RFC 8693) de canjear un token por otro más restringido y vinculado a una tarea concreta, usada en configuraciones empresariales para que cada acción posterior obtenga su propio token, emitido explícitamente y con ámbito.
Backend para frontend (BFF): Un pequeño servidor que tú ejecutas y que se sitúa entre el widget y Syncanix, de modo que los tokens de autenticación nunca llegan al navegador. La forma más blindada de autenticar a tus usuarios.
Autenticación reforzada (step-up): Pedir a un usuario que vuelva a confirmar su identidad —por ejemplo con autenticación multifactor— antes de ejecutar una acción sensible.
Actuar en nombre de: El asistente ejecutando una acción como el usuario final, con su identidad y sus permisos, nunca con acceso elevado o compartido.
Niveles de confirmación: Cómo Syncanix controla las acciones según el riesgo: las de lectura pueden ejecutarse automáticamente, las de escritura piden confirmación y las destructivas se bloquean salvo que las autorices.
Seguridad a nivel de fila: Una función de la base de datos que filtra automáticamente cada consulta a las filas de un único espacio de trabajo: la última salvaguarda de Syncanix para mantener separados los datos de los clientes, incluso si una consulta se olvida de limitarse a sí misma.
Intención firmada: Un token de un solo uso e imposible de manipular que vincula una acción aprobada a un usuario, una capacidad y unas entradas concretas, de modo que una acción confirmada no puede alterarse ni reproducirse.
Puerta de evaluación: Una comprobación de calidad automática que se ejecuta antes de promocionar a producción y bloquea el cambio si las respuestas del asistente empeoran, de modo que producción solo cambia para mejor.
Detección de desviaciones: Darse cuenta de cuándo tu API o su comportamiento cambian y el catálogo ya no coincide con la realidad, y señalarlo para que el asistente nunca actúe sobre una imagen obsoleta.
Retención cero de datos (ZDR): Un acuerdo por el que un proveedor de IA procesa una solicitud sin almacenarla ni entrenar con ella. La CLI exige tu consentimiento explícito antes de cualquier enriquecimiento con IA.
BYOK (aporta tu propia clave): Usar tus propias claves de proveedor de IA, de modo que tu proveedor te factura el uso del modelo directamente en lugar de contar para tu plan.
BYOMCP (trae tu propio servidor MCP): Conectar servidores MCP que ya operas como fuentes de herramientas adicionales. Sus herramientas aparecen junto a tu catálogo descubierto, y las llamadas se reenvían a tu servidor respetando el aislamiento por tenant y la autenticación reforzada (step-up).
Witness (testigo): Una observación en tiempo de ejecución de la forma de una llamada a la API — nombres de campos y tipos inferidos, nunca valores — producida por el middleware api-witness opcional. Los witnesses mantienen el catálogo alineado con lo que tu API realmente sirve.
UC (créditos de uso): La unidad en la que Syncanix pone precio a las interacciones. Cada interacción cuesta 6, 15, 18 o 30 UC según lo que hizo: responder, ejecutar una acción, consultar información o ambas cosas. Los planes se dimensionan por créditos de uso incluidos, así que el coste lo marca el uso y no la plantilla.
Entorno: Una copia aislada de tu configuración. Cada espacio de trabajo tiene un entorno de desarrollo para la configuración y un entorno de producción al que llegan tus usuarios.
Promover: Llevar tu configuración de desarrollo a producción, de modo que el comportamiento en vivo solo cambie cuando tú lo decidas.
Claves publicable y secreta: Una clave publicable (pk_…) puede incrustarse de forma segura en tu página web para el widget; una clave secreta (gak_…) se usa en el servidor, por ejemplo por la CLI. Nunca expongas una clave secreta en el código de cliente.
Espacio de trabajo: Un único inquilino de Syncanix: tu proyecto, con su catálogo, configuración, equipo y facturación. Puedes pertenecer a más de uno.