Conceptos

Esta página presenta el vocabulario utilizado en la plataforma y en el resto de la documentación.

Instalación y organización

Una instalación es un stack completo de la Aptabit Platform en un servidor, con su configuración, sus datos y su identidad de licencia. Cada instalación atiende a una organización, creada en el primer acceso.

Para separar entornos o unidades con aislamiento completo, utilice instalaciones distintas. Varias instalaciones pueden ejecutarse en el mismo servidor, cada una con su proyecto Compose, sus contenedores y su red.

Workspaces

El workspace es la unidad de trabajo dentro de la organización:

• Personal: cada persona tiene el suyo.
• Compartido: creado por un administrador, con miembros directos o provenientes de grupos del directorio corporativo.

Los contextos, flujos, programaciones e integraciones se organizan por workspace. Un modelo solo aparece en el chat de un workspace después de habilitarse en él. El selector de workspace está en la barra superior.

Roles y módulos

El acceso combina tres capas:

• Rol: cuenta root (propietaria de la instalación), administrador o miembro.
• Módulos por persona: Chat, Agentes, Almacenamiento, Datos, Flujos, Programaciones e Integraciones. Las personas nuevas comienzan sin ningún módulo.
• Alcance: pertenencia a workspaces y acceso a cada agente y modelo.

Consulte Usuarios, roles y acceso.

Contextos

Un contexto es donde se guardan los archivos y los datos que utiliza la plataforma:

• Conocimiento: documentos leídos, divididos en fragmentos e indexados para búsqueda híbrida (semántica y léxica).
• Datos: tablas tipadas, completadas desde archivos o manualmente, consultadas mediante SQL de solo lectura.
• Personal: el área fija de cada persona con los archivos que adjuntó en el chat, visible solo para ella.

Consulte Almacenamiento: conocimiento y datos.

Modelos y proveedores

Un proveedor externo es un servicio de modelos al que se accede por API: OpenAI, Azure OpenAI, Anthropic o cualquier endpoint compatible con la API de OpenAI. Un modelo local se ejecuta en su servidor, en un runtime gestionado por la propia plataforma o en un servidor de inferencia que usted ya opera. Consulte Modelos, runtimes y aceleradores.

Agentes

Un agente combina un modelo base, instrucciones y parámetros de generación, con acceso restringido a workspaces y personas. El conocimiento proviene del contexto elegido en la conversación o de un flujo construido alrededor del agente. Consulte Agentes.

Flujos, contratos y ejecuciones

Un flujo es una automatización armada con bloques en un constructor visual. Su contrato define la exposición (interna, API o chat) y los esquemas JSON de entrada y de salida. Un flujo pasa de borrador a publicado y solo se ejecuta publicado.

Cada ejecución genera un registro de ejecución con origen, estado, entrada, salida y la traza de cada bloque. Consulte Flujos y programaciones.

Programaciones

Una programación ejecuta un flujo publicado a un intervalo fijo (a partir de 60 segundos), con una entrada JSON fija, hasta un número máximo de ejecuciones, si se define.

Integraciones

Una integración es una conexión registrada con un sistema externo, con sus recursos y credenciales cifradas. Los flujos la utilizan mediante el bloque de integración. Consulte Integraciones.

Registros y procedencia

El registro unificado reúne cada interacción de chat, agente y flujo y los eventos de auditoría. La procedencia es lo que cada respuesta de IA guarda sobre su origen: el modelo que la produjo y las fuentes que la fundamentaron. Consulte Gobernanza y cumplimiento.

Licencia

La licencia es emitida por Aptabit para su organización y se valida en línea, mediante check-in, o sin conexión, mediante un archivo. Consulte Licencia y conectividad.