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.
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.
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 ejecutan la CLI, 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.
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.
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.
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 el uso del modelo se te facture directamente, sin recargo de Syncanix.
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.
MAEU (usuarios finales activos mensuales): El número de usuarios finales distintos que interactúan con tu asistente en un mes: la medida principal con la que se dimensionan los planes.
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.