Tema
Conceptos
Los siete términos que aparecen en el resto de la documentación.
Agente
Una conversación con memoria. Tiene un prompt de sistema, un modelo, opcionalmente un conjunto de tools y de áreas de conocimiento, y recuerda lo hablado con cada usuario.
Es lo que embebes en tu producto como chat. Se identifica por un identifier (un slug legible, p. ej. soporte) o por su id (un UUID inmutable) — donde la documentación pida un agente, cualquiera de los dos vale.
→ Configurar el agente · Integrar un agente
Inferencia
Una llamada suelta y sin estado: entra un prompt, sale una respuesta. No recuerda nada entre llamadas y no conversa.
Se configura en el panel (prompt de sistema, modelo, RAGs asociados) y se ejecuta desde tu backend con POST /api/inferences/{identifier}. Es la herramienta para clasificar, extraer, resumir o generar JSON estructurado.
RAG
Un conjunto de documentos indexados sobre el que se puede buscar por significado en vez de por palabra exacta. Retrieval-Augmented Generation: se recuperan los fragmentos relevantes y se le pasan al modelo como contexto.
Un RAG se alimenta de una file source y se asocia a agentes (vía la tool rag_retrieve) o a inferencias.
File source
El origen de los documentos de un RAG: un directorio del sistema de ficheros, una carpeta de Google Drive, un bucket S3, SharePoint o un sitio web rastreado. ur la escanea periódicamente, extrae el texto e indexa los fragmentos.
Tiene su propio estado de sincronización, y puedes consultar si un fichero concreto llegó a indexarse.
Tool
Una función que el modelo puede decidir invocar durante un turno (function calling). ur distingue dos niveles:
- Plantilla — el código de la tool. Viene con el producto y solo se puede activar o desactivar.
- Instancia — una plantilla ya configurada y con nombre propio. Es lo que se vincula a un agente.
La consecuencia práctica: la configuración vive en la instancia, así que si quieres los mismos documentos con otros parámetros, creas una segunda instancia con otro nombre.
Las que vienen de serie son calculator y rag_retrieve (buscar en tus RAGs).
Canal
Por dónde entra una conversación a un agente. Cada agente tiene exactamente dos canales, creados automáticamente y que solo se editan, nunca se crean ni se borran:
widget— el chat flotante embebido con<script>.js_sdk— tu propia UI, construida con el SDK.
Cada uno se habilita y se restringe por origen de forma independiente. Además, las conversaciones de un canal y otro son hilos separados, aunque sea el mismo usuario.
→ Canales
Subject e hilo
El subjectId es la identidad de conversación: quién está hablando, desde el punto de vista del agente. En el widget y el SDK lo genera el propio navegador y se guarda en localStorage; en la API la eliges tú (lo normal es el id de usuario de tu sistema).
El hilo es la conversación en sí, y se identifica por la terna (agente, subjectId, canal). De ahí que el mismo subjectId en widget y en js_sdk sean dos conversaciones distintas.
Empezar de cero equivale a generar un subjectId nuevo.